FlexGrid for WinForms - ComponentOne Studio

FlexGrid for WinForms
2015.01.15 更新
グレープシティ株式会社
ComponentOne FlexGrid for WinForms
目次
はじめに
コンポーネントをプロジェクトに組み込む方法
コンポーネントのランタイムファイル
主な特長
12-13
13
14-15
製品の概要
16
製品構成
16
新機能と変更点
16
5.0Jで更新された内容
クラスメンバ
サンプル
4.0J で更新された内容
クラスメンバ
16-24
24-26
26
26-34
34-37
3.0Jで更新された内容
37-39
2.0Jで更新された内容
39-40
VS-FlexGrid ProからFlexGrid for WinForms へ
40-41
FlexGridの.NET 製品とActiveX製品の相違点
41
行と列のコレクション(Rows/Cols)
41-42
スタイル(Styles)
42-44
セル範囲(CellRange)
44-46
型付けした列
C1FlexGridとC1FlexGridClassic
47
47-48
プロパティ比較一覧
48-58
メソッド比較一覧
58-60
イベント比較一覧
60-62
クイックスタート
手順 1: C1FlexGrid を使用したアプリケーションを作成する
63
63
手順 2: C1FlexGrid をデータソースに連結する
63-69
手順 3: C1FlexGrid の設定をカスタマイズする
69-71
設計時のサポート
エディタ
列エディタ
1
12
72
72
72-73
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
スタイルエディタ
73-75
キャプションスタイルと列スタイル
75-79
スマートタグ
80-83
Column タスク
83-89
基本操作
90-92
行と列
92-93
93-94
セルの選択
94-96
セルの範囲
96
セルのイメージ
96
セルのフォーマット
96-97
セルの内容
97-99
セルの外観
99-101
条件付きの書式設定
101-102
オーナー描画セル
102-104
セルの編集
104
リストボックスとコンボボックス
104-106
チェックボックス
106-107
マップリスト
107-110
セルボタン
110-111
マスク
111-113
入力値の正当性検査
113-114
カスタムエディタ
114-116
カスタムエディタの作成
編集モードの制御
セルのマージ
116
116-117
117
テーブルヘッダのマージ
117-119
データビューのマージ
119-120
セルをはみだして表示
120-121
カスタムマージ
121-122
アウトラインとデータの集計
小計行の作成
2
79
C1FlexGrid タスク
列のサイズ変更
122
122-124
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
カスタムツリーの作成
124-128
コントロールによるアウトラインとツリーの作成
128-129
データのロード
129-133
アウトラインツリー
133-134
小計の追加
134-137
Subtotal メソッドの使用
137-139
アウトラインの保守
139
Node クラスの使用
139-140
保存とロード、および印刷
テキストファイルの保存とロード
140
Microsoft Excel ファイルの保存とロード
140-141
データベースからのグリッドのロード
141-142
グリッドの印刷
142-143
フィルタリング
143
AllowFilteringプロパティ
143-146
プログラムによるフィルタの管理
146-148
プログラムによるフィルタの適用
148-150
フィルタ動作のカスタマイズ
150-152
フィルタリングUIのカスタマイズ
152-154
プロパティグループ
データ連結
154-155
156
データソースへの連結
156-161
データの取得と設定
161-162
チュートリアル
Edit チュートリアル
163
163
手順1: コントロールの作成
163-166
手順2: 列タイプとデータの書式設定
166-169
手順3: ドロップダウンリスト
169-172
手順4: データの正当性検査
172-174
手順5: クリップボードへの対応
174-176
手順6: カスタムエディタの組み込み
176-179
Outline チュートリアル
手順1: コントロールの作成
3
140
179
179-185
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
手順2: データの読み込みとアウトラインの構築
185-188
手順3: マウスおよびキーボードのカスタム設定
188-190
手順4: 編集の許可と禁止
190-192
Data Analysis チュートリアル
192-193
手順1:コントロールの作成
193-194
手順2:グリッドの初期化とデータ表示
194-201
手順3:自動ソート
201-202
手順4:小計行とアウトラインツリー
202-204
グリッド
205
205
FlexGridの各部名称について
205
エディタにアクセスする
205
列エディタにアクセス
205-207
スタイルエディタにアクセス
207-209
VisualStyle を使用して外観を変更する
209-211
XP のテーマで表示する
211-212
グリッド領域の背景色をを変更する
212-213
最後の列を広げてグリッド領域を埋める
213-214
グリッドの背景画像を設定する
214-215
透明度を指定して背景画像を設定する
215-216
レイアウトを保存/ロードする
216-219
パフォーマンスを改善する
219-221
JIS2004 対応フォントを使用する
221-222
グループ化の機能を使用する
境界線
222
222
コントロールの境界線スタイルを変更する
222-226
グリッドの境界線スタイルを設定する
226-231
グリッドの境界線を変更する(非表示、色変更)
231-232
行/列の境界線を設定する
232-234
セルに線を描画する
234-235
スクロールバー
4
190
手順5: ツールチップの実装
タスク別ヘルプ
235
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
スクロールバーの表示/非表示を設定する
235-238
常にスクロールバーを表示する
238-239
スクロールバーの表示状態を取得する
スクロール動作を変更する
VS-FlexGrid と同様のスクロール動作にする
239-240
240
スクロールチップを表示する
240-241
スクロール位置を変更する
241-243
スタイル
243
組み込みスタイルの位置について
243-244
通常セルの外観を変更する
244-246
固定セルの外観を変更する
246-247
選択されているセルの外観を変更する
247
カレントセルの外観を変更する
247-248
カレントセルのフォーカス枠を変更する
248-251
カレントセルのフォーカス枠の色を変更する
251-252
1行おきのスタイルを設定する
252-253
固定セルや静止セルも1行おきに外観を変更する
253-257
Excel スタイルのヘッダを使用する
257
行/列の外観を変更する
257-259
カスタムスタイルを作成する
259-262
セル(範囲)の外観を変更する
262-263
適用したスタイルをクリアする
263-266
データの内容に応じてスタイルを適用する
266-269
設定したスタイルを優先させる
269-271
スタイルの要素
5
239
271
背景色/文字色を変更する
271-272
フォントを変更する
272-273
データの表示位置を変更する
273-274
画像の表示位置を変更する
274-275
3Dテキストを表示する
275-276
背景画像を設定する
276-278
折り返して表示する
278-279
トリミングして表示する
279-280
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
縦書きで表示する
280-281
データ型を設定する
281-283
書式を設定する
283-284
マージンを設定する
284-285
スタイル要素の設定をクリアする
285-287
287
行/列
287
デザイン
行列数を設定する
287-289
固定行または固定列を設定する
289-290
静止行または静止列を設定する
290-291
列ヘッダを設定する
291-293
行ヘッダを設定する
293-294
すべての行の高さ/列の幅を変更する
294-295
行の高さ/列の幅を変更する
295-296
デザイン時に設定した列幅が無効になってしまう場合の対処方法
296-297
列の順序を変更する
297-300
行列のデータ型を設定する
300-301
行列の書式を設定する
301-303
固定列に行番号を表示する
303-306
操作
6
306
行を追加する
306-308
列を追加する
308-310
行/列を削除する
310-312
行を挿入する
312-313
列を挿入する
313-315
ユーザーによる行の追加を許可する
315-316
ユーザーによる行の削除を許可する
316-318
ユーザーによる行/列の移動を許可する
318-320
ユーザーによる行の高さ/列幅の変更を許可する
320-321
データにあわせて行/列のサイズを調整する
321-322
行/列の最小、最大サイズを設定する
322-324
ユーザーによる行/列の静止を許可する
324-325
ユーザーによるデータ検索を有効にする
325-326
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セルの値
セルに値を設定する
セル範囲に値を設定する
326-328
328
セルの値を取得する
328-330
セル(範囲)の値をクリアする
330-333
画像/表示
333
オーナー描画を使用する
333-334
グラデーション背景を描画する
334-337
セルを塗りつぶす
337
セルラベルを表示する
337-338
セルに画像を設定する
338-342
新規追加行を示すアイコンを変更する
342-343
エラー情報を表示する
343-345
エラー情報のアイコンを変更する
345-346
カレント行を示すアイコンを表示する
346-347
イメージを拡大/縮小する
347
列単位でイメージを拡大/縮小
347-349
グリッド全体でイメージを拡大/縮小
349-351
描画方法を変更する
351-352
コンテキストメニューを表示する
353-355
ユーザーデータをツールチップに表示する
355-356
行のユーザーデータをツールチップに表示
356-357
列のユーザーデータをツールチップに表示する
357-359
セルのユーザーデータをツールチップに表示
359-361
セル範囲のユーザーデータをツールチップに表示
361-362
スタイルのユーザーデータをツールチップに表示
362-365
マウス下のセルをハイライト表示する
マージ
7
326
365-366
366
隣接する同一データを自動マージする
366-368
隣接する同一データを自動マージする(制限付き)
368-371
自動マージ処理をカスタマイズする
371-372
カスタムマージ(セル結合)を行う
372-373
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
オーバーフロー表示を行う
373-374
ノード行をマージする
374-376
固定セルと通常セルのマージモードを別々に設定する
376-378
マージセルかどうかを判別する
378-379
選択/移動
379-383
複数の選択モードを利用する
383-384
行全体をハイライト表示する
384-385
選択範囲を作成する
385-386
選択範囲を取得する
386-387
複数行を選択する(ListBox)
387-388
行の選択状態を取得する(ListBox)
388-389
カレントセルを移動/取得する
389-390
Enter/Tab キーによりカレントセルを移動する
390-393
右クリックでカレントセルを移動する
393-394
394
カレントセルのカーソルを非表示にする
394-396
クリックされたセルを取得する
396-397
クリックされたセルの種類を判別する
397-398
ダブルクリック時にテキストを選択状態にする
398-399
入力/編集
399
常時入力モードにする
399-400
編集中のセルの外観を変更する
400-401
グリッド全体の編集を禁止する
401-402
列単位で編集を禁止する
402-404
行単位で編集を禁止する
404-405
セル単位で編集を禁止する
8
379
選択モードを変更する
任意のセルを表示する
405
Enter キーを押した際、編集モードに移行しないようにする
405-406
IMEモードを切り替える
406-407
キー入力を検知する
407-408
セル単位で編集データをチェックする
408-410
行単位で編集データをチェックする
410-411
左右の矢印キーによる編集の終了を無効にする
411-412
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セル編集時の改行を禁止する
412-413
文字数単位で入力を制限する
413-416
バイト単位で入力を制限する
416-417
数値のみの入力を許可する
417-418
カスタムエディタを設定する
418-419
入力マスクを設定する
419-420
パスワード入力を行う
420-422
大文字に変換して入力する
422-423
セルボタン/コンボボックス
セルボタンを表示する
423-424
セルボタンの画像を変更する
424-425
コンボボックスを表示する
425-426
コンボボックスの背景色を変更する
426-428
リストにアイコンを表示させる
428-429
表示値/実値のように2種類のデータを持たせる
429-431
選択されたインデックスを取得する
431-432
マルチカラムコンボボックスを表示する
432-434
コンボボタン/セルボタンを表示するタイミングを変更する
434-435
コンボボックスの幅を設定する
435-437
表示するリストの数を変更する
437-438
表示するリストの順番を設定する
438-441
リストの内容を行ごとに変更する
441-442
データマップの内容を行ごとに変更する
442-444
セルごとにコンボボックスを設定する
444-446
チェックボックス
446
チェックボックスを表示する
446-448
チェックボックスを表示する(SetCellCheck)
448-449
チェックボックスのイメージを変更する
449-451
チェックボックスのセルにテキストを表示する
451-452
日付型セル
9
423
452
カレンダーコントロールを使用して日付の入力を行う
452-454
カレンダーコントロールを表示しない
454-455
スピンボタンを使用して日付の入力を行う
455-457
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
日付の書式を設定する
457-458
和暦で表示する
458-461
時刻のみを表示する
461-462
入力可能な日付を設定する
462-463
数値型セル
463-464
数値型セルの書式を設定する
464-465
ツリー表示/小計行
465
小計行を表示する
465-466
小計行をカスタマイズして表示する
466-468
小計行を使用してアウトラインツリーを表示する
468-470
ノード行を指定してアウトラインツリーを表示する
470-472
連結グリッドでアウトラインツリーを表示する
472-473
ノード行にチェックボックスを表示する
473-475
縮小・展開をコードで実行する
475-477
縮小・展開イメージを変更する
477-479
479
ユーザーによるフィルタリングを許可する
479-482
コードによりフィルタリングを適用する
482-484
フィルタアイコンに独自のアイコンを表示する
484-486
フィルタボタンに独自のアイコンを表示する
486-487
ソート
487
ユーザーによるソートを許可する
487-488
特定列でのソートを制限する
488-490
ソート順序について
490
ソート処理を無効にする
490-493
コードによりソートする
493-494
複数列のソートを実行する
494-495
インジケータを明示的に表示する
495-497
インジケータを非表示にする
497-498
インジケータに独自のアイコンを表示する
498-499
データ連結
10
463
数値エディタを使用する
フィルタリング
499
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
非連結列を追加する
499-501
非連結列の入力を許可する
501-503
固定列にデータを表示する
503-507
フィールドにビットマップイメージを表示する
507-510
自動で列幅を調整する
510-512
印刷
印刷(プレビュー)を実行する
ページ範囲を指定して印刷する
512-513
513
印刷ページの余白を設定する
513-515
印刷ヘッダ/フッタを設定する
515-516
印刷フッタにページ番号を出力する
516-517
ページごとに印刷ヘッダ(フッタ)を設定する
517-519
用紙サイズを指定する
519-521
コントロールの境界線を表示せずに印刷する
521-522
印刷プレビュー画面を最大化して表示する
522
印刷プレビュー画面をカスタマイズする
522-524
複数のグリッドを印刷する
524-527
ファイル入出力
527
Excel ファイルの保存とロード
527-530
XMLファイルの保存とロード
530-532
テキストファイルの保存とロード
532-534
ファイル入出力時に複数のオプションを設定する
グリッドを画像として出力する
クリップボード
11
512
534
534-536
536
自動クリップボードの機能を有効にする
536-537
行ヘッダや列ヘッダを含めてコピーする
537-538
コピー&ペースト処理をコードで実装する
538-539
非表示になっている行や列を除いてコピーする
539-542
データの実値をコピーする
542-545
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
はじめに
FlexGrid for WinForms は、データバインディングの最新技術を取り入れており、Microsoft.NET フレームワークとシームレ
スに統合します。そのため、表形式のデータの表示、編集、フォーマット、整理、要約、および印刷を行うユーザーフレンドリな
インターフェースを作成するための使いやすくて柔軟なグリッドコントロールが得られます。
FlexGrid for WinForms パッケージは、以下の2つのコントロールで構成されます。
C1FlexGrid コントロール
C1FlexGrid コントロールは強力でフル機能を備えたグリッドです。グリッドで圧縮バイナリまたはテキストファイル
(MicrosoftR Access? および ExcelR と互換性を持つ)の読み込み/書き込みを行います。C1FlexGrid は基本機能
や、アウトラインツリー、ソート、セル結合、マスク編集、変換コンボと画像リスト、および自動データ集計などの高度な
機能をすべて提供します。
C1FlexGrid は、ADO.NET と DataObjects for WinForms を含む任意の .NET データソースからデータを表示する
バインドモードか、グリッド自身でデータを管理する非バインドモードで使用できます。
C1FlexGridClassic コントロール
C1FlexGridClassic コントロールは、C1FlexGrid から派生するコントロールで、VSFlexGrid ActiveX コントロールにほ
ぼ 100% 同じオブジェクトモデルを提供します。C1FlexGridClassic は既存の VSFlexGrid プロジェクトの移行を簡素
化するために開発されました。
C1FlexGridClassic のソースコードがサンプルとして付属しています。このソースコードは、カスタムグリッドコントロー
ル開発の基本クラスとしての C1FlexGrid コントロールの使用方法を示す参考として使用できます。
コンポーネントをプロジェクトに組み込む方法
コンポーネントの組み込み
Visual Studio では、ツールボックスにコンポーネントを追加しただけでは、プロジェクトにコンポーネントを追加したことにはな
りません。プロジェクトの参照設定へ追加された時点でコンポーネントが組み込まれます。
以下のいずれかの操作を行うとプロジェクトへコンポーネントが組み込まれます。
フォームにコンポーネントを配置する
ソリューションエクスプローラ上で参照の追加を行う
プロジェクトに組み込まれているコンポーネントの一覧は、ソリューションエクスプローラで確認できます。また、各コンポーネン
トが使用している DLL もソリューションエクスプローラに登録される場合があります。詳細については、Visual Studio の製品ヘ
ルプを参照してください。
本製品で使用しているコンポーネントの一覧を以下に示します。
ファイル
内容
C1.Win.C1FlexGrid.2.dll
本体アセンブリ
C1.Win.C1FlexGrid.4.dll
本体アセンブリ(※)
C1.Win.C1FlexGrid.4.Design.dll
デザイナアセンブリ(※)
※ .NET Framework 4 以上でご利用いただけます。
フォームにコンポーネントを配置する方法
以下に、C1FlexGrid コントロールをツールボックスに追加し、フォームに配置する方法を示します。これにより、コンポーネント
12
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
がプロジェクトに組み込まれます。
配置手順
1. [ツール]メニューから[ツールボックス アイテムの選択]を選択します。
2. [ツールボックス アイテムの選択]ダイアログの「.NET Framework コンポーネント」タブを選択します。
3. 使用するコンポーネントのチェックボックスを ON にして〈OK〉ボタンをクリックしてください。ツールボックスに指定したコ
ントロールのアイコンが表示されます。
4. ツールボックスから指定したコントロールのアイコンを選択してフォームに配置します。ソリューションエクスプローラの
参照設定に指定したコントロールの名前空間が追加されます。
コンポーネントのランタイムファイル
FlexGrid for WinForms のランタイムファイルは、 C:\Program Files\ComponentOne\Studio for WinForms\bin\ フォルダに
インストールされる次のファイルです。
ファイル
内容
C1.Win.C1FlexGrid.2.dll
本体アセンブリ
C1.Win.C1FlexGrid.4.dll
本体アセンブリ(※)
※ .NET Framework 4 以上でご利用いただけます。
注意:
注意:本製品に含まれているファイルのうち、上記以外のファイルは配布できません。
13
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
主な特長
FlexGrid for WinForms の主な機能は以下のとおりです。
コードなしの開発
スマートタグでアクセスできる使い安いエディタを使用して、設計時に列、スタイルなどを指定できます。列エディタで列
の追加・削除、整列、幅調整などの設定を簡単に行うことが可能です。既存のスタイルを修正したり、カスタムスタイル
を作成するには、スタイルエディタを使用できます。従いまして、コードを書く必要はなく、グリッドを設計時に管理できま
す。
高度なセル編集
簡単なテキスト編集、ドロップダウンリスト、コンボリスト、セルボタン、マスク、入力検証で編集処理を制御できます。た
とえば、入力時に自動的にデータを検証するテンプレートを提供するには入力マスクを使用でき、特定の列を読み取り
専用にすることもできます。
統合した印刷
単一のコマンドでグリッドを印刷できます!用紙の方向、余白、フッタを制御することもでき、ユーザにダイアログを表示
して、プリンタを設定することも可能です。また、印刷イベントにて、ページ区切りの追加、ヘッダ行の繰り返し、各ペー
ジにカスタム要素の追加を行うことができます。
階層的なスタイル
強力なプロパティおよびメソッドを使用することで要件に応じるデータ表示を実現できます。たとえ
ば、C1FlexGrid.Subtotalメソッドを使用してデータを要約し、集計値を追加するまたは Tree プロパティでデータの階
層的な表示を実現できます。
柔軟なデータ連結
グリッドは、ADO.NET または ComponentOne DataObjects for .NET などのいずれかの.Net データソースに連結し
てバウンドモードでデータを表示できます。そして、グリッド自体がデータを管理できるアンバウンドモードも用意されて
います。
Office Microsoft2007・・2010のスタイルを使用して
のスタイルを使用して UI の強化
C1FlexGrid は、Office2007、2010のスタイルに似る視覚スタイルを対応しています。たとえば、Blue、Silver と Black。
階層的なデータを子テーブルで表示する
FlexGridは、階層データソースにバインドしている場合、各マスターレコードは展開/縮小でき子グリッドの詳細が表示/
非表示にできます。結果としては、階層データを表示する際のMicrosoft Accessによって提示されたグリッドの種類に
類似した"データ·ツリー"になります。これは、 C1FlexGridコントロールからコントロール(C1FlexDataTree)を継承する
ことにより達成できています。また、バインドされている場合はコントロールが下位のデータソースを検出して、子テーブ
ルを表示する場合それ自体の追加のインスタンスを作成します。
ツリーに変換する可能
特定の行の IsNode プロパティを設定して、FlexGrid を TreeView に変換することができます。高度な DataGrid のよ
うな機能を備える TreeView を使用できます。
セルにデータおよび画像を表示する
グリッドの各セルはデータを表示する他、画像も表示できます。データベースの情報を図で表示するため、簡単なおよ
び効率的な方法、イメージリストにグリッドの列をバインドすることも可能です。
描画する時の特殊な効果
14
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
グリッドのセルに、線、ビットマップ、アイコンなどの特殊な効果を実現することにより、グリッドの外観を独自に変更でき
ます。画像をスケールするまたは透明の効果を追加することもできます。
列にフィールド名を設定する
必要に応じて、列を位置よりその名前で参照することが可能です。データ連結を実現したグリッドの場合は、列キーは
自動的にフィールド名に割り当てられていますが、コードにて割り当てることも可能です。従いまして、ユーザがグリッド
上の異なる位置に移動した場合でも、列を取得するには列の ColIndex(ColKey) 構文を使用できます。
結合セル
近接する同値のセルを結合して、外観や明瞭を高めるために複数の行または列をスパンできます。
範囲の集計
ステートメントは1つのみを使用してセル範囲の集計、平均、または他の統計を計算できます。
複数のファイル形式を使用したデータの保存
複数のファイル形式を使用したデータの保存/ロード
ロード
text、.xls、.xlsx (OpenXml 形式)など、またはOpenXMLファイルの他の拡張子でグリッド内容をロード・保存することが
できます。そして、DataReaderオブジェクトを使用してデータベースからもグリッドデータをロードすることができます。
組み込みのフィルタリング機能
AllowFiltering プロパティを設定することにより、グリッドの各列にフィルタを設定できます。
15
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
製品の概要
製品構成
FlexGrid for WinForms は、次の2つのコンポーネント(コントロール)とヘルプ、サンプルなどから構成されています。
コントロール
C1FlexGrid コントロール
C1FlexGrid は、パワフルであらゆる機能を備えたグリッドです。データの表示、編集、書式設定、集計、および印刷
を、まったく新しい方法で実現します。また、任意の区切り文字によるテキストファイル、Excel ファイル、XML ファイルを
グリッドに読み書きできます。C1FlexGrid には、ひととおりの基本機能はもちろん、アウトラインツリー、ソート、セル
マージ、マスク編集、コンボボックスとイメージリストの変換、自動データ集計などの高度な機能が用意されています。
C1FlexGrid は、連結と非連結の両方のモードで使用できます。連結モード(バウンドモード)では、ADO.NET データ
ソースからのデータを表示します。非連結モード(アンバウンドモード)では、グリッド自身がデータを管理します。
C1FlexGridClassic コントロール
C1FlexGridClassic は、C1FlexGrid から派生したコントロールです。C1FlexGridClassic が提供するオブジェクトモデ
ルは、ActiveX 製品の VSFlexGrid コントロールと似ています。 このコントロールはサンプルとして提供されており、ソー
スコードも付属しています。このコードを参照することで、C1FlexGrid コントロールを基本クラスとして使用し、カスタム
グリッドコントロールを開発する方法が理解できます。詳しくは、製品付属の「FlexGridClassic サンプル」に含まれてい
るソースコード(FlexGridClassic.cs ファイル)、およびサンプルヘルプを参照してください。
注意
注意:C1FlexGridClassic はあくまでもサンプルとして作成されたDLLです。通常使用する際には、C1FlexGrid をご使用
ください。C1FlexGridClassic は、ユーザーサポートの対象外です。
製品ヘルプ
今、ご覧いただいているものです。FlexGrid for WinForms をご利用いただくために必要なあらゆる情報が記載されていま
す。
サンプル
FlexGrid for WinForms の使用例、応用例をまとめたサンプルプログラム集です。これらのサンプルは、VB と C# の違いを
比較しながら学習できるように、まったく同じプロジェクトが両方の言語で作成、収録されています。また、サンプルの目的や使
用方法を説明したサンプルヘルプも付属しています。
新機能と変更点
各バージョンで追加された機能や変更点について紹介します。
5.0Jで更新された内容
で更新された内容
以下は、FlexGrid for Windows Forms 5.0J で追加された主な機能です。
組み込みのデータフィルタリング
描画の改良
オブジェクトモデルの改良-Tree オブジェクト、Node オブジェクト
CheckBoxサポートの改良
16
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コントロール更新の改良
列設定の手間を軽減
起動時のパフォーマンスの向上
新規行テンプレートへの表示テキストの指定
クリップボード処理でのコピー内容指定
行レベルでの検証
集計行のカスタマイズ
異なるマージモードの併用
常時入力モードを簡単に実現
CellStyle クラスへの機能追加
印刷機能の強化
新しい外観描画の仕組み
廃止された機能-Redraw プロパティ
新機能概要
【組み込みのデータフィルタリング】
AllowFiltering プロパティを True に設定すると、C1FlexGrid コントロールはグリッドの各列に対して、ユーザーがフィルタを
適用できるようにします。
データフィルタリング機能は、Windows7やVistaにおいてMicrosoftが使用しているスタイルに従っています。ユーザーが列
ヘッダ上にマウスポインタを動かしたときに、グリッドはヘッダ上にフィルタボタンを表示します。フィルタボタンのクリックによ
り、表示するデータを選択するフィルタエディタが起動します。すべての列がフィルタを持っており、行が表示されるためには、
すべてのフィルタを通過しなくてはなりません。
組み込みのフィルタには、ユーザーが表示する特定の値を選択できる値フィルタ
フィルタ(ValueFilter)のほか、 ユーザーが“指定の
値より大きい”、”指定の値を含む” といった条件を指定できる条件フィルタ(
条件フィルタ(ConditionFilter))もあります。開発者が特定のカ
スタムフィルタを作成し、列に適用することもできます。
以下の画像は、フィルタ機能が実行されているところを表しています。この画像では、表示する商品を選択できる値フィルタエ
値フィルタエ
ディタ
ディタが表示されています。
17
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
次の画像では、発注量の範囲を選択する条件フィルタ
条件フィルタエディタが表示されています。
フィルタが適用されている列には、マウスが列ヘッダ上に置かれていないときでも、ヘッダにフィルタアイコンが表示されます。
このことは、上記画像において ProductID 列および Quantity 列のヘッダにフィルタアイコンが表示されていることで、おわ
かりいただけると思います。
18
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
組み込みのフィルタは、次の言語における自動ローカライズをサポートしています:
英語、スペイン語、フランス語、イタリア語、ポルトガル語、ドイツ語、オランダ語、ロシア語、日本語。
これらのローカライゼーションは製品に組み込まれており、サテライトDLLを必要としません。
新しいフィルタリング機能は極めて強力かつフレキシブルで、視覚的にも目立ちすぎることがありません。詳細は「フィルタリン
グ」を参照してください。
【描画の改良】
Windows XP/Vista/7で機能するテーマサポートを強化しました。以下の画像は、Windows 7における C1FlexGrid コントロー
ルの外観を表しています。VisualStyle プロパティは System に設定されています。
グリッドが、列と行のヘッダに対して、完全にシステムのテーマを利用している点に加え、ソートインジケータが現在は列ヘッダ
の右側でなく上部に表示されている点にご注目ください。これらの新しい特性は、Windows 7/Vista のリストに見られる同機能
に倣っています。
【オブジェクトモデルの改良-
【オブジェクトモデルの改良-Tree オブジェクト、
オブジェクト、Node オブジェクト】
Node オブジェクトには、ツリーの作成および操作をより簡単に行えるようにするプロパティが追加されました。新しいプロパ
ティは、標準のTreeViewコントロールとの互換性のために設計されています。そのため、コードの移行が簡単で、学習の必要
がありません。
Node オブジェクトの新しいプロパティには、Parent、Nodes、Checked、PrevNode,、および NextNodeがあります。
Node オブジェクトのCheckedプロパティは、3つのチェック状態(チェック、未チェック、未定義)をサポートします。これにより、
親ノードに子ノードのチェック状態を反映させるツリーを作成することが容易になります。これに対して、標準のTreeViewコント
ロールがサポートするのは、チェックと未チェックのみです。
Nodeオブジェクトモデルの改良により、標準のTreeViewコントロールのツリーと同様に、C1FlexGridベースのツリーをプログラ
ミングできるようになりました。
【CheckBoxサポートの改良】
サポートの改良】
19
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
前バージョンでは、一般的なAfterEdit イベントを使う必要がありましたが、5.0Jでは新たにCellChecked イベントが追加さ
れ、セルおよびツリーノードのチェックボックスが扱いやすくなりました。
【コントロール更新の改良】
再描画の一時停止や再開に使用する、新しいBeginUpdate メソッドとEndUpdate メソッドが追加されました。これらのメソッ
ドは、標準の.NETコントロールと互換性を持つ改良型オブジェクトモデルのために、Redraw プロパティ(廃止されます)と置き
換わるものです。
【列設定の手間を軽減】
C1FlexGrid をフォームに配置したときの、デフォルトの固定列の列幅を、他の列よりも狭くしました。列幅を調整するのは簡単
ではありますが、今回の変更により、C1FlexGridを使用する開発者はグリッドをフォームに配置するたびにマウスで固定列の
幅を調整せずに済むようになりました。
【起動時のパフォーマンスの向上】
C1FlexGrid には、データソースに連結している場合、グリッドに列サイズを自動変更させる AutoResize プロパティがありま
す。グリッドが大規模なデータソース(要素が10,000程度)に連結されている場合、この自動サイズ変更処理にはかなりの時
間がかかります。
AutoResize プロパティのデフォルト値に True が使用されていたことで、多くのユーザーは気付かないパフォーマンス上の不
利益が生じていました。これを改善するため、本バージョンではAutoResize プロパティのデフォルト値が False に変更されまし
た。これに伴い、自動サイズ調整が必要なアプリケーションではAutoResize プロパティを明示的に True に設定する必要が
あります。
注意
注意:これは、既存のアプリケーションに影響を及ぼす変更です。列の自動サイズ変更が必要なアプリケーションで
は、AutoResize プロパティをTrue に設定する必要があります(設計時には Visual Studio のデザイナを使用して、実
行時にはコードから設定できます)。
【新規行テンプレートへの表示テキストの指定】
新たに追加されたNewRowWatermark プロパティにより、AllowAddNewプロパティがTrueに設定されているときに表示さ
れる新規行のテンプレートに、任意のテキストを指定できるようになりました。
【クリップボード処理でのコピー内容指定
クリップボード処理でのコピー内容指定】
ClipboardCopyModeプロパティが追加され、AutoClipboardプロパティがTrueに設定されている場合に、列ヘッダや行ヘッ
ダを、クリップボードへのコピー内容に含めるかどうか、また Clip プロパティからコピーされるデータに含めるかどうかを指定で
きるようになりました。
【行レベルの検証】
新たに追加されたRowValidating イベントとRowValidated イベントは、グリッドがフォーカスを失ったとき、または別の行が
選択されたときに発生します。
これらのイベントにより、行レベルの検証を行い、結果不正だった場合、ユーザーが他の行へ移動できないようにすることなど
も可能になりました。
【集計行のカスタマイズ】
Subtotal メソッドの呼び出し後、集計行が作成される前に発生するBeforeSubtotal イベントと集計行が作成された後に発生
するAfterSubtotalイベントが追加されました。
これらのイベントを使用することで、集計行をカスタマイズしたり、スタイルや内容を変更したり、いくつかの集計行の作成をま
とめて保留したりすることができます。
20
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【異なるマージモードの併用】
AfterMergingFixedプロパティにより、固定セルとスクロール可能なセルに対して、異なるマージモードを指定することが可能
になりました。たとえば、列ヘッダではカスタムマージを行い、データセルでは自動マージを使用したい、といった場合などには
特に便利です。
【常時入力モード】
EditOptionsプロパティに設定するEditFlags列挙体に以下の2つのメンバが追加され、常時入力モードのグリッドを、コーディ
ングを伴わず、オプション設定のみで簡単に実現できるようになりました。
EditFlags.ExitOnLeftRightKeys:
このフラグが True に設定されている場合(デフォルトの設定)、組み込みのテキストエディタおよび数値エディタは、キャレット
が先頭位置にある状態でユーザーが左矢印キーを押したとき、またはキャレットが末尾位置(TextLengthの位置)にある状態
でユーザーが右矢印キーを押したとき、編集モードを抜けます。
このフラグが False に設定されている場合、組み込みのテキストエディタおよび数値エディタは、ユーザーが[Enter]キーを押
すか、または別なセルをクリックするまで、編集モードを抜けません。
EditFlags.EditOnRequest:
このフラグが True に設定されている場合(デフォルトの設定)、ユーザーが入力を開始するかまたはセルをダブルクリックする
まで、グリッドは編集モードに入りません(MS Excel と同じ動作)。
このフラグが False に設定されている場合、グリッドがフォーカスを得たとき、また選択セルが変更されたときには、グリッドは
自動的に編集モードに入ります(MS Access と同じ動作)。
【CellStyleクラスへの機能追加】
クラスへの機能追加】
CellStyleクラスへの機能追加(StringFormatプロパティ、およびGetTextRectangleメソッド、GetImageRectangleメソッド)
により、セル内のテキストやイメージといったコンテンツ自体の表示領域を計測可能になったため、コンテンツの周囲に線を描
画するなど、装飾を施すことも可能になりました。
【PrintDocumentGridRendererクラスの追加】
クラスの追加】
このクラスはグリッドをPrintDocument オブジェクトにレンダリングするときに使用されます。FlexGridはPrintGridメソッドを提
供しており、これはグリッドを印刷/プレビューする最も簡単な方法です。
PrintGridメソッドは単一のFlexGridを含むPrintDocumentオブジェクトを自動的に作成します。しかし、そのドキュメント上で、
別のグリッドを含め、他のコンテンツ要素を現在のグリッドを組み合わせることはできません。
このような用途に使用するのが、PrintDocumentGridRendererクラスです。
たとえば以下は、フォームに配置されている2つのグリッドを単一のPrintDocumentにレンダリングする例です。
21
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private _g1, _g2 As PrintDocumentGridRenderer
Private printDocument1 As Printing.PrintDocument
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles Button1.Click
22
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' ボタンのクリック時、印刷プレビューダイアログを表示します。
Using dlg As New PrintPreviewDialog()
dlg.Document = Me.printDocument1
dlg.ShowDialog(Me)
End Using
End Sub
Private Sub printDocument1_BeginPrint(ByVal sender As System.Object, ByVal e As
System.Drawing.Printing.PrintEventArgs)
' グリッドのレンダラを作成し、印刷オプションを設定します。
_g1 = New PrintDocumentGridRenderer(flex1)
_g1.Options = PrintGridFlags.ActualSize
' グリッドのレンダラを作成し、印刷オプションを設定します。
_g2 = New PrintDocumentGridRenderer(flex2)
_g2.Options = PrintGridFlags.FitToPageWidth Or PrintGridFlags.ExtendLastCol
End Sub
Private Sub printDocument1_PrintPage(ByVal sender As System.Object, ByVal e As
System.Drawing.Printing.PrintPageEventArgs)
' グリッドをレンダリングします。
If (_g1.CurrentPage < _g1.PageCount) Then
_g1.PrintPage(e)
e.HasMorePages = True
Next
' グリッドをレンダリングします。
ElseIf (_g2.CurrentPage < _g2.PageCount) Then
_g2.PrintPage(e)
e.HasMorePages = _g2.CurrentPage < _g2.PageCount
End If
End Sub
C# コードの書き方
C#
PrintDocumentGridRenderer _g1, _g2;
PrintDocument printDocument1;
private void button1_Click(object sender, EventArgs e)
{
// ボタンのクリック時、印刷プレビューダイアログを表示します。
using (PrintPreviewDialog dlg = new PrintPreviewDialog())
{
dlg.Document = this.printDocument1;
dlg.ShowDialog(this);
}
}
void printDocument1_BeginPrint(object sender, System.Drawing.Printing.PrintEventArgs
e)
{
// グリッドのレンダラを作成し、印刷オプションを設定します。
_g1 = New PrintDocumentGridRenderer(flex1);
_g1.Options = PrintGridFlags.ActualSize ;
// グリッドのレンダラを作成し、印刷オプションを設定します。
_g2 = New PrintDocumentGridRenderer(flex2);
_g2.Options = PrintGridFlags.FitToPageWidth Or PrintGridFlags.ExtendLastCol;
23
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
void printDocument1_PrintPage(object sender,
System.Drawing.Printing.PrintPageEventArgs e)
{
// グリッドをレンダリングします。
_g2 = new PrintDocumentGridRenderer(flex2);
_g2.Options = PrintGridFlags.FitToPageWidth |
PrintGridFlags.ExtendLastCol;
if (_g1.CurrentPage < _g1.PageCount)
{
_g1.PrintPage(e);
e.HasMorePages = true;
}
// グリッドをレンダリングします。
else if (_g2.CurrentPage < _g2.PageCount)
{
_g2.PrintPage(e);
e.HasMorePages = _g2.CurrentPage < _g2.PageCount;
}
}
【新しい外観描画の仕組み
新しい外観描画の仕組み】
個々のセルスタイルを設定する代わりに、グリッドの外観描画を定義したC1FlexGridRenderer クラスを使用して外観を描画す
る方法です。定義した Renderer をプロパティに指定するだけで、複数のグリッド間で統一感のあるプロフェッショナルな外観
設定を簡単に共有できます。
Renderer プロパティは、VisualStyleプロパティの実装に使用されているレンダリングエンジンを利用したものです。Renderer
プロパティはC1FlexGridRendererオブジェクトで、すべてのグリッドのレンダラの継承元となる抽象ベースクラスです。
さらに、C1FlexGridRenderer クラスから継承し、MS Office 2007のVisual Style(blue, silver, black)で使用されているすべて
のグラデーションやイメージを作成可能な25色を使用するGridRendererOffice2007クラスも提供しています。
レンダラをによる描画に関する詳細は、リファレンスページおよび製品付属サンプルプロジェクト「GridRenderer」の
Documentation フォルダにある、GridRenderer.htmを参照してください。
【廃止された機能-
【廃止された機能-Redraw プロパティ】
以下のプロパティが廃止されました。
廃止されたプロパティ
代わりに使用
Redraw
BeginUpdateメソッド、EndUpdate メソッド
クラスメンバ
C1FlexGrid コンポーネントに追加された最新のメンバは以下のとおりです。
メンバ
説明
AllowFiltering プロパティ
ユーザーがデータをフィルタできるかどうかを取得または設定します。
AllowFiltering プロパティ
その列で使用するフィルタのタイプを取得または設定します。
Filter プロパティ
その列のフィルタリングに関与するIC1ColumnFilter を取得または設定します。
ApplyFilters メソッド
すべての列フィルタをグリッド上のデータに適用します。
24
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
BeforeFilter イベント
列フィルタがグリッドに適用される前に発生します。
AfterFilter イベント
列フィルタがグリッドに適用された後に発生します。
IC1ColumnFilter インタフェース
列のフィルタオブジェクトにより実装されるインタフェース。
IC1ColumnFilterEditor インタ
フェース
列のフィルタエディタコントロールにより実装されるインタフェース。
ValueFilter クラス
一連の値に基づくフィルタを表します。
ConditionFilter クラス
1つまたは2つの論理条件に基づくフィルタを表します。
ColumnFilter クラス
ValueFilter とConditionFilter を含むフィルタを表します。
Parent プロパティ
そのノードの親ノードを取得します。
PrevNode プロパティ
前の兄弟ノードを取得します。
NextNode プロパティ
次の兄弟ノードを取得します。
Nodes プロパティ
そのノードの子を含む配列を取得します。
Checked プロパティ
そのノードに関連したチェックボックスの値を取得または設定します。
BeginUpdate メソッド
BeginUpdateメソッドに対する呼び出し後、コントロールの更新を再開します。
EndUpdate メソッド
EndUpdate メソッドが呼び出されるまでコントロールの更新を抑制することで、パフォー
マンスを維持します。
DataMemberChanged イベント
DataMember プロパティの値が変更されたときに発生します。
DataSourceChanged イベント
DataSource プロパティの値が変更されたときに発生します。
DataBindingComplete イベント
データ連結操作が完了したときに発生します。
CellChecked イベント
ユーザーにより、セルのチェックボックスがチェックされた後、またはチェックがはずされ
た後に発生します。
StringFormat プロパティ
セルのテキスト内容の書式設定に使用するStringFormat オブジェクトを取得します。
GetTextRectangle メソッド
テキストが表示されているセルの部分(マージンとボーダーを差し引いた領域)を取得
します。
GetImageRectangle メソッド
イメージが表示されているセルの部分(マージン、ボーダーおよびテキストを差し引いた
領域)を取得します。
PrintDocumentGridRenderer ク PrintDocument オブジェクトへのグリッドのレンダリングに使用されるクラス。
ラス
C1FlexGridRenderer クラス
カスタムグリッドレンダラの抽象ベースクラス。
Renderer プロパティ
コントロールのルック&フィールのカスタマイズに使用されるC1FlexGridRenderer を
取得または設定します。
AfterMergingFixed プロパティ
スクロール不可のセルをマージする方法を取得または設定します。
AfterSubtotal イベント
各行がグリッドに追加された後に発生します。
BeforeSubtotal イベント
各行がグリッドに追加される前に発生します。
ClipboardCopyMode プロパティ
AutoClipboard プロパティが True に設定されている場合、クリップボードにコピーさ
れるグリッドの部品を取得または設定します。
NewRowWatermark プロパティ
AllowAddNew プロパティが True に設定されている場合、新しい行テンプレート上に
表示される文字列を取得または設定します。
25
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
RowValidated イベント
行がフォーカスを失って、検証が行われた後に発生します。
RowValidating イベント
行がフォーカスを失い、検証が必要になる場合に発生します。
ExitOnLeftRightKeys
(EditFlags 列挙体のメンバ)
ユーザーがコンテンツの末尾で右矢印キーを押すか、コンテンツの冒頭で左矢印キー
を押した場合、エディタを終了します。
EditOnRequest(EditFlags 列挙体 マウスまたはキーボードのイベントに応答する場合にのみ編集モードに入ります。この
のメンバ)
フラグを False に設定すると、コントロールがフォーカスを取得するか、ユーザーがカー
ソルを移動したときにグリッド
FilteredColumn(GlyphEnum 列
挙体のメンバ)
列が現在有効なフィルタを保持することを示します。
FilterEditor(GlyphEnum 列挙体
のメンバ)
列がドロップダウンフィルタエディタを保持することを示します。
サンプル
C1FlexGrid の製品付属のサンプルに以下が新しく追加されました。
サンプル
説明
ColumnFilters
新しいフィルタリング機能の使用方法に関するサンプルです。
このサンプルでは、AllowFiltering プロパティとAfterFilterイベントを使って、グリッドの組み込みフィル
タの制御や、カスタマイズを行う方法を紹介します。
CustomFilters
カスタムフィルタを実装する方法を紹介するサンプルです。
ExcelStyleFilter データのソートやフィルタリングをコンテキストメニューから行います。
FilterRow
フィルタ行を実装する方法を紹介します。
GridRenderer
Renderer プロパティを使用したカスタムレンダラの実装方法を紹介します。
NewFeatures
5.0Jで追加された機能をピックアップして紹介します。
4.0J で更新された内容
以下は、FlexGrid for .NET 4.0Jで追加された主な機能です。
スマートデザイナ
カスタムマージオプション
Excel ファイルの保存とロード
エディタの強化
スクロール関連
行/列ヘッダ関連
スタイル関連
ソート
データ連結関連
セルの編集関連
データマップ関連
SaveGrid/Excel 形式に対する最適化の追加
グリッドデザイナでのフォントサイズコントロールの動作の改善
NoFreezing フラグの外観と動作の設定を可能にする SaveExcel の動作の改善
GridTree.Sort メソッドへのオーバーロードの追加
26
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
印刷コードへの付加チェックの追加
VisualStyle プロパティの追加
Addメソッド (Int32) およびAdd メソッド (Int32) メソッドの追加
MouseEnterCell イベントおよび MouseLeaveCell イベントの追加
Grid プロパティの追加
SaveExcelメソッドのオーバーロード追加
追加機能概要
【スマートデザイナ
スマートデザイナ】
スマートデザイナの機能を実装しました。スマートデザイナの詳細や設計時の操作方法については、「設計時のサポート」を参照
してください。
【カスタムマージオプション
カスタムマージオプション】
新たにカスタムマージオプションを実装しました。以前のバージョンでは、カスタムマージを実現するためにグリッドをサブクラス
化して GetMergedRange メソッドをオーバーライドする必要がありました。カスタムマージオプションを使用すると、簡単にマー
ジ範囲のリストを提供できます。
AllowMergingEnum.Custom設定
設定
AllowMergingEnum.Custom設定は、C1FlexGrid.AllowMerging プロパティの新しい設定で、カスタムのマージセル範囲を指
定できます。これまでは、コントロールをサブクラス化して C1FlexGrid.GetMergedRange メソッドをオーバーライドする必要があ
りました。カスタム範囲は、C1FlexGrid.MergedRanges プロパティで指定します。
MergedRangesプロパティ
C1FlexGrid.MergedRanges プロパティは、サブクラス化せずにカスタムマージを可能にします。以前のバージョンでは、カスタム
マージにはグリッドをサブクラス化して C1FlexGrid.GetMergedRange メソッドをオーバーライドする必要がありました。このプロ
パティを使用すると、簡単にマージ範囲のリストを提供できます。
カスタムマージ範囲は、グリッドを Excel ファイル(C1FlexGridBase.SaveExcel/C1FlexGridBase.LoadExcel)、および XML ファイ
ル(C1FlexGridBase.WriteXml/C1FlexGridBase.ReadXml)の保存とロード時にサポートされます。
注意:
注意:新しいカスタムマージの機能については、製品付属の「CustomCellMergeNew サンプル」、
「CustomCellMergeNew2 サンプル」を参照してください。以前のカスタムマージの機能については、製品付属の
「CustomCellMerge サンプル」、「CustomCellMerge2 サンプル」を参照してください。
【Excel ファイルの保存とロード
ファイルの保存とロード】
Excel ファイルの保存とロード時に固定行(列)と静止行(列)をフリーズできるようになりました。この動作は、
FileFlags.NoFreezing プロパティを使用して変更できます。
ま
た、FileFlags.SaveMergedRanges、FileFlags.LoadMergedRanges、FileFlags.IncludeMergedRanges、FileFlags.NoFreezing
の各設定を新たに追加し、セルをマージした状態で Excel ファイルの保存とロードを行えるようになりました。
CellStyle.WordWrap プロパティが True に設定されているとき、埋め込みの改行を含む文字列を Excel ファイルに確実に保存
する(行の高さを適切に設定する)ように改善しました。WordWrap プロパティが False に設定されているときでも、常にハード
改行を使用可能にします。この変更により、Excel 出力がグリッドの内容により近いものになります。
FileFlags.SaveMergedRanges
新しい FileFlags.SaveMergedRanges フラグを使用し、マージ範囲を Excel ファイルに保存できます。たとえば、以下のようにな
ります。
Visual Basic コードの書き方
Visual Basic
27
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.SaveExcel(fileName, FileFlags.IncludeFixedCells Or
FileFlags.SaveMergedRanges)
C# コードの書き方
C#
flex.SaveExcel(fileName, FileFlags.IncludeFixedCells |
FileFlags.SaveMergedRanges);
FileFlags.LoadMergedRanges
FileFlags.LoadMergedRanges 設定は、C1FlexGridBase.LoadExcel フラグパラメータの新しい設定で、Excel シートからマージ
セルをロードできます。ロードする Excel シートにマージセルが含まれる場合、このフラグが C1FlexGrid.AllowMerging プロパ
ティを AllowMergingEnum.Custom に設定してマージセルを C1FlexGrid.MergedRanges コレクションにロードします。
FileFlags.IncludeMergedRanges
FileFlags.IncludeMergedRanges 設定は、FileFlags.SaveMergedRanges と FileFlags.LoadMergedRanges を組み合わせた
もので、マージ範囲を含む Excel ファイルを保存およびロードする場合に使用できます。
FileFlags.NoFreezing
FileFlags.NoFreezing 設定は、Excel ファイルの保存およびロード時にグリッドの行と列がフリーズされないようにする新しい設
定です。デフォルトでは、固定行(列)と静止行(列)は、Excel ファイルへのインポート時にフリーズされ、Excel ファイル内の静止
行と列はグリッドへのインポート時にフリーズされます。
【エディタの強化】
組み込み数値エディタを追加しました。また、ComboBoxEditor プロパティを新たに追加しました。
数値エディタ
数値の編集時、グリッドはデフォルトで組み込み数値エディタを使用します。数値エディタは、セルスタイル(列)に割り当てられた
Format プロパティを使用可能にし、(セル型に基づいて)キーチェック、入力時の書式、範囲チェックを提供します。
EditFlags.UseNumericEditor フラグを含めないことで、組み込み数値エディタを無効にできます。
ComboBoxEditor プロパティ
ComboBoxEditor プロパティは、アクティブな ComboBox エディタコントロールの主要なプロパティへの簡単アクセスを提供し
ます。以下のサブプロパティが含まれます。
プロパティ
説明
Items
現在アクティブな ComboBox エディタ内の項目のコレクションを取得します。
SelectedIndex
現在アクティブな ComboBox エディタ内で選択されたインデックスを取得または設定します。
SelectedItem
現在アクティブな ComboBox エディタ内で選択された項目を取得または設定します。
SelectedKey
現在アクティブな ComboBox エディタ内で選択された項目に対応するキーを取得します。
これらのプロパティは、現在アクティブな ComboBox エディタ上でプロパティを取得または設定します。これらはすべて現在のエ
ディタを ComboBox オブジェクトにキャストして、ComboBox オブジェクト上で適切なプロパティを取得または設定します。アク
ティブなエディタがない場合やエディタが ComboBox でない場合、 これらのプロパティは null または -1 を返し、設定できませ
ん。たとえば、以下のようになります。
Visual Basic コードの書き方
28
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
' ComboBoxEditorプロパティを使用:
Console.WriteLine("ComboBoxのインデックス:{0}",
flex.ComboBoxEditor.SelectedIndex)
' ComboBoxEditorプロパティを使用しない:
If Not flex.Editor Is Nothing Then
Dim cb As ComboBox
cb = CType(flex.Editor, ComboBox)
Console.WriteLine("ComboBoxのインデックス:{0}", cb.SelectedIndex)
End If
C# コードの書き方
C#
// ComboBoxEditorプロパティを使用:
Console.WriteLine("ComboBoxのインデックス:{0}",
flex.ComboBoxEditor.SelectedIndex);
<// ComboBoxEditorプロパティを使用しない:
if (flex.Editor != null)
{
ComboBox cb;
cb = flex.Editor as ComboBox;
Console.WriteLine("ComboBoxのインデックス:{0}", cb.SelectedIndex);
}
注意 :このプロパティは、C# の 'as' のような条件分岐のキャスト演算子を現在持っていない Visual Basic で特に便利で
す。
【スクロール関連】
スクロールバーの常時表示、セル単位のスクロールが可能になりました。また、これまでの BeforeScrollTip イベント
を ShowScrollTip イベントに置き換えました。
ScrollOptions プロパティ
C1FlexGridBase.ScrollOptions は、ScrollFlags 列挙体フラグを使用してグリッドのスクロール動作をカスタマイズします。
ScrollFlags 列挙体には、次のフラグが含まれます。
フラグ
説明
AlwaysVisible
必要のない場合でも、スクロールバーを常に表示します。
ScrollByRowColumn
ピクセル単位ではなく、行または列単位でスクロールします。
DelayedScroll
スクロールバーがドラッグされている間スクロールしません。
ShowScrollTips
垂直スクロールバーの横にツールチップを表示します。
このプロパティは、以前のバージョンでは使用できなかったオプションを提供します。また、独自のプロパティを持ったオプションも
指定します。
ActiveX 製品 VS-FlexGrid Pro と同様のスクロール動作を実装するには、DelayedScroll と ScrollByRowColumn を実装装しま
す。
Visual Basic コードの書き方
29
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
flex.ScrollOptions = ScrollFlags.DelayedScroll Or _
ScrollFlags.ScrollByRowColumn
C# コードの書き方
Visual Basic
flex.ScrollOptions = ScrollFlags.DelayedScroll |
ScrollFlags.ScrollByRowColumn;
以下のプロパティが廃止されました。
廃止されたプロパティ
代わりに使用
ScrollTrack
ScrollFlags.DelayedScroll フラグ
ScrollTips
ScrollFlags.ShowScrollTips フラグ
ScrollTipText
ShowScrollTipイベント
ScrollBarsVisible プロパティ
以前のバージョンでは、コントロールのサイズとそのクライアント領域を比較してスクロールバーの表示状態を検出する必要があ
りました。ScrollableControl.ScrollBarsVisible プロパティにより、それが不要となりました。
これまでの BeforeScrollTip イベントに代わって ShowScrollTip イベントを使用
BeforeScrollTip イベントの代わりに ShowScrollTip イベントが使用されるようになりました。古いイベントには次の2つの問題
点がありました。
外部プロパティ(ToolTipText)を使用してイベント引数を提供。
対応する After イベントを持たない Before イベント。
新しい ShowScrollTip イベントを使用すると、イベントパラメータを使用してツールチップテキストを提供できるようになり、ずっと
わかりやすくて使いやすいものになりました。たとえば、以下のようになります。
Visual Basic コードの書き方
Visual Basic
' 古いコード(旧式)
Private Sub _flex_BeforeScrollTip(ByVal sender As Object, ByVal e As
RowColEventArgs) Handles _flex.BeforeScrollTip
_flex.ToolTipText = String.Format("row {0}", e.Row)
End Sub
' 新しいコード
Private Sub _flex_ShowScrollTip(ByVal sender As Object, ByVal e As
ToolTipEventArgs) Handles _flex.ShowScrollTip
e.ToolTipText = String.Format("row {0}", e.Row)
End Sub
C# コードの書き方
C#
<// 古いコード(旧式)
private void _flex_BeforeScrollTip(object sender, RowColEventArgs e)
{
_flex.ToolTipText = string.Format("row {0}", e.Row);
30
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
<// 新しいコード
private void _flex_ShowScrollTip(object sender, ToolTipEventArgs e)
{
e.ToolTipText = string.Format("row {0}", e.Row);
}
【行/列ヘッダ】
ShowThemedHeaders プロパティ
ShowThemedHeaders プロパティは、行と列のヘッダを XP のテーマで表示するかどうかを個別に、また、
ScrollableControl.BorderStyle プロパティとも別個に制御します。
【スタイル関連】
スタイルの背景画像、配置方法を指定できるようになりました。また、選択したセルに対応する行ヘッダと列ヘッダの描画に使用
するスタイルを追加しました。
CellStyle.BackgroundImage/
/CellStyle.BackgroundImageLayout プロパティ
CellStyle.BackgroundImage/CellStyle.BackgroundImageLayout プロパティは、スタイルの背景画像、配置方法を指定しま
す。これを使用し、カスタムの境界線、グラデーション、透過度などの高度なテーマを提供できます。また、特にセルの背景をサ
ポートするために追加された新しい ImageAlignEnum.TileStretch 設定もあります。この設定は、画像の端部分の元のサイズ
を維持したまま中央部分を伸縮します。
SelectedColumnHeader/
/SelectedRowHeader プロパティ
選択したセルに対応する行ヘッダと列ヘッダの描画に使用するスタイルです。CellStyleCollection.SelectedColumnHeader プロ
パティとCellStyleCollection.SelectedRowHeader プロパティを使用して Excel ファイルのようなスタイルでカレントセルの位置を
わかりやすくすることができます。このプロパティは、ScrollableControl.BorderStyle/ShowThemedHeaders プロパティに影
響します。行または列のヘッダが XP のテーマで描画されていない場合のみ有効になります。
【ソート】
現在のソートを定義する列への参照を取得できるようになりました。
SortColumn プロパティ
SortColumn プロパティはグリッドに適用された現在のソートを定義する列への参照を取得します。これは、グリッドの
ソートに使用するメソッド(Sort メソッド、ヘッダ列のクリック、データソースオブジェクトのソート)に関係なく機能します。
ユーザーは、Column.Sort プロパティの値を確認してソート順を決定できます。
【データ連結関連】
CellChanged イベントを改良し、グリッドと DataTable オブジェクトの連結時に e.Col パラメータに変更された実際の列を
渡すようにした。
データ連結時に Column.Caption プロパティが使用可能になりました。
【セルの編集関連】
31
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
StartEdit と AfterEdit イベント動作の機能を強化ユーザーがセルボタンをクリックした場合、StartEdit イベント
とAfterEdit イベントが発生しないよう改善しました。この場合、CellButtonClick イベントのみが発生します。
C1FlexGridBase.AutoClipboard で切り取り/貼り付けするか、ドラッグ&ドロップした際に、StartEdit イベント
とAfterEdit イベントが発生するように改善しました。
EditFlags.DelayedCommit の設定を新たに追加しました。
EditFlags.DelayedCommit 設定は、EditOptions プロパティと共に使用し、変更が基のデータソースに適用されるタイミ
ングを決定します。
C1FlexGridBase.EditOptions 値にEditFlags.DelayedCommit フラグが含まれる(デフォルト設定)場合、
グリッドは標準の Windows Forms 動作を使用し、カーソルが新しい行に移動したかグリッドがフォーカスを失ったときに
のみ変更をコミットします。
C1FlexGridBase.EditOptions 値に EditFlags.DelayedCommit フラグが含まれない場合、変更は個々の編集の直後に
データソースにコミットされます。
【データマップ関連】
自動貼り付けロジックを改良し、データマップされたセルを使用可能にしました。
データマップ列の処理機能を強化
列のDataType プロパティを設定すると、データ型に基づいてその RowCol.TextAlign プロパティが自動的に設定されま
す。今回、
RowCol.DataMap プロパティを設定して同じ効果が得られるようになりました。これにより、コントロールはさらに使用し
やすくなります。 それは、標準的なシナリオの場合、DataMap を使用して数値(ID。デフォルトでは右揃え)を文字列(デ
フォルトでは左揃え)
に変換するからです。たとえば、グリッドが製品テーブルに連結された場合、数値の分類 ID 列はデフォルトで右揃えとな
ります。文字列を含む
DataMap をその列に割り当てると、列は自動的に左揃えになります。
大容量のデータマップ(500 アイテム以上)使用時のコンボボックスのパフォーマンスを改善しました。
【GridTree.Sort メソッドへのオーバーロードの追加】
新しいオーバーロードが GridTree.Sort メソッドに追加されました。この新しいオーバーロードは、_flex.Sort(IComparer コンペア
ラ)に類似したカスタムコンペアラをパラメータとして取得します。
【印刷コードへの付加チェックの追加】
印刷コードに付加チェックが追加されました。この結果、ユーザーが文書の半分ほどページサイズを変更したところで、新しい
ページサイズに合うようにグリッドイメージが適宜縮小されます。
【VisualStyle プロパティの追加】
VisualStyle プロパティが C1FlexGridBase クラスに追加されました。このプロパティは、VisualStyle 列挙体から値を取得し、一
般的に使用される視覚スタイルにマッチするようにグリッドの外観全体をカスタマイズします。VisualStyle プロパティを使用する
と、複数の個別プロパティやスタイルをカスタマイズしなくても、高品質なレイアウトを素早くかつ簡単に設定できます。
VisualStyle プロパティは、行/列ヘッダの描画や強調に使用するグラデーション、枠、および選択領域を制御します。フォント、
前景色など、外観に関連しないその他のプロパティには影響を与えません。
また、VisualStyle プロパティは ComponentOne Studio に含まれるすべてのコントロールに実装されているため、一貫性のあ
るプロフェッショナルな外観を持つアプリケーションを作成することが可能です。
VisualStyle で使用可能な設定は以下のとおりです。
VisualStyle
説明
Custom
視覚スタイルなし(通常のスタイルと外観のプロパティを使用します)
System
スタイルは現在のシステム設定に一致します。
Office2007Blue
スタイルは Office2007 Blue カラースキームに一致します。
Office2007Silver
スタイルは Office2007 Silver カラースキームに一致します。
32
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Office2007Black
スタイルは Office2007 Black カラースキームに一致します。
VisualStyle プロパティの設定方法に関する詳細は、「VisualStyle を使用して外観を変更する」を参照してください。
【RowCollection.Add メソッド (Int32) および ColumnCollection.Add メソッド (Int32) メソッドの追加】
Add メソッド (Int32)と Add メソッド (Int32)が、それぞれ RowCollection クラスと ColumnCollection クラスに追加されました。こ
れらのメソッドは InsertRange に似ていますが、特定の位置にエレメントを追加するのではなく、常にコレクションの最後に追加し
ます。
【MouseEnterCell イベントおよび MouseLeaveCell イベントの追加】
MouseEnterCell イベントと MouseLeaveCell イベントが C1FlexGridBase クラスに追加されました。これらのイベントは、非推
奨となった MouseHoverCell に置き換わるものです。MouseHoverCell は、入るか、離れるセルの行および列インデックスを
含む RowColEventArgs を渡します。
【RowCol.Grid プロパティの追加】
行または列オブジェクトからオーナーグリッドコントロールへの参照の取得を可能にする Grid を追加しました。?
【SaveExcelメソッドのオーバーロード追加】
メソッドのオーバーロード追加】
SaveExcel メソッドに以下のオーバーロードが追加されました。
C1FlexGridBase.SaveExcel(String, String, FileFlags, PrinterSettings)
【Microsoft® Office Excel 2007 ファイルの読み込みと保存をサポートする OpenXml の追加】
Microsoft® Office Excel 2007 ファイルの読み込みと保存をサポートする OpenXml の追加
FlexGrid for WinForms は、Open Xml Format をサポートするようになりました。これは Microsoft Excel ファイルに対応する
2007 Microsoft® Office System のデフォルトの XML ベースのファイル形式です。OpenXml ファイルには、ZIP 形式を使用して
圧縮された多くの XML ファイルが含まれています。これらのファイルは圧縮されているため、OpenXml ファイルは一般的な文書
ファイル(.doc および .xls など)よりも通常小さくなります。.xls ファイルの読み込みや保存と同じように、.xlsx ファイルまたは
OpenXml ファイルを別の拡張子を使用して、読み込み、保存することができます。詳細は、「OpenXml ファイルの読み込みと保
存」を参照してください。
【その他】
IC1EmbeddedEditor インタフェースを公開しました。
IC1EmbeddedEditor のメソッドはリフレクションを使用して呼び出されることに注意してください。コントロールはインタ
フェース全体を実装する必要はありません。一致する名前、パラメータ、および戻り値を持つパブリックメソッドはすべて、
グリッドによって認識されて呼び出されます。
AggregateFlags 列挙体に新しい値、AggregateFlags.ExcludeHiddenCells を追加しました。
小計行機能を改良して TimeSpan 値の操作を可能にしました。
C1FlexGridBase.AutoSizeCols メソッドを改良し、ヘッダセル内のソートグリフが占めるスペースを計算に入れるようにし
ました。
値の強制型変換のパフォーマンスを改善(書式付き文字列のロード時に特に著しく改善)しました。
コントロールの作成とロード時間の最適化を追加しました。
アクセシビリティを改良して ComponentOne True DBGrid と Microsoft DataGridView との整合性を保証します。
XP スタイルの境界線の描画を改良しました。
XP スタイルが有効にされ、ScrollableControl.BorderStyle プロパティ が XpThemes または FixedSingle に設定されて
いる場合、テーマの色が SystemColors.WindowFrame の代わりに使用されます。
UseCompatibleTextRendering プロパティ
UseCompatibleTextRendering プロパティは、コントロールが Graphics クラス(GDI+。旧バージョンと互換性を持ち、
デフォルトで true)、または新しい
TextRenderer(GDI。.NET 2.0 以上で使用可能)を使用してテキストを描画するかどうかを決定します。 TextRenderer ク
ラスは、複雑なスクリプトをサポートする GDI、およびいくつかの国際的アプリケーションにより対応させた Uniscribe API
を使用します。また、GDI はハードウェアアクセラレーションもサポートしていますが、テストでは、新しい GDI 描画では互
33
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
換(GDI+)モードより約 25% 処理が遅くなります。
このプロパティは、各自のアプリケーションの他のコントロールやダイアログに一致したモードを選択できるように追加さ
れました。
クラスメンバ
4.0J で追加されたメンバは以下のとおりです。
メンバ
説明
ComboBoxEditorプロパティ
現在アクティブな エディタのプロパティへの簡単なアクセスを提供する
ComboBoxEditor オブジェクトを取得します。
GetDataDisplay メソッド (Int32,
Int32, ByRef Image, ByRef
CheckEnum)
文字列として書式設定されたグリッドセルの値、およびセル内の画像またはチェック
ボックスを取得します。
GetDataDisplay メソッド (Int32,
String, ByRef Image, ByRef
CheckEnum)
文字列として書式設定されたグリッドセルの値、およびセル内の画像またはチェック
ボックスを取得します。
IsCellCheckBoxメソッド
セルの内容をチェックボックスとして表示するかどうかを決定する値を取得します。
IsCellSelectedメソッド
セルが選択されているかどうかを決定する値を取得します。
BackgroundImageプロパティ
スタイルの背景画像を取得または設定します。
LoadExcel メソッド (String,
FileFlags)
Microsoft Excel(.xls)ファイルの最初のワークシートからグリッドをロードします。
MergedRangesプロパティ
C1FlexGrid.AllowMerging プロパティが AllowMergingEnum.Custom 列挙体 に設
定されたときにマージするグリッドセルを決定する CellRangeCollection を取得しま
す。
SaveExcel メソッド (String,
FileFlags)
グリッドの内容を Microsoft Excel(.xls)ファイルに保存します。
ScrollOptionsプロパティ
グリッドのスクロール動作を指定する ScrollFlags 列挙体 値を取得または設定しま
す。
垂直スクロールチップを表示する前に発生します。
ShowScrollTipイベント
ShowThemedHeadersプロパティ
コントロールが行ヘッダまたは列ヘッダの表示に XP テーマを使用するかどうかを取得
または設定します。
SortColumnプロパティ
グリッドに適用された現在のソートを定義する列への参照を取得します。
Subtotal メソッド
(AggregateEnum, Int32, String,
String)
セルの内容に基づいて行をグループ化して集計値を計算します。
Subtotal メソッド
(AggregateEnum, Int32, String,
String, String)
セルの内容に基づいて行をグループ化して集計値を計算します。
Subtotal メソッド
(AggregateEnum, Int32, String,
String, String, String)
セルの内容に基づいて行をグループ化して集計値を計算します。
UseCompatibleTextRenderingプ テキスト描画が以前のリリースの Windows Forms と互換性を持つかどうかを指定し
ロパティ
ます。
34
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
CellRangeCollectionクラス
CellRange オブジェクトのコレクション。
新しい CellRange オブジェクトをコレクションに追加します。
Add メソッド (CellRange)
Add メソッド (CellRange, Boolean)
新しい CellRange オブジェクトをコレクションに追加します。オプションとして、他の重
複する範囲をコレクションから削除します。
Clearメソッド
コレクションからすべてのオブジェクトを削除します。
Containsメソッド
CellRange オブジェクトがコレクションのメンバかどうかを決定します。
Count プロパティ
コレクション内の CellRange の数を取得します。
IndexOf メソッド (CellRange)
コレクションの CellRange のインデックスを取得します。
IndexOf メソッド (Int32, Int32)
コレクション内で指定した行と列を含む最初の CellRange オブジェクトのインデックス
を取得します。
Insertメソッド
CellRange オブジェクトをコレクションの指定したインデックスに挿入します。
Itemプロパティ
指定したインデックスにある CellRange オブジェクトを取得または設定します。
Removeメソッド
CellRange オブジェクトをコレクションから削除します。
RemoveAtメソッド
コレクションから指定したインデックスにあるオブジェクトを削除します。
BackgroundImageLayoutプロパ
ティ
スタイルが背景画像を拡大縮小して配置する方法を決定する値を取得または設定し
ます。
SelectedColumnHeaderプロパ
ティ
選択した列ヘッダの描画に使用するスタイルを取得します。
SelectedRowHeaderプロパティ
選択した行ヘッダの描画に使用するスタイルを取得します。
BuildString メソッド
(StyleElementFlags)
この CellStyle の文字列表示を返します。
IndexOf メソッド (String, Boolean)
指定した名前を持つ のインデックスを取得します。オプションとして、列が見つからな
い場合例外をスローします。
ComboBoxEditorクラス
現在アクティブな ComboBox エディタに関する情報を提供するヘルパークラス。
Itemsプロパティ
現在アクティブな ComboBox エディタ内の項目のコレクションを取得します。
SelectedIndexプロパティ
現在アクティブな ComboBox エディタ内で選択されたインデックスを取得または設定
します。
SelectedItemプロパティ
現在アクティブな ComboBox エディタ内で選択された項目を取得または設定します。
SelectedKeyプロパティ
現在アクティブな ComboBox エディタ内で選択された項目に対応するキーを取得しま
す。
MaximumLevelプロパティ
アウトラインの最も深いノードのレベルを取得します。
ScrollBarsVisibleプロパティ
現在表示されているスクロールバーを示す ScrollableControl.ScrollBars 値を取得し
ます。
ExcludeHiddenCells
集計から非表示行と列を除外します。
(AggregateFlags列挙体のメンバ)
Custom(AllowMergingEnum列
挙体のメンバ)
C1FlexGrid.MergedRanges コレクションを使用してマージするセルを決定します。
BackgroundImage
スタイルの背景画像を指定します。
35
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
(StyleElementFlags列挙体のメン
バ)
BackgroundImageLayout
(StyleElementFlags列挙体のメン
バ)
スタイルの背景画像の配置を指定します。
DelayedCommit(EditFlags列挙体 行の変更、またはフォーカスの移動の場合のみデータソースへの変更をコミットしま
のメンバ)
す。
IncludeMergedRanges
(FileFlags列挙体のメンバ)
C1FlexGridBase.SaveExcel メソッドと C1FlexGridBase.LoadExcel メソッドを使用し、
マージ範囲を含めて Excel の保存およびロードします。
LoadMergedRanges(FileFlags列
挙体のメンバ)
C1FlexGridBase.LoadExcel メソッドを使用して Excel からのインポート時にマージ範囲
をロードします。このフラグは、テキストファイルのロード時には影響せず、Excel 入力
の場合のみに影響します。
NoFreezing(FileFlags列挙体のメ
ンバ)
C1FlexGridBase.SaveExcel メソッドと C1FlexGridBase.LoadExcel メソッドを使用し、
Excel のエクスポートとインポート時に行と列をフリーズしません。
SaveMergedRanges(FileFlags列
挙体のメンバ)
マージ範囲を xls 出力ファイルに保存します。このフラグは、テキストファイルの保存
のときは影響せず、Excel 出力のときにのみ影響します。
SelectedColumnHeader
(CellStyleEnum列挙体のメンバ)
選択した列ヘッダの描画に使用するスタイル。
SelectedRowHeader
(CellStyleEnum列挙体のメンバ)
選択した行ヘッダの描画に使用するスタイル。
ShowThemedHeadersEnum列挙 コントロールが行ヘッダまたは列ヘッダの表示にテーマを使用するかどうかを指定しま
体
す。
TileStretch(ImageAlignEnum列
挙体のメンバ)
画像を部分に分けてグリッドに入れ、隅部分はコピーし、中央はセルの大きさに合わ
せて伸縮します。
UseNumericEditor(EditFlags列挙 数値型を編集するときに組み込み数値エディタを使用します。
体のメンバ)
IC1EmbeddedEditorインタフェー
ス
エディタによって実装され、グリッドによってセル上の編集コントロールをホストするた
めに使用されるインタフェース。
C1EditorFormatメソッド
指定したマスクを使用して特定の値を書式設定します。
C1EditorGetStyleメソッド
編集前と編集中に表示するボタンの種類を決定するエディタスタイル(DropDown、
Modal、None)を取得します。
C1EditorGetValueメソッド
エディタの現在の値を取得します。
C1EditorInitializeメソッド
エディタの内容とスタイルを初期化するために呼び出されます。
C1EditorKeyDownFinishEditメ
ソッド
特定のキーが編集を終了するかどうかを決定する値を取得します。
C1EditorUpdateBoundsメソッド
エディタのサイズと位置を更新するために呼び出されます。
C1EditorValueIsValidメソッド
エディタの現在の内容が有効かどうかを決定する値を取得します。
OwnerDrawCellEventArgs コンス OwnerDrawCellEventArgs クラスの新しいインスタンスを初期化します。
トラクタ
MouseEnterCellイベント
マウスがセルに入ると発生します。
MouseLeaveCellイベント
マウスがセルから離れる発生します。
36
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ResetVisualStyleメソッド
VisualStyle プロパティの値をリセットします。
VisualStyleプロパティ
コントロールの外観全体を決定する値を取得または設定します。
Add メソッド (Int32)
Column オブジェクトの特定の数をコレクションに追加します。
Sort メソッド (Int32, IComparer)
指定されたIComparerを使用して、すべてのノードを特定のレベルでソートします。
Add メソッド (Int32)
Row オブジェクトの特定の数をコレクションに追加します。
VisualStyle列挙体
コントロールの描画時に使用する VisualStyle を指定します。
Grid プロパティ
この行または列を所有する C1FlexGridBase@C1FlexGridBase への参照を取得しま
す。
3.0Jで更新された内容
で更新された内容
以下は、 FlexGrid for .NET 3.0J で追加された主な機能です。
マルチカラムコンボボックスへの対応
XML ファイルのインポート/エクスポート(C1FlexGridBase.ReadXml/C1FlexGridBase.WriteXml メソッド)
セルラベルの表示(ShowCellLabels プロパティ)
エラー情報の表示(ShowErrors プロパティ、C1FlexGridBase.GetCellErrorInfo/C1FlexGridBase.GetRowErrorInfo
イベント)
XP のテーマを追加(ScrollableControl.BorderStyle プロパティ)
スタイルの保持メカニズムを改良
Excel エクスポートの現地通貨処理フィルタを改良
AddNew の動作を改良して他のグリッド(TrueDBGrid、Microsoft DataGrid、Microsoft Access)との整合性を向上
内部使用または保護されていた便利なメソッドを表示
PrintGridFlags 列挙体に ExtendLastCol 設定を追加
追加機能概要
【マルチカラムコンボボックスへの対応】
新しい IC1MulticolumnDictionary インタフェースを実装した DataMaps と共に、複数列コンボが実装されました。
MultiColumnDictionary クラスは、IC1MultiColumnDictionary を持っており、文字列データまたはデータソース(ITypedList
を実装する任意のオブジェクト)に基づく複数列データマップとして使用できます。
MultiColumnDictionary クラスには2つのコンストラクタがあります。
コンストラクタの1つは、パイプ区切り(|)の項目リストを格納する文字列を取ります。
各項目はタブ区切りの列リストを格納します。
Visual Basic コードの書き方
Visual Basic
' 文字列に基づく MultiColumnDictionary を作成して、列に割り当てます。
' 注意:これにより各項目に整数型のキーが自動的に生成され、
' キー値がグリッド内に格納されます。
Dim text As String = "Row1, Col1\tRow1, Col2
Dim map As MultiColumnDictionary = New MultiColumnDictionary(text,0,True)
_flex.Cols(1).DataMap = map
C# コードの書き方
37
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
// 文字列に基づく MultiColumnDictionary を作成して、列に割り当てます。
// 注意:これにより各項目に整数型のキーが自動的に生成され、
// キー値がグリッド内に格納されます。
string text = "Row1, Col1\tRow1, Col2|Row2, Col1\tRow2, Col2";
MultiColumnDictionary map = new MultiColumnDictionary(text, 0, true);
_flex.Cols[1].DataMap = map;
もう1つのコンストラクタは、4つの引数を取ります。すなわち、データソース、グリッドに格納されるデータの格納先の列の名
前、ドロップダウンリストに表示されるフィールドのリスト、リストを閉じたときにグリッドに表示される列インデックスです。たとえ
ば、次のようになります。
Visual Basic コードの書き方
Visual Basic
' データに基づく MultiColumnDictionary を作成して、列に割り当てます。
' 注意:データソースが変更されるとリストは自動的に更新されます。
Dim dt As DataTable = GetDataTable("employees")
Dim columnNames() As String = New String() {"FirstName", "LastName",
"Country"}
Dim map As MultiColumnDictionary = New
MultiColumnDictionary(dt,"EmployeeID",columnNames,1)
_flex.Cols(2).DataMap = map
C# コードの書き方
C#
// データに基づく MultiColumnDictionary を作成して、列に割り当てます。
// 注意:データソースが変更されるとリストは自動的に更新されます。
DataTable dt = GetDataTable("employees");
string[] columnNames = new string[] { "FirstName", "LastName", "Country"
};
MultiColumnDictionary map = new MultiColumnDictionary(dt, "EmployeeID",
columnNames, 1);
_flex.Cols[2].DataMap = map;
【AddNew の動作を改良して他のグリッド(
の動作を改良して他のグリッド(TrueDBGrid、
、Microsoft DataGrid、
、Microsoft Access)との整合性を向上】
)との整合性を向上】
これまで、新しい行はカーソルが新しい行テンプレート内に移動したときに追加されていましたが、今回のバージョンからは、
ユーザーが新しい行テンプレートの編集を開始したときに新しい行が追加されるようになりました。
【内部使用または保護されていた便利なメソッドを表示】
内部使用または保護されていた以下のメソッドが表示されるようになりました。
メソッド
説明
IsCellFixed(int row, int col)
ブール型
IsCellCursor(int row, int col)
ブール型
IsCellHighlighted(int row, int col)
ブール型
IsCellValid(int row, int col)
ブール型
HitTestInfo HitTest()
引数なし。現在のマウス位置を使用します。
38
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
SetCellStyle(int row, int col, string styleName)
void。名前によってスタイルを設定します。
Styles.Add(string name, string basedOn)
CellStyle。名前によってスタイルを作成します。
【PrintGridFlags 列挙体に ExtendLastCol 設定を追加】
この新しい設定により、グリッドは各印刷ページの最後の列を拡張します。C1FlexGridBase.PrintGrid メソッド、および
C1PrintDocument と共に使用できます。たとえば、次のようになります。
Visual Basic コードの書き方
Visual Basic
' PrintGrid メソッドを使用してグリッドを印刷します。
_flex.PrinGrid("mygrid", PrintGridFlags.ShowPreviewDialog Or
PrintGridFlags.ExtendLastCol)
' C1PrintDocument を使用してグリッドを印刷します。>
_flex.PrintParameters.PrintGridFlags = PrintGridFlags.ExtendLastCol
Dim c1pd As New C1PrintDocument()
c1pd.StartDoc()
c1pd.RenderBlockText("This is a C1PrintDocument.")
c1pd.RenderBlockText(" ")
c1pd.RenderBlockC1Printable(_flex, c1pd.BodyAreaSize.Width)
c1pd.EndDoc()
C# コードの書き方
C#
// PrintGrid メソッドを使用してグリッドを印刷します。
_flex.PrinGrid("mygrid", PrintGridFlags.ShowPreviewDialog
// C1PrintDocument を使用してグリッドを印刷します。
_flex.PrintParameters.PrintGridFlags = PrintGridFlags.ExtendLastCol;
C1PrintDocument c1pd = new C1PrintDocument();
c1pd.StartDoc();
c1pd.RenderBlockText("This is a C1PrintDocument.");
c1pd.RenderBlockText(" ");
c1pd.RenderBlockC1Printable(_flex, c1pd.BodyAreaSize.Width);
c1pd.EndDoc();
これは、グリッドの ExtendLastCol プロパティから完全に独立していることに注意してください。ExtendLastCol グリッドプロパ
ティは印刷に対して効力を持ちません。
2.0Jで更新された内容
で更新された内容
以下は、FlexGrid for .NET 2.0J で追加された主な機能です。
カスタムエディタへの対応
Excel ファイルの保存とロード
自動クリップボードへの対応
セルのマージとグループ化のカスタム動作
データソースオブジェクトへの簡単アクセス
CellStyle クラスのパワーアップ
新しいイベント
処理のスピードアップ
39
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
追加機能概要
【カスタムエディタへの対応】
任意の .NET コントロールをグリッドエディタとして使用できるようになりました。コントロールのインスタンスを列の
CellStyle.Editor プロパティに指定すれば、グリッドはそのコントロールを使用して列内のセルを編集できます。
IC1EmbeddedEditor インタフェースを実装して、グリッドと外部エディタの統合を改良することで、カスタムエディタの動作をカ
スタマイズできます。C1Input ライブラリ内のコントロールはすべて、IC1EmbeddedEditor を実装しており、グリッドエディタと
して使用できるようになりました(コードは必要ありません)。
また、UIType エディタクラスをグリッドエディタとして使用する方法を示すサンプルコードも用意されています(製品付属の
「CustomEditors サンプル」を参照してください)。
【Excel ファイルの保存とロード】
C1FlexGridBase.SaveGrid と C1FlexGridBase.LoadGrid の各メソッドは、Microsoft Excel ファイル(.xls)を保存およびロードで
きるバージョンをオーバーロードしました。グリッドでは、純正の .NET コードが使用されているため、Excel をコンピュータにイン
ストールする必要がありません。
さらに、C1FlexGridBase.SaveExcel と C1FlexGridBase.LoadExcel という特別のメソッドでは、コントロールを追加してグリッドを
Excel ワークブックの特定シートに保存できます。
【自動クリップボードへの対応】
新しい AutoClipboard プロパティでは、グリッドは標準のクリップボードキーを自動的に処理して、セル値の切り取り、コ
ピー、貼り付け、および削除を行えます。
【セルのマージとグループ化のカスタム動作】
新しい CustomComparer プロパティでは、隣接セルをマージまたはグループ化するかどうかを決定する場合に使用する
IComparer クラスを指定できます。
【データソースオブジェクトへの簡単アクセス】
新しい Row.DataSource プロパティでは、行のデータソースに簡単にアクセスできます。たとえば、グリッドを ADO.NET
DataView に連結している場合、各グリッド行に付加された DataViewRow オブジェクトを簡単に取得できます。 【CellStyle
クラスのパワーアップ】 CellStyle クラスには、CellStyle.Editor プロパティと CellStyle.Render メソッドが新たに加わりました。
CellStyle.Editor プロパティでは、カスタムエディタを指定できます。CellStyle.Render メソッドでは、スタイルを使用して文字列
やイメージを任意の Graphics オブジェクトに描画できます。
【新しいイベント】
グリッドは、ユーザーが行を追加または削除する前と後にイベントを発生させて、これらのアクション
(C1FlexGridBase.BeforeAddRow、C1FlexGridBase.AfterAddRow、C1FlexGridBase.CancelAddRow、
C1FlexGridBase.BeforeDeleteRow、C1FlexGridBase.AfterDeleteRow)を監視したり取り消したりできるようになりました。ま
た、非連結データ列をサポートするイベントも新たに追加されました(C1FlexGridBase.GetUnboundValue と
C1FlexGridBase.SetUnboundValue の各イベント)。
【処理のスピードアップ】
いくつかの最適化により、グリッドにおける描画やスクロールが旧バージョンに比べて飛躍的に高速化しました。
40
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
VS-FlexGrid Proから
からFlexGrid for WinForms へ
Visual Basic 6.0 の環境で、ActiveX 製品 VS-FlexGrid Pro を使用して作成したアプリケーションを、新たに.NET環境で構築し
直す場合、最適なツールとしてなにを選択するべきでしょうか?
答えは、FlexGrid for WinForms です。
FlexGrid for WinForms は、ActiveX コンポーネントである VS-FlexGrid Pro のソースをすべて書き直し、.NET Framework へ
シームレスにつながるオブジェクト構造を実現しました。そのため、ADO.NETをはじめとする.NET Framework の革新的な機能
を十二分に活用でき、開発工程の生産性を最大限に高めます。一方で、セルマージやソート、アウトライン表示など、長年に
渡り高い評価を得る、VS-FlexGrid Pro の特長が大切に継承されています。
FlexGrid for WinForms と ActiveX 製品の VS-FlexGrid Pro や MSFlexGrid との間には互換性はなく、移行ツールも用意され
ていません。そのため、残念ながら、ソースコードを変更せずに.NETアプリケーションに変換するといったことはできません。
ただし、「製品の特長が継承されている」、このことは思いのほか重要です。はじめて使用するコントロールの場合、使いこな
せるようになるまでには、それなりの学習期間が必要ですが、FlexGrid for WinForms を選択することで、これまでに培った
ActiveX製品VS-FlexGrid Pro の使用経験を最大限に生かしつつ、.NET での開発をスムーズに進めることができます。元来、
FlexGrid for WinForms はシンプルなオブジェクト構造を持っているため、製品を習得しやすいこともあります。.NETに慣れて
いない開発者でも、VS-FlexGrid Pro の経験を生かしつつ、新たな世界に挑戦できます。
このページでは、ActiveX 製品 VS-FlexGrid Pro を使用して作成したアプリケーションを、FlexGrid for WinForms を使用し
た.NETアプリケーションに再構築する際に参考となるよう、「.NETとActiveX製品の相違点」、「プロパティ、メソッド、イベント比
較」にて、お役に立てるような情報をご提供しております。ActiveX から .NET アプリケーションへの再構築をご検討中のお客
様は、是非ご覧ください。
FlexGridの
の.NET 製品と
製品とActiveX製品の相違点
製品の相違点
ここでは FlexGrid for WinForms と VS-FlexGrid Pro の大きな相違点、行と列のコレクション(Rows/Cols)、スタイル
(Styles)、セル範囲(CellRange)、型付けした列についてご紹介します。機能的に異なる点ではなく、.NET 製品と ActiveX 製
品の基本的な考え方の違いになります。
行と列のコレクション(
行と列のコレクション(Rows/
/Cols))
41
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
これは、VS-FlexGrid ProからFlexGrid for WinForms への恐らく最も顕著な変更点です。
スタイル(
スタイル(Styles))
42
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
43
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
44
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セル範囲 (Cell Range)
45
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
46
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
型付けした列
C1FlexGridと
とC1FlexGridClassic
C1FlexGridClassic は、ユーザーサポートの対象外です。
VS-FlexGrid Pro は、複数の VSFlexGrid コントロール(ADO、DAO、アンバウンド、Unicode など)で構成されていますが、
FlexGrid for WinForms では、C1FlexGrid と C1FlexGridClassic の2種類になります。
C1FlexGrid は VS-FlexGrid Pro の ActiveX コントロールを単に移植しただけものではありません。C1FlexGridは、まったく新し
いタイプのグリッドコントロールとしてC#でゼロから記述されており、同じ設計原理を使用しながら ActiveX コントロールのオブ
ジェクトモデルよりさらに最新かつクリーンでパワフルな新しいオブジェクトモデルを採用しています。C1FlexGridコントロール
は、ADO.NET データソースに連結することも、非連結モードで使用することも可能です。
また、既存アプリケーションとのソースコードの互換性を最高レベルに維持するため、さらには、VS-FlexGrid Pro ユーザーの
学習曲線をできる限りスムーズなものにするため、C1FlexGridClassic コントロールも提供されています。
C1FlexGridClassic は、C1FlexGrid を基本クラスとして使用するコントロールで、VS-FlexGrid Pro 7.0J のオブジェクトモデルと
ほとんど同じオブジェクトモデルを提供します。C1FlexGridClassicのソースコードが提供されているため、新しいオブジェクトモ
デルの使い方を正確に理解することが可能です。あるいは、ソースコードを手本にして、C1FlexGridを基本クラスにした独自の
グリッドを作成できます。
新しく.NETアプリケーションを作成する場合は、C1FlexGrid コントロールをご利用ください。
カスタムコントロールを作成したい場合や、VS-FlexGrid Pro に動作を近づけたい場合などに、C1FlexGridClassic コントロール
47
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
のソースコードを参考にしてください。
プロパティ比較一覧
全般
VS-FlexGrid Pro
FlexGrid for WinForms
備考/機能概要
AllowBigSelection
SelectionModeプロパティ
SelectionModeEnum
(C1FlexGridBaseクラス)
行(列)のヘッダのクリックにより行(列)全体を選択できるようにします。
SelectionModeプロパティ
SelectionModeEnum
(C1FlexGridBaseクラス)
マウスやキーボードを使ってセルを範囲選択できるようにします。
AllowSelection
AllowUserFreezing AllowFreezingプロパティ
(C1FlexGridBaseクラス)
AllowUserResizing AllowResizingプロパティ
AllowFreezingEnum
マウスを使って静止行(列)数を変更できるかどうかを設定します。
AllowResizingEnum
(C1FlexGridBaseクラス)
マウスを使って行(列)の大きさを変更できるようにします。
BorderStyleプロパティ
BorderStyleEnum
(ScrollableControlクラス)
ボーダースタイルを取得または設定
AutoResize
AutoResizeプロパティ
(C1FlexGridBaseクラス)
データベースからデータを読み込んだときに、列の幅を自動的に調節
するかどうかを設定します。
AutoSearch
AutoSearchプロパティ
AutoSearchEnum
(C1FlexGridBaseクラス)
ユーザーが文字をタイプしたときに一致する項目を検索するかどうかを
設定します。
AutoSearchDelayプロパティ
AutoSearchプロパティで使用されるバッファがリセットされるまでの遅
延時間を秒単位で設定します。
Appearance
AutoSearchDelay
(C1FlexGridBaseクラス)
AutoSizeMode
AutoSizeRowsメソッド
AutoSizeFlags
AutoSizeRowメソッド
AutoSizeメソッドが有効のとき、列幅と行の高さのどちらを調整するか
を設定します。
AutoSizeColメソッド
AutoSizeColsメソッド
(C1FlexGridBaseクラス)
AutoSizeMouse
AllowResizingプロパティ
AllowResizingEnum
(C1FlexGridBaseクラス)
行ヘッダをダブルクリックすると、列内のデータに合わせて列幅が自動
調節されるかどうかを設定します。
BackColor
Styles.Normal.BackColorプ
ロパティ
スクロール可能領域の背景
色を設定します。
BackColorAlternate
Styles.Alternate.BackColorプロパティ
1行おきの背景色を設定します。
BackColorBkg
Styles.EmptyArea.BackColor グリッドの最後の列(最右列)または行(最下行)を越えた通常グレー表
プロパティ
示されている領域の背景色を設定します。
BackColorFixed
Styles.Fixed.BackColorプロ
48
固定列(行)の背景色を設定します。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
パティ
BackColorFrozen
Styles.Frozen.BackColorプロ 静止列(行)の背景色を設定します。
パティ
CaseSensitive
(VSFlexString)
FindRowメソッド
(C1FlexGridBaseクラス)
文字検索において、大文字と小文字を区別するかどうかを設定しま
す。
引数caseSensitiveを使用
Clip
Clipプロパティ
選択範囲のセルの内容を設定します。
(C1FlexGridBaseクラス、
CellRange構造体)
ClipSeparators
ClipSeparatorsプロパティ
行(列)区切りに使用される文字を設定します。
(C1FlexGridBaseクラス)
Editable
AllowEditingプロパティ
コントロールを編集可能にするかどうかを設定します。
(C1FlexGridBase、RowColク
ラス)
EditMask
EditMaskプロパティ
セル編集に使用する入力マスクを設定します。
(C1FlexGridBase、
CellStyle、RowColクラス)
EditMaxLength
TextBoxのMaxLengthプロパ セルに入力可能な文字数を設定します。
ティを使用
製品ヘルプ:よくある質問
(FAQ)を参照
EditSel???
TextBoxのSelectionStartプ
ロパティなどを使用
セル内で範囲選択されたテキストの文字数/開始点/文字列を設定し
ます。
製品ヘルプ:よくある質問
(FAQ)を参照
EditText
Editor.Textプロパティ
編集するセルの内容を設定します。
(C1FlexGridBaseクラス)
EditWindow
Editor プロパティ
グリッドが現在編集モードかどうかを検査できます。
(C1FlexGridBaseクラス)
FillStyle
FlexDataSource
SelectionModeプロパティ
SelectionModeEnum
(C1FlexGridBaseクラス)
プロパティの設定対象をカレントセルにするか、選択されたすべてのセ
ルにするかを指定します。
DataSourceプロパティ
データソースを設定します。
(C1FlexGridBaseクラス)
FloodColor
オーナー描画を使用
インジケータのようにセルを塗りつぶす色を設定します。
製品ヘルプ:よくある質問
(FAQ)を参照
FontWidth
Font プロパティ
テキストフォントの幅を設定します。
(C1FlexGridBase、CellStyle
クラス)
49
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ForeColor
Styles.Normal.ForeColorプ
ロパティ
スクロール可能領域のテキスト色を設定します。
ForeColorFixed
Styles.Fixed.ForeColorプロ
パティ
固定列(行)のテキスト色を設定します。
ForeColorFrozen
Styles.Frozen.ForeColorプロ 静止列(行)のテキスト色を設定します。
パティ
FormatString
Styles.Fixed.TextAlign、
Caption プロパティ
列の幅、列の配置、固定行(列)の数およびそれらのヘッダとして表示
するテキストなどを設定します。 前バージョンとの互換のために用意さ
れています。
(Row、Column クラス)
Appearance
BorderStyleプロパティ
(ScrollableControlクラス)
ボーダースタイルを取得または設定
GridColor
GridColorFixed
Styles.Normal.Border.Color
Styles.Fixed.Border.Colorプロパティ
データセルまたは固定行(列)のグリッド線の色を設定します。
GridLines
GridLinesFixed
Styles.Normal.Border.Style
Styles.Fixed.Border.Styleプロパティ
通常セルまたは固定行(列)のグリッド線のスタイルを設定します。
GridLineWidth
Styles.Normal.Border.Width グリッド線の幅を設定します。
プロパティ
HighLight
HighLightプロパティ
選択したセルをハイライト表示します。
(C1FlexGridBase、
CellStyleCollecitionクラス)
OLEDragMode
OLEDropMode
OwnerDraw
Picture
DragModeプロパティ
DragModeEnum
(C1FlexGridBaseクラス)
OLEドラッグ&ドロップ操作の処理をコンポーネントが自動で行うか、ま
たはコードから手動で行うかを設定します。
DropModeプロパティ
DropModeEnum
(C1FlexGridBaseクラス)
コントロールが自動または手動のどちらのOLEドロップターゲットとして
使用できるかを設定します。
DrawModeプロパティ
DrawModeEnum
(C1FlexGridBaseクラス)
DrawCellイベントを発生させるタイミングを設定します。
BackgroundImageプロパ
ティ
VSFlexGridコントロールのピクチャ(表全体を表したビットマップ)を参照
します。
(C1FlexGridBaseクラス)
PictureType
該当なし
Pictureプロパティによって生成されるピクチャの形式を設定します。
Redraw
BeginUpdateメソッド、
EndUpdateメソッド
VSFlexGridコントロールの再描画を制御します。
(C1FlexGridBaseクラス)
RightToLeft
該当なし
テキストの表示方向(右から左へ/左から右へ)を設定します。
SelectionMode
SelectionModeプロパティ
SelectionModeEnum
(C1FlexGridBaseクラス)
行(列)単位、またはリストボックス方式でセルを選択できるようにしま
す。
50
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
SheetBorder
Border プロパティ
(CellStyleクラス)
TabBehavior
グリッド全体を囲むボーダーの色、および静止領域とスクロール可能領
域との境界線の色を設定します。
KeyActionTabプロパティ
KeyActionEnum
(C1FlexGridBaseクラス)
[Tab]キーでフォーカスを移動する対象を、コントロールとグリッドセル
のどちらにするかを指定します。
セル関連
VS-FlexGrid Pro
FlexGrid for WinForms
備考/機能概要
BackColorSel
Styles.Highlight.BackColorプ
ロパティ
選択されたセルのテキスト色の背景色を設定します。
Cell
CellRangeオブジェクト
任意の選択範囲の属性を設定します。
Cell???
GetCellRectメソッド
セルの高さ/幅/上端の位置/左端の位置を参照し、必要があ
れば、画面をスクロールしてそのセルを表示領域内に移動します。
CellAlignment
TextAlignプロパティ
TextAlignEnum
(CellStyleクラス、RowColクラ
ス)
セルまたは指定範囲のセルのどの位置にデータを表示するかを設
定します。
CellForeColor
BackColorプロパティ
セルまたは指定範囲のセルの背景色/文字色を設定します。
CellBackColor
ForeColorプロパティ
(CellStyleクラス)
CellButtonPicture
CellButtonImageプロパティ
セルボタンに使用されるピクチャを設定します。
(C1FlexGridBaseクラス)
CellChecked
CheckBoxプロパティ
CheckEnum
(CellRangeオブジェクト)
セルまたは指定範囲のセルにチェックボックスを表示するかどうか
を設定します。
GetCellCheckプロパティ、
SetCellCheckプロパティ、
GetCellCheckメソッド、
SetCellCheckメソッド
(C1FlexGridBaseクラス)
CellFloodColor
オーナー描画を使用
インジケータのようにセルを塗りつぶす色を設定します。
製品ヘルプ:よくある質問
(FAQ)を参照
CellFloodPercent
オーナー描画を使用
製品ヘルプ:よくある質問
(FAQ)を参照
CellFont???
Font プロパティ
セルを塗りつぶす領域を、セル全体に対する百分率で設定しま
す。
セルに使用されるテキストのフォントを設定します。
(CellStyleクラス)
CellPicture
Image プロパティ
セルまたは指定範囲に表示するピクチャを設定します。
(CellRangeオブジェクト)
51
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
SetCellImageメソッド、
GetCellImageメソッド
(C1FlexGridBaseクラス)
CellPictureAlignment ImageAlign プロパティ
CellTextStyle
ComboCount
ImageAlignEnum
(CellStyle、RowColクラス)
セルまたは指定範囲のセルのどの位置にピクチャを表示するかを
設定します。
TextEffect プロパティ
TextEffectEnum
(CellStyleクラス)
セルまたは指定範囲のセルのテキストの表示スタイルを設定しま
す。
ComboBoxEditor.Items.Count セルのコンボリストの項目数を参照します。
プロパティ
(ComboBoxEditorクラス)
ComboData
DataMapプロパティ
セルのコンボリストの項目に関連付けられたID文字を参照します。
(RowCol、CellStyleクラス)
ComboIndex
SelectedIndexプロパティ
(ComboBoxEditorクラス)
ComboItem
SelectedItemプロパティ
(ComboBoxEditorクラス)
ComboList
ComboListプロパティ
セルのコンボリストで現在選択されている項目のインデックスを設
定します。
リストを使って編集を行うときのみ、セルのコンボリストの項目に関
連付けられた文字列を参照します。
セルのコンボリストの項目を設定します。
(C1FlexGridBase、CellStyle、
RowColクラス)
ComboSearch
Ellipsis
EditOptionsプロパティ
EditFlags AutoSearchを使用
(C1FlexGridBase クラス)
コンボリストがユーザー入力文字の自動検索(インクリメンタル
サーチ)をサポートするかどうかを設定します。
Trimming プロパティ
StringTrimming
(CellStyleクラス)
セル内の文字列がすべて表示できないときに、省略符号(...)を表
示するようにするかどうかを設定します。
製品ヘルプ:よくある質問
(FAQ)を参照
FocusRect
FocusRect プロパティ
(C1FlexGridBaseクラス)
カレントセルの周囲に描画するフォーカス枠のスタイルを設定しま
す。
ForeColorSel
Styles.Highlight.ForeColorプ
ロパティ
選択されたセルのテキスト色を設定します。
PicturesOver
ImageAndTextプロパティ
セル内のテキストとピクチャを重ね合わせるかどうかを設定しま
す。
(RowColクラス)
Text(VSFlexGrid)
SetDataメソッド
カレントセルまたは指定範囲のセルのテキストを設定します。
(C1FlexGridBaseクラス)
TextArray
Item プロパティ
任意のセルのテキストを設定します。
(C1FlexGridBaseクラス)
TextMatrix
52
TextEffectプロパティ
任意のセルのテキストを設定します。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
(CellStyleクラス)
TextStyle
TextEffectプロパティ
TextEffectEnum
TextStyleFixed
(CellStyleクラス)
標準のセルと固定列(行)のテキストを3D表示します。
Value
該当なし
カレントセルの数値を参照します。
ValueMatrix
該当なし
指定したセルの数値を参照します。
列関連
VS-FlexGrid Pro FlexGrid for WinForms
備考/機能概要
Col
カレント列を設定します。
Col プロパティ
(C1FlexGridBaseクラス)
ColAlignment
ColComboList
TextAlignプロパティ
TextAlignEnum
(RowColクラス)
セルのどの位置にデータを表示するかを列単位で設定します。
ComboListプロパティ
指定した列で使用するドロップダウンリストの項目を設定します。
(RowColクラス)
ColData
UserDataプロパティ
ユーザーデータを取得または設定します。
(RowColクラス)
ColDataType
DataTypeプロパティ
列のデータ型を設定します。
(RowColクラス)
ColEditMask
EditMaskプロパティ
セルの編集に使用する入力マスクを列単位で設定します。
(RowColクラス)
ColFormat
Format プロパティ
数値、ブール値、日付の表示書式を設定します。
(RowColクラス)
ColHidden
Visible プロパティ
列を表示するかどうかを設定します。
(RowColクラス)
ColImageList
ImageMapプロパティ
(RowColクラス)
ColIndex
Index プロパティ
データ値をイメージに変換するのに使用するデータマップを取得ま
たは設定します。
列のインデックスを参照します。
(RowColクラス)
ColIsVisible
LeftColプロパティ・RightColプロパ
ティにより判別
指定した列が表示領域内にあるかどうかを参照します。
(C1FlexGridBaseクラス)
ColKey
Name プロパティ
指定の列を識別するためのキーを設定します。
(Column クラス)
ColPos
Left プロパティ
コントロールの左端から指定列の左端までの距離を参照します。
(Column クラス)
ColPosition
53
Move メソッド
選択した列を指定した場所に移動します。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
(Column、ColumnCollectionクラ
ス)
Cols
Count プロパティ
列の総数を設定します。
(ColumnCollectionクラス)
ColSel
ColSelプロパティ
列の選択範囲を設定します。
(C1FlexGridBaseクラス)
ColWidth
Width プロパティ
指定した列の幅を設定します。
(Column クラス)
ColWidthMax
MaxSizeプロパティ
列の幅の最大値を設定します。
(RowColCollectionクラス)
ColWidthMin
MinSizeプロパティ
列の幅の最小値を設定します。
(RowColCollectionクラス)
ExtendLastCol
ExtendLastColプロパティ
(C1FlexGridBaseクラス)
FixedAlignment TextAlignFixed プロパティ
FixedCols
最後(右端)の列の幅をコントロール幅に合わせて自動的に調節す
るかどうかを設定します。
TextAlignEnum
(RowColクラス)
固定列のどの位置にテキストを表示するかを設定します。
Fixed プロパティ
固定列の総数を指定します。
(ColumnCollectionクラス)
FrozenCols
Frozen プロパティ
静止列(編集可能かつスクロール不可の列)の総数を設定します。
(ColumnCollectionクラス)
LeftCol
LeftColプロパティ
コントロールの左端(固定列は除く)に表示する列を設定します。
(C1FlexGridBaseクラス)
MouseCol
MouseColプロパティ
現在マウスポインタが置かれている列番号を参照します。
(C1FlexGridBaseクラス)
RightCol
RightColプロパティ
コントロールの右端に表示されている列の番号を参照します。
(C1FlexGridBaseクラス)
行関連
VS-FlexGrid
Pro
FlexGrid for WinForms
備考/機能概要
BottomRow
BottomRowプロパティ
コントロールの最下部に表示されている行の番号を参照します。
(C1FlexGridBaseクラス)
FindRow
FindRowメソッド
指定した文字列を含む行インデックスを参照します。
(C1FlexGridBaseクラス)
FixedRows
Fixed プロパティ
固定行の総数を指定します。
(RowCollectionクラス)
FrozenRows
54
Frozen プロパティ
静止行(編集可能かつスクロール不可の行)の総数を設定しま
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
(RowCollectionクラス)
IsSelected
Selected プロパティ
(Row、RowCol、RowCollectionクラ
ス)
MouseRow
MouseRowプロパティ
す。
指定した行を選択状態にします。また、指定行が選択状態である
かどうかを参照します。
現在マウスポインタが置かれている行番号を参照します。
(C1FlexGridBaseクラス)
Row
Row プロパティ
カレント行を設定します。
(C1FlexGridBaseクラス)
RowData
UserDataプロパティ
ユーザーデータを取得または設定します。
(RowCol、CellStyleクラス)
RowHeight
Height プロパティ
指定した行の高さを設定します。
(Row クラス)
RowHeightMax MaxSizeプロパティ
行の高さの最大値を設定します。
(RowCollectionクラス)
RowHeightMin MinSizeプロパティ
行の高さの最小値を設定します。
(RowCollectionクラス)
RowHidden
Visible プロパティ
行を表示するかどうかを設定します。
(RowColクラス)
RowIsVisible
TopRow/BottomRowプロパティに
より判別
指定した行が表示領域内にあるかどうかを参照します。
(C1FlexGridBaseクラス)
RowPos
Top プロパティ
コントロールの上端から指定行の上端までの距離を参照します。
(Row クラス)
RowPosition
Move プロパティ
選択の行を指定の場所に移動します。
(Row、RowCol、RowCollectionクラ
ス)
Rows
Count プロパティ
行の総数を設定します。
(RowCollectionクラス)
RowSel
RowSelプロパティ
行の選択範囲を設定します。
(C1FlexGridBaseクラス)
RowStatus
FrameworkのDataRow.RowStateプ
ロパティを使用
行の状態(追加済み、削除済み、修正済み)を示す値を設定しま
す。
SelectedRow
SelectedRows
Selected プロパティ
(Row、RowCol、RowCollectionクラス)
選択された行の位置および行数を参照します。
TopRow
TopRowプロパティ
コントロールの上端(固定列は除く)に表示する行を設定します。
(C1FlexGridBaseクラス)
ソート
55
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
VS-FlexGrid
Pro
FlexGrid for WinForms
備考/機能概要
ColSort
Sort プロパティ
行を並べ替える方向を列ごとに設定します。
(Column クラス)
ExplorerBar
AllowDraggingプロパティ
ヘッダを使ってソートや移動ができるようにするかどうかを設定します。
AllowSortingプロパティ
(C1FlexGridBase、RowColクラ
ス)
Sort
Sort プロパティ
指定した列をソートのキーとして、選択範囲の行を並べ替える順番を設定
します。
(Column クラス)
マージ
VS-FlexGrid Pro FlexGrid for WinForms 備考/機能概要
MergeCells
AllowMergingプロパ
ティ
(C1FlexGridBaseクラ
ス)
MergeCol
MergeRow
MergeRow
AllowMergingプロパ
ティ
AllowMergingEnum
内容の同じセル間のグリッド線を削除し、複数のセルを1つのセルにまとめます
(マージします)。
AllowMergingEnum
指定した列(行)のセルをマージします。
(RowColクラス)
MergeCompare CustomComparerプロ
パティ
セルをマージする際の比較方法を設定します。
(C1FlexGridBaseクラ
ス)
スクロール
VS-FlexGrid
Pro
FlexGrid for
WinForms
ScrollBars
ScrollBarsプロパ 表示するスクロールバーの種類を選択します。
ティ
備考/機能概要
(C1FlexGridBase
クラス)
ScrollTips
ScrollOptionsプ
ロパティ
ユーザーが垂直方向にスクロールするときに、ツールチップを表示するかどうかを設定し
ます。
(C1FlexGridBase
クラス)
ScrollTipText ShowScrollTipイ
ベント
グリッドが垂直方向にスクロールしているときに表示するツールチップのテキストを設定し
ます。
(C1FlexGridBase
クラス)
56
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ScrollTrack
ScrollOptionsプ
ロパティ
ユーザーがスクロールのつまみを動かしたときに、それに合わせてVSFlexGridの内容を
スクロールするかどうかを設定します。
(C1FlexGridBase
クラス)
計算・小計行
VS-FlexGrid Pro
FlexGrid for WinForms
備考/機能概要
Aggregate
Aggregate プロパティ
AggregateEnum
(C1FlexGridBaseクラス)
AggregateFlags
特定範囲に対する集合関数(合計、平均など)を算出します。
IsSubtotal
該当なし
指定した行に小計を表示するのか、通常のデータを表示するのかを設定し
ます。
MultiTotals
該当なし
小計を1行にまとめて表示するかどうかを設定します。
SubtotalPosition SubtotalPositionプロパ
ティ
小計を挿入する位置(データの上または下)を設定します。
(C1FlexGridBaseクラス)
データ接続
VS-FlexGrid
Pro
FlexGrid for
WinForms
DataMember DataMemberプロパ
ティ
備考/機能概要
データメンバを設定します。
(C1FlexGridBaseクラ
ス)
DataMode
該当なし
コントロールをデータソースと連結した場合に、変更内容を同期させるかどうかを設
定します。
DataSource
DataSourceプロパ
ティ
(C1FlexGridBaseクラス)
データソースを設定します。
VirtualData
該当なし
データをまとめて一度にロードするか、または必要に応じてロードするかを設定しま
す。
階層
VS-FlexGrid Pro
FlexGrid for WinForms
備考/機能概要
Children
Children プロパティ
子ノードの総数を参照します。
(Node クラス)
Expanded
Expanded プロパティ
ノードの現在の状態(展開/縮小)を設定します。
(Node クラス)
Image
Image プロパティ
ノードのピクチャを設定します。
(Node クラス)
IsCollapsed
57
Collapsed プロパティ
行の表示状態(展開/縮小)を設定します。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
(Node クラス)
Key
Key プロパティ
ノードキーを設定します。
(Node クラス)
Level
Level プロパティ
ノードのアウトラインレベルを参照します。
(Node クラス)
NodeClosedPicture NodeImageCollapsedプロパ 縮小されたアウトラインノードを表すピクチャを設定します。
ティ
(GridTreeクラス)
NodeOpenPicture
NodeImageExpandedプロパ 展開されたアウトラインノードを表すピクチャを設定します。
ティ
(GridTreeクラス)
OutlineBar
Tree プロパティ
(C1FlexGridBaseクラス)
OutlineCol
Level プロパティ
データの表示階層を切り替えるためのアウトラインバーのタイプを設
定します。
アウトラインツリーを表示する列を設定します。
(Node クラス)
RowOutlineLevel
Tree プロパティ
小計行の表示階層を設定します。
(C1FlexGridBaseクラス)
Text(VSFlexNode)
Data プロパティ
ノードのテキストを設定します。
(Node クラス)
TreeColor
LineColorプロパティ
データをツリー表示するときの線の色を設定します。
(GridTreeクラス)
メソッド比較一覧
VS-FlexGrid Pro
FlexGrid for WinForms
備考/機能概要
AddItem
AddItemメソッド
VSFlexGridコントロールに新しい行を追加します。
(C1FlexGridBaseクラス)
AddNode
AddNodeメソッド
(Node クラス)
AutoSize
AutoSizeCol メソッド
カレントノードに基づく特定位置(最初/最後の子ノードなど)にノード
を追加します。
セル項目に合わせて列幅または行の高さを自動的に調節します。
AutoSizeCols メソッド
AutoSizeRow メソッド
AutoSizeRows メソッド
(C1FlexGridBaseクラス)
BindToArray
該当なし
VSFlexGridコントロールをバリアント型の配列に連結します。
BuildComboList
該当なし
ColComboListプロパティに割り当てる文字列をレコードセットのデー
タから取得します。
CellBorder
Color プロパティ
カレントセルまたは選択範囲の周りや内側にボーダーを描画します。
58
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Direction プロパティ
Width プロパティ
(CellBorderクラス)
Clear
Clear メソッド
VSFlexGridコントロールの内容をクリアします。
(C1FlexGridBase、RowCol、
CellStyleクラスなど)
DataRefresh
Refresh メソッド
データソースのデータを強制的に再取得します。
(C1FlexGridBaseクラス)
DragRow
Move メソッド
ドラッグによる行の移動を開始します。
(Row、RowColクラスなど)
EditCell
StartEditingメソッド
(C1FlexGridBaseクラス)
コントロールをセル編集モードに切り替えます。
EnsureVisible
EnsureVisibleメソッド
必要に応じてグリッドをスクロールし、指定のノードを表示領域に表示
します。
(Node クラス)
FinishEditing
FinishEditingメソッド
(C1FlexGridBaseクラス)
GetMergedRange GetMergedRangeメソッド
保留中のすべての編集を終了し、グリッドをブラウズモードに戻しま
す。
指定のセルを含むマージ範囲を参照します。
(C1FlexGridクラス)
GetNode
GetNodeメソッド
NodeTypeEnum
(Node クラス)
指定の小計行に対するアウトラインノードオブジェクトを参照します。
GetNodeRow
該当なし
アウトラインモードの特定行における親または子ノードなどの行番号
を参照します。
GetSelection
Selection プロパティ
row1引数(col1引数)の値がrow2引数(col2引数)の値を超えないよ
うに、現在の選択範囲を参照します。
(C1FlexGridBaseクラス)
LoadArray
該当なし
バリアント配列または他のVSFlexGridコントロールからデータをロード
します。
LoadGrid
LoadExcel メソッド
グリッドのデータと形式をファイルから読み込みます。
LoadExcelSheetNames メソッド
LoadGrid メソッド
(C1FlexGridBaseクラス)
Move
Move メソッド
(Node クラス)
アウトラインツリー上で指定のノードを上位または下位レベルに移動
します。
OLEDrag
FrameworkのDoDragDropメ
ソッドを使用
OLEドラッグ操作を開始します。
Outline
Subtotal メソッド
小計の表示階層を設定します。
(C1FlexGridBaseクラス)
PrintGrid
PrintGridメソッド
グリッドをプリンタに出力します。
(C1FlexGridBaseクラス)
59
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
RemoveItem
RemoveItemメソッド
VSFlexGridコントロールから行を削除します。
(C1FlexGridBaseクラス)
RemoveNode
RemoveNodeメソッド
指定のノードおよびそのすべての子ノードをグリッドから削除します。
(Node クラス)
SaveGrid
SaveExcel メソッド
グリッドのデータと形式をファイルに保存します。
SaveGrid メソッド
(C1FlexGridBaseクラス)
Select
Select メソッド
ノードを選択します。
(C1FlexGridBaseクラス)
ShowCell
ShowCellメソッド
(C1FlexGridBaseクラス)
Sort
Sort メソッド
(C1FlexGridBaseクラス)
Subtotal
Subtotal メソッド
必要に応じて内容をスクロールし、指定セルを表示領域に表示しま
す。
指定した列をソートのキーとして、選択範囲の行を並べ替える順番を
設定します。
(C1FlexGridBaseクラス)
小計を算出します。
イベント比較一覧
VS-FlexGrid Pro
FlexGrid for
WinForms
AfterCollapse
AfterCollapseイベント
アウトラインモードにおいて、1つまたは複数の行が展開(縮小)された後
に発生します。
AfterDataRefresh
AfterDataRefreshイベ
ント
レコードソースからデータが読み込まれた後に発生します。
AfterEdit
AfterEditイベント
ユーザーがセルの内容を変更した後に発生します。
AfterMoveColumn
AfterDragColumnイベ エクスプローラバー上で、列をドラッグして移動した後に発生します。
ント
AfterMoveRow
AfterDragRowイベント エクスプローラバー上で、行のドラッグまたはDragRow メソッドの呼び出し
によって行を移動した後に発生します。
AfterRowColChange
AfterRowColChange
イベント
カレントセル(RowおよびColプロパティの値)が他のセルに変更された後
に発生します。
AfterScroll
AfterScrollイベント
コントロールがスクロールされた後に発生します。
AfterSelChange
AfterSelChangeイベン 選択したセル範囲(RowSelおよびColSelプロパティの値)が変更された後
ト
に発生します。
AfterSort
AfterSortイベント
エクスプローラバー上で、列ヘッダのクリックによって列をソートした後に発
生します。
AfterUserFreeze
AfterFreezeRow イベ
ント
静止列(行)の総数が変更された後に発生します。
備考/機能概要
AfterFreezeColumn イ
ベント
60
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
AfterUserResize
AfterResizeRow イベ
ント
ユーザーが行や列の大きさを変更した後に発生します。
AfterResizeColumn イ
ベント
BeforeCollapse
BeforeCollapseイベン
ト
アウトラインモードにおいて、1つまたは複数の行が展開(縮小)される直
前に発生します。
BeforeEdit
BeforeEditイベント
コントロールがセル編集モードに切り替わるときに発生します。
BeforeMouseDown
BeforeMouseDownイ
ベント
コントロールがMouseDownイベントを処理する前に発生します。
BeforeMoveColumn
BeforeDragColumnイ
ベント
エクスプローラバー上で、ドラッグして列を移動する前に発生します。
BeforeMoveRow
BeforeDragRowイベン エクスプローラバー上で、行のドラッグまたはDragRowメソッドの呼び出し
ト
によって行が移動される直前に発生します。
BeforePageBreak
BeforePageBreakイベ
ント
VSFlexGridコントロールの印刷中に発生し、改ページを制御します。
BeforeRowColChange BeforeRowColChange カレントセル(RowおよびColプロパティの値)が他のセルに変更される直
イベント
前に発生します。
BeforeScroll
BeforeScrollイベント
コントロールがスクロールされる直前に発生します。
BeforeScrollTip
BeforeScrollTipイベン
ト
スクロール時のツールチップを表示する前に発生します。
BeforeSelChange
BeforeSelChangeイベ
ント
選択したセル範囲(RowSel、ColSelの値)が変更される直前に発生しま
す。
BeforeSort
BeforeSortイベント
エクスプローラバー上で、クリックして列をソートする前に発生します。
BeforeUserResize
BeforeResizeRow イベ ユーザーが行や列の大きさを変更する前に発生します。
ント
BeforeResizeColumn
イベント
CellButtonClick
CellButtonClickイベン
ト
ユーザーがセルのボタンをクリックする前に発生します。
CellChanged
CellChangedイベント
セルの内容が変更された後に発生します。
ChangeEdit
ChangeEditイベント
エディタ内のテキストが変更された後に発生します。
ComboCloseUp
ComboCloseUpイベン コンボボックスが閉じる前に、発生します。
ト
ComboDropDown
ComboDropDownイ
ベント
コンボボックスが閉じる前に、発生します。
Compare
Compare イベント
Sort プロパティが「9-ユーザー定義」に設定されたときに行を比較するた
めに発生します。
DrawCell
OwnerDrawCellイベン セルのカスタム描画を行う前に発生します。
ト
EnterCell
EnterCellイベント
別のセルがアクティブセルになったときに発生します。
Error
GridErrorイベント
データバウンド時にデータベースエンジンからエラーが返された後に発生
61
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
します。
KeyDownEdit
KeyDownEditイベント
編集モード中にキーが押されたときに発生します。
KeyPressEdit
KeyPressEditイベント
編集モード中に文字が入力されたときに発生します。
KeyUpEdit
KeyUpEditイベント
編集モード中にキーが離されたときに発生します。
LeaveCell
LeaveCellイベント
カレントセルが別のセルに移る直前に発生します。
RowColChange
RowColChangeイベン アクティブセルが別のセルに移ったときに発生します。
ト
SelChange
SelChangeイベント
選択範囲が別のセルや別の範囲に変更されたときに発生します。
SetupEditWindow
SetupEditorイベント
編集ウィンドウを作成して表示する前に、発生します。
StartEdit
StartEditイベント
コントロールがセル編集モードに切り替わったとき(BeforeEditイベントの
後)に発生します。
StartPage
該当なし
グリッドの印刷中、各ページの印刷が開始される直前に発生します。
ValidateEdit
ValidateEdit イベント
コントロールがセル編集モードから通常のモードに切り替わる前に発生し
ます。
62
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
クイックスタート
このセクションでは、基本的な C1FlexGrid 機能を使用して、簡単なグリッドアプリケーションを作成する方法について学習しま
す。このセクションでは、C1FlexGrid のすべての機能の包括的なチュートリアルを意図するものではありませんが、クイックス
タートについて説明し、製品を使用するためのいくつかの一般的な方法に重点を置いて説明します。詳細なチュートリアルに
ついては、「チュートリアル
チュートリアル」を参照してください。
手順 1: C1FlexGrid を使用したアプリケーションを作成する
次の手順では、簡単なグリッドアプリケーションの作成方法を順を追って説明します。
1. 新しいプロジェクトを作成します。
2. C1FlexGrid コントロールをフォームに追加します。フォームに追加する方法についての詳細は、「コンポーネントをプロ
ジェクトに組み込む方法」を参照してください。
3. C1FlexGrid タスク メニューを開きます。C1FlexGrid タスク
タスクメニューへのアクセスについての詳細は、「C1FlexGrid タ
スク」を参照してください。
4. C1FlexGrid タスク
タスクメニューで、[親コンテナへのドッキング
親コンテナへのドッキング]をクリックします。これにより、グリッドの Dock プロパティ
が Fill に設定され、グリッドがフォーム領域いっぱいに表示されます。
5. プログラムを実行し、簡単なグリッドアプリケーションが表示されます。
おめでとうございます ! 簡単なグリッドアプリケーションが正常に作成されました。次のトピックでは、C1FlexGrid コントロール
をデータソースに連結する方法について学習します。
手順 2: C1FlexGrid をデータソースに連結する
次の手順では、「手順 1: C1FlexGrid を使用したアプリケーションを作成する」トピックで作成したグリッドアプリケーションにデータ
ソースを連結する方法を順を追って説明します。
1. C1FlexGrid タスク メニューを開きます。C1FlexGrid タスク
タスクメニューへのアクセスについての詳細は、「 C1FlexGrid タスク 」
を参照してください。
2. C1FlexGrid タスク
タスクメニューで、[データソースの選択
データソースの選択]ドロップダウン矢印をクリックして、ドロップダウンボックスから[プロジェ
プロジェ
クトデータソースの追加
クトデータソースの追加]リンクを選択します。
63
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
3. [データソース構成ウィザード
データソース構成ウィザード]が表示されます。[データソースの種類を選択
データソースの種類を選択]ページで選択されたデフォルトの設定[データ
データ
ベース
ベース]をそのままにして、[次へ
次へ]をクリックします。
4. [データソース
データソース モデルの選択
モデルの選択]ページで[データセット
データセット]を選択のままにして[次へ
次へ]をクリックします。
5. [新しい接続
新しい接続]ボタンをクリックして、新しい接続を作成するか、ドロップダウンリストから接続を選択します。[接続の追加
接続の追加]ダイ
アログボックスが表示されます。
64
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
6. [Microsoft Access データベースファイル
データベースファイル]をデータソース
データソースにします。
7. [参照
参照]をクリックします。[Microsoft Access データベースファイルの選択
データベースファイルの選択]ダイアログボックスで、製品に収録されている
NWind.mdb データベースファイルを選択し、[開く
開く]をクリックします。
8. [接続の追加
接続の追加]ダイアログボックスで、[接続テスト
接続テスト]ボタンをクリックして、データベースまたはサーバーに正常に接続されてい
ることを確認します。[データ接続の選択
データ接続の選択]ページに新しい文字列が表示されます。
65
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
9. [OK]をクリックして、[接続の追加
接続の追加]ダイアログボックスを閉じます。
10. [次へ
次へ]ボタンをクリックして、手順を続行します。データファイルをプロジェクトに追加し、接続文字列を変更するかどうかを確
認するダイアログボックスが表示されます。データベースをプロジェクトにコピーする必要がないので、[いいえ
いいえ]をクリックしま
す。
11. アプリケーションの設定ファイルに接続文字列を保存するには、[次の名前で接続を保存する
次の名前で接続を保存する]チェックボックスをオンにして、
名前を入力します。[次へ
次へ]ボタンをクリックして、手順を続行します。
66
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
12. [データベースオブジェクトの選択
データベースオブジェクトの選択]ページで、[テーブル
テーブル]ノードを展開して、[製品
製品]テーブルを選択し、すべてのフィールドを
オンにします。[データセット名
データセット名]ボックスに[NwindDataSet]を入力し、[終了
終了]をクリックしてウィザードを終了します。
67
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
13. データセットと接続文字列がプロジェクトに追加されます。さらに、Visual Studio が次のコードを自動的に作成してデータセッ
トに入力します。
Visual Basic コードの書き方
Visual Basic
Me.ProductsTableAdapter.Fill(Me.ProductsDS.Products)
C# コードの書き方
C#
this.productsTableAdapter.Fill(this.productsDS.Products);
プログラムを実行し、次の点に注目します。
[Products]テーブルのデータがグリッドに表示されます。
68
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
おめでとうございます ! グリッドアプリケーションがデータソースに正常に連結されました。次のトピックでは、書式スタイル、
VisualStyle、および組み込みスタイルをカスタマイズする方法について学習します。
手順 3: C1FlexGrid の設定をカスタマイズする
次の手順では、グリッドの書式スタイル、VisualStyle、および組み込みスタイルの設定を順を追って説明します。
1. デザイナを表示し、最初の列ヘッダーの右端に表示される水平方向の二重矢印を[UnitPrice]列が表示されるまで左
にドラッグして、グリッドの最初の列のサイズを変更します。
2. [UnitPrice]列をクリックして、[Column タスク
タスク]メニューを開きます。
69
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
3. [書式設定
書式設定]テキストボックスの横にある省略符号ボタンをクリックして、[書式文字列のダイアログボックス
書式文字列のダイアログボックス]を開きま
す。
4. [書式文字列のダイアログボックス
書式文字列のダイアログボックス]で、[形式の種類
形式の種類]の下にある[通貨
通貨]を選択して、[OK]をクリックします。
5. [プロパティ
プロパティ]ウインドウで、 VisualStyle プロパティを Office2007Blue に設定します。
6. C1FlexGrid タスク メニューを開きます。直前にタスクメニューを使用して列を編集したので、[Column タスク
タスク]メニュー
が表示されます。[C1FlexGrid タスク
タスク]を選択して、C1FlexGrid タスク
タスクメニューに戻ります。
7. [C1FlexGrid タスク
タスク]メニューで、[スタイルエディタ]を選択して、スタイル
スタイルエディタ を開きます。
8. [組み込みスタイル
組み込みスタイル]の下にある[Fixed]を選択します。
9. 右ペインの[Font]ノードを展開して、Bold プロパティを True に設定します。
10. ForeColor プロパティを「Web」タブの CornflowerBlue に設定し、[OK]をクリックしてダイアログボックスを閉じます。
プログラムを実行し、次の点に注目します。
グリッドアプリケーションに書式文字列、C1FlexGridBase.VisualStyle、および組み込みスタイルを使用した[Products]テーブ
ルが表示されます。
70
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
グリッドの書式文字列、C1FlexGridBase.VisualStyle、および組み込みスタイルが正常に設定されました。これでクイックスター
トは終了です。
71
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
設計時のサポート
設計時に Visual Studio のプロパティグリッド、メニュー、デザイナを使用して FlexGrid for WinForms を構成できます。以下
のセクションでは、C1FlexGrid の設計時環境を使用し、C1FlexGrid コントロールを設定する方法について説明します。
エディタ
C1FlexGrid のレイアウトと外観を制御できる設計時エディタとして、列エディタとスタイルエディタ
列エディタとスタイルエディタの2つがあります。さらに、特
定列のキャプションおよび列の外観を変更できる設計時エディタとして、キャプションスタイルと列スタイル
キャプションスタイルと列スタイルの2つがあります。
列エディタ
コードを記述するかわりに、設計時にグリッド列の設定をすることができます。デザイナは、次の3つの方法のいずれかでアク
セスできます。
フォームに貼り付けたグリッドを選択し、プロパティウィンドウの Cols プロパティの隣に表示される省略ボタン(…)をク
リックする
コントロールを右クリックし、コンテキストメニューから列エディタ
列エディタを選択します。
グリッドの右上隅にあるスマートタグ ( ) をクリックし、C1FlexGrid タスク メニューから列エディタ
列エディタを選択します。
以下のような列エディタ
エディタが表示されます。
連結モードでは、DataSource のフィールドの表示や、列のキャプション、幅、表示位置などの設定が行えます。非連結モード
では、列のデータタイプを選択するために同じく使用します。
FlexGrid 列エディタで行える操作は次のとおりです。
列の移動: マウスでヘッダセルを新しい位置へドラッグすることで、列の移動が行えます。
列幅調整: マウスでヘッダセルの右端をドラッグすることで、列幅を変更できます。また、〈Shift〉キーを押しながら他の
72
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ヘッダセルをクリックすることで複数列を選択でき、プロパティウィンドウを用いて同時にセル幅を変更できます。列幅
を-1に設定すると、デフォルトの幅に戻ります。
列プロパティの設定: 1つ以上の列が選択されている場合、エディタの左にあるプロパティグリッドで、選択されている
列のプロパティを確認したり編集が行えます。
列の挿入、または削除: 選択した列の前、または後に新しい列の挿入や(主にアンバウンドモードで有用)、選択した
列を削除するためにツールバーを使用してください。
一般的な操作を行うためのツールバー: 下記はツールバー上のボタンの機能について説明しています。
ボタン
説明
フォント: ドロップダウンリストで選択したフォントを設定します。
フォントサイズ: ドロップダウンリストで選択したフォントサイズを設定します。
フォントの書式設定: フォントに太字、斜体、下線を適用します。
位置揃え: フォントの配置を左、中央、右、標準に設定します。
配置: 列の内容を、上詰め、中央揃え、下詰めに整列させます。これらは、グリッドの列のヘッダ以
外の領域に反映されます。列のヘッダの配置を設定するには、列を選択して、TextAlignFixed プロ
パティを設定してください。
背景色: 選択した列の背景色を設定します。
前景色: 選択した列の前景色を設定します。
固定行を対象とする: 固定行に設定を適用します。
ヘルプ: プロパティグリッドで選択したプロパティの説明を表示するかどうかを決めます。
全ての変更を元に戻す: 変更をすべて取り消し、デフォルトの状態に戻します。
ロード後に列幅を調整: このボタンは、グリッドがデータソースに連結される場合に、データの内容
にあわせてグリッドが自動的にすべての列幅を調整するかどうかを決めます。
データソースから再ロード: 現在のデータソースから取得した情報ですべての列をリセットします。グ
リッドがデータソースに連結され、最初から編集し始めたい場合に、このボタンは有用です。グリッド
がデータソースに連結されない場合、ボタンは無効になります。
列の選択: ドロップダウンリストから設定する列を選択します。
列の挿入: 選択した列の左側、もしくは右側に列を挿入します。これらのボタンはグリッドのみに機
能し、データソースには影響を及ぼしません。
列の削除: 選択した列を削除します。
列幅: 選択しているすべての列の幅を同じ幅に揃えるか、広げるか狭くします。
列の表示/非表示: 列の表示/非表示を切り替えます。
すべての列を表示: すべての列を表示します。
非表示列を表示: 非表示の列を見えるように表示します。列の Visible プロパティをFalseに変更す
ると列は非表示になります。こうすることで、マウスで列を選択できなくなります。それらを選択し編
集することができるように、列をすべて表示するためにはこのボタンを使用してください。
これらのボタンは、プロパティグリッドを制御します。選択した列のプロパティをアルファベット順に表
示するか分類された順に表示するかどうかを決めます。
73
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
スタイルエディタ
必要に応じて、スタイルをコードの記述時ではなく設計時に設定できます。スタイルエディタ
スタイルエディタは、次の3つの方法のいずれかで
アクセスできます。
該当するグリッドを選択し、プロパティウィンドウを開いて Styles プロパティの隣に表示される省略ボタン(…)をクリック
します。
グリッドを右クリックし、コンテキストメニューからスタイル
スタイルエディタを選択します。
グリッドの右上隅にあるスマートタグ ( ) をクリックし、C1FlexGrid タスク メニューからスタイルエディタ
スタイルエディタを選択します。
次のスタイルエディタのダイアログが表示されます。
スタイルエディタを使用すると、既存のスタイル変更や新しいカスタムスタイルを追加して、それらをセル、行、および列に後か
ら設定することができます。
〈追加
追加〉と〈削除
削除〉ボタンは、カスタムスタイルを追加および削除します。リスト内でカスタムスタイルを選択して新しい名前を入力
すると、カスタムスタイルの名前を変更できます。〈クリア
クリア〉ボタンは、すべてのカスタムスタイルを削除して組み込みスタイルを
デフォルト値に戻します。
〈オートフォーマット
オートフォーマット〉ボタンは、定義済みスタイルの完全セットを選択できる2番目のダイアログを表示します。[オートフォー
オートフォー
マット
マット]ダイアログの外観は次のとおりです。
74
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
キャプションスタイルと列スタイル
選択した列のキャプションスタイル
キャプションスタイルエディタと列スタイル
列スタイルエディタを使用し、それぞれ、キャプションテキストと列テキストのプロ
パティ、および配置、背景、境界線を指定できます。
キャプションスタイル
キャプションスタイルエディタと列スタイル
列スタイルエディタは、Column タスク
タスクメニューでのみアクセスできます。Column タスク
タスクメ
ニューの詳細については、「Column タスク」を参照してください。
キャプションスタイル
キャプションスタイルエディタと列スタイル
列スタイルエディタには、「テキスト
テキスト」、「配置
配置」、「背景
背景」、「罫線
罫線」の4つのタブがあります。[プレ
プレ
ビュー
ビュー]領域では、グリッドに適用する前の設定を確認できます。
テキスト
「テキスト
テキスト」タブは、キャプションのフォントと書式を設定します。
75
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
フォント
フォント領域では、次のオプションが使用できます。
フォント名: フォント名を選択します。
サイズ: フォントサイズを選択します。
色: フォント色を選択します。
文字の方向: Normal(標準)、Up(上方向)、Down(下方向)から選択します。
フォントの効果: ボタンを使用し、太字、斜体、下線の ON/OFF を切り替えます。
フォーマット
フォーマット領域では、次のオプションが使用できます。
書式設定: 〈...〉ボタンをクリックし、[書式文字列
書式文字列]ダイアログボックスを開きます。[書式文字列
書式文字列]ダイアログの詳細につ
いては、セルの内容 を参照してください。
入力マスク: 〈...〉ボタンをクリックし、[定型入力
定型入力]ダイアログボックスを開きます。[定型入力
定型入力]ダイアログの詳細につい
ては、マスク . を参照してください。
3D効果:
効果: Flat(フラット)、Raised(浮出し)、Inset(くぼみ)のいずれかを選択します。テキストの効果オプションの詳細
については、TextEffectEnum 列挙体を参照してください。
トリミング: None、Character、Word、EllipsisCharacter、EllipsisWord、EllipsisPath から選択し、長い文字列をセ
ルに合わせてトリミングする方法を設定します。トリミングの詳細については、Visual Studio のヘルプ
「StringTrimming 列挙体(System.Drawing)」 を参照してください。
折り返して全体を表示する: キャプションのワードラップを有効にするには、このボックスを ON にします。
配置
76
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
「配置
配置」タブは、キャプションのテキストと画像の両方の配置を設定します。
文字の配置領域では、次のオプションが使用できます。
横位置: ボタンをクリックし、左揃え、中央揃え、右揃え、標準
左揃え、中央揃え、右揃え、標準を切り替えます。
縦位置: ボタンをクリックし、上揃え、中央揃え、下揃え
上揃え、中央揃え、下揃えを切り替えます。
画像の配置領域では、次のオプションが使用できます。
配置: ボタンをクリックし、セル内の画像配置を切り替えるか、画像のスケール、タイル、ストレッチ、タイルストレッチ
スケール、タイル、ストレッチ、タイルストレッチ、
非表示を切り替えます。画像の配置オプションの詳細については、ImageAlignEnum 列挙体を参照してください。
サンプルイメージの表示: [プレビュー]領域にサンプル画像を表示するには、[サンプルイメージの表示]ボックスを
ON にします。
表示領域では、次のオプションが使用できます。
テキスト
テキスト/画像の間隔:
画像の間隔:この値を増減し、テキストと画像の間の間隔を調整します。
表示方法: TextOnly、ImageOnly、Overlay、Stack、None から選択します。表示方法の詳細については、
DisplayEnum列挙体を参照してください。
77
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
背景
「背景
背景」タブは、背景色と背景画像を設定します。
背景色領域では、次のオプションが使用できます。
色: セルの背景色を選択します。
背景画像領域では、次のオプションが使用できます。
画像: 画像を選択するには〈選択〉ボタンをクリックし、画像を削除するには〈クリア〉ボタンをクリックします。
レイアウト: スケール、タイル、ストレッチ、タイルストレッチ、非表示を切り替えます。
罫線
「罫線
罫線」タブは、罫線と余白を設定します。
78
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
罫線領域では、次のオプションが使用できます。
スタイル: None(なし)、
(なし)、Flat(フラット)、
(フラット)、Double(2重線)、
(2重線)、Raised(浮出し)、
(浮出し)、Inset(くぼみ)、
(くぼみ)、Groove,(溝付き)、
(溝付き)、Fillet
(フィレット)、
(フィレット)、Dotted(点線)
(点線)から選択します。各種の罫線スタイルオプションの詳細については、
C1.Win.C1FlexGrid.BorderStyleEnum Enumeration列挙体を参照してください。
幅: 値を増減し、罫線の幅を調整します。
色: 罫線の色を選択します。
文字の方向: Both(両方向)、
(両方向)、Horizontal(水平方向)、
(水平方向)、Vertical(垂直方向)
(垂直方向)から選択します。各種の罫線の方向オプ
ションの詳細については、BorderDirEnum 列挙体を参照してください。
余白領域では、次のオプションが使用できます。
左: 値を増減し、左余白を調整します。
上: 値を増減し、上余白を調整します。
右: 値を増減し、右余白を調整します。
下: 値を増減し、下余白を調整します。
スマートタグ
スマートタグ()は、各コントロールで通常使用されるプロパティを提供するショートカット[タスク
タスク]メニューを表します。
C1FlexGrid を通じて使用可能なスマートタグには、[C1FlexGrid タスク]メニューと[Column タスク]メニューの2種類のがあ
ります。
79
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1FlexGrid タスク
C1FlexGrid タスク
タスクメニューでは、列エディタ と スタイルエディタ にすばやくアクセス
し、AllowAddNew、AllowDelete、AllowEditing、AllowDragging の各プロパティを設定できます。
C1FlexGrid タスク
タスクメニューにアクセスするには、グリッドの右上隅にあるスマートタグ ( ) をクリックします。C1FlexGrid タス
クメニューが開きます。C1FlexGrid タスク
タスクメニューは以下のように操作します。
データソースの選択
[データソースの選択
データソースの選択]ボックスのドロップダウン矢印をクリックし、使用可能なデータソースのリストを開きます。新しいデータ
ソースを追加できるようになります。プロジェクトに新しいデータソースを追加するには、〈プロジェクトデータソースの追加
プロジェクトデータソースの追加…〉〉を
クリックして[データソース構成ウィザード
データソース構成ウィザード]を開きます。
80
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
プロジェクトに新しいデータソースを追加する方法の詳細については、データソースへの連結 を参照してください。
追加を有効にする
[追加を有効にする
追加を有効にする]チェックボックスを ON にすると、AllowAddNew プロパティが True になり、グリッドに新しい行を追加で
きるようになります。デフォルトは、OFF となっています。
削除を有効にする
[削除を有効にする
削除を有効にする]チェックボックスを ON にすると、AllowDelete プロパティが True になり、グリッドの行を削除できるよう
になります。デフォルトは、OFF となっています。
編集を有効にする
[編集を有効にする
編集を有効にする]チェックボックスを ON にすると、AllowEditing プロパティが True になり、グリッドの行を編集できるよう
になります。デフォルトは、ON となっています。
列の順序変更を有効にする
[列の順序変更を有効にする
列の順序変更を有効にする]チェックボックスを ON にすると、AllowDragging プロパティが True になり、グリッドの列をド
ラッグできるようになります。デフォルトは、ON となっています。
VisualStyle
VisualStyle については、「VisualStyle を使用して外観を変更する」を参照してください。
列エディタ
〈列エディタ…〉をクリックすると、列エディタ を開きます。
81
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
スタイルエディタ
〈スタイルエディタ…〉をクリックすると、スタイルエディタ を開きます。
82
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
.
Column タスク
〈Column タスク
タスク〉をクリックすると、Column タスク メニューが開きます。
C1FlexGridのバージョン情報
のバージョン情報
クリックすると、[C1FlexGrid のバージョン情報
のバージョン情報]ダイアログボックスが開きます。ここで、C1FlexGrid のバージョン番号を見る
ことができます。
親コンテナにドッキング/ドッキング解除
〈親コンテナにドッキングする
親コンテナにドッキングする〉をクリックすると、C1FlexGrid コントロールの Dock プロパティが Fill に設定されます。
C1FlexGrid が親コンテナにドッキングされると、親コンテナから C1FlexGridをドッキング解除するオプションが使用可能にな
ります。〈親コンテナでドッキングを解除する
親コンテナでドッキングを解除する〉をクリックすると、C1FlexGridの Dock プロパティが None に設定されます。
Column タスク
Column タスク
タスクメニューでは、列のキャプション、データフィールド、データ型、入力マスク、書式文字列、列のコンボリストを設
定し、 AllowSorting、AllowEditing、AllowResizing、AllowDragging、AllowMerging、Visible の各プロパティを設定す
ることもできます。
Column タスク
タスクメニューにアクセスするには、グリッドの列をクリックするか、C1FlexGrid タスク メニューから[Column タスク
タスク]
83
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
を選択します。
列キャプション
[列キャプション
列キャプション]ボックスにキャプションを入力すると、列の Captionプロパティが設定されます。
データフィールド
[データフィールド
データフィールド]ボックスのドロップダウン矢印をクリックすると、データソースで使用可能なフィールドのリストが開きます。
データ型
[データ型
データ型]ボックスのドロップダウン矢印をクリックすると、使用可能なデータ型のリストが開きます。
84
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
入力マスク
[入力マスク
入力マスク]ボックスの〈...〉ボタンをクリックすると、[定型入力
定型入力]ダイアログボックスが開きます。
85
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
書式設定
[書式設定
書式設定]ボックスの〈...〉ボタンをクリックすると、[書式文字列
書式文字列]ダイアログボックスが開きます。
コンボリスト
86
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[コンボリスト
コンボリスト]ボックスの〈...〉ボタンをクリックすると、[コンボリスト
コンボリスト]ダイアログボックスが開きます。
ソートを有効にする
[ソートを有効にする
ソートを有効にする]チェックボックスを ON にすると、AllowSorting プロパティが True に設定され、列のソートが可能になり
ます。デフォルトは、ON となっています。
編集を有効にする
[編集を有効にする
編集を有効にする]チェックボックスを ON にすると、AllowEditing プロパティが True に設定され、列の編集が可能になり
ます。デフォルトは、ON となっています。
サイズ変更を有効にする
[サイズ変更を有効にする
サイズ変更を有効にする]チェックボックスを ON にすると、AllowResizing プロパティが True に設定され、列のサイズ変更
が可能になります。デフォルトは、ON となっています。
順序変更を有効にする
[順序変更を有効にする
順序変更を有効にする]チェックボックスを ON にすると、AllowDragging プロパティが True に設定され、グリッドの列のド
ラッグが可能になります。デフォルトは、ON となっています。
マージを有効にする
[マージを有効にする
マージを有効にする]チェックボックスを ON にすると、AllowMerging プロパティが True に設定され、列でのマージが可能
になります。デフォルトは、OFF となっています。
表示
[表示
表示]チェックボックスを ON にすると、Visibleプロパティが True に設定され、列はグリッド内で表示状態になります。デフォ
ルトは、ON となっています。
87
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
キャプションスタイル
〈キャプションスタイル
キャプションスタイル…〉をクリックすると、選択した列のキャプション
キャプションスタイルエディタが開きます。ここで、配置、背景、罫線を
含む、キャプションテキストの各プロパティを指定できます。
列スタイル
〈列スタイル
列スタイル…〉をクリックすると、選択した列の列スタイル
列スタイルエディタが開きます。ここで、テキスト、配置、背景、罫線を含む、列
の各プロパティを指定できます。
88
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1FlexGrid タスク
〈C1FlexGrid タスク
タスク〉をクリックすると、C1FlexGrid タスク メニューに戻ります。
親コンテナにドッキング/ドッキング解除
〈親コンテナにドッキングする
親コンテナにドッキングする〉をクリックすると、C1FlexGrid コントロールの Dock プロパティが Fill に設定されま
す。C1FlexGrid が親コンテナにドッキングされると、親コンテナから C1FlexGrid をドッキング解除するオプションが使用可能
になります。〈親コンテナでドッキングを解除する
親コンテナでドッキングを解除する〉をクリックすると、C1FlexGrid の Dock プロパティが None に設定されます。
89
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
基本操作
基本操作
C1FlexGridコントロールを使用すると、グリッド形式のデータを表示、編集、グループ化、あるいは集計できます。グリッドは
ADO.NETデータソースに連結することも、グリッド独自のデータを管理することもできます。
C1FlexGrid コントロールは、以下の要素で構成された多機能なオブジェクトモデルを用意しています。
90
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
以下の各トピックでは、C1FlexGrid コントロールの主な機能について紹介します。
行と列
グリッドの寸法とレイアウトの設定方法について説明します。
データの取 グリッドへのデータ設定、および取得について説明します。
得と設定
セルの選
91
「カレントセル」と「セル範囲」の概念について説明します。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
択
セルの範
囲
任意のセルグループを単一の単位として使用する方法について説明します。
セルのイ
メージ
セル内に画像を表示する方法について説明します。
セルの
フォーマッ
ト
数値、日付、およびブール値の書式設定、あるいは個々のセルまたは範囲のフォント、色、配置、およびピク
チャの変更により、グリッドの外観をカスタマイズする方法について説明します。
セルの編
集
簡単なテキスト編集、ドロップダウンリストおよびコンボリスト、セルボタン、マスク編集、およびデータ検証を実
装する方法について説明します。
セルの
マージ
グリッドの表示を変更して同じ内容のセルをマージし、データ内での関係をハイライト表示する「グループ化し
た」ビューを作成する方法について説明します。
アウトライ
ンとデータ
の集計
グリッドに小計行を追加し、アウトラインツリーを構築する方法について説明します。
保存とロー グリッドの内容または書式設定を保存し、後で再読み込みしたり、グリッドデータを Microsoft Access および
ド、および Excel などの他のアプリケーションと交換する方法について説明します。このセクションでは、グリッドを印刷す
印刷
る方法についても説明します。.
プロパティ
グループ
主要な C1FlexGridプロパティ一覧。機能別に相互参照可能.
行と列
C1FlexGrid コントロールは、行と列で構成されます。行および列の各コレクションは、Rows プロパティと Colsプロパティに
よって提供されます。
グリッドをデータソースに連結する場合、行および列の数はデータソースで使用できるデータ量によって決まります。非連結
モードでは、コレクション内で Count プロパティを使用し、それらを任意の値に設定できます。たとえば、次のコードでは、グ
リッドの行数と列数を、500行と10列に設定します。
Visual Basic コードの書き方
Visual Basic
_flex.Rows.Count = 500
_flex.Cols.Count = 10
C# コードの書き方
C#
_flex.Rows.Count = 500;
_flex.Cols.Count = 10;
行と列には、「固定
固定」と「スクロール可能
スクロール可能」の2つの基本タイプがあります(Count プロパティが返すカウントは、固定セルおよび
スクロール可能なセルの数を含みます)。固定行は、ユーザーがグリッドを垂直方向にスクロールしても常にグリッドの一番上
に、固定列は、ユーザーがグリッドを水平方向にスクロールしても常にグリッドの左端に表示されます。この他にも、行と列に
はスクロールされませんが、編集が可能な「静止」タイプ(Frozen プロパティ)があります。
92
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
固定セルは、行や列のヘッダ情報を表示する場合に便利です。
Rows および Cols コレクションの RowColCollection.Fixed プロパティを使用すると、固定の行および列の数を設定できま
す。たとえば、次のコードは固定行および非固定列を持ったグリッドを作成します。
Visual Basic コードの書き方
Visual Basic
_flex.Rows.Fixed = 1
_flex.Cols.Fixed = 0
C# コードの書き方
C#
_flex.Rows.Fixed = 1;
_flex.Cols.Fixed = 0;
また、Rows および Cols コレクションには、グリッド上で行や列を挿入、削除、および移動するメソッドも含まれます。 Item プ
ロパティ(インデクサ)を使用すると、各コレクションの個々の要素(行と列)にアクセスできます。
コードではなく、設計時に 列エディタ を使用して列に関するさまざまな設定することもできます。列エディタを使用して列の設
定を行う方法の詳細については、「列エディタ」を参照してください.
列のサイズ変更
列の幅は、その Width プロパティで指定します。設計時に、Width プロパティは、グリッド内で直接設定することも、列エディ
列エディ
タから設定することもできます。デザイン画面で変更する場合、列ヘッダの右端に表示される水平方向の二重矢印をクリックし
てドラッグすると、列のサイズを変更できます。
93
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
点線の垂直線は、グリッドのサイズがどのように変更されるかを示します。ポインタを左にドラッグすると、列のサイズは小さく
なり、右にドラッグすると列のサイズは大きくなります。列の Width プロパティは、サイズ変更操作が完了したときに調整され
ます。
列エディタまたはコードによって、列の Width プロパティを指定します。列エディタの詳細については、列エディタ を参照してく
ださい。次のコードは、列の Width プロパティを 10 に設定します。
Visual Basic コードの書き方
Visual Basic
_flex.Cols(1).Width = 10
C# コードの書き方
C#
_flex.Cols(1).Width = 10
特定の列のサイズ変更を禁止するには、Column タスク
タスクメニュー、列エディタ、コードのいずれかを使用し、列の
AllowResizing プロパティを False に設定します。Column タスクメニューの詳細については、Column タスク を参照してくだ
さい。次のコードは、Column1 の AllowResizing プロパティを False に設定します。
Visual Basic コードの書き方
Visual Basic
_flex.Cols(1).AllowResizing = False
C# コードの書き方
C#
_flex.Cols(1).AllowResizing = False
セルの選択
グリッドはカレントセル
カレントセルを持っています。グリッドがアクティブの間、カレントセルの周囲にはフォーカス長方形が表示されます。ユーザーはキーボードやマウスでカー
ソルを移動し、グリッドが編集可能であればセルの内容を編集できます。
94
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Office の視覚スタイルが、カーソルセルの位置の行および列ヘッダーをハイライトして、カーソルのロケーションも表します。VisualStyle の設定については、
「VisualStyle を使用して外観を変更する」を参照してください。
Row および Col プロパティを使用して、カレントセルをコードで取得または設定することができます。これらのプロパティのいずれかを –1 に設定すると、カーソルが
非表示になります。
グリッドは、拡張セル選択をサポートしています。これは、2つの対角(カレントセルと、セル選択セル
カレントセルと、セル選択セル)によって定義されるセルの長方形範囲です。セル範囲をコード
によって取得または設定するには、RowSel と ColSel プロパティを使用します。あるいは、Selection プロパティを使用し、セル範囲を設定することもできます。
注意:
注意:カレントセルを変更すると、セル範囲が自動的にリセットされます。コーディングによって拡張セル範囲を作成するには、RowSel と ColSel の前に Row
と Col を設定するか、Select メソッドを使用します。
セル範囲の外観は、次の各プロパティが制御します。
FocusRect カレントセルを表示するために描画されるフォーカス長方形の種類を決定します。
HighLight deセル範囲をハイライト表示するタイミング(常に、コントロールにフォーカスを持つときと、持たないときはハイライト表示しない)を指定します。
HighLight と Focus これは、セル範囲の外観(フォント、色、ボーダー)を指定するセルスタイルです。
使用可能なセル範囲の種類は、SelectionMode プロパティで決定します。デフォルトでは、グリッドは通常のセル範囲をサポートします。この動作を変更して拡張セ
ル範囲ができないようにすると、行や列ごと、あるいはリストボックスモードで選択できます(リストボックスモードでは個々の行を選択できます)。
リストボックスモードを使用した場合、Selected プロパティを使用して、個々の行のセル範囲状態を取得または設定できます。あるいは、Selected プロパティを使用
して、選択した行のコレクションを取得することもできます。たとえば、次のコードでは一定の条件を満たすすべての行を選択します。
Visual Basic コードの書き方
Visual Basic
' Sales列が8000以上の行をすべて選択します
_flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox
Dim index As Integer
For index = _flex.Rows.Fixed To _flex.Rows.Count - 1
If Val(_flex(index, "Sales")) > 80000 Then
_flex.Rows(index).Selected = True
End If
Next
Console.WriteLine("There are now {0} rows selected", _flex.Rows.Selected.Count)
C# コードの書き方
C#
// Sales列が8000以上の行をすべて選択します
_flex.SelectionMode = SelectionModeEnum.ListBox;
for (int index = _flex.Rows.Fixed ; index < _flex.Rows.Count; index++)
{
if
(Microsoft.VisualBasic.Conversion.Val(System.Runtime.CompilerServices.RuntimeHelpers.GetObjectValue(_flex[index,
"Sales"])) > 80000)
{
_flex.Rows[index].Selected = true;
}
}
95
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Console.WriteLine("There are now {0} rows selected", _flex.Rows.Selected.Count);
セルの範囲
CellRange オブジェクトでは、任意のセルグループを単一の単位として操作できます。たとえば、次のサンプルコードは
CellRange オブジェクトを作成し、範囲内のデータをクリアし、それにカスタムスタイルを設定します。
Visual Basic コードの書き方
Visual Basic
Dim rg As CellRange = _flex.GetCellRange(3, 3, 10, 10)
rg.Data = Nothing
rg.Style = _flex.Styles("MyRangeStyle")
C# コードの書き方
C#
CellRange rg = _flex.GetCellRange(3, 3, 10, 10);
rg.Data = null;
rg.Style = _flex.Styles["MyRangeStyle"];
CellRange オブジェクトは、StyleNew プロパティを持っています。このプロパティは、既存の範囲スタイルが存在すればそれ
を取得します。存在しない場合は、新しい範囲スタイルを作成し、それに範囲を設定して返します。このプロパティは、書式設
定するときにフル装備の制御を必要としない場合に便利です。たとえば、指定範囲に赤い背景色を指定するだけであれば、次
のように記述できます。
Visual Basic コードの書き方
Visual Basic
Dim rg As CellRange = _flex.GetCellRange(3, 3, 10, 10)
rg.StyleNew.BackColor = Color.Red
C# コードの書き方
C#
CellRange rg = _flex.GetCellRange(3, 3, 10, 10);
rg.StyleNew.BackColor = Color.Red;
セルのイメージ
各グリッドセルは、セル内に格納されているデータのほか、画像も表示できます。これは、次の2つの方法で行うことができま
す。
SetCellImage メソッドを使用して Image オブジェクトをセルに設定する方法。このメソッドを使用すると、任意のイメー
ジを各セルに設定することができるため、イメージがセルのデータに関連付けられていない場合に便利です。たとえ
ば、ピクチャをセルのデータが無効である場合のインジケータとして使用できます。
ImageMapプロパティを列に設定する方法。グリッドは、自動的にセルデータを関連付けられているイメージにマッピン
グします。このメソッドは、イメージにデータの絵などの表現が含まれている場合に便利です。たとえば、イメージは、製
品の種類を表すアイコンを含むことができます。
96
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セルのフォーマット
C1FlexGrid コントロールの主なパワフルな機能の1つは、グリッド全体と個々のセルの外観のほとんどあらゆる要素をカスタ
マイズできる点です。
セルの内容
セルの内容を書式設定する方法を制御するには、Format プロパティを .NET Framework の String.Format メソッドで使用
するのと同じ書式文字列に設定します。たとえば、次のコードは列1に short date (短い日付)、列2に Currency (通貨)の値
を示しています。
Visual Basic コードの書き方
Visual Basic
' Short date (短い日付)
_flex.Cols(1).Format = "d"
' Currency (通貨)
_flex.Cols(2).Format = "c"
C# コードの書き方
C#
// Short date (短い日付)
_flex.Cols[1].Format = "d";
// Currency (通貨)
_flex.Cols[2].Format = "c";
セルの内容の書式設定は、設計時に[書式文字列
書式文字列]ダイアログボックスを使用して設定することもできます。
97
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[書式文字列
書式文字列]ダイアログボックスは、Column タスク メニューまたは列エディタ からアクセスできます。
Column タスク メニューで、[書式設定
書式設定]ボックスの〈...〉ボタンをクリックします。
列エディタ で、左ペインの Format プロパティを探し、その横の〈...〉ボタンをクリックします。
注意:
注意:[書式文字列
書式文字列]ダイアログボックスは列固有で、選択した列の Format プロパティのみを変更します。
Visual Basic の Format 関数で使用するようなカスタム書式("#,###"、など)も使用できます。
セルデータの取得
インデクサまたは GetData メソッドを使用して、グリッドのデータ自体を取得できます。書式設定したデータを取得するに
は、GetDataDisplayメソッドを使用します。たとえば、次のようになります。
Visual Basic コードの書き方
Visual Basic
' Short date (短い日付)
_flex.Cols(1).Format = "d"
' Currency (通貨)
_flex.Cols(2).Format = "c"
_flex(1, 2) = 10000
Console.WriteLine("Raw value: {0}", _flex(1, 2))
Console.WriteLine("Display value: {0}", _flex.GetDataDisplay(1, 2))
' Raw value: 10000
' Display value: $10,000.00
98
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
// Short date (短い日付)
_flex.Cols[1].Format = "d";
// Currency (通貨)
_flex.Cols[2].Format = "c";
_flex[1, 2] = 10000;
Console.WriteLine("Raw value: {0}", _flex[1, 2]);
Console.WriteLine("Display value: {0}", _flex.GetDataDisplay(1, 2));
// Raw value: 10000
// Display value: $10,000.00
セルの外観
セルの外観(配置、フォント、色、ボーダーなど)は、CellStyle オブジェクトで処理します。グリッドには Stylesプロパティがあ
り、このプロパティにグリッドの書式設定に使用するスタイルのコレクションが格納されています。このコレクションは、グリッド
要素(固定セル、スクロール可能セル、セル範囲、フォーカスセルなど)の外観を定義する組み込みメンバを持っています。こ
れらのスタイルを変更し、グリッドの外観を変更できます。また、独自のカスタムスタイルを作成し、セル、行、または列に設定
することができます。
グリッドの外観を変更する最も簡単な方法は、組み込みスタイルを変更することです。たとえば、次のサンプルコードは、範囲
指定したセルを赤い背景に緑のボールド文字で表示します。
Visual Basic コードの書き方
Visual Basic
Dim cs As CellStyle = _flex.Styles.Highlight
cs.Font = New Font(_flex.Font, FontStyle.Bold)
cs.ForeColor = Color.Green
cs.BackColor = Color.Red
C# コードの書き方
C#
CellStyle cs = _flex.Styles.Highlight;
cs.Font = new Font(_flex.Font, FontStyle.Bold);
cs.ForeColor = Color.Green;
cs.BackColor = Color.Red;
あるいは、独自のスタイルを作成して、セル、行、および列に設定することもできます。たとえば、次のサンプルコードは、カスタ
ムのセルスタイルを作成して、それを5行ごとに指定します。
Visual Basic コードの書き方
Visual Basic
Dim cs As CellStyle = _flex.Styles.Add("Fifth")
cs.BackColor = Color.Gray
Dim idex%
99
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
For idex = _flex.Rows.Fixed To _flex.Rows.Count - 1 Step 5
_flex.Rows(idex).Style = cs
Next
C# コードの書き方
C#
CellStyle cs = _flex.Styles.Add("Fifth");
cs.BackColor = Color.Gray;
for (int index = _flex.Rows.Fixed ; index <= _flex.Rows.Count - 1; index += 5)
{
_flex.Rows[index].Style = cs;
}
カスタムスタイルを作成して、それらを列、行、およびセル範囲に割り当てるには、次のように記述します。
Visual Basic コードの書き方
Visual Basic
' 新しいカスタムスタイルを作成します。
Dim s As CellStyle = _flex.Styles.Add("MyStyle")
s.BackColor = Color.Red
s.ForeColor = Color.White
' 列に新しいカスタムスタイルを適用します。
_flex.Cols(3).Style = _flex.Styles("MyStyle")
' 行に新しいカスタムスタイルを適用します。
_flex.Rows(3).Style = _flex.Styles("MyStyle")
' セル範囲に新しいカスタムスタイルを適用します。
Dim rg As CellRange = _flex.GetCellRange(4, 4, 6, 6)
rg.Style = _flex.Styles("MyStyle")
C# コードの書き方
C#
/// 新しいカスタムスタイルを作成します。
CellStyle s = _flex.Styles.Add("MyStyle");
s.BackColor = Color.Red;
s.ForeColor = Color.White;
/// 列に新しいカスタムスタイルを適用します。
_flex.Cols[3].Style = _flex.Styles["MyStyle"];
// 行に新しいカスタムスタイルを適用します。
_flex.Rows[3].Style = _flex.Styles["MyStyle"];
// セル範囲に新しいカスタムスタイルを適用します。
CellRange rg = _flex.GetCellRange(4,4,6,6);
rg.Style = _flex.Styles["MyStyle"];
100
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コードではなく、設計時にスタイルエディタ
スタイルエディタを使用してスタイルを設定することもできます。スタイルエディタ
スタイルエディタを使用してセルの外
観を設定する方法の詳細については、「スタイルエディタ」を参照してください。
条件付きの書式設定
セルをその内容に基づいて書式設定するには、CellChangedイベントを使用して、内容に基づいたセルスタイルを選択しま
す。たとえば、次のサンプルコードは、新しいスタイルを作成し、それをセルの内容に基づいてセルに適用します。
Visual Basic コードの書き方
Visual Basic
Dim cs As C1.Win.C1FlexGrid.CellStyle
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 大きな値の場合に設定するカスタムスタイルを作成します
cs = _flex.Styles.Add("LargeValue")
cs.Font = New Font(Font, FontStyle.Italic)
cs.BackColor = Color.Gold
End Sub
' 内容によってスタイルを設定します
Private Sub _flex_CellChanged(ByVal sender As Object, ByVal e As RowColEventArgs)
Handles _flex.CellChanged
' 50,000より大きい場合スタイルを設定します
'(それ以外の場合、スタイルには Nothing が設定されます)
Dim cs As CellStyle
If _flex(e.Row, e.Col).ToString >= 50000 Then
cs = _flex.Styles("LargeValue")
_flex.SetCellStyle(e.Row, e.Col, cs)
End If
End Sub
C# コードの書き方
C#
CellStyle cs;
private void Form1_Load(object sender, EventArgs e)
{
// 大きな値の場合に設定するカスタムスタイルを作成します
cs = _flex.Styles.Add("LargeValue");
cs.Font = new Font(Font, FontStyle.Italic);
cs.BackColor = Color.Gold;
}
// 内容によってスタイルを設定します
private void _flex_CellChanged( object sender, RowColEventArgs e)
{
101
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 50,000より大きい場合スタイルを設定します
'(それ以外の場合、スタイルには Null が設定されます)
if (Microsoft.VisualBasic.CompilerServices.Conversions.ToDouble(_flex[e.Row,
e.Col].ToString()) >= 50000)
{
cs = _flex.Styles["LargeValue"];
_flex.SetCellStyle(e.Row, e.Col, cs);
}
}
オーナー描画セル
CellStyleオブジェクトがセルの外観(背景および前景色、配置、フォント、マージン、ボーダーなど)の多くを制御している場合
でも、それだけでは十分ではないことがあります。グラデーションの背景を使用したり、カスタムグラフィックを直接セルに描画
したい場合があります。こうした場合には、 DrawModeプロパティと OwnerDrawCell イベント使用すると、各セルの描画方
法を完全に制御できます。
DrawMode プロパティは、OwnerDrawCell イベントを発生させるかどうかを決定します。このイベントを使用すると、セルの
あらゆる視覚的な外観を変更できます。OwnerDrawCellイベントの引数を使用すると、表示データやデータの表示に使用す
るスタイルを変更できます。また、完全に継承したり、希望のものはすべてセルに描画できます。
イベントハンドラ内の e.Text と e.Image の各引数を設定すると、セルに表示するテキストとイメージを変更できます。ま
た、e.Style プロパティを設定すると、セルの表示に使用するスタイルも変更できます。
Style 引数のプロパティは変更できないことに注意してください。変更すると他のセルに影響する場合があるからです。代わり
に、新しい CellStyle オブジェクトを Style 引数に割り当てます。たとえば、e.Style.ForeColor = Color.Red を設定する代わ
りに、e.Style = _flex.Styles["RedStyle"] を使用してまったく新しいスタイルをこの引数に割り当てます。
また、独自の描画コードを使用してセルに描画することも、カスタムコードを e.DrawCell メソッドへの呼び出しと組み合わせる
ことさえできます。たとえば、GDI呼び出しを使用してセルの背景を描画して、次に、e.DrawCell を呼び出してセルのボーダー
や内容を表示できます。
注意:
注意:上級の OwnerDraw コードの例については、製品付属の「RtfGrid サンプル」を参照してください。
次のサンプルコードでその一例を示します。グラデーションブラシを使用して、選択したセルの背景を描画します。まず、コード
では次のように DrawMode プロパティの指定と LinearGradientBrush オブジェクトの宣言をし、グリッドがリサイズされるた
びにブラシを更新します。
Visual Basic コードの書き方
Visual Basic
Dim m_GradientBrush As System.Drawing.Drawing2D.LinearGradientBrush
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' オーナー描画セルで使用するブラシを定義します
m_GradientBrush = New
System.Drawing.Drawing2D.LinearGradientBrush(ClientRectangle, Color.SteelBlue,
Color.White, 45)
' グラデーションを行うためにオーナー描画を使用します
_flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
102
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Private Sub _flex_Resize(ByVal sender As Object, ByVal e As System.EventArgs) Handles
_flex.Resize
' コントロールのリサイズ時にグラデーションブラシを更新します
m_GradientBrush = New
System.Drawing.Drawing2D.LinearGradientBrush(ClientRectangle, Color.SteelBlue,
Color.White, 45)
End Sub
C# コードの書き方
C#
System.Drawing.Drawing2D.LinearGradientBrush m_GradientBrush;
private void Form1_Load(object sender, EventArgs e)
{
// オーナー描画セルで使用するブラシを定義します
m_GradientBrush = new
System.Drawing.Drawing2D.LinearGradientBrush(ClientRectangle, Color.SteelBlue,
Color.White, 45);
//グラデーションを行うためにオーナー描画を使用します
_flex.DrawMode = DrawModeEnum.OwnerDraw;
}
private void _flex_Resize( object sender, System.EventArgs e)
{
// コントロールのリサイズ時にグラデーションブラシを更新します
m_GradientBrush = new
System.Drawing.Drawing2D.LinearGradientBrush(ClientRectangle, Color.SteelBlue,
Color.White, 45);
}
次に、OwnerDrawCell イベントを処理し、カスタムブラシを使用してセルの背景を描画します。次のサンプルコードでは、前
景はグリッド自身がイベント引数内で DrawCell メソッドを使用して処理します。
Visual Basic コードの書き方
Visual Basic
Private Sub _flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles _flex.OwnerDrawCell
' 選択セルの背景にグラデーションブラシを使用して描画します
If _flex.Selection.Contains(e.Row, e.Col) Then
' 背景を描画します
e.Graphics.FillRectangle(m_GradientBrush, e.Bounds)
' セルの内容を描画します
e.DrawCell(C1.Win.C1FlexGrid.DrawCellFlags.Content)
103
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' セル描画の終了
e.Handled = True
End If
End Sub
C# コードの書き方
C#
private void _flex_OwnerDrawCell( object sender, OwnerDrawCellEventArgs e)
{
// 選択セルの背景にグラデーションブラシを使用して描画します
if (_flex.Selection.Contains(e.Row, e.Col))
{
// 背景を描画します
e.Graphics.FillRectangle(m_GradientBrush, e.Bounds);
// セルの内容を描画します
e.DrawCell(DrawCellFlags.Content);
// セル描画の終了
e.Handled = true;
}
}
セルの編集
デフォルトでは、C1FlexGrid コントロールのセルにユーザーが入力して編集できます。ユーザーがグリッドを編集できないよう
にするには、AllowEditing プロパティを False に設定します。特定列をユーザーが編集できないようにするに
は、AllowEditing プロパティを False に設定します。特定行をユーザーが編集できないようにするには、AllowEditing プロ
パティを False に設定します(グリッドがデータソースに連結している場合、どの列が編集可能であるかを検出して自動的に
AllowEditing プロパティが設定されます)。
セルの編集を開始するには、次の方法のどれかを使用できます。
セルに直接入力。入力すると、セルの内容は入れ替わります。
[F2]キーまたは[Enter]キーを押す。すると、グリッドは編集モードになり、カレントセルの内容が編集できます。
セルをダブルクリック。これは[F2]キーを押した場合と同じことになりますが、クリックした場所の近くから入力が行われ
ます。
基本編集モードを使用すると、ユーザーはセルに値を入力できます。編集中の列に、特定のデータ型が設定されている場合、
ユーザーが入力した値は自動的に適切なデータ型に変換されます。適切なデータ型に変換できない値をユーザーが入力した
場合、グリッドは GridError イベントを発生させてユーザーによる編集は無視します。
多くのアプリケーションでは、基本編集機能で十分間に合いますが、C1FlexGrid では、編集プロセスを制御できるプロパティ
やイベントを装備しており、選択範囲リスト、エディットボタン、高度な正当性検査の制御が行えます。Ver.2.0から
は、C1FlexGrid には外部エディタのサポートも組み込まれました。これにより、任意のコントロールをグリッドエディタとして使
用できます(たとえば、C1Input コントロールをグリッドエディタとして使用できるようになりした)。これらの機能を以下に説明し
ます。
リストボックスとコンボボックス
多くのアプリケーションでは、セルは使用可能な値を定義したリストを持っています。このような場合、ユーザーに値をドロップ
ドロップ
104
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ダウンリスト
ダウンリストから選択させることができます。これを行うには、各選択肢をパイプ文字("|")で区切った文字列
(例:"True|False|Don't know"など)を作成して、それを C1FlexGrid の ComboList プロパティやC1FlexGridBase.Cols
(Index).RowCol.ComboList プロパティに設定します。C1FlexGridBase.Cols(Index).RowCol.ComboList プロパティに設定す
ると、列ごとに異なるリストを持つことができます。これらの ComboList プロパティを設定すると、セルの横にドロップダウンが
表示されます。リストボックス、コンボボックスをクリックするか、または[F2]キーを押すと、そのセルで使用できる選択肢のリス
トが表示されます。
さらに通常、セルは共通値のリストを持っていますが、もちろんユーザーは別の値を入力することもできます。入力は、テキスト
ボックスとドロップダウンリスト
ドロップダウンリストを組み合わせたドロップダウンコンボボックスを使用して行います。コンボボックスを作成するに
は、パイプ文字("|")で区切った選択肢のリスト(例:"|True|False|Don't know")を開き、それを前と同様に C1FlexGridの
ComboList プロパティや RowCol.ComboList プロパティに設定します。
たとえば、次のサンプルコードでは、グリッドは列1に色の名前を含むドロップダウンコンボリスト、および列2にドロップダウン
コンボボックスを表示します。列1を編集するとき、ユーザーはリストから値を選択する必要があります。列2を編集するとき、
ユーザーは、値を選択することも別の値を入力することもできます。
Visual Basic コードの書き方
Visual Basic
' ドロップダウンリスト
_flex.Cols(1).ComboList = "赤|緑|青|黄
' ドロップダウンコンボ
_flex.Cols(2).ComboList = " |赤|緑|青|黄
C# コードの書き方
C#
//ドロップダウンリスト
flex.Cols[1].ComboList = "赤|緑|青|黄
//ドロップダウンコンボ
_flex.Cols[2].ComboList = "|赤|緑|青|黄
RowCol.ComboList プロパティは、設計時に[コンボリスト
コンボリスト]ダイアログボックスを使用して設定することもできます。[コンボリ
スト]ダイアログボックスでは、リストを[ドロップダウンリスト
ドロップダウンリスト]、[ドロップダウンコンボ
ドロップダウンコンボ]、[セルボタン
セルボタン]、[セルボタン(入力可
セルボタン(入力可)]
のいずれで表示するかを選択できます。
105
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[コンボリスト
コンボリスト]ダイアログボックスは、Column タスク メニューまたは 列エディタ からアクセスできます。
Column タスク
タスクメニューで、[コンボリスト
コンボリスト]ボックスの〈...〉ボタンをクリックします。
列エディタ
列エディタで、左ペインの RowCol.ComboList プロパティを探し、その横の〈〈...〉〉ボタンをクリックします。
注意:
注意:[コンボリスト]ダイアログボックスは列固有で、選択した列の RowCol.ComboList プロパティのみを変更し
ます。
同じ列であっても、セルごとに異なるリストを設定したい場合もあります。たとえば、行1にはプロパティリストを表示し、行2には
その値を表示させたい場合です。この場合、行2の値は行1で選択されたプロパティに依存するため、有効な選択肢は行ごと
に変わります。このような場合には、BeforeEdit イベントをトラップし、このイベント内で Column オブジェクトの ComboList
プロパティをカレントセルの適切なリストに指定する必要があります。C1FlexGrid の ComboList プロパティはグリッド全体に
適用されます。
組み込みコンボボックスは、デフォルトで自動検索機能を提供します。ユーザーが値を入力すると、選択は次に一致するところ
へ移動します。EditOptions プロパティを使用してこの機能を無効にし、AutoSearchDelay プロパティを使用してグリッドが
自動検索バッファをリセットするまでの時間を制御できます。
また、組み込みコンボボックスは Visual Studio プロパティウィンドウのエディタのような自動循環機能も備えています。関連付
けられたリストを持つセルをダブルクリックすると、グリッドは自動的に次の値を選択します。EditOptions プロパティを使用し
てこの機能を無効にすることもできます。
チェックボックス
デフォルトでは、グリッドはブール型の列(列タイプは Column オブジェクトの DataTypeプロパティで指定)の値をチェック
ボックスとして表示します。ブール値をチェックボックスとして表示したくない場合、列の Format プロパティを True/False 値
で表示する値を含む文字列に設定します。たとえば、次のようになります。
Visual Basic コードの書き方
Visual Basic
_flex.Cols["bools"].Format = "Yes;No"
C# コードの書き方
C#
106
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
_flex.Cols["bools"].Format = "Yes;No";
非連結モードでは、 SetCellCheck メソッド(GetCellCheckメソッド)を使用して、チェックボックスを任意のセルに追加(取得)
できます。チェックボックスは、セル内のテキストと並べて表示されます。列の RowCol.ImageAlign プロパティを使用すると、
配置を指定できます。
チェックボックスには、2値式(ブール型)と3値式の2つの種類があります。ブール型のチェックボックスで
は、CheckEnum.Checked と CheckEnum.Unchecked 状態が切り替わります。3値式チェックボックスでは、
、
CheckEnum.TSChecked、CheckEnum.TSUnchecked、および CheckEnum.TSGrayed の設定値が順に設定されます(参
照:CheckEnum)。
セルがチェックボックスを持ち、AllowEditing プロパティが True に設定されている場合、チェックボックスの状態を変更する
には、マウスでチェックボックスをクリックするか、[スペース]キーまたは[Enter]キーを押します。
デフォルトでは、マウスまたはキーボードでチェックボックスの値を切り替えると、選択されているすべてのチェックボックスの値
が切り替わります。EditOptions プロパティを使用してこの機能を無効にできます。
マップリスト
「リストボックスとコンボボックス」で説明した Combolist プロパティや Column オブジェクトの RowCol.ComboList プロパティ
によって、セル値は確実にリストから選択されます。ユーザーが選択した値は、列に適合した型に変換され、あたかもユー
ザーが入力したようにグリッドに格納されます。
多くの場合、セルは定義済みリストから値を取得できますが、実際の値に即したユーザーフレンドリな値の表示が要求されま
す。たとえば、列に製品コードが含まれている場合、コードは保存しておき、表示は製品名にしたいことがあります。
このようにするには、RowCol.ComboList プロパティを使用します。このプロパティには、IDictionary オブジェクトへの参照を
含みます。IDictionary オブジェクトは、グリッド内に格納したものとユーザー側に表示されるものとの間のマッピングを確立し
ます(IDictionary インタフェースは System.Collections 名前空間で定義され、特に Hashtable クラスによって実装されます)。
たとえば、次のサンプルコードは、色の値と名前を含むデータマップを作成します。色の値はグリッドに格納され、ユーザーに
は名前が表示されます。
Visual Basic コードの書き方
Visual Basic
Dim dtMap As Hashtable = New Hashtable()
dtMap.Add(Color.Red, "りんごの赤")
dtMap.Add(Color.Green, "森林の緑")
dtMap.Add(Color.Blue, "空の青")
dtMap.Add(Color.Black, "石炭の黒")
dtMap.Add(Color.White, "雪の白")
flex.Cols(1).DataType = GetType(Color)
flex.Cols(1).DataMap = dtMap
C#コードの書き方
Visual Basic
Hashtable Hashtable dtMap = new Hashtable();
dtMap.Add(Color.Red, "りんごの赤");
dtMap.Add(Color.Green, "森林の緑");
dtMap.Add(Color.Blue, "空の青");
dtMap.Add(Color.Black, "石炭の黒");
dtMap.Add(Color.White, "雪の白");
flex.Cols[1].DataType = typeof(Color);
flex.Cols[1].DataMap = dtMap;
107
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
IDictionary を実装しているクラスは、DataMap として使用できます。たとえば、Hashtable、ListDictionary、および
SortedList です。これらのクラスはすべて、有効なデータマップを提供します。相違点は、それらのクラスが編集可能な列内で
使用されるときドロップダウンリスト内の各項目の順序がクラスによって異なることです。
SortedList クラスは、キーで項目をソートします。Hashtable は、任意の順序を使用します。ListDictionary は、項目がリスト
に追加された順序を維持します。このため、ListDictionary が通常、DataMaps の最適な選択肢となります。
データマップ内のキーは、編集対象のセルと同じ型でなければならないことに注意してください。たとえば、列が短整数(Int16)
を含む場合、この列に関連付けられているデータマップは短整数型のキーである必要があります。正規の整数(Int32)をキー
として使用すると機能しません。
次のサンプルコードはその違いを示します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' キーで項目をソート
Dim sl As New SortedList()
sl.Add("0", "Zero")
sl.Add("1", "One")
sl.Add("2", "Two")
sl.Add("3", "Three")
' リストに追加された順序を維持
Dim ld As New ListDictionary()
ld.Add(0, "Zero")
ld.Add(1, "One")
ld.Add(2, "Two")
ld.Add(3, "Three")
' 任意の順序
Dim ht As New Hashtable()
ht.Add(0, "Zero")
ht.Add(1, "One")
ht.Add(2, "Two")
ht.Add(3, "Three")
flex.Cols(1).DataMap = sl
flex.Cols(1).Caption = "SortedList"
flex.Cols(2).DataMap = ld
flex.Cols(2).Caption = "ListDictionary"
flex.Cols(3).DataMap = ht
flex.Cols(3).Caption = "HashTable"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, System.EventArgs e);
{
// キーで項目をソート
SortedList sl = new SortedList();
sl.Add("0", "Zero");
sl.Add("1", "One");
sl.Add("2", "Two");
108
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
sl.Add("3", "Three");
// リストに追加された順序を維持
ListDictionary ld = new ListDictionary();
ld.Add(0, "Zero");
ld.Add(1, "One");
ld.Add(2, "Two");
ld.Add(3, "Three");
// 任意の順序
Hashtable ht = new Hashtable();
ht.Add(0, "Zero");
ht.Add(1, "One");
ht.Add(2, "Two");
ht.Add(3, "Three");
flex.Cols[1].DataMap = sl;
flex.Cols[1].Caption = "SortedList";
flex.Cols[2].DataMap = ld;
flex.Cols[2].Caption = "ListDictionary";
flex.Cols[3].DataMap = ht;
flex.Cols[3].Caption = "HashTable";
}
さらに、列の DataType プロパティに列挙体を設定すると、グリッドは、各列挙値と名前とのデータマップを自動的に構築して
使用します。たとえば、次のサンプルコードは地域から成る列挙を作成します。地域の値はグリッドに格納され、ユーザーには
地域名が表示されます。
Visual Basic コードの書き方
Visual Basic
Private Enum Countries
NewYork
Chicago
NewOrleans
London
Paris
End Enum
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Cols(1).DataType = GetType(Countries)
End Sub
C# コードの書き方
C#
private enum Countries
{
NewYork;
Chicago;
NewOrleans;
London;
Paris;
}
private void Form1_Load(object sender, EventArgs e)
{
109
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Cols[1].DataType = typeof(Countries);
}
セルボタン
セルの種類によっては、テキストボックスまたはドロップダウン以外の高機能のエディタが必要な場合もあります。たとえば、列
にファイル名や色が含まれていると、ダイアログボックスを使用して編集する必要があります。
こうした場合、ComboList プロパティに省略符号("…")を設定します。そうすると、コントロールはセルの横にボタンを表示し、
これをユーザーがクリックすると CellButtonClick イベントを発生させます。イベントをトラップしてダイアログを表示させ、ユー
ザーが選択した値でセルの内容を更新できます。
また、省略符号("…")の前にパイプ文字(|)を追加すると、ユーザーはボタンが表示されたセルに入力して、セルの内容を編集
できるようになります。
デフォルトでは、セルボタンに省略符号("…")が表示されます。CellButtonImage プロパティを使用すると、セルボタンにピク
チャを設定することができます。
次のサンプルコードは、セルボタンを使用して列を編集する方法を示しています。
Visual Basic コードの書き方
Visual Basic
' 列を設定します。
Dim c As C1.Win.C1FlexGrid.Column = _flex.Cols(1)
c.DataType = GetType(Color)
c.ComboList = "..." ' << セルボタンを表示
c.ComboList = "..."
C# コードの書
C#
' 列を設定します。
Column c = _flex.Cols[1];
c.DataType = typeof(Color);
c.ComboList = "...";
c.ComboList = "...";
// << セルボタンを表示
そして次のサンプルコードでは、セルボタンのクリックを処理します。ユーザーがセルボタンをクリックし、カラーダイアログボッ
クスから色を選択できるようにしています。
Visual Basic コードの書き方
Visual Basic
Private Sub _flex_CellButtonClick(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles _flex.CellButtonClick
' カラーダイアログボックスを生成します。
Dim clrDlg As New ColorDialog()
' ダイアログを初期化します。
If _flex(e.Row, e.Col) Is GetType(Color) Then
clrDlg.Color = _flex(e.Row, e.Col)
110
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
End If
' ダイアログから新しい色を取得し、それをセルに割り当てます。
If clrDlg.ShowDialog() = Windows.Forms.DialogResult.OK Then
_flex(e.Row, e.Col) = clrDlg.Color
End If
End Sub
C# コードの書き方
C#
private void _flex_CellButtonClick( object sender, RowColEventArgs e)
{
// カラーダイアログボックスを生成します。
ColorDialog clrDlg = new ColorDialog();
// ダイアログを初期化します。
if (_flex[e.Row, e.Col] == typeof(Color))
{
clrDlg.Color = (Color)_flex[e.Row, e.Col];
}
// ダイアログから新しい色を取得し、それをセルに割り当てます。
if (clrDlg.ShowDialog() == DialogResult.OK)
{
_flex[e.Row, e.Col] = clrDlg.Color;
}
}
マスク
C1FlexGridコントロールは、マスクによる編集をサポートします。マスク編集とは、テンプレートとして入力マスクを使用し、
ユーザーが入力した値の正当性を自動的に検査します。マスクは、EditMask 、または EditMask プロパティで指定します。
このプロパティは、通常のテキストフィールドおよびドロップダウンコンボボックスフィールドに使用できます。
マスク文字列には、次の2種類の文字を使用できます。1つはリテラル文字で、入力の一部を表します。もう1つはテンプレート
文字で、特定のカテゴリ(数値やアルファベットなど)に属する文字のプレースホルダの役割を果たします。たとえば、次のコー
ドでは、列1に電話番号を入力させるために"(999) 999-9999"というマスクを設定します。この"9"は、任意の数値を表すプレー
スホルダです。
Visual Basic コードの書き方
Visual Basic
' 電話番号を入力するためのマスクを設定します
_flex.Cols(1).EditMask = "(999) 999-9999"
C# コードの書き方
C#
// ' 電話番号を入力するためのマスクを設定します
_flex.Cols[1].EditMask = "(999) 999-9999";
111
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
EditMask プロパティを空以外の文字列に設定すると、列は日付/時刻値を含む(通常これらの列の編集には
DateTimePicker コントロールを使用)場合でも組み込みマスクエディタの使用を強制されます。これは特に、(日付を含まず)
時刻のみを含む DateTime 列を持っている場合に便利です。こうした場合、次のプロパティを設定して DateTimePicker コン
トロールの代わりにマスクエディタを使用できます。
Visual Basic コードの書き方
Visual Basic
_flex.Cols(1).DataType = GetType(DateTime)
_flex.Cols(1).Format = "hh:mm tt"
_flex.Cols(1).EditMask = "99:99 LL"
C# コードの書き方
C#
_flex.Cols[1].DataType = typeof(DateTime);
_flex.Cols[1].Format = "hh:mm tt";
_flex.Cols[1].EditMask = "99:99 LL";
EditMask プロパティは、設計時に[定型入力
定型入力]ダイアログボックスを使用して設定することもできます。
[定型入力
定型入力]ダイアログボックスは、Column タスク メニューまたは 列エディタ からアクセスできます。
Column タスク
タスクメニューで、[入力マスク
入力マスク]ボックスの〈...〉ボタンをクリックします。
列エディタ
列エディタで、左ペインの RowCol.EditMask プロパティを探し、その横の〈...〉ボタンをクリックします。
注意:
注意:[定型入力]ダイアログボックスは列固有で、選択した列の EditMask プロパティのみを変更します。
112
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
マスク文字を設定するための有効な書式についての詳細は、EditMask プロパティの説明を参照してください。
同列内の個々のセルにそれぞれ異なるマスクを設定するには、BeforeEditイベントをトラップして、このイベント内
でEditMask プロパティにカレントセルに対する適切なマスクを設定します。
入力値の正当性検査
多くの場合、マスクを設定するだけではユーザーの入力値に対する十分な正当性検査を行えません。たとえばマスクでは、値
の有効範囲を定義することや、カレントセルの値を他のセル値に基づいて正当性検査することはできません。
このような場合は、ValidateEdit イベントをトラップし、カレントセルのEditor.Textプロパティの値が有効であるかどうかを検査
します。この時点では、セルにはまだ元の値が保持されています。入力値が不正であれば、Cancel 引数を True に設定しま
す。そうすることで、ユーザーが有効な値を入力するまでグリッドは編集モードを維持します。
たとえば、次のサンプルコードでは、通貨型の列に入力した値の正当性を検査し、入力値が確実に1,000~10,000の範囲にあ
るようにします。
Visual Basic コードの書き方
Visual Basic
Private Sub _flex_ValidateEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.ValidateEditEventArgs) Handles _flex.ValidateEdit
' Decimal 型の列のみ正当性検査を行います.
If _flex.Cols(e.Col).DataType Is GetType(Decimal) Then
Try
Dim dec As Decimal = Decimal.Parse(_flex.Editor.Text())
If (dec < 1000) Or (dec > 10000) Then
MessageBox.Show("Value must be between 1,000 and 10,000")
e.Cancel = True
End If
Catch
MessageBox.Show("数値として認識できません。")
e.Cancel = True
End Try
End If
End Sub
C# コードの書き方
C#
private void _flex_ValidateEdit( object sender, ValidateEditEventArgs e)
{
//Decimal 型の列のみ正当性検査を行います
if (_flex.Cols[e.Col].DataType == typeof(Decimal))
{
try
{
Decimal dec = Decimal.Parse(_flex.Editor.Text);
if ( dec < 1000 || dec > 10000 )
{
MessageBox.Show("Value must be between 1,000 and 10,000");
e.Cancel = true;
113
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
catch
{
MessageBox.Show("数値として認識できません。");
e.Cancel = true;
}
}
}
カスタムエディタ
組み込みエディタでは多種多様な柔軟性と機能を提供していますが、外部コントロールを特定のエディタとして使用したい場
合もあります。たとえば、複数の列リストから選択するためのエディタ、またはビジネスオブジェクトの編集用に記述した特別の
コントロールを使用したい場合があります。
Control 基本クラスから派生する任意のコントロールを基本的なグリッドエディタとして使用できます。IC1EmbeddedEditor
インタフェースを実装しているコントロールは、グリッドとのより優れた統合を提供し、より高度な機能を提供しま
す。IC1EmbeddedEditor インタフェースについては、Editor プロパティも参照してください。
コントロールをカスタムエディタとして使用するには、Editor プロパティを使用してコントロールのインスタンスをグリッド列また
はスタイルに関連付けるだけで済みます。設計時(列エディタを使用
列エディタを使用)または実行時にこれを行うことができます。これで、グ
リッドでこのコントロールが自動的に使用されるようになります。
設計時にカスタムエディタを定義するには、フォームにエディタコントロールのインスタンスを追加し、C1FlexGrid タスク メ
ニューから[列エディタ]を選択して 列エディタ を開きます。カスタムエディタを使用する列を選択し、その Editor プロパティを
新しいエディタコントロールの名前に設定します。
たとえば、NumericUpDown コントロールをグリッドエディタとして使用するには、次の手順に従います。
1. C1FlexGrid コントロールをフォームに追加します。
2. NumericUpDown コントロールをフォームに追加し、そのBorderStyle プロパティを None に設定します.
3. C1FlexGrid タスク メニューから[列エディタ
列エディタ]を選択します。[列エディタ
列エディタ]へのアクセス方法の詳細については、列エ
ディタ を参照してください。
4. 列エディタ
列エディタで、最初のスクロール可能なグリッド列を選択し、その Editor プロパティを「numericUpDown1」に設定し
ます。
114
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
プロジェクトを実行し、最初の列にある値を編集します。グリッドがどのように NumericUpDown コントロールを配置して初期
化し、ユーザーによるセル値の編集を可能にするかに注意してください。セルの編集が完了したら、別のセルをクリックするか
[Enter]キーを押して次のセルに移動します。新しい値がどのようにセルに適用されるかに注意してください。
また、コードを使用してカスタムエディタをグリッドに割り当てることもできます。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムエディタを作成します
Dim editor as New NumericUpDown()
editor.BorderStyle = BorderStyle.None
' カスタムエディタをグリッドに割り当てます
_flex.Cols(1).Editor = editor
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, System.EventArgs e)
{
// カスタムエディタを作成します
NumericUpDown editor = new NumericUpDown();
editor.BorderStyle = BorderStyle.None;
// ' カスタムエディタをグリッドに割り当てます
_flex.Cols[1].Editor = editor;
}
115
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
カスタムエディタの作成
Control 基本クラスから派生する任意のコントロールをグリッドエディタとして使用できます。これが可能となるのは、グリッド
が Text や Bounds などの各プロパティと Leave や TextChanged などの各イベントにアクセスできる基本クラスに関する十
分な知識を持っているからです。多くの場合、このレベルのサポートで十分です。
しかし、基本クラスにそれほど厳密に従わないコントロールを使用したい場合があります。たとえば、DateTimePicker コント
ロールは、Text の代わりに編集値の取得に使用する Value プロパティを持っています。この場合、IC1EmbeddedEditor イ
ンタフェースに1つまたは複数のメソッドを実装してデフォルト動作を変更できます。たとえば、C1Input ライブラリ内のコント
ロールはすべて IC1EmbeddedEditor をサポートしているため、C1FlexGrid (およびC1TrueDBGrid)と緊密に統合します。
IC1EmbeddedEditor インタフェースは非常に単純で、グリッドは最近の連結を使用してこのインタフェースに連結するため全
メンバを実装することも必要ありません。エディタコントロールに必要なメンバのみを実装します。
このインタフェースは、非常に柔軟性が高く事実上ほとんどのコントロールをグリッドエディタとして使用できます。
UITypeEditor クラスをグリッドエディタとして使用することも可能です。これを行うには、下記のようなラッパクラスが必要です。
1. Control から派生している(UITypeEditor は派生していない)
2. IC1EmbeddedEditor インタフェースを実装している
3. 適切な UITypeEditor をカプセル化している
このようなラッパクラスのソースコードは、製品付属の「CustomEditors」サンプルにあります。
UITypeEditorラッパクラスを使用し、C1FlexGrid で任意の UITypeEditors を使用できます。.NET は、色、フォント、ファイル名
などを編集するためのいくつかの UITypeEditors を提供しています。また、コントロールを記述するより簡単な場合は、独自の
UITypeEditors を記述することもできます。
注意:
注意:C1FlexGrid で組み込み、カスタム、UITypeEditor の各エディタを使用する例については、製品付属の
「CustomEditorsサンプル」を参照してください。
編集モードの制御
グリッドが現在編集モードかどうかは、Editor プロパティの値で確認します。このプロパティが null(VBの場合はNothing)を
返す場合、グリッドは編集モードではありません。null 以外であれば、グリッドは編集モードであり、プロパティはセルの編集に
使用中のコントロール(TextBox、ComboBox、またはその他のコントロールタイプが可能)への参照を返します。
プログラムによってグリッドを編集モードに切り替えるには、 StartEditing メソッドを使用します。また、編集を終了するに
は、FinishEditingメソッドを使用します。
グリッドで発生する編集の各イベントを処理し、さらに編集処理を制御できます。セル編集のプロセスで、次の各イベントが発
生します。
イベント
説明
BeforeEdit
このイベントは、編集可能なセルが選択されたときに発生します。このイベントの
Cancel 引数を True に設定すると、セルの編集を禁止できます。ま
た、ComboListプロパティを変更して、適切なドロップダウンボタンをセル内に描
画することもできます。このイベントの後にユーザーが実際に編集を開始せず
に、単に選択を別のセルまたはコントロールに移動できることに注意してくださ
い。
StartEdit
このイベントは、BeforeEdit と同じですが、ユーザーがキーを実際に入力するか
セル内のドロップダウンボタンをクリックして、実際に編集を開始しようとする点が
異なります。この段階では、まだ編集を取り消すことができます。
StartEdit イベント発生時点では、Editor プロパティがまだ未確定な状態である
ことに注意してください。これは、使用するエディタタイプをコントロールがまだ決
116
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
イベント
説明
定していないからです。この段階で、カスタムエディタを Editor プロパティに割り
当てることができます。
SetupEditor
このイベントは、セル編集のエディタコントロールが作成および設定された後、そ
れが表示される前に発生します。この時点で、エディタのプロパティを変更できま
す(たとえば、TextBoxエディタ内で使用する最大長またはパスワード文字を設定
します)。また、独自のイベントハンドラをエディタに付加することもできます。
ValidateEdit
このイベントは、ユーザーが編集を完了したとき、エディタ値がグリッドにコピーさ
れる前に発生します。グリッドから元の値を取得して確認できます(イベントはこ
のセルの座標値を提供します)。Editor プロパティ(Editor.Text など)を介して、
グリッドに割り当てようとしている新しい値を確認できます。新しい値がセルに有
効でない場合、Cancel 引数を True に設定するとグリッドは編集モードを維持し
ます。
セルを編集モードのままにする代わりに、元の値を復元して編集モードから抜け
るには、Cancel を True に設定して FinishEditing メソッドを呼び出します。
AfterEdit
このイベントは、新しい値がセルに適用されてエディタが非アクティブ化した後に
発生します。このイベントを使用し、このセル値に依存しているすべて(小計値、
ソートなど)を更新できます。
セルのマージ
C1FlexGrid コントロールでは、複数のセルを1つにマージすることで、複数行または列を1つのセルのように扱うことができま
す。この機能によって、グリッドに表示されるデータをより見やすく整えることができます。これは、HTMLにおける"
<ROWSPAN>"および"<COLSPAN>"タグの機能と似ています。
セルマージを有効にするには、次の2つの操作を行う必要があります。
1. グリッドの AllowMerging プロパティに AllowMergingEnum None 以外の値を設定します(各設定の機能について
はリファレンスの項に説明があります)。
2. 列をマージしたい場合、マージしたい各列の AllowMerging プロパティを True に設定します。行をマージしたい場
合、マージしたい各行の RowCol.AllowMerging プロパティを True に設定します。
マージは、隣接するセル内に同一文字列(長さ0の文字列を除く)が格納されていると発生します。2つのセルを強制的にマー
ジする手段はありません。セルマージは、セルの内容に応じて自動的に行われます。この機能を使用すると、データをソートし
て表示する際、重複する隣接行のデータをマージすることで、同一データの連続を表すことができます。
セルマージには、いくつかの利用方法があります。たとえば、セルマージによってテーブルのヘッダやデータビューを作成した
り、または隣接する列にテキストをはみ出して表示させることなどができます。
テーブルヘッダのマージ
セルをマージしてテーブルのヘッダを作成するには、まずグリッドの AllowMerging プロパティを FixedOnly に設定します。
次に、マージしたい各列の AllowMerging プロパティと、マージしたい各行の AllowMerging プロパティを設定します。最
後に、マージするセルの内容がすべて同じになるように、ヘッダセルにテキストを設定します。
このサンプルコードを次に示します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
117
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Dim i%
' コントロールを初期化します。
_flex.Styles.Normal.WordWrap = True
_flex.Cols.Count = 9
_flex.Rows.Fixed = 2
_flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.FixedOnly
' 行ヘッダを作成します。
_flex.Rows(0).AllowMerging = True
' 同一内容の4つのセルをマージします。
Dim rng As C1.Win.C1FlexGrid.CellRange = _flex.GetCellRange(0, 1, 0, 4)
rng.Data = "North"
' 同一内容の4つのセルをマージします。
rng = _flex.GetCellRange(0, 5, 0, 8)
rng.Data = "北"
For i = 1 To 4
_flex(1, i) = "Qtr " & i
_flex(1, i + 4) = "Qtr " & i
Next
' 列ヘッダを作成します。
_flex.Cols(0).AllowMerging = True
' 同一内容の2つのセルをマージします。
rng = _flex.GetCellRange(0, 0, 1, 0)
rng.Data = "Sales by Product"
' セルの配置と自動サイズの調整を行います。
_flex.Styles.Fixed.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
_flex.AutoSizeCols(1, _flex.Cols.Count - 1, 10)
End Sub
C# コードの書き方
C#
private void Form1_Load(System.object sender, System.EventArgs e)
{
int i;
// コントロールを初期化します。
_flex.Styles.Normal.WordWrap = true;
_flex.Cols.Count = 9;
_flex.Rows.Fixed = 2;
_flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.FixedOnly;
// 行ヘッダを作成します。
_flex.Rows[0].AllowMerging = true;
// 同一内容の4つのセルをマージします。
118
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1.Win.C1FlexGrid.CellRange rng = _flex.GetCellRange(0, 1, 0, 4);
rng.Data = "北";
// 同一内容の4つのセルをマージします。
rng = _flex.GetCellRange(0, 5, 0, 8);
rng.Data = "南";
for ( i = 1 ; i <= 4; i++)
{
_flex[1, i] = "Qtr " + i;
_flex[1, i + 4] = "Qtr " + i;
}
// 列ヘッダを作成します。
_flex.Cols[0].AllowMerging = true;
// 同一内容の2つのセルをマージします。
rng = _flex.GetCellRange(0, 0, 1, 0);
rng.Data = "Sales by Product";
// セルの配置と自動サイズの調整を行います。
_flex.Styles.Fixed.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
_flex.AutoSizeCols(1, _flex.Cols.Count - 1, 10);
}
以下の図のような結果になります:
データビューのマージ
セルマージは、グリッドをデータソースに連結したときも同じように機能します。次のコードは、設計時にデータソースに連結さ
れたグリッドの例を示します。データソースへの連結方法の詳細については、「データソースへの連結」を参照してください。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
Dim i%
' マージ対象のセルを設定します
119
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
_flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.RestrictCols
For i = _flex.Cols.Fixed To _flex.Cols.Count - 1
_flex.Cols(i).AllowMerging = True
Next
End Sub
C# コードの書き方
C#
private void Form1_Load( System.object sender,
{
int i;
System.EventArgs e)
// マージ対象のセルを設定します
_flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.RestrictCols;
for (int i = _flex.Cols.Fixed; i <= _flex.Cols.Count - 1; i++)
{
_flex.Cols(i).AllowMerging = true;
}
}
このコードの実行結果は次のとおりです。
セルマージによって、データが視覚的にグループ化され、テーブルの情報が非常にわかりやすくなる点に注目してください。
注意:
注意:データを自動マージする例については、製品付属の「CellMerging サンプル」を参照してください。
セルをはみだして表示
AllowMerging プロパティには、他の設定とは異なる特殊な動作を定義する2つの設定値を持っており、この設定値を使用す
る場合は、特定の行の AllowMerging プロパティや特定の列の AllowMerging プロパティを設定する必要はありません。
Spill 設定
このプロパティを AllowMergingEnum.Spill に設定すると、1つのセル内に収まらない長いデータが、隣のセル(空白の場合
120
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
に限り)にはみ出して表示されます。その結果の動作は Microsoft Excel の場合と同じです。長いデータをセルに入力するとき
に隣接するセルが、空白であればデータは、はみ出して必要なだけのスペースを占領します。
たとえば、下の図は、C1FlexGrid.AllowMerging を AllowMergingEnum.Spill に設定した場合、ユーザーがさまざまな長さ
のデータを入力したときのグリッドの外観を示します。
Nodes 設定
AllowMergingEnum.Nodes 設定は、AllowMergingEnum.Spill と同じですが、アウトラインノードだけに適用されます。こ
の設定は、データをグループ化して、ノード行にデータ行とは異なる書式を設定した場合に便利です。
たとえば、下の図は、Subtotal メソッドを使用してデータのグループ化と集計を行い、C1FlexGrid.AllowMerging を
AllowMergingEnum.Nodes に設定したときのグリッドの外観を示します。
この図は、トピック: 小計行の作成の場合と同じです。違いは、小計行(ノード)がここでは空白の隣接セルにはみ出して、グ
リッドの外観が改善されている点です。
カスタムマージ
カスタムマージ
これまでの自動マージを行いつつ、デフォルトのマージ動作を次の2つの方法でカスタマイズすることもできます。
カスタムIComparerクラスをCustomComparer プロパティに割り当てます。デフォルトでは、グリッドは同じ Null 以外
の値を含んでいる隣接セルをマージします。文字列の比較は、大文字と小文字を区別し、空白を含めます。大文字と
小文字を区別しない比較を使用し、空白を取り除いてグリッドのセルをマージしたい場合、IComparerを実装しているカ
121
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
スタムクラスを記述し、それを CustomComparer プロパティに割り当てることができます。
C1FlexGrid から派生する新しいクラスを記述し、GetMergedRange 仮想メソッドを変更して独自のカスタムマージロ
ジックを提供します。
注意:
注意:C1FlexGrid を継承したカスタムマージロジックの実装方法の例については、製品付属の「CustomMerge
サンプル」、「CustomMerge2 サンプル」を参照してください。
アウトラインとデータの集計
C1FlexGrid コントロールには、データを集計して階層表示するためのメソッドとプロパティが用意されています。データを集計
し、小計行を追加するには、Subtotal メソッドを使用します。データを階層表示するには、Tree プロパティを使用します。
小計行の作成
Subtotal メソッドを使用すると、通常(小計以外)のデータ行を集合計算した小計行を追加できます。
Subtotal メソッドは、階層的な集合計算をサポートします。たとえば、グリッドに売上データが含まれる場合、
C1FlexGridBase.Subtotal を呼び出して「製品」「販売地域」および「販売員」ごとの売上計を算出します。これを以下のコードで
示します。
Visual Basic コードの書き方
Visual Basic
Private Sub ShowTotals()
' 既存の小計をクリアします
_flex.Tree.Column = 0
_flex.Tree.Style = TreeStyleFlags.Simple
' グリッドをソートします
_flex.Subtotal(AggregateEnum.Clear)
' 総計(特定の列インデックスの変わりに-1を使用)を算出します.
_flex.Subtotal(AggregateEnum.Sum, -1, -1, 3, "Grand Total")
' 列0(製品)ごとの合計を算出します
_flex.Subtotal(AggregateEnum.Sum, 0, 0, 3, "Total {0}")
' 列1(地域)ごとの合計を算出します
_flex.Subtotal(AggregateEnum.Sum, 1, 1, 3, "Total {0}")
' 内容に合わせて列の幅を調整します
_flex.AutoSizeCols()
End Sub
C# コードの書き方
C#
private void ShowTotals()
{
// 既存の小計をクリアします
_flex.Tree.Column = 0;
122
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
_flex.Tree.Style = TreeStyleFlags.Simple;
// グリッドをソートします
_flex.Subtotal(AggregateEnum.Clear);
// 総計(特定の列インデックスの変わりに-1を使用)を算出します
_flex.Subtotal(AggregateEnum.Sum, -1, -1, 3, "Grand Total");
// 列0(製品)ごとの合計を算出します
_flex.Subtotal(AggregateEnum.Sum, 0, 0, 3, "Total {0}");
// 列1(地域)ごとの合計を算出します
_flex.Subtotal(AggregateEnum.Sum, 1, 1, 3, "Total {0}");
// 内容に合わせて列の幅を調整します
_flex.AutoSizeCols();
}
Subtotal メソッドによって小計行が追加されると、その行には自動的に小計行用のスタイルが割り当てられます(5レベルの
小計行用の組み込みスタイルがあります)。設計時にスタイルエディタ
スタイルエディタを使用するか、もしくは実行時にコードを使用してアウト
ラインスタイルのプロパティを変更すると、小計行の外観をカスタマイズできます。たとえば、次のようになります。
Visual Basic コードの書き方
Visual Basic
' 小計のスタイルを設定します
Dim cs As C1.Win.C1FlexGrid.CellStyle
cs = _flex.Styles(C1.Win.C1FlexGrid.CellStyleEnum.GrandTotal)
cs.BackColor = Color.Black
cs.ForeColor = Color.White
cs.Font = New Font(Font, FontStyle.Bold)
cs = _flex.Styles(C1.Win.C1FlexGrid.CellStyleEnum.Subtotal0)
cs.BackColor = Color.DarkRed
cs.ForeColor = Color.White
cs.Font = New Font(Font, FontStyle.Bold)
cs = _flex.Styles(C1.Win.C1FlexGrid.CellStyleEnum.Subtotal1)
cs.BackColor = Color.DarkBlue
cs.ForeColor = Color.White
C# コードの書き方
C#
//小計のスタイルを設定します
CellStyle cs;
cs = _flex.Styles[CellStyleEnum.GrandTotal];
cs.BackColor = Color.Black;
cs.ForeColor = Color.White;
cs.Font = new Font(Font, FontStyle.Bold);
cs = _flex.Styles[CellStyleEnum.Subtotal0];
cs.BackColor = Color.DarkRed;
123
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
cs.ForeColor = Color.White;
cs.Font = new Font(Font, FontStyle.Bold);
cs = _flex.Styles[CellStyleEnum.Subtotal1];
cs.BackColor = Color.DarkBlue;
cs.ForeColor = Color.White;
このコードを実行すると、グリッドの外観は次のようになります。
総計行は、すべての製品、販売地域、および販売員の総売上を含みます。この行は Subtotal メソッドの呼び出し時、
groupOn 引数に -1 を使用することで作成されます。その他の小計行は、製品と販売地域ごとの合計を示します。これらは、
groupOn 引数に 0 または 1 を指定することで作成されます。
また、合計以外の集合計算(平均や百分率など)を算出したり、行ごとに複数の集合計算(総売上、純売上)を算出することも
できます。
Subtotal メソッドによって作成された小計行は、次の4点で通常の行と異なります。
1. Subtotal メソッドに AggregateEnum.Clear 引数を指定して呼び出すと、小計行を自動消去できます。これは、データ
を動的に表示するための便利な機能です。この機能によって、ユーザーが列の移動やデータの再ソートをしても、小計
行が自動的に再計算されます。
2. 小計行をアウトラインのノードとして使用できます。グリッドをアウトライン表示すると、グループごとの小計行を縮小す
ることでデータ全体の概要を把握したり、必要に応じて小計行を展開し、データの詳細を閲覧したりできます。アウトラ
インツリーを表示するには、Column および Tree.Style の各プロパティを設定してアウトラインツリーの位置と外観を
定義します。
3. 小計行をツリーのノードとして処理できます。Node プロパティを介して、小計行の Node オブジェクトを取得できます。
4. グリッドをデータソースに連結しているとき、小計行は実際のデータと関連付けられていません。したがって、カーソル
をデータソース内で移動すると、グリッドの小計行は無視されます。
アウトラインツリーのノードをクリックすると、グリッドの各セクションを縮小および展開できます。これは、集合計算値だけでな
く、さまざまな種類のデータ表示に便利な機能です。次のトピックでは、カスタムアウトラインツリーを作成してディレクトリ情報
を表示する方法を紹介します。
カスタムツリーの作成
Subtotal メソッドを使用せずにアウトラインツリーを作成するには、次の手順に従います。
1. グリッドにデータを供給します。
124
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
2. アウトラインノードとして定義したい行の IsNodeプロパティを True に設定します。
3. 各ノード行の Nodeオブジェクトを取得し、そのLevel プロパティを設定して各ノードの階層レベルを定義します。大きい
値ほど、アウトラインツリー上のより深い(よりインデントした)階層レベルを意味します。
たとえば、次のサンプルコードは、ディレクトリツリーを作成します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' グリッドレイアウトの初期化を行います
fg.Cols.Fixed = 0
fg.Cols.Count = 1
fg.Rows.Count = 1
fg.ExtendLastCol = True
fg.Styles.Normal.TextAlign = TextAlignEnum.LeftCenter
fg.Styles.Normal.Border.Style = BorderStyleEnum.None
' アウトラインツリーを表示します
fg.Tree.Column = 0
fg.Tree.Style = TreeStyleFlags.SimpleLeaf
' グリッドにデータをセットします
AddDirectory("c:\", 0)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, System.EventArgs e)
{
// グリッドレイアウトの初期化を行います
fg.Cols.Fixed = 0;
fg.Cols.Count = 1;
fg.Rows.Count = 1;
fg.ExtendLastCol = true;
fg.Styles.Normal.TextAlign = TextAlignEnum.LeftCenter;
fg.Styles.Normal.Border.Style = BorderStyleEnum.None;
// アウトラインツリーを表示します
fg.Tree.Column = 0;
fg.Tree.Style = TreeStyleFlags.SimpleLeaf;
// グリッドにデータをセットします
AddDirectory("c:\\", 0);
}
上記のサンプルではグリッドのレイアウトを初期化してから、AddDirectory ルーチンを呼び出し、グリッドにデータを供給して
ツリー構造を設定させます。
Visual Basic コードの書き方
Visual Basic
Private Sub AddDirectory(ByVal dir As String, ByVal level As Integer)
' ディレクトリを追加します
Dim thisDir As String
125
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
thisDir = Path.GetFileName(dir)
If thisDir.Length = 0 Then thisDir = dir
fg.AddItem(thisDir.ToUpper())
' 新たに行を作成し、ノードとします
Dim row As Row
row = fg.Rows(fg.Rows.Count - 1)
row.IsNode = True
' ノードレベルを設定します
Dim nd As Node
nd = row.Node
nd.Level = level
' ファイル情報を取得し、ツリーに追加します
Dim file As String, cnt As Integer
cnt = 1
For Each file In Directory.GetFiles(dir)
fg.AddItem(Path.GetFileName(file).ToLower())
cnt = cnt + 1
If cnt > 10 Then Exit Fo
' 最大10個までのファイルを追加します
Next
' ディレクトリ情報を取得し、ツリーにサブディレクトリ
'(最大4階層まで)を追加します
If level < = 4 Then
Dim subdir As String
cnt = 1
For Each subdir In Directory.GetDirectories(dir)
AddDirectory(subdir, level + 1)
cnt = cnt + 1
If cnt > 10 Then Exit For
' 最大10個までのサブディレクトリを追加します
Next
End If
End Sub
C# コードの書き方
C#
private void AddDirectory(string dir, int level)
{
// ディレクトリを追加します
string thisDir;
thisDir = Path.GetFileName(dir);
if (thisDir.Length == 0)
{
thisDir = dir;
}
fg.AddItem(thisDir.ToUpper());
// 新たに行を作成し、ノードとします
Row row;
row = fg.Rows[fg.Rows.Count - 1];
row.IsNode = true;
// ノードレベルを設定します
126
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
//
//
//
//
//
Node nd;
nd = row.Node;
nd.Level = level;
ファイル情報を取得し、ツリーに追加します
int cnt;
cnt = 1;
foreach (string file in Directory.GetFiles(dir))
{
fg.AddItem(Path.GetFileName(file).ToLower());
cnt = cnt + 1;
最大10個までのファイルを追加します
if (cnt > 10)
{
break;
}
}
ディレクトリ情報を取得し、ツリーにサブディレクトリ
(最大4階層まで)を追加します
if (level <= 4)
{
cnt = 1;
foreach (string subdir in Directory.GetDirectories(dir))
{
AddDirectory(subdir, level + 1);
cnt = cnt + 1;
最大10個までのサブディレクトリを追加します
if (cnt > 10)
{
break;
}
}
}
}
AddDirectory は、カレントディレクトリおよびすべてのサブディレクトリをトラバースする再帰ルーチンです。このサンプルで
は、時間の節約のため、ツリーサイズを4つのディレクトリレベルに制限しています。実際のアプリケーションでは、展開したと
きにのみ、ツリーの分枝を読み込むようにルーチンを変更する必要があります(後述の 「チュートリアル」を参照してください)。
このコードは次のような外観のグリッドを作成します。
127
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コントロールによるアウトラインとツリーの作成
C1FlexGrid コントロールのユニークで定評のある機能の1つは、階層的なグループ化を通常の非構造化データに追加する
能力です。
これを達成するために、C1FlexGrid は Node 行の概念を導入しています。 Node 行は、通常のデータを格納しません。代わ
りに、これらは、通常の TreeView コントロールのノードとまったく同様に、類似のデータをグループ化するヘッダーとして機能
します。 TreeView コントロールのノードと同様に、ノード行は縮小/展開したり、格納しているデータを非表示/表示にしたり
できます。また、TreeView コントロールと同様に、ノード行もノード階層を定義する Level プロパティを持っています。下位レベ
ルノードは上位レベルノードを格納します。
たとえば、顧客名、国、都市、および売上高を表示するグリッドがあるとします。この標準的なグリッドは通常、次のような表示
になります。
A情報はすべてそこにありますが、国や顧客ごとの総売上額が見てあまり明瞭ではありません。 C1FlexGrid のアウトライン
機能を使用すると、データを国(レベル0)別にグループ化してから、各国の都市(レベル1)別にグループ化した後、各都市の
顧客(レベル2)別にグループ化できます。以下に、アウトラインを追加した後の同じグリッドを示します。
128
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
このグリッドは、前と同じ情報を表示(同じデータソースにバインド)していますが、各ノードがその下にデータの概要を格納す
るツリーを追加します。ノードは、縮小して概要のみを表示したり、展開して詳細を表示したりできます。各ノード行は、複数の
列の概要(この場合は販売合計数と合計金額)を表示できることに注意してください。
この項では、通常のグリッドをより機能豊富なアウトライングリッドに変える手順をガイドします。
データのロード
アウトライングリッドへのデータのロードは、通常のグリッドへのロードとまったく同じです。データソースがデザイン時に使用可
能な場合、Visual Studio のプロパティウィンドウを使用し、1行のコードを記述せずに、グリッドの DataSource プロパティを設
定して、グリッドをデータにバインドできます。
データソースがデザイン時に使用可能でない場合、コードでグリッドの DataSource プロパティを設定できます。一般に、デー
タバインディングコードは次のようになります。
C# コードの書き方
C#
public Form1()
{
InitializeComponent();
//データを取得します。
var fields = @"
Country,
City,
SalesPerson,
Quantity,
ExtendedPrice";
var sql = string.Format("SELECT {0} FROM Invoices ORDER BY {0}", fields);
var da = new OleDbDataAdapter(sql, GetConnectionString());
da.Fill(_dt);
//グリッドをデータにバインドします。
this._flex.DataSource = _dt;
// ExtendedPrice 列をフォーマットします。
_flex.Cols["ExtendedPrice"].Format = "n2";
}
このコードは、OleDbDataAdapter を使用して、DataTable にデータを入力した後、この DataTable をグリッドの
DataSource プロパティに割り当てます。
このコードを実行すると、最初の画像に示した「通常のグリッド」が得られます。この通常のグリッドを2番目の画像に示したア
ウトライングリッドに変えるには、アウトラインを構成するノード行を挿入する必要があります。
129
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ノード行の作成
ノード行は、以下の点を除き、通常行とほぼ同じです。
ノード行はデータバインドされません。グリッドがデータソースにバインドされると、各通常行はデータソース内の項目に
対応します。ノード行は対応しません。代わりに、ノード行は類似データを格納する通常行をグループ化します。
ノード行は縮小または展開できます。ノード行が縮小すると、すべてのデータと子ノードは非表示になります。アウトライ
ンツリーが表示されている場合、ユーザーはマウスやキーボードを使用してノードを縮小および展開できます。アウトラ
インツリーが表示されていない場合、ノードはコードによってのみ展開または縮小できます。
行がノードかどうかを決定するには、次のように IsNode プロパティを使用できます。
C# コードの書き方
C#
var row = _flex.Rows[rowIndex];
if (row.IsNode)
{
//行はノードです。
var node = row.Node;
DoSomethingWithTheNode(node);
}
else
{
//この行はノードではありません。
}
ノード行は次の3つの方法で作成できます。
1. Rows.InsertNodeメソッドを使用します。これにより、新しいノード行が指定したインデックスに挿入されます。ノード行
が作成されたら、それを他の任意の行と同様に使用できます(列ごとのデータの設定やスタイルの適用など)。これは、
合計を挿入してアウトラインを構築するための「低レベル」の方法です。この方法は、最大の制御と柔軟性を提供し、以
下に示されています。
2. Subtotalメソッドを使用します。このメソッドは、グリッド全体をスキャンし、グリッドデータが変化する位置にオプションの
小計を持つノード行を自動的に挿入します。これは、合計を挿入してアウトラインを構築するための「高レベル」の方法
です。この方法は、コードがほとんど不要ですが、グリッド上でデータを構造化する方法とアウトラインの外観について
いくつかのことを前提しています。
3. グリッドが非バインドの場合、IsNode を true に設定することで、通常行をノード行に変えることができます。これはグ
リッドが非バインドの場合にのみ機能することに注意してください。通常のデータバインド行をノードに変えようとする
と、グリッドは例外をスローします。
下のコードに、指定の列の同じ値をグループ化するノード行を挿入する GroupBy メソッドを実装する方法を示します。
C# コードの書き方
C#
//指定レベルのノードを挿入する指定の列をグループ化します。
void GroupBy(string columnName, int level)
{
object current = null;
for (int r = _flex.Rows.Fixed; r < _flex.Rows.Count; r++)
{
if (!_flex.Rows[r].IsNode)
{
130
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
var value = _flex[r, columnName];
if (!object.Equals(value, current))
{
// value changed: ノードを挿入します。
_flex.Rows.InsertNode(r, level);
//最初のスクロール可能な列にグループ名を表示します。
_flex[r, _flex.Cols.Fixed] = value;
//現在の値を更新します。
現在の値。
}
}
}
}
このコードは、すべての列をスキャンし、既存のノード行をスキップして(これにより複数レベルのノードを追加するためにコード
を呼び出すことが可能)、グループ化されている列の現在の値のトラッキングを維持します。 現在の値が変更されると、最初
のスクロール可能な列に新しいグループ名を表示するノード行が挿入されます。
例に戻り、このメソッドを使用し、次を呼び出すことで、2レベルのアウトラインを作成できます。
C# コードの書き方
C#
void _btnGroupCountryCity_Click(object sender, EventArgs e)
{
GroupBy("Country", 0);
GroupBy("City", 1);
}
非常に単純ですが、いくつかの注意点があります。最初に、このメソッドは、データがアウトライン構造に従ってソートされること
を前提としています。この例では、[国]ではなく、[販売員
販売員]によってソートされた場合、アウトラインは、おそらく不必要な国ごと
の複数のレベル0ノードを含むことになります。
また、GroupBy メソッドは、多くの行を挿入できますが、グリッドのちらつきの原因にもなります。これを回避するには、通常
は、更新を実行する前に Redrawプロパティを false に設定して、更新が完了した後に設定を true に戻します。
これらの問題を処理するには、アウトラインを作成するコードを次のように記述し直す必要があります。
C# コードの書き方
C#
void _btnGroupCountryCity_Click(object sender, EventArgs e)
{
//更新中の再描画を中断します。
using (new DeferRefresh(_flex))
{
//元のソート(国、都市別など)を復元します
ResetBinding();
//国、都市によってグループ化します。
GroupBy("Country", 0);
GroupBy("City", 1);
}
}
DeferRefresh クラスは、グリッドの Redraw プロパティを false に設定し、それが破棄されたときに元の値を復元する単純な
131
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ユーティリティです。これにより、更新中に例外が発生しても Redraw が正しく復元されるようになります。以下
に、DeferRefresh クラスの実装を示します。
C# コードの書き方
C#
/// Redraw ブロック内のグリッドの長い演算をカプセル化するために使用される Utility クラス。
///これにより、ちらつきが回避され、万一の場合に Redraw プロパティが正しくリセットされるようになります。
///演算中に例外がスローされます。
class DeferRefresh : IDisposable
{
C1FlexGrid _grid;
bool _redraw;
public DeferRefresh(C1FlexGrid grid)
{
_grid = grid;
_redraw = grid.Redraw;
grid.Redraw = false;
}
public void Dispose()
{
_grid.Redraw = _redraw;
}
}
BindGrid メソッドは、グリッドがアウトライン構造で要求された順序でソートされるようにします。例では、ソート順は[国
国]、[都
都
市]、[販売員
販売員]別の順となります。コードは次のようになります。
C# コードの書き方
C#
// グリッドのバインドを解除して再バインドし、すべてをリセットします。
void ResetBinding()
{
//グリッドのバインドを解除します。
_flex.DataSource = null;
//任意のカスタムソートをリセットします。
_dt.DefaultView.Sort = string.Empty;
//グリッドを再バインドします。
_flex.DataSource = _dt;
// ExtendedPrice 列をフォーマットします。
_flex.Cols["ExtendedPrice"].Format = "n2";
//コンテンツの大きさに合わせて列のサイズを自動調整します。
_flex.AutoSizeCols();
}
132
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
この時点でこのコードを実行すると、ノード行が予想どおりに作成されますが、アウトラインツリーが表示されていないため、
ノードを展開したり縮小できないことが分かります。アウトラインツリーは次のセクションで説明します。
アウトラインツリー
アウトラインツリーは、通常の TreeView コントロールで目にするものと非常に類似しています。アウトラインツリーは、インデ
ントした構造を表示し、各ノード行の横には縮小/展開アイコンがあるため、ユーザーはアウトラインを展開および縮小して希
望レベルの詳細を表示できます。
アウトラインツリーは、Tree.Column プロパティで定義された任意の列に表示できます。デフォルトでは、このプロパティは-1
に設定され、ツリーはまったく表示されません。上記の例でアウトラインツリーを表示するには、次のコードを使用します。
C# コードの書き方
C#
void _btnTreeCountryCity_Click(object sender, EventArgs e)
{
using (new DeferRefresh(_flex))
{
//前と同様に国と都市別にグループ化します。
_btnGroupCountryCity_Click(this, EventArgs.Empty);
//アウトラインツリーを表示します。
_flex.Tree.Column = 0;
//ツリーに合わせてサイズを自動調整します。
_flex.AutoSizeCol(_flex.Tree.Column);
//詳細ノードを縮小します。
_flex.Tree.Show(1);
}
}
このコードは、前のメソッドを呼び出してアウトラインを構築した後、Tree.Column プロパティをゼロに設定して、最初の列にア
ウトラインツリーを表示させます。また、C1FlexGrid.AutoSizeColメソッドも呼び出して、列がアウトラインツリーを収めるのに
十分な広さになるようにします。最後に、Tree.Show メソッドを呼び出して、すべてのレベル0ノード(この場合は都市)を表示
してすべての詳細を隠します。
Treeプロパティは、アウトラインツリーのカスタマイズに使用するいくつかのメソッドとプロパティを公開する GridTree オブジェ
クトへの参照を返します。主なメソッドとプロパティは以下のとおりです。
Column: アウトラインツリーを格納する列のインデックスを取得または設定します。このプロパティを -1に設定すると、
アウトラインツリーはユーザーから非表示になります。
Indent: 隣接するノードレベル間のインデントをピクセル単位で取得または設定します。インデントレベルが高いほど、
ツリーは広くなります。
Style: 表示するアウトラインツリーのタイプを取得または設定します。このプロパティを使用し、ツリーが上部にボタン
バーを含めてユーザーがツリー全体を縮小/展開できるようにするかどうか、線および/または記号を表示するかどう
か、およびツリーをデータ行やノード行と結ぶ線を表示するかどうかを決定します。
LineColor: ツリーの結合線の色を取得または設定します。
LineStyle: ツリーの結合線のスタイルを取得または設定します。
たとえば、上のコードを変更することで、これらの2行を含めます。
C# コードの書き方
C#
133
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
//アウトラインツリーを表示します。
_flex.Tree.Column = 0;
_flex.Tree.Style = TreeStyleFlags.CompleteLeaf;
_flex.Tree.LineColor = Color.White;
_flex.Tree.Indent = 30;
アウトラインツリーは次のように変わります。
左上セルのラベル「1」、「2」、および「*」というラベルのボタンに注意してください。これらのボタンをクリックすると、ツリー全体
が対応するレベルに縮小または展開します。また、大幅に広くなったインデントや、ツリーを通常行(「Anne Dodsworth」)や
ノード行と結ぶ線にも注意してください。
小計の追加
ここまで、ノード行とアウトラインツリーの作成をカバーしました。しかし、アウトラインを本当に有益なものにするには、ノード行
は格納しているデータの概要情報を含める必要があります。
Subtotal メソッドを使用してアウトラインツリーを作成すると、小計が自動的に追加されます。これは後述のセクションで説明
されます。
上述した Rows.InsertNode メソッドを使用してアウトラインツリーを作成した場合、Aggregate メソッドを使用し、各行グルー
プの小計を計算して、その結果をノードに直接挿入する必要があります。
以下の Subtotal メソッドはこれを行う方法を示します。
C# コードの書き方
C#
//小計を指定レベルの各ノードに追加します。
void AddSubtotals(int level, string colName)
{
//合計する列を取得します。
int colIndex = _flex.Cols.IndexOf(colName);
//行をスキャンして該当レベルのノードを探します。
for (int r = _flex.Rows.Fixed; r < _flex.Rows.Count; r++)
{
if (_flex.Rows[r].IsNode)
{
var node = _flex.Rows[r].Node;
if (node.Level == level)
134
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
{
//ノードを見つけて、明細金額の合計を計算します。
var range = node.GetCellRange();
var sum = _flex.Aggregate(AggregateEnum.Sum,
range.r1, colIndex, range.r2, colIndex,
AggregateFlags.ExcludeNodes);
//グリッドに合計を表示します。
//(自動的に列形式を使用します。)
_flex[r, colIndex] = sum;
}
}
}
}
AddSubtotals メソッドは、グリッド行をスキャンしてノード行を探します。 希望レベルのノード行が見つかると、メソッドは
GetCellRangeメソッドを使用してノードの子行を取得します。次に、Aggregate メソッドを使用し、範囲全体のターゲット列の
値の合計を計算します。 Aggregate への呼び出しには、既存のノードの二重計算を回避するために ExcludeNodes フラグ
が組み込まれます。小計が計算されると、小計は通常の _flex[row, col] インデクサでノード行のセルに割り当てられます。
ノード行がデータにバインドしていないため、これがデータソースにまったく影響しないことに注意してください。
また、このメソッドを使用して、複数の合計を各ノード行に追加できることにも注意してください。この例では、[数量
数量]および[明
明
細金額
細金額]列に合計を追加します。合計に加えて、平均、最大、最小など、他の集計も追加できます。
これで、このメソッドを使用して、ノード行、アウトラインツリー、および小計を持つ完全なアウトラインを作成できるようになりま
した。
C# コードの書き方
C#
void _btnTreeCountryCity_Click(object sender, EventArgs e)
{
using (new DeferRefresh(_flex))
{
//元のソート(国、都市、販売員別など)を復元します。
ResetBinding();
//国、都市によってグループ化します。
GroupBy("Country", 0); //国(レベル0)によってグループ化します。
GroupBy("City", 1);
//都市(レベル1)によってグループ化します。
//国、都市ごとの合計を追加します。
AddSubtotals(0,
AddSubtotals(0,
AddSubtotals(1,
AddSubtotals(1,
"ExtendedPrice");
"Quantity");
"ExtendedPrice");
"Quantity");
//国(レベル0)ごとの明細金額
//国(レベル0)ごとの数量
//都市(レベル1)ごとの明細金額
//都市(レベル1)ごとの数量
//アウトラインツリーを表示します。
_flex.Tree.Column = 0;
_flex.AutoSizeCol(_flex.Tree.Column);
_flex.Tree.Show(1);
135
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
この時点でプロジェクトを実行すると、国と都市ごとの販売した合計数と合計金額を表示するノード行を持つツリーが表示され
ます。これは非常に洗練されていますが、小さな問題があります。ノード行のどれかを展開すると、多数の重複した値が表示さ
れます。指定の都市の下のすべての行が同じ国と都市を持っています。
これは正確ですが、画面サイズの浪費にもなります。これらの重複した値を消去するのは簡単で、グループ化されている列の
Width をゼロに設定するだけで済みます。ただし、これを行う際は、グリッドの AllowMerging プロパティを Nodes に設定
することも忘れないようにする必要があります。これにより、ノード行に割り当てられたテキストが表示列にはみ出して表示され
ます。(別のオプションは、ノードテキストを最初の表示列に割り当てる方法ですが、通常、マージの方が、より長いテキストを
ノード行に使用できるため、より良いソリューションです)
以下に、修正したコードと最終結果を示します。
C# コードの書き方
C#
void _btnTreeCountryCity_Click(object sender, EventArgs e)
{
using (new DeferRefresh(_flex))
{
//元のソート(国、都市、販売員別など)を復元します。
ResetBinding();
//国、都市によってグループ化します。
GroupBy("Country", 0); //国(レベル0)によってグループ化します。
GroupBy("City", 1);
//都市(レベル1)によってグループ化します。
//グループ化した列を隠します。
//(これらはツリーノードに既に表示されている重複した値のみ持っています。)
//(ただし、これらを非表示にはできません。非表示にするとノードテキストも非表示になります。)
136
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
_flex.Cols["Country"].Width = 0;
_flex.Cols["City"].Width = 0;
//ノードのコンテンツを次のセルにはみ出して表示できるようにします。
_flex.AllowMerging = AllowMergingEnum.Nodes;
//国、都市ごとの合計を追加します。
AddTotals(0, "ExtendedPrice");
AddTotals(0, "Quantity");
AddTotals(1, "ExtendedPrice");
AddTotals(1, "Quantity");
//国(レベル0)ごとの明細金額
//国(レベル0)ごとの数量
//都市(レベル1)ごとの明細金額
//都市(レベル1)ごとの数量
//アウトラインツリーを表示します。
_flex.Tree.Column = 0;
_flex.AutoSizeCol(_flex.Tree.Column);
_flex.Tree.Show(1);
}
}
今、[国]と[都市
国]と[都市]列は非表示になっていますが、それらの値はまだノード行に表示されています。ツリーを縮小すると、国と都
市ごとの合計が表示されます。
Subtotal メソッドの使用
C1FlexGrid の Subtotal メソッドを使用しても、ツリーを作成できることを前に説明しました。Subtotal メソッドは、上述した
GroupBy および AddSubtotals メソッドと同じタスクを実行します。ただし、1つの手順で両方の作業を実行するため、効率
が少し向上します。
下のコードに、
、Subtotal メソッドを使用して前に行ったのと同じことを実行できることを示します。処理が少しスピードアップし、
どのヘルパーメソッドも使用されていないだけです。
C# コードの書き方
137
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
void _btnTreeCountryCity_Click(object sender, EventArgs e)
{
using (new DeferRefresh(_flex))
{
//元のソート(国、都市、販売員別など)を復元します。
ResetBinding();
//国と都市ごとにグループ化し、合計します。
_flex.Subtotal(AggregateEnum.Sum,
_flex.Subtotal(AggregateEnum.Sum,
_flex.Subtotal(AggregateEnum.Sum,
_flex.Subtotal(AggregateEnum.Sum,
0,
0,
1,
1,
"Country", "ExtendedPrice");
"Country", "Quantity");
"City", "ExtendedPrice");
"City", "Quantity");
//グループ化した列を隠します。
//(これらはツリーノードに既に表示されている重複した値のみ持っています。)
//(ただし、これらを非表示にはできません。非表示にするとノードテキストも非表示になります。)
_flex.Cols["Country"].Width = 0;
_flex.Cols["City"].Width = 0;
_flex.AllowMerging = AllowMergingEnum.Nodes;
//アウトラインツリーを表示します。
_flex.Tree.Column = 0;
_flex.AutoSizeCol(_flex.Tree.Column);
_flex.Tree.Show(1);
}
}
Subtotal メソッドは非常に便利で柔軟です。このメソッドは、数多くのオーバーロードを持つため、インデックスや名前別にグ
ループ化して合計する列を指定したり、挿入するノード行にキャプションを組み込むかどうかや、グループ化の実行方法などを
指定したりできます。以下の要約で、使用可能なオーバーロードを説明します。
1. Subtotal(AggregateEnum aggType)
メソッドのこのバージョンは、集計タイプをパラメータとしてのみ受け取ります。新しい小計を挿入する前に既存の小計
を削除する場合にのみ役立ちます。この場合、 aggType パラメータは AggregateEnum.Clear に設定されます。
2. Subtotal(AggregateEnum aggType, int groupBy, int totalOn)
Subtotal(AggregateEnum aggType, string groupBy, string totalOn)
これらは最も一般に使用されるオーバーロードです。パラメータは、挿入する集計のタイプ、およびグループ化して合計
する列です。列は、インデックスまたは名前によって参照できます。後者は上の例で使用されたものです。
3. Subtotal(AggregateEnum aggType, int groupBy, int totalOn, string caption)
Subtotal(AggregateEnum aggType, string groupBy, string totalOn, string caption)
これらのオーバーロードは、特別な caption パラメータです。 caption パラメータは、グループ化する値を識別するた
めに新しいノード行に追加されたテキストを決定します。デフォルトでは、グループ化する値が表示されるため、国に
よってグループした場合、ノード行は「アルゼンチン」、「ブラジル」などを表示します。 caption パラメータを「国:{0}」な
どの文字列に設定した場合、ノード行は代わりに「国:アルゼンチン」を表示します。
4. Subtotal(AggregateEnum aggType, int groupFrom, int groupTo, int totalOn, string caption)
138
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Subtotal(AggregateEnum aggType, string groupFrom, string groupTo, string totalOn, string caption)
これらのオーバーロードは、groupBy パラメータを groupFrom と groupTo の2つに分けます。デフォルトでは、
Subtotal メソッドは、groupBy または任意の前の列の値が変更されると必ずノード行を挿入します。
たとえば、行が「都市」列には前の行と同じ値を持ち、「国」列には異なる値を持っている場合、Subtotal メソッドはこれ
らの行が異なるグループにあると見なして、groupBy 列の値が同じ場合でも新しいノード行を挿入します。これらの集
計により、その動作をオーバーライドして、グループを識別するときに考慮される列範囲を指定できます。
アウトラインの保守
これまで、高レベルの Subtotal メソッドと、低レベルの Rows.InsertNode や Aggregate メソッドを使用して、ツリーと合計
を持つアウトラインを作成する方法について説明しました。
この時点で、アウトラインツリーはデータに基づいて作成されていても、決してデータにバインドされていないことや、グリッドま
たはデータへの変更があるときに自動的に維持されないことを覚えておくことは重要です。
ユーザーがたとえば、「ExtendedPrice」列の値を変更した場合、小計は自動的に更新されません。ユーザーがグリッドをソート
した場合、データは更新され小計が非表示になります。
アウトラインを維持するには、次の2つの一般的な方法があります。
1. ユーザーにアウトラインを無効にするような変更を行わせないようにします。これが最も簡単なオプションです。グリッド
の AllowEditing、AllowDragging、および AllowSorting プロパティを false に設定し、アウトラインに影響するよう
な任意の変更を防止します。
2. データまたはグリッドへの変更があるときにアウトラインを更新します。ハンドラをグリッドの AfterDataRefresh,
AfterSort、および AfterEdit イベントにアタッチして、アウトラインを適切に再生成します。
オプション2は通常、動的データ分析の速くてシンプルなツールを提供するため、より興味深い方法です。この方法は、
C1FlexGrid で提供されている Analyze サンプルに示されています。サンプルでは、初期アウトラインを作成し、ユーザーに
列の並べ替えを許可します。列順が変更されると、サンプルは自動的にデータを再ソートして、アウトラインを再作成します。
ユーザーは、国、製品、販売員ごとに売上を表示するシンプルなレポートを簡単に作成できます。
Node クラスの使用
Nodeクラスは、アウトラインツリーの作成と管理に使用できる数多くのメソッドとプロパティを提供します。これらのメソッドやプ
ロパティの多くは、標準の TreeView オブジェクトモデルをベースとしているため、ほとんどの開発者が精通しているはずで
す。
Node オブジェクトを取得するには、次のいずれかを使用できます。
次のように、Rows.InsertNode メソッドの戻り値を使用します。
C#
var node = _flex.Rows.InsertNode(index, level);
あるいは、次のように、行の Node プロパティを使用して既存の行のノードを取得できます。
C#
var node = _flex.Rows[index].IsNode
? _flex.Rows[index].Node
: null;
どちらの場合も、Node オブジェクトを取得したら、次のプロパティとメソッドを使用してそれを操作できます。
Level: アウトラインツリーのノードレベルを取得または設定します。
Data: Node.Row と Tree.Column によって定義されたセルの値を取得または設定します。
139
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Image: Node.Row と Tree.Column によって定義されたセルの値を取得または設定します。
Checked: Node.Row と Tree.Column によって定義されたセルのオン/オフ状態を取得または設定します。
Collapsed/Expanded: ノードの縮小/展開状態を取得または設定します。
また、次のメソッドを使用してアウトライン構造を探索することもできます。
GetCellRange(): このノードに属する行の範囲を記述した CellRange オブジェクトを取得します。
Children: このノードの下にある子ノードの数を取得します。
Nodes: このノードの子ノードを格納するノード配列を取得します。
GetNode: このノードと指定の関係(親、最初の子、次の兄弟など)を持つノードを取得します。
上の考察では、グリッドがデータの提供元のデータソースにアタッチされているバインドシナリオに焦点を当てました。非バイン
ドシナリオでもツリーとアウトラインを作成できます。この場合は、IsNode プロパティを true に設定することで任意の行をノー
ド行に変えることができるため、実質的に、いくらかシンプルになります。
グリッドは、バインドされていない場合は表示されるすべてのデータを所有し、データソースがデータを所有するときにはできな
いことを実行できます。たとえば、C1FlexGridで提供されている TreeNode サンプルに示すように、 Move メソッドを使用して
ツリーのノードをあちこち移動できます。
非バインドグリッドのノードの使用方法は、通常の TreeView コントロールのノードの使用方法と非常に類似しています。
保存とロード、および印刷
C1FlexGrid コントロールでは、グリッドを保存、ロード、および印刷できるメソッドを用意しています。
テキストファイルの保存とロード
SaveGrid メソッドは、グリッドの内容をテキストファイルに保存します。このメソッドの引数には、使用する区切り文字の種類
(コンマ(,)、タブなど任意の区切り文字)、固定セルを保存するかどうか、あるいはスクロール可能なセルのみを保存するか、
使用するエンコードの種類(ASCII または Unicode など)を指定します。保存されたテキストファイルは、後でコントロールやコ
ンマ(,)やタブ区切りされたファイルをサポートする他のアプリケーション(Microsoft Excel など)に再ロードできます。
LoadGridメソッドは、データをテキストファイルからロードします。SaveGrid メソッドまたは他のアプリケーションで作成したテ
キストファイルもロードできます。
テキストファイルの形式は非常に単純です。ファイルには、画面に表示されているとおりの書式付きの文字列として保存されま
す。セルテキストに引用符号またはセルセパレータ文字が含まれる場合、セルテキストは引用符号で囲まれます。セルテキス
トの引用符号文字は二重引用符号のみです。これは、Microsoft Excel テキストファイルでの規則と同じです。
テキストファイルはピクチャや書式情報を含みません。
SaveGrid メソッドは、グリッド全体を保存するか、(スクロール可能な、表示されている、または選択されている)特定の部分の
みを保存するかを指定できる flags 引数を持っています。
Microsoft Excel ファイルの保存とロード
Ver.2.0からは、SaveGrid と LoadGrid メソッドを使用し、テキストファイルはもちろん、Microsoft Excel ファイル(xls)、および
テキストファイルも保存したりロードしたりできるようになりました。これによって、データと共に書式情報も保存できます。
C1FlexGridBase.SaveGrid と C1FlexGridBase.LoadGrid の各メソッドを使用して Excel ファイルを保存およびロードするには、
書式引数を FileFormatEnum.Excel に設定し、これらのメソッドを通常どおり呼び出すだけです。コンピュータに Microsoft
Excel がインストールされている必要はありません。
Excel ファイルは、「ワークシート」から成る「ワークブック」を含んでいます。SaveGrid と LoadGrid の各メソッドは常に、1枚の
シートから成るブックを保存し、既存のブックの最初のシートをロードします。ロードまたは保存する複数のシートをさらに制御
したい場合、代わりに SaveExcel、LoadExcel、 LoadExcelSheetNames の各メソッドを使用します。Excel ファイルの保存と
ロード処理は、行と列のサイズ、フォント、色、書式、およびセル配置など、ほとんどのデータ型と書式情報を変換します。ただ
し、すべての書式要素を変換できるわけではありません。たとえば、グリッドは Excel セル内の値をロードしますが、基となる式
140
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
はロードしません。イメージやデータマップ、およびセルボーダーなどのその他の特性も変換されません。
データベースからのグリッドのロード
データベースからグリッドをロードすることもできます。これは、1つまたは複数のコントロールと基になるデータソースとの間の
ライブ接続を維持するデータ連結と異なります。データベースからデータをロードするには、DataReader オブジェクトを次のよ
うに使用できます。
Visual Basic コードの書き方
Visual Basic
Private Sub _btnData_Click(ByVal sender As Object, ByVal e As System.EventArgs)
' DataReaderを準備します
Dim strConn As String = "data source=MYMACHINE;initial catalog=Northwind;"
Dim myConn As New SqlConnection(strConn)
Dim myCMD As New SqlCommand("SELECT * FROM Employees", myConn)
myConn.Open()
Dim myReader As SqlDataReader = myCMD.ExecuteReader()
' データベースのスキーマからグリッドの構造を構築します
Dim dt As DataTable = myReader.GetSchemaTable()
_flex.Cols.Count = 1
Dim dr As DataRow
For Each dr In dt.Rows
Dim c As Column = _flex.Cols.Add()
c.Caption =(c.Name <<= CStr(dr("ColumnName")))
c.DataType = CType(dr("DataType"), Type)
Next dr
' グリッドを配置します
_flex.Rows.Count = 1
Dim row As Integer = 1
Dim cols As Integer = dt.Columns.Count
Dim v As Object() = CType(Array.CreateInstance(GetType(Object), cols), Object())
While myReader.Read()
myReader.GetValues(v)
_flex.AddItem(v, row ++, 1)
End While
' クリーンアップ
_flex.AutoSizeCols()
myReader.Close()
myConn.Close()
End Sub
C# コードの書き方
C#
private void _btnData_Click(object sender, System.EventArgs e)
{
// DataReaderを準備します
string strConn = "data source=MYMACHINE;initial catalog=Northwind;";
SqlConnection myConn = new SqlConnection(strConn);
SqlCommand myCMD = new SqlCommand("SELECT * FROM Employees", myConn);
myConn.Open();
141
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
SqlDataReader myReader = myCMD.ExecuteReader();
// データベースのスキーマからグリッドの構造を構築します
DataTable dt = myReader.GetSchemaTable();
_flex.Cols.Count = 1;
foreach (DataRow dr in dt.Rows)
{
Column c = _flex.Cols.Add();
c.Caption = c.Name = (string)dr["ColumnName"];
c.DataType = (Type)dr["DataType"];
}
// グリッドを配置します
_flex.Rows.Count = 1;
int row = 1;
int cols = dt.Columns.Count;
object[] v = (object[])Array.CreateInstance(typeof(object), cols);
while (myReader.Read())
{
myReader.GetValues(v);
_flex.AddItem(v, row++, 1);
}
// クリーンアップ
_flex.AutoSizeCols();
myReader.Close();
myConn.Close();
}
グリッドの印刷
PrintGrid メソッドを使用して、グリッドの内容を印刷します。このメソッドには、拡大縮小(scaling)モード、印刷/印刷プレ
ビューダイアログを表示するかどうか、ヘッダやフッタの設定などを選択できる引数があります。
コントロールは、さらにヘッダやフッタに使用するフォントなどの追加の印刷プロパティを提供するPrintParameters プロパ
ティ、およびプリンタ、用紙サイズ、用紙方向、余白などを選択するために使用できる .NET Framework の PrintDocument
オブジェクトを用いることができます。
次のサンプルコードは、PrintParameters プロパティを使用して用紙方向、マージン、ヘッダおよびフッタのフォントを設定しま
す。次に、PrintGrid メソッドを呼び出して、印刷プレビューダイアログを表示します。
Visual Basic コードの書き方
Visual Basic
' グリッドの PrintDocumentオブジェクトを取得します
Dim pd As Printing.PrintDocument
pd = flex.PrintParameters.PrintDocument()
' ページ設定を行います(用紙方向:横向き 左余白:150)
With pd.DefaultPageSettings
.Landscape = True
.Margins.Left = 150
End With
' ヘッダとフッタのフォントを設定します
flex.PrintParameters.HeaderFont = New Font("Arial Black", 14, FontStyle.Bold)
flex.PrintParameters.FooterFont = New Font("Arial Narrow", 8, FontStyle.Italic)
' グリッドをプレビューします
142
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.PrintGrid("VB Tutorial", _
PrintGridFlags.FitToPageWidth + _
PrintGridFlags.ShowPreviewDialog, _
"VB Tutorial" + _
Chr(9) + Chr(9) + Format(DateTime.
C# コードの書き方
C#
// グリッドの PrintDocumentオブジェクトを取得します
System.Drawing.Printing.PrintDocument pd;
pd = flex.PrintParameters.PrintDocument;
// ページ設定を行います(用紙方向:横向き 左余白:150)
pd.DefaultPageSettings.Landscape = true;
pd.DefaultPageSettings.Margins.Left = 150;
// ヘッダとフッタのフォントを設定します
flex.PrintParameters.HeaderFont = new Font("Arial Black", 14, FontStyle.Bold);
flex.PrintParameters.FooterFont = new Font("Arial Narrow", 8, FontStyle.Italic);
// グリッドをプレビューします
flex.PrintGrid("C# Tutorial",
PrintGridFlags.FitToPageWidth |
PrintGridFlags.ShowPreviewDialog,
"C# Tutorial" + (char)(9) + (char)(9) +
string.Format("{0:yyyy/MM/dd}", DateTime.Now),
(char)(9) + (char)(9) + "Page {0} of {1}");
フィルタリング
グリッドにおけるデータのフィルタリングは、通常2つの形式で提供されます。
ヘッダベース
ヘッダベース: フィルタが適用された各列上にフィルタアイコンが表示されます。ユーザーはフィルタアイコンのクリック
により、フィルタを確認、編集できます。 これは Windows 7/Vista および C1FlexGrid コントロールで使用されているメ
カニズムです。このタイプのフィルタの主な利点には、(1)ユーザーが、どの列がフィルタリングされているかがわかるこ
と、 (2)フィルタリングが画面上に余分な領域を必要としないこと、(3)より使いやすいフィルタエディタを利用でき、カスタ
マイズもより簡単なこと、があります。
行フィルタ:
行フィルタ:行フィルタは常に表示されており、ユーザーがその行に値や式を入力することができます。このタイプのフィ
ルタの主な利点は、フィルタリングされている列および現在のフィルタ条件を、ユーザーが常に見ることができる点で
す。主な欠点は、フィルタ用のための領域が必要なことと、通常のグリッド操作の邪魔になる可能性があることです。
フィルタ行はC1FlexGrid コントロールには組み込まれていませんが、実装は比較的簡単です。実装方法
は、FilterRow サンプル
サンプルで紹介しています。
以下で示すコード例は、製品付属の ColumnFilters サンプル
サンプル、および CustomFilters サンプル
サンプルから抜粋したものがほとんど
です。これらの機能を実行する完全なプロジェクトについては、各サンプルを参照してください。
AllowFilteringプロパティ
プロパティ
ヘッダベースのフィルタを実装するために、C1FlexGrid コントロールは、列の移動とサイズ調整の実装に使用されているもの
と同じパターンを採用しています。グリッドは、コントロールレベルでフィルタリングを制御する新しいAllowFiltering プロパティ
を持ち、グリッドの Column オブジェクトもまた、列レベルでフィルタリングを制御するAllowFiltering プロパティを持っていま
す。
簡単なフィルタリングのシナリオを実現するには、ユーザーはグリッドのプロパティを True に設定します。後は、列
143
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
のAllowFiltering プロパティの値を変更することで、特定の列に対して、フィルタリングの動作を無効にしたり、カスタマイズし
たりできます。列のAllowFiltering プロパティに設定可能な値は以下のとおりです。
Default: グリッドはColumnFilter 型のフィルタを自動的に作成します。このフィルタは後述する ValueFilter と
ConditionFilter を合わせたものです。
ByValue: グリッドはValueFilter 型のフィルタを自動的に作成します。このフィルタは、表示すべき値のリストを保持し
ます。リスト上にない値は、エンドユーザーには表示されません。
ByCondition: グリッドはConditionFilter 型のフィルタを自動的に作成します。このフィルタでは、”指定の値より大き
い”、”指定の値を含む”などといった条件を1つまたは2つ指定します。2つの条件を、AND、ORオペレータで結合する
ことも可能です。
Custom: グリッドはフィルタを自動的に作成しません。開発者が、フィルタのインスタンスを作成し、列の Filter プロパ
ティに明示的に割り当てる必要があります。
None: 列はフィルタリングされません。.
デフォルトでは、C1FlexGrid コントロールは列フィルタエディタをローカライズして、CurrentUICulture 設定で指定された言
語を使用します。しかし、Language プロパティを使用し、デフォルトをオーバーライドして、グリッドが列フィルタエディタを表示
するときに使用される言語を指定できます。
フィルタが適用された列には、マウスポインタを置かなくてもヘッダー上にフィルタアイコンが表示されます。これは
ProductName と Quantity 列ヘッダーがフィルタアイコンを表示している画像内に表示されます。
組み込みフィルタが自動ローカライズをサポートする言語は、英語、スペイン語、フランス語、イタリア語、ポルトガル語、ドイツ
語、オランダ語、ロシア語、日本語、ギリシャ語、デンマーク語、フィンランド語、ノルウェー語、スウェーデン語、アラビア語、
ポーランド語、中国語、トルコ語、ペルシア語(ファルシ語)、韓国語、およびヘブライ語です。ローカライズは内蔵されているた
め、サテライト dll は不要です。
Value Filter
ValueFilter は概念的に非常にシンプルです。値のリストを持ち、リストにあげられた値だけがグリッド上に表示されます。リス
トに null が設定されると、フィルタは無効化され、すべての値が表示されます。このタイプのフィルタは、名前や列挙型のよう
に別々の値を持つ列のフィルタリングに向いています。
ValueFilter エディタはチェックボックスが付いた値のリストで構成されています。ユーザーは、1度にすべての値をチェックし
たり、あるいはチェックをはずしたりすることもできます。長いリストの操作も、高度な組み込みのキーボードナビゲーションを使
えば簡単です。エディタは、フレキシブルな検索バッファを実装しており、ユーザーが値の一部を入力することで値に位置づけ
ることが可能です。たとえば、”Hilton”と入力すると、"New York Hilton"、"Prince Edward Hilton"、 あるいは"Paris Hilton"な
ど、"Hilton"を含む次の値が選択されます。また、[Ctrl]+[Up]キーまたは[Ctrl]+[Down]キーを押すと、次のまたは前の
チェックされた要素へと移動します。
値は、現在、列に割り当てられた Format を使ってリスト上に表示されます。
注意:
注意:グリッドでフィルタを1つ以上の列に設定する場合、ValueFilterエディタで表示されるフィルタリング値が、前回の
フィルタが設定された後だけ表示されます
この画像は、ValueFilter エディタを表しています。
144
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Condition Filter
ConditionFilter はよりフレキシブルです。ユーザーは特定の値を選択する代わりに、“指定の値より大きい”、”指定の値で始
まる”、または”指定の値を含む”といったオペレータを使って、条件を2つまで指定することができます。
このタイプのフィルタは数値や日付/時刻の値のように”連続的な”値を含む列のフィルタリングに向いています。
この画像は、ConditionFilter エディタを表しています。
145
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Custom Filters
カスタムフィルタは特殊な値を扱うために作成されます。たとえば、色や地理データ、あるいは独自のデータ型などをフィルタリ
ングするのに向いています。
カスタムフィルタを作成するには、開発者は2つのクラスを作成しなくてはなりません。
Filter: このクラスはIC1ColumnFilter インタフェースを実装する必要があり、これにより、特定の値にフィルタを適用
したり、フィルタをリセットしたり、フィルタのパラメータの確認・編集に使用されるエディタを返したりするために使用され
るメソッドを指定します。
Filter Editor: このクラスは必ず Control から継承され、 IC1ColumnFilterEditor インタフェースを実装する必要が
あり、これにより、エディタを初期化したり、フィルタへの変更を適用したりするために使用されるメソッドを指定します。
製品付属のCustomFilters サンプルでは、Color型、DateTime型、およびString型の値のフィルタリングに使用される3つの
カスタムフィルタを実装しています。
プログラムによるフィルタの管理
前述のように、すべての列で列のフィルタリングを有効にするには、グリッドのAllowFiltering プロパティを True に設定する
だけで充分です。しかしながら、多くの場合、フィルタリングに対してより細かな制御が必要になることもあります。それは、
個々の列において、AllowFilteringプロパティと Filter プロパティを変更することで実現できます。
たとえば、以下のコードではフィルタリングを有効にしていますが、String 型の列でのフィルタリングは禁止しています。
Visual Basic コードの書き方
VisualBasic
' グリッドのフィルタリングを有効にします。
146
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
_flex.AllowFiltering = True
' string 型の列はフィルタリングを禁止します。
For Each c As Column In _flex.Cols
If c.DataType Is GetType(String) Then
c.AllowFiltering = AllowFiltering.None
Else
c.AllowFiltering = AllowFiltering.Default
End If
Next
C# コードの書き方
C#
// グリッドのフィルタリングを有効にします。
_flex.AllowFiltering = true;
// string 型の列はフィルタリングを禁止します。
foreach (Column c in _flex.Cols)
{
c.AllowFiltering = c.DataType == typeof(string)
? AllowFiltering.Default
: AllowFiltering.None;
}
フィルタを作成して列に割り当てるか、または既存のフィルタを取得して各種プロパティを変更することにより、フィルタリングの
処理をさらにカスタマイズすることができます。たとえば、以下のコードでは、 ConditionFilterを作成して”C”の文字で始まる
すべての要素を選択するように構成し、その後で新しいフィルタを ProductName 列に割り当てています。
Visual Basic コードの書き方
VisualBasi
' グリッドのフィルタリングを有効にします。
__flex.AllowFiltering = True
' 新しいConditionFilterを作成します。
Dim Filter = New ConditionFilter()
' "C"で始まる要素を選択するフィルタを構成します。
Filter.Condition1.Operator = ConditionOperator.BeginsWith
Filter.Condition1.Parameter = "C"
' 新しいフィルタを"ProductName"列に割り当てます。
_flex.Cols("ProductName").Filter = Filter
C# コードの書き方
C#
// グリッドのフィルタリングを有効にします。
_flex.AllowFiltering = True
' 新しいConditionFilterを作成します。
ConditionFilter filter = new ConditionFilter();
// "C"で始まる要素を選択するフィルタを構成します。
filter.Condition1.Operator = ConditionOperator.BeginsWith;
147
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
filter.Condition1.Parameter = "C";
// 新しいフィルタを"ProductName"列に割り当てます。
_flexCustom.Cols["ProductName"].Filter = filter;
プログラムによるフィルタの適用
フィルタは、ユーザーがフィルタを編集したときに適用されます。データが変更された時点では、フィルタは自動的に適用されま
せん。フィルタを現在グリッドにロードされているデータに適用するには、グリッドの ApplyFilters メソッドを呼び出します。
たとえば、以下のコードでは、ユーザーがグリッド上のデータを編集するときに、<適用>ボタンを有効にしています。<適用>ボ
タンをクリックすることで、フィルタを適用し、次の変更までボタンを無効にします。
Visual Basic コードの書き方
Visual Basic
public Sub New()
{
InitializeComponent()
' データを取得します。
Dim da = New OleDbDataAdapter("select * from products", GetConnectionString())
Dim dtProducts = New DataTable()
da.Fill(dtProducts)
' グリッドにデータを連結します。
_flex.DataSource = dtProducts
' グリッドのフィルタリングを有効にします。
_flex.AllowFiltering = true
' <適用>ボタンを有効にするために、変更を監視します。
AddHandler _flex.AfterEdit, AddressOf _flex_AfterEdit
AddHandler _btnApplyFilters.Click, AddressOf _btnApplyFilters_Click
End sub
C# コードの書き方
C#
public Form1()
{
InitializeComponent();
// データを取得します。
var da = new OleDbDataAdapter("select * from products", GetConnectionString());
var dtProducts = new DataTable();
da.Fill(dtProducts);
// グリッドにデータを連結します.
_flex.DataSource = dtProducts;
// グリッドのフィルタリングを有効にします。
_flex.AllowFiltering = true;
148
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// <適用>ボタンを有効にするために、変更を監視します。
_flex.AfterEdit += _flex_AfterEdit;
}
上記のコードでは、グリッドをデータソースに連結し、 AllowFiltering プロパティを True に設定することでフィルタリングを有
効にし、AfterEditイベントにイベントハンドラを関連付けています。このイベントハンドラの実装は下記のようになります。
Visual Basic コードの書き方
Visual Basic
Private Sub _flex_AfterEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs)
Dim c As C1.Win.C1FlexGrid.Column
For Each c In _flex.Cols
If Not (c.ActiveFilter Is Nothing) Then
_btnApplyFilters.Enabled = True
End If
Next c
End Sub
C# コードの書き方
C#
void _flex_AfterEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
foreach (C1.Win.C1FlexGrid.Column c in _flex.Cols)
{
if (c.ActiveFilter != null)
{
_btnApplyFilters.Enabled = true;
break;
}
}
}
このコードは、すべての列をスキャンして、列にフィルタが定義されているかどうかを判断します。アクティブなフィルタが捕捉さ
れると、コードが現在のデータに対してフィルタを適用するボタンを有効にします。ボタンがクリックされると、以下のイベントラ
を実行します。
Visual Basic コードの書き方
Visual Basic
Private Sub _btnApplyFilters_Click(ByVal sender As Object, ByVal e As
System.EventArgs)
_flex.ApplyFilters()
_btnApplyFilters.Enabled = False
End sub
C# コードの書き方
C#
private void _btnApplyFilters_Click(object sender, EventArgs e)
{
149
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
_flex.ApplyFilters();
_btnApplyFilters.Enabled = false;
}
コードは単純に、すべてのアクティブなフィルタを適用し、次の変更までボタンを無効にします。ボタンのクリックを取得する代
わりに編集後に毎回、フィルタを適用したい場合、以下のようにAfterEdit イベントハンドラから直接ApplyFilter を呼び出す
こともできます。
Visual Basic コードの書き方
Visual Basic
Pivate Sub _flex_AfterEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs)
'フィルタを適用します。
_flex.ApplyFilters()
End Sub
C# コードの書き方
C#
private void _flex_AfterEdit(object sender, RowColEventArgs e)
{
// フィルタを適用します。
_flex.ApplyFilters();
}
フィルタ動作のカスタマイズ
フィルタが適用されると、グリッドは行の Visible プロパティを False に設定して行を非表示にします。しかし、フィルタリング動
作をカスタマイズできるように、グリッドは、BeforeFilter イベントとAfterFilterイベントを発生させます。たとえば、行を表示/非
表示する代わりに、どの行がフィルタを通過したか、あるいは通過しなかったかを示す個別のスタイルを適用したいとします。
これは、コードにより簡単に実現できます。
Visual Basic コードの書き方
Visual Basic
Public Sub New()
InitializeComponent()
' グリッドを設定します。
_flex.AllowFiltering = True
_flex.DataSource = dtInvoices
' フィルタで除外された行のスタイルを作成します。
Dim cs = _flex.Styles.Add("filteredOut")
cs.BackColor = Color.LightSalmon
cs.ForeColor = Color.DarkOrange
' イベントハンドラを関連付けます。
AddHandler _flex.BeforeFilter, AddressOf _flex_BeforeFilter
AddHandler _flex.AfterFilter, AddressOf _flex_AfterFilter
End Sub
C# コードの書き方
150
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
public Form1()
{
InitializeComponent();
// グリッドを設定します。
_flex.AllowFiltering = true;
_flex.DataSource = dtInvoices;
// フィルタで除外された行のスタイルを作成します。
var cs = _flexStyles.Styles.Add("filteredOut");
cs.BackColor = Color.LightSalmon;
cs.ForeColor = Color.DarkOrange;
// イベントハンドラを関連付けます。
_flex.BeforeFilter += _flex_BeforeFilter;
_flex.AfterFilter += _flex_AfterFilter;
}
このコードは、フィルタを通過しなかった行を表すのに(それらを非表示にする代わりに)使用されるカスタムスタイルを作成し
ます。次に、BeforeFilter イベントとAfterFilterイベントにイベントハンドラをアタッチします。イベントハンドラのコードは以下の
ようになります。
Visual Basic コードの書き方
Visual Basic
' フィルタが適用される前に描画を保留します。
Private Sub _flex_BeforeFilter(ByVal sender As Object, ByVal e As CancelEventArgs)
_flex.BeginUpdate()
End Sub
' フィルタの適用後にスタイルを適用します。
Private Sub _flex_AfterFilter(ByVal sender As Object, ByVal e As EventArgs)
' フィルタで除外された行を表すスタイルを取得します。
Dim cs = _flexStyles.Styles("filteredOut")
' すべての行にスタイルを適用します。
Dim r As Integer
For r = _flex.Rows.Fixed To _flex.Rows.Count - 1
Dim Row = _flex.Rows(r)
If (Row.Visible) Then
' 通常の行:スタイルをリセット
Row.Style = Nothing
Else
' フィルタで除外された行:表示してスタイルを設定
Row.Visible = True
Row.Style = cs
End If
Next
' 更新を再開します。
_flex.EndUpdate()
End Sub
C# コードの書き方
151
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
// フィルタが適用される前に描画を保留します。
private void _flex_BeforeFilter(object sender, CancelEventArgs e)
{
_flexStyles.BeginUpdate();
}
// フィルタの適用後にスタイルを適用します。
private void _flexStyles_AfterFilter(object sender, EventArgs e)
{
// フィルタで除外された行を表すスタイルを取得します。
var cs = _flex.Styles["filteredOut"];
// すべての行にスタイルを適用します
for (int r = _flexStyles.Rows.Fixed; r < _flexStyles.Rows.Count; r++)
{
var row = _flexStyles.Rows[r];
if (row.Visible)
{
// 通常の行:スタイルをリセット
row.Style = null;
}
else
{
// フィルタで除外された行:表示してスタイルを設定
row.Visible = true;
row.Style = cs;
}
}
// 更新を再開します。
_flexStyles.EndUpdate();
}
BeforeFilterイベントハンドラは、本バージョンで追加されたBeginUpdate メソッドを呼び出し、フィルタで除外された行にカスタ
ムスタイルが適用されるまで、グリッド自身が再描画されるのを抑制します。
AfterFilter イベントハンドラははじめに、フィルタで除外された行を表すために作成したスタイルを取得します。それからグリッ
ドの行をスキャンして、Visible プロパティが False に設定されているすべての行に対して新しいスタイルを適用します。これら
が、フィルタによって非表示にされていた行です。この処理が終わると、コードはEndUpdateメソッドを呼び出し、グリッドの更
新を再開します。
フィルタリング
フィルタリングUIのカスタマイズ
のカスタマイズ
デフォルトのフィルタリングの動作とUIは、列のフィルタリングに関わる大多数のシナリオに対応していると思いますが、列フィ
ルタのクラスを独立的に使用し、独自のユーザーインタフェースを実装することも可能です。
たとえば、以下のコードは、ConditionFilter クラスを使用して iTunes スタイルのサーチボックスをC1FlexGrid に実装する方
法を示しています。このタイプの検索では、ユーザーはある値を入力すると、自動的にグリッドの行をフィルタリングして、いず
れかの列に検索文字列を含む行を表示します。
iTunesスタイルの検索の実装は、フィルタのパラメータとして使用されるテキストを含むテキストボックスからはじめます。ユー
ザーがテキストボックスでタイピングをやめた1/2ミリ秒後にフィルタが適用されるように、Timer コントロールも定義します。
152
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
public Sub New()
InitializeComponent()
' ユーザーがサーチボックスへのタイピングをやめた1/2秒後に
' フィルタを適用するようタイマーを構成します。
_timer.Interval = 500
AddHandler _timer.Tick, AddressOf t_Tick
' サーチボックスの変更を監視します。
AddHandler _txtSearch.TextChanged, AddressOf _txtSearch_TextChanged
End Sub
' サーチボックスのテキストの変更時、タイマーを再開します。
Private Sub _txtSearch_TextChanged(ByVal sender As Object, ByVal e As EventArgs)
_timer.Stop()
_timer.Start()
End Sub
C# コードの書き方
C#
public Form1()
{
InitializeComponent();
// ユーザーがサーチボックスへのタイピングをやめた1/2秒後に
// フィルタを適用するようタイマーを構成します。
_timer.Interval = 500;
_timer.Tick += t_Tick;
// サーチボックスの変更を監視します。
_txtSearch.TextChanged += _txtSearch_TextChanged;
}
// サーチボックスのテキストの変更時、タイマーを再開します。
void _txtSearch_TextChanged(object sender, EventArgs e)
{
_timer.Stop();
_timer.Start();
}
これでタイマーは構成できたので、あとは、タイマー作動時にフィルタを作成して適用するだけです。
Visual Basic コードの書き方
Visual Basic
' タイマー作動時にフィルタを適用します。
Private Sub _t_Tick(ByVal sender As Object, ByVal e As EventArgs)
' ひとまず終了...
_timer.Stop()
' フィルタを構成します。
filter As New ConditionFilter()
filter.Condition1.Operator = C1.Win.C1FlexGrid.ConditionOperator.Contains
153
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
filter.Condition1.Parameter = _txtSearch.Text
' フィルタを適用します。
_flex.BeginUpdate()
For r As Integer = _flexSearch.Rows.Fixed To _flexSearch.Rows.Count - 1
Dim visible As Boolean = False
For c As Integer = _flexSearch.Cols.Fixed To _flexSearch.Cols.Count - 1
If _searchFilter.Apply(_flexSearch(r, c)) Then
visible = True
count += 1
Exit For
End If
Next
_flex.Rows(r).Visible = visible
Next
_flex.EndUpdate()
End Sub
C# コードの書き方
C#
// タイマー作動時にフィルタを適用します。
void t_Tick(object sender, EventArgs e)
{
// ひとまず終了...
_timer.Stop();
// フィルタを構成します。
var filter = new C1.Win.C1FlexGrid.ConditionFilter();
filter.Condition1.Operator = C1.Win.C1FlexGrid.ConditionOperator.Contains;
filter.Condition1.Parameter = _txtSearch.Text;
// フィルタを適用します。
_flex.BeginUpdate();
for (int r = _flex.Rows.Fixed; r < _flex.Rows.Count; r++)
{
bool visible = false;
for (int c = _flex.Cols.Fixed; c < _flex.Cols.Count; c++)
{
if (filter.Apply(_flex[r, c]))
{
visible = true;
break;
}
}
_flex.Rows[r].Visible = visible;
}
_flex.EndUpdate();
}
プロパティグループ
C1FlexGrid コントロールには、数多くのプロパティ、メソッド、およびイベントが用意されています。コントロールを効率的に使
用するために、これらのすべてを把握しておく必要はありません。
154
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ここでは、これらのうち最も重要なプロパティ、メソッド、およびイベントを用途別にまとめます。複数のグループに重複してリス
トされている要素もあります。それぞれの詳細については、リファレンスの項を参照してください。
1. グリッドのレイアウト
Rows, Cols, AutoSizeCols, ScrollBars, ScrollBarsVisible, ScrollOptions
2. カーソルとセル範囲の選
SelectionMode, Select, ShowCell, Row, Col, RowSel, ColSel, Selection, MouseRow, MouseCol,
BeforeRowColChange, AfterRowColChange, BeforeSelChange, AfterSelChange, KeyActionTab,
KeyActionEnter
3. 編集
AllowEditing, ComboList, EditMask, BeforeEdit, StartEdit, ValidateEdit, AfterEdit, StartEditing,
FinishEditing, Editor, CellButtonClick, KeyDownEdit, KeyPressEdit, KeyUpEdit, ChangeEdit
4. セル値の設定と参照
Item (インデクサ), GetData, GetDataDisplay, SetData, GetCellRange, GetCellImage, SetCellImage, Clip,
FindRow, Aggregate, CellChanged
5. ユーザーインタフェース
AllowEditing, AllowMerging, AllowResizing, AllowDragging, AllowFiltering, AllowSorting, BeforeSort,
AfterSort, AutoSearch, AutoSearchDelay, BeforeDragColumn, AfterDragColumn, BeforeDragRow,
AfterDragRow, BeforeResizeColumn, AfterResizeColumn, BeforeResizeRow, AfterResizeRow,
ShowScrollTip
6. アウトラインとデータのグループ化
Subtotal, Tree, IsNode, Level, Collapsed, BeforeCollapse, AfterCollapse
7. セルのマージ
AllowMerging
8. データ連結
DataSource, DataMember, AfterDataRefresh, AutoResize, GridError
9. グリッドの保存、ロード、印刷
LoadGrid, SaveGrid, LoadExcel, SaveExcel, ClipSeparators, PrintGrid
10. ドラッグ&ドロップ
DragMode, DropMode, BeforeMouseDown
11. フィルタリング
155
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
データ連結
データ連結のプロセスによって、1人または複数のデータユーザーが単一のデータプロバイダに同時接続することが可能にな
ります。データ連結したグリッド上でカーソルを動かすと、同じデータソースに接続されている他のコントロールも変更されて新
しいカレントレコードを反映します。データ連結したグリッドの値を編集すると、同じデータソースに接続されている他のコント
ロールも変更されて新しい値を反映します。
C1FlexGridは、ADO.NET データソースオブジェクト(DataTable、
、DataView、
、DataSet、
、DataViewManagerなど)へのデー
タ連結をサポートします。
グリッドをデータソースに連結するには、データソースオブジェクトをグリッドの DataSource プロパティに設定します。データ
ソースオブジェクトが複数のテーブルを持っている場合は、使用テーブルを指定する文字列を DataMember プロパティに設
定する必要があります。
あるいは、SetDataBinding メソッドを1回呼び出せば両方のプロパティを同時に設定することもできます。
新しいデータソースをグリッドに割り当てると、グリッドは自動的にその列を更新してデータソース内で使用可能な列に連結し
ます。次に、移動、表示/非表示、削除などの各操作を行って列をカスタマイズできます。また、Width、EditMask、Format
などの各列プロパティを設定することもできます。
注意:
注意:データソースへの連結後にグリッド列を並べ替える例については、製品付属の「ColumnOrder サンプル」を参照
してください。
データソースオブジェクトの作成の詳細については、.NET Framework のマニュアルを参照してください。
データソースへの連結
コード行を記述しなくても、Visual Studio のデータソース構成ウィザード
データソース構成ウィザード を使用すると C1FlexGrid をデータソースに簡単に連
データソースに簡単に連
結できます。ウィザードにアクセスする方法には2つあり、プロパティウィンドウの DataSource プロパティを使用する
か、C1FlexGrid タスク メニューの[データソースの選択]ボックスを使用します。C1FlexGrid タスク
タスクメニューの詳細について
は、「C1FlexGrid タスク」を参照してください。
プロパティウィンドウの DataSource プロパティの横のドロップダウン矢印、またはC1FlexGrid タスク
タスクメニューの[データソース
データソース
の選択
の選択]ボックスをクリックすると、使用可能なデータソースのリストから選択したりプロジェクトにデータソースを追加したりでき
ます。プロジェクトにデータソースを追加するには、〈プロジェクトにデータソースを追加
プロジェクトにデータソースを追加〉をクリックし、[データソース構成ウィ
データソース構成ウィ
ザード
ザード]を開きます。
156
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
データソース構成ウィザード
データソース構成ウィザードでは、手順に従ってデータソースの追加を体験します。[データソースの種類を選択
データソースの種類を選択]ページでは、
情報の収集元となるアプリケーションの種類を選択できます。デフォルト選択は[データベース
データベース]です。
157
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[データ接続の選択]ページで、データベースの場所を指定できます。まだデータベースに接続していない場合、〈新しい接続
新しい接続〉
ボタンをクリックして新しい接続を指定できます。〈新しい接続
新しい接続〉ボタンをクリックすると、[接続の追加
接続の追加]ダイアログボックスが開
きます。ここで、データベースの場所を参照して接続をテストできます。
158
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
このウィザードは、[接続文字列をアプリケーション構成ファイルに保存する
接続文字列をアプリケーション構成ファイルに保存する]ページで、接続を保存して名前を付けます。この
ページで、名前を指定するか、ウィザードで提供されるデフォルトを使用できます。
159
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[データベースオブジェクトの選択
データベースオブジェクトの選択]ページで、データセットに含めるテーブルとフィールドを指定できます。また、データセットの
名前を提供するか、ウィザードで提供されるデフォルトを使用することもできます。
160
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ウィザードは、DataSet、BindingSource、TableAdapter を作成し、それらをプロジェクトに追加します。フォームをダブルクリッ
クすると、Form_Load イベントにデータベースを記述するコードが自動的に生成されていることもわかります。
データの取得と設定
C1FlexGrid は、連結モードと非連結モードのどちらの方法も使用できます。連結モードでは、グリッドはデータソースに接続さ
れ、グリッドに表示されるすべてのデータはデータソースから取得します。このモードでは、グリッド上のデータを変更すると元
のデータソースのデータも変更されます。非連結モードでは、グリッドはグリッド独自のデータソースを管理します。
連結モードと非連結モードのどちらの場合も、C1FlexGrid 内のデータに最も簡単にアクセスするために、Row と Columnの
各インデクサを使用します。このインデクサで、取得または設定対象のデータが格納されている行または列内のセルを指定で
きます。たとえば、次のサンプルコードは、グリッドの2行目のデータを選択します。
Visual Basic コードの書き方
Visual Basic
flex.Rows(2).Selected = True
C# コードの書き方
161
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
flex.Rows[2].Selected = true;
連結モードと非連結モードのどちらの場合も、C1FlexGrid のデータに最も簡単にアクセスするには、 Item プロパティを使用
します。このプロパティは行および列インデックスを取り込み、セルに格納されているデータを取得または設定するインデクサ
として使用できます(列名をインデックスとして使用することもできます)。たとえば、次のサンプルコードは、グリッドの最初の列
に行番号を格納します。
Visual Basic コードの書き方
Visual Basic
For r As Integer= flex.Rows.Fixed To
flex.Rows.Count - 1
flex(r, 0) = r
Next
C# コードの書き方
C#
for (int r = flex.Rows.Fixed; r <= flex.Rows.Count
r++)
{
flex[r, 0] = r;
}
値をセルに格納すると、グリッドはその値を列に指定されている DataType に変換しようとします。変換できない場合、グリッド
は GridError イベントを発生させてセルを変更しません。SetData メソッドを使用して coerce 引数を False に設定すると、こ
の動作を変更できます。
インデックスを使用してデータを取得するとき、グリッドはセルに格納されている実データを返します。書式付きのデータ(グリッ
ドがユーザーが見えるように表示しているデータ)を含む文字列を取得するには、GetDataDisplay メソッドを使用します。
また、Clip プロパティを使用して、セル範囲の内容を設定または取得することもできます。このプロパティは特に、クリップボー
ドやドラッグ&ドロップ操作を処理する場合に便利です。デフォルトでは Clip プロパティは、セル間をタブ文字(Chr(9))で区
切った文字列を返し、行と行の間には復帰文字(Chr(13))を返します。別の区切り文字を使用するには、ClipSeparatorsプロ
パティを変更します。
CellRange オブジェクトでは、任意のセル範囲の内容を設定したり取得することができます。
162
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
チュートリアル
以下の各チュートリアルでは、C1FlexGrid コントロールのいくつかの主要機能を説明します。チュートリアルごとに、いくつか
の簡単なプロジェクトの作成を通して各手順を詳しく説明します。また、製品には、より複雑なサンプルプログラムが収録され
ており、参考として使用できます。
各チュートリアルの内容は次のとおりです。
チュートリアル
説明
Edit チュートリアル
基本的なデータ入力グリッドからスタートし、このチュートリアルでは、データの書式設定、チェック
ボックス、ドロップダウンリスト、入力マスク、データの正当性検査、およびクリップボードへの対応
を実装します。
Outline チュートリアル
C1FlexGrid をアウトライナとして使用し、構造化(階層)データを表示します。
Data Analysis チュート
リアル
さまざまな製品、地域、販売員の売上データを含むグリッドからスタートし、このチュートリアルでは
動的なレイアウト(列の順序)、自動ソート、セルマージ、自動小計行、アウトラインを実装します。
Edit チュートリアル
このチュートリアルでは、基本的なデータ入力グリッドから始め、次のような機能を追加します。
1.
2.
3.
4.
5.
6.
データの書式設定
チェックボックス
ドロップダウンリスト
複雑なデータの正当性検査
クリップボードへの対応
カスタムエディタ
これらの機能を追加した最終的なアプリケーションの外観は次のようになります。
手順
手順1: コントロールの作成
新規にプロジェクトを作成します。ツールボックスの C1FlexGrid アイコンをクリックしてからフォーム上をクリックし、オブジェク
トが適切なサイズになるまで C1FlexGrid コントロールをドラッグしてフォームに追加してください。
ツールボックスに C1FlexGrid コントロールが見つからない場合は、「コンポーネントをプロジェクトに組み込む方法」を参考に
してください。
1. Visual Studio のプロパティウィンドウを使用し、C1FlexGrid コントロールのプロパティを下記のように設定します。
163
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
プロパティ
設定
(Name)
fg
Dock
Fill
Cols.Count
5
Cols.Fixed
0
2. フォームのキャプション部分をダブルクリックし、コードウィンドウを開きます。ファイルの一番上に、次のステートメントを
追加します。
Visual Basic コードの書き方
Visual Basic
Imports C1.Win.C1FlexGrid
C# コードの書き方
C#
using C1.Win.C1FlexGrid;
これによって、C1FlexGrid アセンブリで定義されているオブジェクトを、名前空間の一部だけを使ってプロジェクト内で
参照でき、入力の手間を省くことができます。
3. [Column タスク
タスク]メニューまたは[FlexGrid 列エディタ
列エディタ]からデザイナを使用するか、コードによって以下のコードを入
力(またはコピー
またはコピー)し、列を設定します。
デザイナの場合
グリッドの1番目の列を選択します。列の[Column タスク
タスク]メニューが開きます。
[列キャプション]と[データフィールド]の各ボックスに「製品」と入力します。
残りの列の[列キャプション
列キャプション]と[データフィールド
データフィールド]の各ボックスを以下のように設定します。
Column1
Column
地域
列キャプション
データフィール
ド
地域
Column 2
Column
販売員
列キャプション
データフィール
ド
販売員
Column 3
Column
売上
列キャプション
データフィール
ド
164
売上
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Column1
Column 4
Column
ボーナス
列キャプション
データフィール
ド
ボーナス
また、列は、以下のように[FlexGrid 列エディタ
列エディタ]から設定することもできます。
[C1FlexGrid タスク
タスク]メニューの〈列エディタ
列エディタ〉をクリックし、[FlexGrid 列エディタ
列エディタ]を開きます。[FlexGrid 列エディタ
列エディタ]へ
のアクセス方法の詳細については、18:28 2012/12/17列エディタにアクセス を参照してください。
右ペインで、列0を選択します。
左ペインで、Caption と Name の各プロパティを「製品
製品」に設定します。
残りの列の Caption と Name の各プロパティを以下のように設定します。
Column 1
Name
地域
Caption
地域
Column 2
Name
販売員
Caption
販売員
Column 3
Name
売上
Caption
売上
Column 4
Name
165
ボーナス
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Column 1
Caption
ボーナス
設定が終わったら〈OK〉をクリックしてエディタを閉じます。
コードの場合
Form_Load イベントに次のコードを追加します。
Visual Basic コードの書き方T
Visual Basic
' 列を設定します。
Dim cols As String = "製品|地域|販売員|売上
Dim colNames As String() = cols.Split("|")
Dim i%For i = 0 To C1FlexGrid1.Cols.Count - 1
C1FlexGrid1(0, i) = colNames(i)
C1FlexGrid1.Cols(i).Name = colNames(i)Next
C# コードの書き方
C#
// 列を設定します。
string cols = "Product|Region|Salesperson|Sales|Bonus";
string[] colNames = cols.Split(new char[] { '|' });
for (int i = 0; i <= this.c1FlexGrid1.Cols.Count - 1; i++)
{
c1FlexGrid1[0, i] = colNames[i];
c1FlexGrid1.Cols[i].Name = colNames[i];
}
プログラムの実行と検証:
第1段階はこれで完了です。[F5]キーを押してプロジェクトを実行すると、コントロールにデータを入力できます。直接文字を入
力することも、[F2]キーまたは[Space]キーを押して既存の項目を修正することもできます。
手順
手順2: 列タイプとデータの書式設定
166
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
数値やデータ値をグリッドに表示するときは通常、それらの値を一定の書式にしたがって整然と表示する必要がありま
す。C1FlexGrid コントロールでは、各列の DataType および Format の各プロパティを指定することでこれらを実現できま
す。これらのプロパティは、デザイナでもコードでも設定できます。
デザイナの場合
1.
2.
3.
4.
グリッドの「売上」列を選択します。「売上」列の[Column タスク
タスク]メニューが開きます。
[データ型
データ型]ボックスを Decimal に設定します。
[書式設定
書式設定]ボックスの〈...〉ボタンをクリックし、[書式文字列
書式文字列]ダイアログボックスを開きます。
[形式の種類
形式の種類]で通貨を選択し、[小数点以下表示桁数
小数点以下表示桁数] を 0 にします。
5. 〈OK〉をクリックし、[書式文字列
書式文字列]ダイアログを閉じます。
6. グリッドの「ボーナス」列を選択します。「ボーナス」列の[Column タスク
タスク]メニューが開きます。
7. [データ型
データ型]ボックスを Boolean に設定します。
また、DataType と Format の各プロパティは、以下のように[FlexGrid 列エディタ
列エディタ]から設定することもできます。
1. [C1FlexGrid タスク
タスク]メニューの〈列エディタ
列エディタ〉を選択し、[FlexGrid 列エディタ
列エディタ]を開きます。[FlexGrid 列エディタ
列エディタ]への
アクセス方法の詳細については、列エディタ を参照してください。
2. 右ペインの「売上」列を選択します。
3. DataType プロパティを Decimal に設定します。
4. Format プロパティの横の〈...〉ボタンをクリックします。[書式文字列
書式文字列]ダイアログボックスが開きます。
167
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
5.
6.
7.
8.
[形式の種類]で通貨を選択し、[小数点以下表示桁数
小数点以下表示桁数] を 0 にします。
〈OK〉をクリックし、[書式文字列
書式文字列]ダイアログを閉じます。
右ペインの「ボーナス」列を選択します。
DataType プロパティを Boolean に設定します。
9. 〈OK〉をクリックし、エディタを閉じます。
コードの場合
列の DataType と Format を指定するには、Edit チュートリアルの 手順1:コントロールの作成 で追加されたコードの後ろ
に、以下のコードを追加します。
168
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 列のDataTypeとFormatプロパティを指定します。
Dim c As Column = fg.Cols("売上")
c.DataType = GetType(Decimal)
c.Format = "c"' << currency(通貨)
c = fg.Cols("ボーナス")
c.DataType = GetType(Boolean)
c.ImageAlign = ImageAlignEnum.CenterCenter
C# コードの書き方
C#
// 列のDataTypeとFormatプロパティを指定します。
Column c = fg.Cols["売上"];
c.DataType = typeof(Decimal);
c.Format = "c"; // << currency(通貨)
c = fg.Cols["ボーナス"];
c.DataType = typeof(bool);
c.ImageAlign = ImageAlignEnum.CenterCenter;
プログラムの実行と検証:
追加したコードは、「売上」列に通貨型の値の格納と表示、「ボーナス」列にブール値が入力できるように書式設定します。
この段階でプロジェクトを実行すると、グリッドが「売上」列で数値以外の入力を受け付けないことがわかります。「ボーナス」列
は、チェックボックスで値を表示し、マウスまたはキーボードでON/OFFを切り替えることができます。これは、ブール値の列
のデフォルトの動作です。
注意:
注意:Format プロパティは、データには決して影響せず、表示方法に影響するだけであることに注意してください。
手順
手順3: ドロップダウンリスト
データの入力は、冗長で誤りの生じやすい操作です。その点ドロップダウンリストを使うと、入力は最小限で済み、間違いの生
じる可能性も減らすことができます。さらにデータの整合性も増します。
169
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
説明をわかりやすくするために、このサンプルプロジェクトでは3つの製品(テレビ、冷蔵庫、洗濯機)、4つの地区(北、南、西、
東)、3人の常勤販売員(鈴木、佐藤、田中)の情報だけを扱うことにします。
C1FlexGrid 内で、これらのリストをドロップダウンとして使用するには、リストごとに各項目を含む文字列(パイプ文字(|)で区
切る)を作成し、それらを各列の ComboList に設定するだけです。このプロパティは、デザイナでもコードでも設定できます。
デザイナの場合
1. 「製品」列を選択します。「製品」列の[Column タスク
タスク]メニューが開きます。
2. [コンボリスト
ンボリスト]ボックスの〈...〉ボタンをクリックし、[コンボリスト
コンボリスト]ダイアログボックスを開きます。
3. 以下のように、テレビ
テレビ、冷蔵庫
冷蔵庫、洗濯機
洗濯機と入力します。
4.
5.
6.
7.
〈OK〉をクリックし、[コンボリスト
コンボリスト]ダイアログを閉じます。
「地域」列を選択します。
[コンボリスト
コンボリスト]ボックスの〈...〉ボタンをクリックします。
以下のように、北、南、東、西
北、南、東、西と入力します。
8. 〈OK〉をクリックします。
9. 「販売員」列を選択します。
170
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
10. [コンボリスト
コンボリスト]ボックスの〈...〉ボタンをクリックします。
11. 以下のように、鈴木、田中、佐藤
鈴木、田中、佐藤と入力し、[ドロップダウンコンボ
ドロップダウンコンボ]オプションを選択します。
12. 〈OK〉をクリックします。
また、ComboList プロパティは、以下のように[FlexGrid 列エディタ
列エディタ]を使用して設定することもできます。
1. [C1FlexGrid タスク
タスク]メニューの〈列エディタ
列エディタ〉を選択し、[FlexGrid 列エディタ
列エディタ]を開きます。[FlexGrid 列エディタ]への
アクセス方法の詳細については、列エディタ を参照してください。
2. 右ペインの「製品」列を選択します。
3. 左ペインで、ComboList プロパティを テレビ|冷蔵庫
蔵庫|洗濯機
洗濯機に設定します。
4.
5.
6.
7.
171
右ペインの「地域」列を選択します。
左ペインで、ComboList プロパティを北
北|南
南|東
東|西
西に設定します。
右ペインの「販売員」列を選択します。
左ペインで、ComboList プロパティを |鈴木
鈴木|佐藤
佐藤|田中
田中に設定します。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
8. 〈OK〉をクリックし、エディタを閉じます。
コードの場合
コンボリストを追加するには、手順2:列タイプとデータの書式設定 で追加されたコードの後ろに、以下のコードを追加します。
Visual Basic コードの書き方
Visual Basic
' ドロップダウンリストを設定します。
fg.Cols("製品").ComboList = "テレビ|冷蔵庫|洗濯機"
fg.Cols("地域").ComboList = "北|南|東|西"
fg.Cols("販売員").ComboList = "|鈴木|佐藤|田中"
C# コードの書き
C#
// ドロップダウンリストを設定します。
fg.Cols["製品"].ComboList = "テレビ|冷蔵庫|洗濯機";
fg.Cols["地域"].ComboList = "北|南|東|西";
fg.Cols["販売員"].ComboList = "|鈴木|佐藤|田中";
プログラムの実行と検証:
最後の ComboList 文字列だけがパイプで始まっていることに注目してください。これによって、ユーザーはリストにない名前
を入力することができます。別の言い方をすれば、単純なドロップダウンリストと異なり、これらの値はドロップダウンコンボボッ
クスを使って編集できるということです。
[F5]キーを押してプロジェクトを再実行し、カーソルを動かしてみてください。コンボリストが設定されているセル上にカーソル
を置くと、ドロップダウンボタンが現れます。そのボタンをクリックするとリストが表示され、項目の頭文字を入力するとリスト内
でその項目がハイライト表示されます。
手順
手順4: データの正当性検査
172
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
データ型をグリッド列に設定すると、グリッドは確実に適切な型のデータだけをその列に格納します。これによってエラーの発
生を防げますが、入力したデータが正しいことを確実にするために、さらに厳密な正当性検査が必要になる場合がよくありま
す。その場合、ValidateEdit を使用する必要があります。
たとえば、独占禁止法によって北地区でのテレビの販売が禁止されている場合について考えてください。データ入力ミスと費
用のかさむ訴訟を避けるために、ユーザーがこの組み合わせをコントロールに入力できないようにする必要があります。
次のサンプルコードは、セルの編集のたびにデータを調べて、無効な入力がないようにします。
Visual Basic コードの書き方
Visual Basic
Private Sub fg_ValidateEdit(ByVal sender As Object,
ByVal e As C1FlexGrid.ValidateEditEventArgs) Handles
fg.ValidateEdit
Dim rgn As String = ""
Dim prd As String = ""
' 正当性検査に必要なデータを取得します。
Select Case e.Col
Case 0
prd = fg.Editor.Text
rgn = fg(e.Row, "地域")
Case 1
prd = fg(e.Row, "製品")
rgn = fg.Editor.Text
End Select
' 北地区でのテレビの販売は行えません。
If prd = "テレビ" And rgn = "北" Then
MsgBox("警告: 規制 #12333AS/SDA-23 " & _
prd & "を" & rgn & "地区で販売できません。")
e.Cancel = True
End If
End Sub
C# コードの書き
C#
private void fg_ValidateEdit( object sender,
C1.Win.C1FlexGrid.ValidateEditEventArgs e)
{
object rgn = null;
object prd = null;
// 正当性検査に必要なデータを取得します。
switch (e.Col)
{
case 0:
prd = fg.Editor.Text;
rgn = fg.GetData(e.Row, "地域");
break;
case 1:
prd = fg.GetData(e.Row, "製品");
rgn = fg.Editor.Text;
173
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
break;
}
// ' 北地区でのテレビの販売は行えません。
If(((string) prd == "テレビ") && ((string)rgn == "北" )
{
MessageBox.Show("警告: 規制 #12333AS/SDA-23 " +
prd + "を" + rgn + "地区で販売できません。");
"Please verify input.");
e.Cancel = true;
}
}
プログラムの実行と検証:
このルーチンはまず、正当性検査をする必要がある入力データを集めます。検査する値は、Editor.Text プロパティを使用し
て取得することに注目してください。この処理が必要なのは、各編集値がまだコントロールに反映されていないためです。検査
が失敗した場合、関数は警告を表示して Cancel 引数を True に設定します。これによって、編集値が取り消されてセルは編
集モードに戻り、ユーザーは入力し直しことができます。
[F5]キーを押して再びプロジェクトを実行して、無効な値を入力してみてください。コントロールがそれらの値を受け付けないの
がわかります。
手順
手順5: クリップボードへの対応
Windows のクリップボードは、アプリケーション間で情報のやりとりをするときに非常に便利なデバイスです。
FlexGrid プロジェクト
プロジェクトをクリップボード対応にするのは非常に簡単です。AutoClipboard プロパティを True に設定するだけ
で、グリッドはクリップボードに関連する標準のキーボードコマンド([Ctrl+X]または[Shift+Delete]で切り取り、[Ctrl+C]また
は[Ctrl+Insert]でコピー、[Ctrl+V]または[Sift+Insert]で貼り付け)のすべてを自動的に処理します。
デザイナの場合
プロパティウィンドウで AutoClipboard プロパティを探し、それを True に設定します。
174
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コードの場合
手順3:ドロップダウンリスト で追加されたコードの後ろに、以下のコードを追加します。
Visual Basic コードの書き方
Visual Basic
fg.AutoClipboard = True
C# コードの書き
C#
fg.AutoClipboard = true;
クリップボードの操作に非常に関連の深い、Windows の優れたもう1つの機能といえば OLE ドラッグ&ドロップで
す。C1FlexGrid コントロールは、この機能を組み込むために DragMode と DropMode の各プロパティを提供します。この
2つのプロパティを「自動」に設定するだけで、ドラッグ&ドロップによって、Microsoft Excel などの他のアプリケーションにデー
タを移動したり、Excel スプレッドシートから C1FlexGrid コントロールにデータを移動したりできます。
デザイナの場合
DragMode と DropMode の各プロパティを探し、どちらも Automatic に設定します。
コードの場合
AutoClipboard プロパティを設定したコードの後ろに、以下のコードを追加します。
Visual Basic コードの書き方
Visual Basic
fg.DragMode = DragModeEnum.Automatic
fg.DropMode = DropModeEnum.Automatic
C# コードの書き
175
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
fg.DragMode = DragModeEnum.Automatic;
fg.DropMode = DropModeEnum.Automatic;
プログラムの実行と検証:
[F5]キーを押して再度プロジェクトを実行し、適当なデータのコピーや貼り付けを試してみてください。不正なデータでも貼り付
けが可能なことがわかります。これは、貼り付けコードがデータの正当性の検査を行っていないためです。正当性検査を行う
には、独自のコードを追加する必要があります。
手順
手順6: カスタムエディタの組み込み
C1FlexGrid は、テキスト入力、マスクテキスト、リストからの選択、チェックボックスなどに使用するためのパワフルな組み込
みエディタを提供します。しかし、カスタムエディタ、自分で記述したコントロールを代わりに使用したい場合があります。
FlexGrid では簡単にカスタムエディタをプラグインできます。
カスタムエディタをサンプルコードの「売上」列に付加するには、まず NumericUpDown コントロールをフォームに追加しま
す。
1. .NETプロパティウィンドウを使って次の各プロパティを指定した新しいコントロールを設定します。
プロパティ
設定
BorderStyle
None
DecimalPlaces
2
Maximum
5000000
ThousandsSeparator True
Visible
False
2. [C1FlexGrid タスク
タスク]メニューから〈列エディタ
列エディタ〉を選択し、グリッドの列エディタを表示させます。
3. 3番目の列(売上の数値を格納)を選択し、次のように Editor プロパティを NumericUpDown1 に設定します.
176
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
プログラムの実行と検証:
この段階で、プロジェクトを実行して「売上」列の適当な値を編集してみてください。グリッドは、組み込みエディタの代わりに
NumericUpDown コントロールを使用していることがわかります。コントロールは正しく配置、初期化、管理されています。
フォーカスを別のセルに移動すると、その値がグリッドに格納されます。
ただし、カスタムエディタは組み込みエディタとまったく同じようには動作しません。たとえば、次のようになります。
1. 数値を入力して編集を開始した場合、古い値はクリアされません。
2. エディタのサイズは厳密に正確ではありません(小さめになります)。
3. [Enter]キーを押して編集を終了すると、警告音が鳴ります。
これらの問題は2つの方法で解決できます。1つの方法では、エディタのイベントを使用しますが、この場合、他のプロジェクト
でそのコントロールを再使用することは難しくなります。もう1つの方法では、派生クラスを作成してIC1EmbeddedEditor イン
タフェースに適切なメソッドを実装します。
Visual Basic コードの書き方
177
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
Dim myup As New MyUpDown
fg.Cols(3).Editor = myup
Public Class MyUpDown
Inherits NumericUpDown
' 初期値を設定します。
Public Sub C1EditorInitialize(ByVal value As Object, _
ByVal editorAttributes As IDictionary)
value = Convert.ChangeType(value, GetType(Decimal))
' 入力全体を選択します。
MyBase.Select(0, Int32.MaxValue)
End Sub
' FontHeightを設定し、コントロールに長方形の高さを維持させます。
Public Sub C1EditorUpdateBounds(ByVal rc As Rectangle)
MyBase.FontHeight = rc.Height
Bounds = rc
End Sub
' ユーザーが入力したときに警告音を鳴らさないようにします。
Protected Overrides Function ProcessDialogKey(ByVal keyData As Keys) As Boolean
If (keyData = Keys.Enter) Then
Parent.Focus()
If (Parent.Focused) Then SendKeys.Send("{Down}")
Return True
End If
Return MyBase.ProcessDialogKey(keyData)
End Function
End Class
C# コードの書き
C#
MyUpDown myup = new MyUpDown();
fg.Cols[3].Editor = myup;
internal class MyUpDown : NumericUpDown
{
// 初期値を設定します。
public void C1EditorInitialize(object value, IDictionary editorAttributes)
{
if (value != null)
{
Value = (decimal)Convert.ChangeType(value, typeof(decimal));
}
// 入力全体を選択します。
Select(0, int.MaxValue);
}
// FontHeightを設定して、コントロールに長方形の高さを維持させます。
public void C1EditorUpdateBounds(Rectangle rc)
{
base.FontHeight = rc.Height;
Bounds = rc;
}
178
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// ユーザーが入力したときに警告音を鳴らさないようにします。
override protected bool ProcessDialogKey(Keys keyData)
{
if (keyData == Keys.Enter)
{
Parent.Focus();
if (Parent.Focused) SendKeys.Send
("{Down}");
return true;
}
return base.ProcessDialogKey(keyData);
}
}
たとえば、次のコードは3つのメソッドを実装します。
C1EditorInitialize を 呼び 出して エディタを初期化します。初期値 が 設定され入力全体が選択されます。これによっ
て、最初の問題が解決します。入力全体が選択されているため、この段階で最初の文字を入力すると現在の内容が希
望どおりに置き換えられます。
C1EditorUpdateBounds を 呼び 出して、編集対象のセル上にエディタを配置します。ただし、NumericUpDown コ
ントロールの高さはフォントサイズに基づいて自動的に設定されます(このためセルには低めになります)。コードは、エ
ディタの FontHeight プロパティを設定し、エディタをセル上に正しく配置します。
ProcessDialogKey メソッドを変更して、ユーザーが[Enter]キーを押したとき警告音が鳴らないようにします。
Outline チュートリアル
Outline チュートリアルは、チュートリアルの「Tut_XMLTree」に収録されています。XML文書は、プロジェクトフォルダ内の
NWindEmbedPics.xml を使用します。
このチュートリアルでは、C1FlexGrid をアウトライナとして使用し構造化(階層)データを表示する方法を示します。アウトライ
ナとして使用する場合、C1FlexGrid コントロールは Tree コントロールと同じように動作してノードを表示します。ノードは、縮
小または展開して従属データを含む分枝を表示できます。
サンプルでは、XML 文書をグリッドにロードしてツリー表示します。これらの機能を追加した最終的なアプリケーションの外観
は次のようになります。
179
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
手順
手順1: コントロールの作成
まず新規にプロジェクトを作成し、次の2つのコントロールを追加します。
コマンドボタンをフォームの一番上に追加
C1FlexGrid コントロールをコマンドボタンの下に追加
ツールボックスに C1FlexGrid コントロールが見つからない場合は、「コンポーネントをプロジェクトに組み込む方法」を参考にしてくださ
い。
1. Visual Studio のプロパティウィンドウを使用し、各プロパティを下記のように設定します。
コマンドボタン
プロパティ
設定
Dock
Top
Text
"XMLファイルを
開く...
C1FlexGrid
プロパティ
設定
Name
fg
Dock
Fill
2. フォームのキャプション部分をダブルクリックし、コードウィンドウを開きます。ファイルの一番上に、次のステートメントを追加しま
す。
Visual Basic コードの書き方
Visual Basic
Imports C1.Win.C1FlexGrid
C# コードの書き
C#
using C1.Win.C1FlexGrid;
これによって、C1FlexGrid アセンブリで定義されているオブジェクトを、名前空間の一部だけを使ってプロジェクト内で参照でき、
入力の手間を省くことができます。
3. プロパティウィンドウやエディタのデザイナを使用するか、以下のコードを入力(コピー)し、グリッドを設定します。
デザイナの場合
プロパティウィンドウで、C1FlexGrid コントロールの以下のプロパティを設定します。
プロパテ
設定
Cols.Count
2
Cols.Fixed
0
ExtendLastCol
True
Rows.Count
1
Tree.Column
0
Tree.Style
SimpleLeaf
グリッドのスタイルを設定します。
[C1FlexGrid タスク
タスク]メニューの〈スタイルエディタ
スタイルエディタ〉を選択し、[FlexGrid スタイルエディタ
スタイルエディタ]を開きます。[FlexGrid スタイル
エディタ
エディタ]へのアクセス方法の詳細については、スタイルエディタ を参照してください。
180
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[組み込みスタイル
組み込みスタイル]のリストで Normal を選択します。
Border.Style プロパティを None、TextAlign プロパティを LeftCenter、および WordWrap プロパティを False に設定
します。
〈追加
追加〉ボタンをクリックします。
CustomStyle1 の名前を Data に変更します。
BackColor プロパティを Control に設定します。
181
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
〈OK〉〉をクリックし、エディタを閉じます。
グリッドの列を設定します。
グリッドの列0を選択します。列0の[Column タスク
タスク]メニューが開きます。
[列キャプション
列キャプション]を「要素
要素」に設定します。
[編集を有効にする
編集を有効にする]チェックボックスを OFF にします。
182
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
列1を選択します。
[列キャプション
列キャプション]を「テキスト
テキスト」に設定します。
また、列は以下のように[FlexGrid 列エディタ
列エディタ]から設定することもできます。
[C1FlexGrid タスク]メニューの〈列エディタ
列エディタ〉を選択し、[FlexGrid 列エディタ
列エディタ]を開きます。[FlexGrid 列エディタ
列エディタ]へのアク
セス方法の詳細については、列エディタ を参照してください。
右ペインの列0を選択します。
左ペインで、AllowEditing プロパティを False に設定し、Caption プロパティを「要素
要素」に設定します。
183
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コードの場合
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles
MyBase.Load
' グリッドを初期化します。
fg.Rows.Count = 1
fg.Cols.Count = 2
fg.Cols.Fixed = 0
fg.ExtendLastCol = True
fg(0, 0) = "要素"
fg(0, 1) = "テキスト"
' アウトラインツリーを初期化します。
fg.Tree.Column = 0
fg.Tree.Style = TreeStyleFlags.SimpleLeaf
fg.Cols(0).AllowEditing = False
' スタイルを初期化します。
fg.Styles.Normal.Border.Style = BorderStyleEnum.None
fg.Styles.Normal.TextAlign = TextAlignEnum.LeftCenter
fg.Styles.Normal.WordWrap = False
Dim cs As CellStyle = fg.Styles.Add("Data")
cs.BackColor = SystemColors.Control
End Sub
C# コードの書き
C#
private void Form1_Load(object sender, System.EventArgs e)
{
// グリッドを初期化します。
fg.Rows.Count = 1;
fg.Cols.Count = 2;
fg.Cols.Fixed = 0;
fg.ExtendLastCol = true;
fg[0, 0] = "要素";
fg[0, 1] = "テキスト";
// アウトラインツリーを初期化します。
fg.Tree.Column = 0;
fg.Tree.Style = TreeStyleFlags.SimpleLeaf;
fg.Cols[0].AllowEditing = false;
// スタイルを初期化します。
fg.Styles.Normal.Border.Style = BorderStyleEnum.None;
fg.Styles.Normal.TextAlign = TextAlignEnum.LeftCenter;
fg.Styles.Normal.WordWrap = false;
CellStyle cs = fg.Styles.Add("Data");
cs.BackColor = SystemColors.Control;
}
プログラムの実行と検証:
184
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コードはまず、グリッドのレイアウトと列見出しテキストを設定します。
次に、 Treeプロパティを使用してアウトラインツリーを初期化し、最初の列のAllowEditing プロパティを False に設定することによって
XML ノードの編集ができないようにします。ユーザーが、2番目の列データを編集できることに注目してください。2番目の列には各 XML
ノードのデータが含まれています。
これでコントロールが用意できました。これにコードを追加していきます。
手順
手順2: データの読み込みとアウトラインの構築
データを読み込んで、アウトラインを構築するには、Button1_Click イベントにコードを追加して GetXMLData ルーチンを追
加します。
1. コマンドボタンをダブルクリックして、次のコードを Button1_Click イベントに追加します。
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles Button1.Click
' ファイル名を取得します。
Dim fo As OpenFileDialog = New OpenFileDialog()
fo.DefaultExt = "xml"
fo.Filter = "XML Files (*.xml)
If fo.ShowDialog() <> Windows.Forms.DialogResult.OK Then Exit Sub
' XMLファイルをロードします。
Dim xdoc As Xml.XmlDocument = New Xml.XmlDocument()
xdoc.Load(fo.FileName)
' スピードを向上させるために再描画しないようにします。
fg.BeginUpdate()
' グリッドにデータを格納します。
fg.Rows.Count = 1
GetXMLData(xdoc.ChildNodes(1), 0)
' ツリーを表示する列の幅を自動的に調整します。
fg.AutoSizeCol(0)
' レベル0、1、2を展開します。
fg.Tree.Show(2)
' 再描画を行うようにします。
185
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
fg.EndUpdate()
End Sub
C# コードの書き
C#
private void Button1_Click(object sender, System.EventArgs e)
{
// ファイル名を取得します。
OpenFileDialog fo = new OpenFileDialog();
fo.DefaultExt = "xml";
fo.Filter = "XML Files (*.xml)
if (fo.ShowDialog() != DialogResult.OK)
{
return;
}
// XMLファイルをロードします。
System.Xml.XmlDocument xdoc = new System.Xml.XmlDocument();
xdoc.Load(fo.FileName);
// スピードを向上させるために再描画しないようにします。
fg.BeginUpdate();
// グリッドにデータを格納します。
fg.Rows.Count = 1;
GetXMLData(xdoc.ChildNodes[1], 0);
// ツリーを表示する列の幅を自動的に調整します。
fg.AutoSizeCol(0);
// レベル0、1、2を展開します。
fg.Tree.Show(2);
// 再描画を行うようにします。
fg.EndUpdate();
}
このルーチンはまず、OpenFileDialog を表示させ、ユーザーがXMLファイルを選択してグリッドにロードできるように
します。ファイルが選択されると、ルーチンはそれを XmlDocument オブジェクトにロードし、XmlDocument オブジェ
クトはファイルの内容を解析してメモリに格納します。
その後、グリッドの BeginUpdate メソッド を 呼び出し、コントロールがデータを読み込んでいる間は再描画しないよう
にします。この方法を使用するとパフォーマンスが非常に向上します。したがって、大容量のデータを C1FlexGrid に
追加するときは常にこれを使用してください。
次に、ルーチンは、Count = 1 を設定してすべてのデータをクリアし、GetXMLData ルーチンを呼び出して
XmlDocument オブジェクトの内容をコントロールに読み込みます。GetXMLData ルーチンは、このサンプルの主要
ルーチンで以下に示します。
グリッドにデータを読み込んだ後、AutoSizeCol を使用して最初の列幅を内容に合わせて調整し、Show メソッドでア
ウトラインを展開してレベル0、1、2を表示させます。次に、EndUpdate メソッドを呼び出すと、グリッドは通常どおり再
描画を始めます。
2. このチュートリアルで一番興味深いのが、GetXMLData ルーチンです。このルーチンは、XMLDocument オブジェク
トをトラバースして、アウトラインツリーを構築します。コードは次のとおりです。
Visual Basic コードの書き方
Visual Basic
Private Sub GetXMLData(ByVal node As Xml.XmlNode, ByVal level As Integer)
186
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' コメントノードを無視します。
If node.NodeType = Xml.XmlNodeType.Comment Then
Exit Sub
End If
' このノードのための新しい行を追加します。
Dim row As Integer = fg.Rows.Count
fg.Rows.Add()
' 追加した行にデータを追加します。
fg(row, 0) = node.Name
If node.ChildNodes.Count = 1 Then
fg(row, 1) = node.InnerText
fg.SetCellStyle(row, 1, fg.Styles("Data"))
End If
' ノードが"Name"というサブノードを持つなら、その値を
' ツールチップとして使用するために保存します。
Dim ndName As Xml.XmlNode = node.SelectSingleNode("Name")
If Not (ndName Is Nothing) Then
fg.Rows(row).UserData = ndName.InnerText
End If
' ノードに子ノードがあるなら、それらも取得します。
If node.ChildNodes.Count > 1 Then
' ノードに子ノードがあるなら、それらも取得します。
fg.Rows(row).IsNode = True
fg.Rows(row).Node.Level = level
' 子ノードがある場合、子ノードもグリッドに追加します。
Dim child As Xml.XmlNode
For Each child In node.ChildNodes
GetXMLData(child, level + 1)
Next
End If
End Sub
C# コードの書き
C#
private void GetXMLData(System.Xml.XmlNode node, int level)
{
// コメントノードを無視します。
if (node.NodeType == System.Xml.XmlNodeType.Comment)
{
return;
}
// このノードのための新しい行を追加します。
int row = fg.Rows.Count;
fg.Rows.Add();
// 追加した行にデータを追加します。
fg[row, 0] = node.Name;
if (node.ChildNodes.Count == 1)
{
fg[row, 1] = node.InnerText;
fg.SetCellStyle(row, 1, fg.Styles["Data"]);
}
187
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// ノードが"Name"というサブノードを持つなら、その値を
// ツールチップとして使用するために保存します。
System.Xml.XmlNode ndName = node.SelectSingleNode("Name");
if (ndName != null)
{
fg.Rows[row].UserData = ndName.InnerText;
}
// ノードに子ノードがあるなら、それらも取得します。
if (node.ChildNodes.Count > 1)
{
// ノードに子ノードがあるなら、それらも取得します。
fg.Rows[row].IsNode = true;
fg.Rows[row].Node.Level = level;
// 子ノードがある場合、子ノードもグリッドに追加します。
foreach (System.Xml.XmlNode child in node.ChildNodes)
{
GetXMLData(child, level + 1);
}
}
}
ルーチンはまず、XML コメントノードを無視します。その後、RowCollection.Add メソッドを使用し、新しい行をグリッドに追加
します。次に、ルーチンはノード名を設定します。そして、ノードの子ノードが1つだけであることを確認します。子ノードが1つだ
けの場合、ノードはデータノードとして解釈でき、ノードの InnerText プロパティの値を追加した行の2番目の列にコピーしま
す。また、データノードのセルスタイルを、フォームのロード時に作成したカスタムスタイル"Data"に設定します。次のコードブ
ロックでは、このノードが"Name"というサブノードを持っているかどうかを調べます。持っていれば、"Name"ノードの内容を追
加した行の RowCol.UserData プロパティに設定します。この値は後で、ツールチップの実装に使用され、ノードが縮小されて
いるときでもノード名がユーザーに表示されるようにします。最後に、ノードに子ノードがある場合、GetXMLData ルーチン自
身を呼び出して子ノードもグリッドに追加します。
プログラムの実行と検証:
この段階でプロジェクトを実行すると、すでに XML ファイルのロードや表示を行うことができ、ユーザーがクリックすると縮小や
展開ができることがわかります。次の手順では、いくつか修正を行いアプリケーションを使いやすくします。
手順
手順3: マウスおよびキーボードのカスタム設定
188
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1FlexGrid コントロールは、ユーザーがノードを展開したり縮小する機能を提供していますが、この動作を拡張し、カスタマイ
ズすることもできます。ツリーのノードが展開したり縮小するたびにBeforeCollapse イベントと AfterCollapseイベントが発生
するため、これに呼応する形でアクションを設定することができます。さらに、Collapsed プロパティを使うと、各ノードの縮小し
た状態をコーディングによって取得および設定できます。
このサンプルでは、DoubleClick イベントと KeyPress イベントをトラップし、ユーザーがダブルクリックするか、[Enter]キーを
押したときにノードを展開または縮小します。コードは次のとおりです。
Visual Basic コードの書き方
Visual Basic
Private Sub fg_DoubleClick(ByVal sender As Object, ByVal e As System.EventArgs)
Handles fg.DoubleClick
If fg.MouseCol = 0 Then
ToggleNodeState()
End If
End Sub
Private Sub fg_KeyPress(ByVal sender As Object, ByVal e As
System.Windows.Forms.KeyPressEventArgs) Handles fg.KeyPress
If e.KeyChar = vbCr Then
ToggleNodeState()
End If
End Sub
Private Sub ToggleNodeState()
' ノードが選択されていない場合は、実行しません。
If (fg.Row < 0) Then Exit Sub
' カレント行がノード以外の場合は、処理を行いません。
Dim r As Row = fg.Rows(fg.Row)
If Not r.IsNode Then Exit Sub
' ノードを展開または縮小します。
r.Node.Collapsed = Not r.Node.Collapsed
End Sub
C# コードの書き
C#
private void fg_DoubleClick(object sender, System.EventArgs e)
{
if (fg.MouseCol == 0)
{
ToggleNodeState();
}
}
private void fg_KeyPress(object sender, System.Windows.Forms.KeyPressEventArgs e)
{
if (e.KeyChar == (char)13)
{
ToggleNodeState();
}
}
private void ToggleNodeState()
{
// ノードが選択されていない場合は、実行しません。
189
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
if (fg.Row < 0)
{
return;
}
// カレント行がノード以外の場合は、処理を行いません。
Row r = fg.Rows[fg.Row];
if (r.IsNode == false)
{
return;
}
// ノードを展開または縮小します。
r.Node.Collapsed = !(r.Node.Collapsed);
}
プログラムの実行と検証:
イベントハンドラ、ユーザーが最初の列をダブルクリックしたかどうか、あるいは[Enter]キーを押したかどうかを確認
し、ToggleNodeState ルーチンを呼び出します。ToggleNodeState は、カレント行がノード行であることを確認し、ノード行
であれば Collapsed プロパティの値を切り替えます。
手順
手順4: 編集の許可と禁止
最初の列の AllowEditing プロパティを False に設定したことを思い出してください。これによって、ユーザーは最初の列のセ
ルすべてを編集できなくなります。ノード行の2列目もデータを入力できないようにしましょう。これを行うには、次のコードを追
加して BeforeEdit イベントを処理します。
Visual Basic コードの書き方
Visual Basic
Private Sub fg_BeforeEdit(ByVal sender As Object,
ByVal e As RowColEventArgs)
Handles fg.BeforeEdit
' カレント列がノードの場合、編集を行いません。
Dim r As Row = fg.Rows(fg.Row)
If r.IsNode Then e.Cancel = True
End Sub
C# コードの書き
C#
private void fg_BeforeEdit( object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
// カレント列がノードの場合、編集を行いません。
Row r = fg.Rows[fg.Row];
if (r.IsNode == true)
{
e.Cancel = true;
}
}
190
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
手順
手順5: ツールチップの実装
このチュートリアルの最後に、ツールチップをアウトラインに追加します。ツールチップには、前述の GetXMLData ルーチンで
各行の UserData プロパティに格納したテキストを表示します。ユーザーが "Name" ノードの親ノードにマウスを移動すると、
"Name"ノードの内容が表示されます。これは、親ノードが縮小していて"Name"ノードの内容が表示されていないときに便利で
す。
1. ToolTip コントロールをフォームに追加します。
2. 次のコードを追加してグリッドの MouseMove イベントを処理します。
Visual Basic コードの書き方
Visual Basic
Private Sub fg_MouseMove(ByVal sender As Object, ByVal e As
System.Windows.Forms.MouseEventArgs)
Handles fg.MouseMove
' マウスが置かれたセルのツールチップをチェックします。
Dim tip As String = ""
If fg.MouseCol = 0 And fg.MouseRow > 0 Then
tip = fg.Rows(fg.MouseRow).UserData
End If
' 現在のツールチップと異なる場合に新たに設定します。
If tip <> ToolTip1.GetToolTip(fg) Then
ToolTip1.SetToolTip(fg, tip)
End If
End Sub
C# コードの書き方
C#
private void fg_MouseMove(object sender, System.Windows.Forms.MouseEventArgs e)
{
// マウスが置かれたセルのツールチップをチェックします。
object tip = null;
if ((fg.MouseCol == 0) && (fg.MouseRow > 0))
{
tip = fg.Rows[fg.MouseRow].UserData;
}
// 現在のツールチップと異なる場合に新たに設定します。
if (tip != (object)toolTip1.GetToolTip(fg))
{
toolTip1.SetToolTip(fg, (string)tip);
}
}
プログラムの実行と検証:
コードはまず、MouseRow と MouseCol の各プロパティを使用し、マウスが置かれたセルをチェックします。ツールチップの
テキストが入った行の最初の列上にマウスが置かれた場合、テキストを取得します。それ以外は、ツールチップのテキストは
「Nothing」に設定されます。
191
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
次に、ルーチンは新しいツールチップと現在のツールチップとを比較し、必要であれば Tooltip コントロールの SetToolTip メ
ソッドを呼び出してテキストを更新します。
これで、チュートリアルを終了します。上記のプロジェクトは多様に拡張できます。たとえば、編集データを XML 文書に保存し
たり、ノードの追加、削除、移動を行ったり、さまざまな種類のデータをいろいろなスタイルで使用できます。
Data Analysis チュートリアル
このチュートリアルでは、C1FlexGrid コントロールで最も便利な機能のいくつかを組み合わせ、データテーブルの動的ビュー
を実現します。このアプリケーションは、Microsoft Visual Studio に付属の NorthWind データベースから、販売売上を含む単
純なデータをグリッドに連結することからスタートし、次の機能を追加します。
動的なレイアウト(列の順序)
自動ソート
セルのマージ
自動小計行
アウトライン
最終的なアプリケーションの外観は次のようになります。ユーザーは、最初の3列をドラッグし、LastName、ShipCountry、
CategoryName ごとにデータをグループ化できます。列をドラッグすると、各合計行が自動的に再計算され、アウトラインツ
リーが再構築されます。
192
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
手順
手順1:コントロールの作成
:コントロールの作成
新規にプロジェクトを作成します。ツールボックスの C1FlexGrid アイコンをクリックしてからフォーム上をクリックし、オブジェクト
が適切なサイズになるまで C1FlexGrid コントロールをドラッグしてフォームに追加します。
Iツールボックスに C1FlexGrid コントロールが見つからない場合は、「コンポーネントをプロジェクトに組み込む方法」を参考に
してください。
1. Visual Studio のプロパティウィンドウを使用し、C1FlexGrid コントロールのプロパティを下記のように設定します。
プロパティ
設定
Name
fg
Dock
Fill
2. フォームのキャプション部分をダブルクリックし、コードウィンドウを開きます。ファイルの一番上に、次のステートメントを
追加します。
Visual Basic コードの書き方
Visual Basic
Imports System.Data.OleDb
Imports System.ComponentModel
Imports C1.Win.C1FlexGrid
C# コードの書き
C#
using System.Data.OleDb;
using System.ComponentModel;
using C1.Win.C1FlexGrid;
これによって、C1FlexGrid および OleDb アセンブリで定義されているオブジェクトを、名前空間の一部だけを使ってプ
193
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ロジェクト内で参照でき、入力の手間を省くことができます。
手順
手順2:グリッドの初期化とデータ表示
:グリッドの初期化とデータ表示
グリッドを設定し、解析する売上データをグリッドに読み込むには、デザイナかコードでレイアウトプロパティとスタイルを設定し
て、GetDataSource メソッドを使用してグリッドにデータを読み込みます。
1. デザイナまたはコードで、グリッドのレイアウトとスタイルを設定します。
デザイナの場合
プロパティウィンドウで、以下のプロパティを設定します。
プロパティ
設定
AllowEditing
False
AllowSorting
None
AllowMerging
Nodes
ExtendLastCol
True
SelectionMode Cell
Tree.Style
Simple
Tree.Column
1
[C1FlexGrid タスク
タスク]メニューの〈列エディタ〉を選択し、[FlexGrid 列エディタ
列エディタ]を開きます。[FlexGrid 列エディ
タ]へのアクセス方法の詳細については、列エディタ を参照してください。
右ペインの列0を選択します。
左ペインで、Width プロパティを 20 に設定します。
〈OK〉をクリックし、列エディタを閉じます。
[C1FlexGrid タスク
タスク]メニューの〈スタイルエディタ
スタイルエディタ〉を選択し、[FlexGrid スタイルエディタ
スタイルエディタ]を開きます。
[FlexGrid スタイルエディタ
スタイルエディタ]へのアクセス方法の詳細については、スタイルエディタ を参照してください。
[組み込みスタイル
組み込みスタイル]のリストから Normal を選択します。
Border.Style プロパティを None に、および Trimming プロパティを EllipsisCharacter に設定します。
194
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[組み込みスタイル
組み込みスタイル]のリストから Subtotal0 を選択します
BackColor プロパティを Gold、および ForeColor プロパティを Black に設定します。
Subtotal1 と Subtotal2 の各プロパティを以下のように設定します。
Subtotal1
BackColor Khaki
ForeColor Black
Subtotal2
BackColor LightGoldenrodYellow
ForeColor Black
〈OK〉〉をクリックし、スタイルエディタを閉じます。
コードの場合
Form_Load イベントに以下のコードを追加し、グリッドのレイアウトとスタイルを設定します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
' グリッドのレイアウトと動作を設定します。
fg.AllowEditing = False
195
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
fg.AllowSorting = AllowSortingEnum.None
fg.AllowMerging = AllowMergingEnum.Nodes
fg.SelectionMode = SelectionModeEnum.Cell
fg.ExtendLastCol = True
fg.Cols(0).Width = fg.Cols.DefaultSize / 4
fg.Tree.Style = TreeStyleFlags.Simple
fg.Tree.Column = 1
' グリッドのスタイルを設定します。
fg.Styles.Normal.Border.Style = BorderStyleEnum.None
fg.Styles.Normal.Trimming = StringTrimming.EllipsisCharacter
Dim s As CellStyle
s = fg.Styles(CellStyleEnum.Subtotal0)
s.BackColor = Color.Gold
s.ForeColor = Color.Black
s = fg.Styles(CellStyleEnum.Subtotal1)
s.BackColor = Color.Khaki
s.ForeColor = Color.Black
s = fg.Styles(CellStyleEnum.Subtotal2)
s.BackColor = Color.LightGoldenrodYellow
s.ForeColor = Color.Black
End Sub
C# コードの書き
C#
private void Form1_Load(object sender, System.EventArgs e)
{
// グリッドのレイアウトと動作を設定します。
fg.AllowEditing = false;
fg.AllowSorting = AllowSortingEnum.None;
fg.AllowMerging = AllowMergingEnum.Nodes;
fg.SelectionMode = SelectionModeEnum.Cell;
fg.ExtendLastCol = true;
fg.Cols[0].Width = fg.Cols.DefaultSize / 4;
fg.Tree.Style = TreeStyleFlags.Simple;
fg.Tree.Column = 1;
// グリッドのスタイルを設定します。
fg.Styles.Normal.Border.Style = BorderStyleEnum.None;
fg.Styles.Normal.Trimming = StringTrimming.EllipsisCharacter;
CellStyle s;
s = fg.Styles[CellStyleEnum.Subtotal0];
s.BackColor = Color.Gold;
s.ForeColor = Color.Black;
s = fg.Styles[CellStyleEnum.Subtotal1];
s.BackColor = Color.Khaki;
s.ForeColor = Color.Black;
s = fg.Styles[CellStyleEnum.Subtotal2];
s.BackColor = Color.LightGoldenrodYellow;
s.ForeColor = Color.Black;
}
ルーチンはまず、グリッドのレイアウトといくつかのスタイルを設定します。
196
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
2. Form_Load イベントに以下のコードを追加し、C1FlexGrid をデータソースに連結します。
Visual Basic コードの書き方
Visual Basic
' グリッドとデータソースを連結します。
fg.DataSource = GetDataSource()
C# コードの書き
C#
// グリッドとデータソースを連結します。
fg.DataSource = GetDataSource();
このルーチンではGetDataSourceメソッド(後述のコードを参照)で作成されたデータソースに連結します。
3. それぞれの RowCol.AllowDragging プロパティを False に設定し、最後の3列をドラッグできないようにロックします。
これは、ユーザーがこれらの列のデータをグループ化できないようにするためです。最後の3列のデータは行ごとに異
なります。このプロパティは、デザイナでもコードでも設定できます。
デザイナの場合
グリッドの列4を選択します。列4の[Column タスク
タスク]メニューが開きます。
[順序変更を有効にする
順序変更を有効にする]チェックボックスを OFF にします。
列5と列6に手順を繰り返します。
また、RowCol.AllowDragging プロパティは、以下のように[FlexGrid 列エディタ
列エディタ]を使用して設定することもできます。
[C1FlexGrid タスク
タスク]メニューの〈列エディタ
列エディタ〉を選択し、[FlexGrid 列エディタ
列エディタ]を開きます。[FlexGrid 列エディ
タ]へのアクセス方法の詳細については、列エディタ を参照してください。
右ペインの列4を選択します。
左ペインで、AllowDragging プロパティを False に設定します。
197
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
列5と列6の AllowDragging プロパティを False に設定します。
エディタは閉じません。
コードの場合
Form_Load イベントに次のコードを追加します。
Visual Basic コードの書き方
Visual Basic
' ユーザーによる列のドラッグを禁止します(最後の3列のみ)。
fg.Cols(4).AllowDragging = False
fg.Cols(5).AllowDragging = False
fg.Cols(6).AllowDragging = False
C# コードの書き
C#
// ユーザーによる列のドラッグを禁止します(最後の3列のみ)。
fg.Cols[4].AllowDragging = false;
fg.Cols[5].AllowDragging = false;
fg.Cols[6].AllowDragging = false;
4. Sales Amount 列の Format プロパティを設定し、金額を通貨値で表示させます。これは、デザイナでもコードでも設定
できます。
デザイナの場合
グリッドの列6を選択します。
[書式設定
書式設定]ボックスの〈...〉ボタンをクリックし、[書式文字列
書式文字列]ダイアログボックスを開きます。
[形式の種類]で、通貨を選択します。
198
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
〈OK〉をクリックし、[書式文字列]ダイアログを閉じます。
また、Format プロパティは、以下のように[FlexGrid 列エディタ
列エディタ]を使用して設定することもできます。
[FlexGrid 列エディタ
列エディタ]で、右ペインの列6を選択します。
左ペインで、Format プロパティの横の〈...〉ボタンをクリックし、[書式文字列
書式文字列]ダイアログボックスを開きます。
[形式の種類]で、通貨を選択します。
〈OK〉をクリックし、[書式文字列
書式文字列]ダイアログを閉じます。
〈OK〉をクリックし、列エディタを閉じます。
コードの場合
Visual Basic コードの書き方
Visual Basic
fg.Cols(6).Format = "C"
C# コードの書き
C#
fg.Cols[6].Format = "C";
5. GetDataSource メソッドは、グリッドが表示するデータテーブルを作成します。このルーチンは、データを取得する SQL
文を除いて非常に単純です。多くのユーザーの場合、これらの SQL 文は手動ではなく、Visual Studio や Microsoft
Access などに実装されているようなビジュアルデザイナを使用して記述します。接続文字列は、NorthWind データ
ベースを参照しています。ご使用のシステムでは、このファイルが別のフォルダにある場合があります。その場合に
は、コード内のこの文字列を変更する必要がある点に注意してください。
Visual Basic コードの書き方
Visual Basic
Prvate Function GetDataSource() As DataTable
199
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 接続文字列を設定します。
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;" & _
"Data Source=C:\Program Files\ComponentOne Studio.NET 2.0\Common\Nwind.mdb"
' 接続文字列を設定します。
Dim rs As String = _
"SELECT Employees.LastName,Orders.ShipCountry," & _
"Categories.CategoryName,Products.ProductName,Orders.OrderDate," & _
"[Quantity]*[Products].[UnitPrice] AS [Sale Amount] " & _
"FROM (Categories INNER JOIN Products " & _
"ON Categories.CategoryID = Products.CategoryID) " & _
"INNER JOIN ((Employees INNER JOIN Orders " & _
"ON Employees.EmployeeID = Orders.EmployeeID) " & _
"INNER JOIN [Order Details] " & _
"ON Orders.OrderID = [Order Details].OrderID) " & _
"ON Products.ProductID = [Order Details].ProductID " & _
"ORDER BY Employees.LastName,Orders.ShipCountry," & _
"Categories.CategoryName;"
' DataSetへデータを取り出します。
Dim da As OleDbDataAdapter = New OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds)
' データテーブルを返します。
GetDataSource = ds.Tables(0)
End Function
C# コードの書き
C#
private DataTable GetDataSource()
{
// 接続文字列を設定します。
string conn = "Provider=Microsoft.Jet.OLEDB.4.0;" +
"Data Source=C:\\Program Files\\ComponentOne Studio.NET
2.0\\Common\\Nwind.mdb";
// Set up the SQL statement.
string rs =
"SELECT Employees.LastName,Orders.ShipCountry," +
"Categories.CategoryName,Products.ProductName,Orders.OrderDate," +
"[Quantity]*[Products].[UnitPrice] AS [Sale Amount] " +
"FROM (Categories INNER JOIN Products " +
"ON Categories.CategoryID = Products.CategoryID) " +
"INNER JOIN ((Employees INNER JOIN Orders " +
"ON Employees.EmployeeID = Orders.EmployeeID) " +
"INNER JOIN [Order Details] " +
"ON Orders.OrderID = [Order Details].OrderID) " +
"ON Products.ProductID = [Order Details].ProductID " +
"ORDER BY Employees.LastName,Orders.ShipCountry," +
"Categories.CategoryName;";
200
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// DataSetへデータを取り出します。
OleDbDataAdapter da = new OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds);
// データテーブルを返します。
return ds.Tables[0];
}
プログラムの実行と検証:
この段階でプロジェクトを実行すると、列を移動したりデータを参照できる簡単なグリッドが表示されます。ただし、データは明
確な方法で構造化されていません。このテーブルには数千のレコードが含まれます。データ全体が表すのものの概要を把握
するのはかなり難しくなります。
手順
手順3:自動ソート
:自動ソート
データを系統立てて整理するための第1歩は、データのソートです。ユーザーが列を並べ替えるたびに、データが自動的に
ソートされるようにします。
ユーザーが列を並べ替えると、C1FlexGrid コントロールは AfterDragColumn イベントを発生させます。イベントハンドラを
追加し、グリッド上のデータテーブルのデータをソートします(グリッドが非連結モードで使用されている場合は、Sort メソッドで
行います)。
フォームに以下のコードを追加し、ユーザーが列をドラッグしたときにレコードセットをソートして小計を再構築します。
Visual Basic コードの書き方
Visual Basic
Private Sub fg_AfterDragColumn(ByVal sender As System.Object, ByVal e As
C1.Win.C1FlexGrid.DragRowColEventArgs)
Handles fg.AfterDragColumn
' ユーザーが列をドラッグしたとき、レコードセットをソートします。
201
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' これはデータをリフレッシュさせ、全ての小計を削除し、AfterDataRefresh
' イベントを発生させます。そして、小計が再計算されます。
Dim sort As String = fg.Cols(1).Name & ", " & fg.Cols(2).Name & ", " &
fg.Cols(3).Name
Dim dt As DataTable = fg.DataSource
dt.DefaultView.Sort = sort
End Sub
C# コードの書き
C#
private void fg_AfterDragColumn(object sender, C1.Win.C1FlexGrid.DragRowColEventArgs
e)
{
// ユーザーが列をドラッグしたとき、レコードセットをソートします。
// これはデータをリフレッシュさせ、全ての小計を削除し、AfterDataRefresh _
// イベントを発生させます。そして、小計が再計算されます。
string sort = fg.Cols[1].Name + ", " + fg.Cols[2].Name + ", " + fg.Cols[3].Name;
DataTable dt = (DataTable)fg.DataSource;
dt.DefaultView.Sort = sort;
}
プログラムの実行と検証:
プロジェクトを実行し、最初の3列の見出しをドラッグして列を並べ替えてみてください。列を移動させるたびに、データは自動
的にソートされ、データが解釈しやすくなります。
次の手順では、小計行とアウトラインツリーを追加します。
手順
手順4:小計行とアウトラインツリー
:小計行とアウトラインツリー
グリッドを連結モードで使用しているとき、データソースに変更を加えると、グリッドは AfterDataRefresh イベントを発生させ
202
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ます。このイベントは、小計行の挿入およびグリッドのアウトラインツリーを構築するためのコードを追加するのに理想的です。
AfterDataRefresh イベントハンドラは次のようになります。
Visual Basic コードの書き方
Visual Basic
Private Sub fg_AfterDataRefresh(ByVal sender As System.Object, ByVal e As
System.ComponentModel.ListChangedEventArgs)
Handles fg.AfterDataRefresh
Dim totalOn As Integer = fg.Cols("Sale Amount").SafeIndex
Dim caption As String = "{0} の合計"
' 3つのレベルのそれぞれの合計を算出します。
fg.Subtotal(AggregateEnum.Sum, 0, 1, totalOn, caption)
fg.Subtotal(AggregateEnum.Sum, 1, 2, totalOn, caption)
fg.Subtotal(AggregateEnum.Sum, 2, 3, totalOn, caption)
' レベル2までのアウトラインを展開します。
fg.Tree.Show(2)
' サイズを変更します。
fg.AutoSizeCols(1, 1, 1000, 3, 30, AutoSizeFlags.IgnoreHidden)
End Sub
C# コードの書き
C#
private void fg_AfterDataRefresh(object sender,
System.ComponentModel.ListChangedEventArgs e)
{
int totalOn = fg.Cols["Sale Amount"].SafeIndex;
string caption = "{0} の合計";
// 3つのレベルのそれぞれの合計を算出します。
fg.Subtotal(AggregateEnum.Sum, 0, 1, totalOn, caption);
fg.Subtotal(AggregateEnum.Sum, 1, 2, totalOn, caption);
fg.Subtotal(AggregateEnum.Sum, 2, 3, totalOn, caption);
// レベル2までのアウトラインを展開します。
fg.Tree.Show(2);
// サイズを変更します。
fg.AutoSizeCols(1, 1, 1000, 3, 30, AutoSizeFlags.IgnoreHidden);
}
プログラムの実行と検証:
コードは、非常に簡単です。まず、"Sale Amount"列のインデックスを取得します。このサンプルでは、インデックスは常に特定
の列を指します。インデックスは通常、その都度取得するほうが固定値にするより良い方法です。これは、誰かがいくつかの
フィールドを SQL 文に追加するとインデックスが変更されるためです。
その後、コードは Subtotal メソッドを呼び出してデータをグループ化し、新しい小計行を挿入します。新しい小計行は、自動的
にアウトラインノードに設定(各行の Row. IsNode プロパティが True に設定)されるため、縮小することができます。
203
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
もう一度、プロジェクトを実行し、列をドラッグしてみてください。Country ごと、ProductCategory ごと、Salesperson ごとの合
計を簡単に見ることができます。詳細を見たい場合は、ツリーを展開してデータをドリルダウンすることもできます。
注意:
注意:グリッドが編集可能で、[売上高]列の一部の値を変更すると AfterDataRefresh イベントが再び発生して、合計
が自動的に更新されることにも注意してください。
これで、チュートリアルを終了します。
204
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
タスク別ヘルプ
タスク別ヘルプは、Visual Studio でのプログラミングに精通し、コントロールのバインド/バインド解除を行う一般的な方法を
理解していることが前提となります。FlexGrid for WinForms 製品の初心者の場合は、「チュートリアル」を先にお読みくださ
い。
各トピックでは、FlexGrid for WinForms 製品を使用した特定のタスクのソリューションが提供されます。ヘルプで概説されて
いる手順に従うことによって、さまざまな C1FlexGrid 機能を利用したプロジェクトを作成できるようになります。
タスク別ヘルプの各トピックでは、読者が新しい .NET プロジェクトを作成した経験を持っていることも前提となります。
グリッド
C1FlexGrid コントロール本体の基本的なタスクや、グリッド全体のデザインに関する機能を紹介します。
FlexGridの各部名称について
の各部名称について
関連項目
「行と列」
エディタにアクセスする
C1FlexGrid の各エディタは、C1FlexGrid タスク
タスクメニュー、コンテキストメニュー、またはプロパティウィンドウからアクセスでき
ます。また、C1FlexGrid のエディタ
のエディタには、列エディタ と スタイルエディタ の2つがあり、設計時にそれらを使用して
C1FlexGrid のレイアウトと外観を制御できます。列の並べ替え、列幅の調整、列のプロパティの設定、列の挿入/削除を実行
するには、列エディタ
列エディタを使用します。既存のスタイルを変更し、カスタムスタイルを追加して後でセル、行、列に指定できるよう
にするには、スタイルエディタ
スタイルエディタを使用します。
列エディタにアクセス
205
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
列エディタ
列エディタにアクセスするには、C1FlexGrid タスク メニュー、コンテキストメニュー、またはプロパティウィンドウを使用します。
[列エディタ
列エディタ]を使用した列の編集の詳細については、「列エディタ」を参照してください。
[C1FlexGrid タスク]メニュー
C1FlexGrid の右上隅のスマートタグ()をクリックし、[C1FlexGrid タスク
タスク]メニューを開いて〈列エディタ
列エディタ〉を選択します。
コンテキストメニュー
フォームを右クリックし、コンテキストメニューから〈列エディタ
列エディタ〉を選択します。
206
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
プロパティウィンドウ
プロパティウィンドウで、Cols プロパティの横の〈...〉ボタンをクリックします。
スタイルエディタにアクセス
スタイルエディタ
スタイルエディタにアクセスするには、C1FlexGrid タスク メニュー、コンテキストメニュー、またはプロパティウィンドウを使用し
ます。[スタイルエディタ]を使用したセルの外観のカスタマイズ方法の詳細については、「 スタイルエディタ」を参照してくださ
い。
[C1FlexGrid タスク]メニュー
C1FlexGrid の右上隅のスマートタグ () をクリックし、[C1FlexGrid タスク
タスク]メニューを開き、〈スタイルエディタ
スタイルエディタ〉を選択します。
207
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コンテキストメニュー
フォームを右クリックし、コンテキストメニューから〈スタイルエディタ〉を選択します。
プロパティウィンドウ
プロパティウィンドウで、Styles プロパティの横の〈...〉ボタンをクリックします。
208
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
VisualStyle を使用して外観を変更する
VisualStyle を使用して C1FlexGrid の外観をカスタマイズするには、VisualStyle プロパティを Custom、
、Office2007Black、
、
Office2007Blue、
、Office2007Silver、または System に設定します。このプロパティは、デザイナまたはコードのいずれかで
設定できます。下図に個々の VisualStyle を示します。
Visual Style
説明
Custom
VisualStyle なし(通常のスタイルと外観のプロパティを使用します)。
Office2007Black
Doスタイルは Office2007 Black カラースキームに一致します。
Office2007Blue
スタイルは Office2007 Blue カラースキームに一致します。
Office2007Silver
スタイルは Office2007 Silver カラースキームに一致します。
System
スタイルは現在のシステム設定に一致します。
Office2010Black
現在のシステム設定に基づく外観を持つコントロールをレンダリングします。
Office2010Silver
Office 2010 Silver カラースキームに基づく外観を持つコントロールをレンダリング
します。
Office2010Blue
Office 2010 Blue カラースキームに基づく外観を持つコントロールをレンダリングし
ます。
デザイナの場合
プロパティウィンドウで、VisualStyle プロパティを指定し、Custom、
、Office2007Black、
、Office2007Blue、
、
Office2007Silver、
、Office2010Blue、
、Office2010Black、
、Office2010Silver、または System に設定します。この例では、
VisualStyle プロパティは Office2007Blue に設定されます。
コードの場合
コードを Form_Load イベントに追加し、VisualStyle プロパティを Custom、
、Office2007Black、
、Office2007Blue、
、
Office2007Silver、
、Office2010Blue、
、Office2010Black、
、Office2010Silver、または System に設定します。次のコードは、
VisualStyle プロパティを Office2007Blue に設定します。
Visual Basic コードの書き方
Visual Basic
Me.C1FlexGrid1.VisualStyle = C1.Win.C1FlexGrid.VisualStyle.Office2007Blue
C# コードの書き方
C#
this.c1FlexGrid1.VisualStyle = C1.Win.C1FlexGrid.VisualStyle.Office2007Blue;
【実行例】
209
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
カスタム視覚スタイル
視覚スタイルの適用なし:
Office2007Black 視覚スタイル
Office 2007 Black カラースキーム:
Office2007Blue 視覚スタイル
Office 2007 Blue カラースキーム:
Office2007Silver 視覚スタイル
Office 2007 Silver カラースキーム:
Office2010Blue 視覚スタイル
Office 2010 Blue カラースキーム:
210
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Office2010Silver 視覚スタイル
Office 2010 Silver カラースキーム:
Office2010Black 視覚スタイル
Office 2010 Black カラースキーム:
システム視覚スタイル
現在のシステム設定:
XP のテーマで表示する
BorderStyle プロパティを BorderStyleEnum.XpThemes 列挙体 に設定し、ShowThemedHeaders プロパティを変更しま
す。
【実行例】
211
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.BorderStyle = C1.Win.C1FlexGrid.Util.BaseControls.BorderStyleEnum.XpThemes
flex.ShowThemedHeaders = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.Both
C# コードの書き方
C#
flex.BorderStyle = C1.Win.C1FlexGrid.Util.BaseControls.BorderStyleEnum.XpThemes;
flex.ShowThemedHeaders = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.Both;
注意:
注意:XP のテーマで表示するには、VisualStyle プロパティが VisualStyle.Custom に設定されている必要がありま
す。
関連項目
「Excel スタイルのヘッダを使用する」
「VisualStyle を使用して外観を変更する」
「コントロールの境界線スタイルを変更する」
グリッド領域の背景色をを変更する
グリッド領域(すべてのセルより下および右にある範囲)は、EmptyArea 組み込みスタイルの BackColor プロパティを設定す
ることで変更できます。(デフォルトはシステムの AppWorkspace 色)
【実行例】
212
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.Cols.Count = 5
flex.Rows.Count = 10
flex.Styles.EmptyArea.BackColor = Color.LightSalmon
C# コードの書き方
C#
flex.Cols.Count = 5;
flex.Rows.Count = 10;
flex.Styles.EmptyArea.BackColor = Color.LightSalmon;
注意:
注意:表示されるグリッド領域は、コントロールのサイズや行数/列数に依存します。
最後の列を広げてグリッド領域を埋める
ググリッドがコントロールいっぱいに収まるように最後の列を広げて表示するには、ExtendLastCol プロパティを True に設定
します。(デフォルトは False)
【実行例】
213
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
fflex.Cols.Count = 4
flex.Rows.Count = 10
' 最後の列を広げてグリッド領域を埋める
flex.ExtendLastCol = True
C# コードの書き方
C#
flex.Cols.Count = 4;
flex.Rows.Count = 10;
// 最後の列を広げてグリッド領域を埋める
flex.ExtendLastCol = true;
注意:
注意:注意:最後の行を広げるような機能は実装されていません。また、印刷(プレビュー)時に同様の表示を行う場合
は、PrintGrid メソッドの印刷オプションで PrintGridFlags.ExtendLastCol を指定する必要があります。
グリッドの背景画像を設定する
BackgroundImage プロパティに画像イメージを設定することができます。画像の配置方法は、BackgroundImageLayout
プロパティで指定します。
【実行例】
214
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.BackgroundImage = Image.FromFile("C:\back.jpg")
flex.BackgroundImageLayout = ImageLayout.Stretch
C# コードの書き方
C#
flex.BackgroundImage = Image.FromFile("C:\back.jpg");
flex.BackgroundImageLayout = ImageLayout.Stretch;
透明度を指定して背景画像を設定する
Color.FromArgb メソッド(System.Drawing)を使用して色とアルファ値を指定し、Normal 組み込みスタイルの BackColor プ
ロパティに設定します。
【実行例】
215
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 背景画像を設定
flex.BackgroundImage = Image.FromFile("C:\back.jpg")
flex.BackgroundImageLayout = ImageLayout.Stretch
' 背景色:白、アルファ値:200
flex.Styles.Normal.BackColor = Color.FromArgb(200, _
Color.White.R, _
Color.White.G, _
Color.White.B)
C# コードの書き方
C#
// 背景画像を設定
flex.BackgroundImage = Image.FromFile(@"C:\back.jpg");
flex.BackgroundImageLayout = ImageLayout.Stretch;
// 背景色:白、アルファ値:200
flex.Styles.Normal.BackColor = Color.FromArgb(200,
Color.White.R,
Color.White.G,
Color.White.B);
注意:
注意:.NET Framework 機能の詳細については MSDN ライブラリ等を参照してください。
レイアウトを保存/ロードする
レイアウトの保存/ロードには、WriteXml /ReadXml メソッドを使用します。
ReadXml/
/WriteXml メソッドによる XML ドキュメントの入出力では、データ以外にもプロパティやスタイルなどのグリッド設
定も対象になるため、レイアウトの保存やロードに使用できます。具体的には、片方のグリッドにスタイルなどの設定を行った
後、WriteXmlメソッドにて設定を XML ドキュメントに保存した上で、もう一方のグリッドで ReadXml メソッドを使用して設定を
216
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
読み込むといった方法になります。
【実行例】
【実行例】
Visual Basic コードの書き方
217
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 片方のグリッドにスタイルやプロパティを設定
flex.Rows.Count = 4
flex.Cols.Count = 3
flex.Styles.Normal.BackColor = Color.YellowGreen
flex.Styles.Fixed.ForeColor = Color.Red
flex.Styles.Normal.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
flex.Styles.Fixed.BackColor = Color.Yellow
flex.Cols(2).Width = 200
flex.Rows(3).Height = 50
flex(3, 2) = "Cell 3, 2"
flex(0, 1) = "Fixed Cell"
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' レイアウトを保存/ロード
Dim ms As System.IO.MemoryStream = New System.IO.MemoryStream()
' Xml に保存
flex.WriteXml(ms)
ms.Position = 0
' もう一つのグリッドで Xml を読み込む
flex2.ReadXml(ms)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 片方のグリッドにスタイルやプロパティを設定
flex.Rows.Count = 4;
flex.Cols.Count = 3;
flex.Styles.Normal.BackColor = Color.YellowGreen;
flex.Styles.Fixed.ForeColor = Color.Red;
flex.Styles.Normal.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
flex.Styles.Fixed.BackColor = Color.Yellow;
flex.Cols[2].Width = 200;
flex.Rows[3].Height = 50;
flex[3, 2] = "Cell 3, 2";
flex[0, 1] = "Fixed Cell";
}
private void button1_Click(object sender, EventArgs e)
{
// レイアウトを保存/ロード
System.IO.MemoryStream ms = new System.IO.MemoryStream();
// Xml に保存
flex.WriteXml(ms);
ms.Position = 0;
// もう一つのグリッドで Xml を読み込む
flex2.ReadXml(ms);
218
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
パフォーマンスを改善する
AutoResize プロパティを使用してパフォーマンスを向上させる
連結されたグリッドがデータソースからデータを取得する場合、グリッドはすべてのセルを計測し、すべてのデータが収まるよう
に列幅を設定します。この結果、データソースのデータを表示するためにグリッドレイアウトが最適化されます。ただし、データ
ソースが大規模の場合(たとえば、数千行以上ある場合)、時間がかかる可能性があります。
このような場合は、AutoResize プロパティを False(デフォルト)に設定し、列幅をコードで設定することを検討する必要があり
ます。データソースと接続後に、AutoSizeCol (AutoSizeCols) メソッドや、列の Width プロパティを利用して列幅を調節して
ください。
Visual Basic コードの書き方
Visual Basic
' データの取得
OleDbDataAdapter.Fill(DataSet)
' 列幅の自動調節機能 OFF
flex.AutoResize = False
' データソースとの接続
flex.DataSource = DataSet.Tables(0)
' 列幅調節
' ~
C# コードの書き方
C#
// データの取得
OleDbDataAdapter.Fill(DataSet);
// 列幅の自動調節機能 OFF
flex.AutoResize = false;
// データソースとの接続
flex.DataSource = DataSet.Tables[0];
// 列幅調節
// ~
BeginUpdate/
/EndUpdate メソッドを使用してパフォーマンスを向上させる
セル値が変更されるか、行や列がグリッドに追加されたり、グリッドから削除されるたびに、グリッドレイアウトを再計算し、表示
を更新するために、いくつかの計算が実行されます。グリッドコンテンツの更新を開始する前に BeginUpdate メソッドをコー
ルして再描画を中断し、変更が完了したら EndUpdate メソッドにより描画を再開することにより、パフォーマンスを大幅に向
上させることができます。
下記のコードでは、Try/Finally ブロックの使用により、更新コードが失敗して例外がスローされた場合でも、EndUpdate メ
ソッドが必ずコールされるようにしています。
Visual Basic コードの書き方
Visual Basic
' グリッドを更新する前に再描画を中断します
219
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.BeginUpdate()
' 変更処理
Try
Dim r As Integer = 0
Do While (r < flex.Rows.Count)
Dim c As Integer = 0
Do While (c < flex.Cols.Count)
flex(r, c) = (r + c)
c += 1
Loop
r += 1
Loop
Finally
' 終了した際に必ず描画を再開します
flex.EndUpdate()
End Try
C#コードの書き方
Visual Basic
// グリッドを更新する前に再描画を中断します
flex.BeginUpdate();
//変更処理
try
{
for (int r = 0; r < flex.Rows.Count; r++)
{
for (int c = 0; c < flex.Cols.Count; c++)
{
flex[r, c] = r + c;
}
}
}
finally
{
// 終了した際に必ず描画を再開します
flex.EndUpdate();
}
グリッドに大量のデータを追加する場合も BeginUpdate/EndUpdate メソッドを使用してグリッドの再描画を抑制すること
で、処理能力を向上させることが可能です。行や列の追加(行数・列数の設定)処理、データの設定処理などを行っている間
は、BeginUpdate メソッドをコールし、再描画を中断する方法を確認してください。
Visual Basic コードの書き方
Visual Basic
' グリッドの描画を中断します
flex.BeginUpdate()
' 行や列の追加(行数・列数の設定)処理
' ~
' データの設定処理
' ~
' グリッドの描画を再開します
220
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.EndUpdate()
C#コードの書き方
Visual Basic
// グリッドの描画を中断します
flex.BeginUpdate();
// 行や列の追加(行数・列数の設定)処理
// ~
// データの設定処理
// ~
// グリッドの描画を再開します
flex.EndUpdate();
繰り返しスタイルを作成している
StyleNew プロパティによるスタイル設定は、カスタムスタイルを新規で作成しますので、繰り返し実行すると、パフォーマンス
が低下したり、リソースの消費量が増加する場合があります。また、何度も発生するイベント内で繰り返しカスタムスタイルを
作成しているような場合も同様です。
同じスタイルを繰り返し適用するような場合は、あらかじめ作成したカスタムスタイルをセルや行、列に適用するようにしてくだ
さい。
JIS2004 対応フォントを使用する
Windows Vista や Windows 7 などで標準搭載される JIS2004 対応フォントを FlexGridで使用した場合について説明します。
(Windows XP/Windows Server 2003 に JIS2004 対応フォントをインストールした場合も同様です)
サロゲート ペア文字の表示
FlexGrid のデフォルト設定では、JIS2004 対応によって追加されたサロゲート ペア文字で表現される文字の一部が正
しく描画されません。これは、デフォルトの設定では UseCompatibleTextRendering プロパティが True に設定され、
GDI+ で描画されているためです。
例: か(U+304B)+ ゜(U+309A)で表示される「か゚」を表示した場合
正しく描画するためには、UseCompatibleTextRendering プロパティを False に設定し、GDI で描画します。
例: か(U+304B)+ ゜(U+309A)で表示される「か゚」を表示した場合(UseCompatibleTextRendering=False)
FlexGrid で描画される結果は全て GDI または GDI+ における .NET Framework の仕様に依存します。
まとめ
FlexGrid for WinForms にて JIS2004 対応フォントを扱う場合、UseCompatibleTextRendering プロパティの利用に
よって対応できるのは画面上の文字列描画に関する問題だけです。それ以外の機能(入力、データベース接続など)
については注意すべき点があります。
JIS2004 対応フォントの詳細については、予め MSDN ライブラリなどの各種参考文献をご覧いただくことをお勧めしま
す。また、アプリケーション開発および運用の際には十分な注意を払い、入念な動作検証を行う必要があります。
注意:
サロゲート ペア文字自体の入力を制御する直接的な機能はありません。
221
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
サロゲート ペア文字を含む編集セル内でのキー操作(カーソルキー、Backspace キー、Delete キー)は標準の
TextBox コントロール等と同様です。
編集中セルではサロゲート ペア文字が正しく描画されます。FlexGrid では編集中のセルにて専用のエディタコン
トロールを利用しますが、ここでは OS が提供するエディタクラスを使用しているためです。
上図のようなサロゲート ペア文字は4バイト(2文字)として扱われます。そのため、入力マスクなど入力文字数の
制御では注意が必要です。
サロゲート ペア文字を含むデータベースとの接続を行う場合は、予めご利用のデータベースにおける当該文字
の扱いに関して確認してください。FlexGrid ではデータベース側での問題(制限事項など)に対応することはでき
ません。
印刷(プレビュー)の結果は、グリッドの描画結果に依存します。UseCompatibleTextRendering プロパティを
False に設定することでサロゲート ペア文字を含むグリッドも正しく印刷されます。
セルラベル、Excel などのファイル出力では、サロゲート ペア文字を含む値も正しく表示、出力されます。
グループ化の機能を使用する
FlexGrid の標準機能には実装されていませんが、コントロールを拡張することで実現可能です。詳細については、製品付属の
FlexGroup サンプルを参照してください。
【FlexGroup サンプルの実行例】
関連項目
「チュートリアル」
境界線
境界線に関するタスクを紹介します。
222
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コントロールの境界線スタイルを変更する
コントロールの境界線スタイルを設定するには、BorderStyle プロパティを
Fixed3D、FixedSingle、Light3D、None、XpThemes のいずれかに設定します。このプロパティは、デザイナでもコードでも
設定できます。
境界線
説明
Fixed3D
3D境界線 (デフォルト設定)
FixedSingle
単線の境界線
Light3D
明るいくぼんだ境界線
None
境界線なし
XpThemes
XPテーマを使用して描画される境界線
【実行例】
3D 境界線 (Fixed3D))
境界線は 3D(立体表示)になります。
単線の境界線 (FixedSingle))
境界線は単線になります。
223
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
明るいくぼんだ境界線
(Light3D))
境界線は、明るい 3D 表示になります。
境界線なし (None))
境界線はありません。
224
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
(XpThemes))
XP テーマの境界線
境界線は、XP テーマ表示になります。
【デザイナで設定する場合】
プロパティウィンドウで BorderStyle プロパティを探し、それを Fixed3D、FixedSingle、Light3D、None、XpThemes のい
ずれかに設定します。この例では、BorderStyle プロパティは Fixed3D に設定されます。
225
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【コードで設定する場合】
Form_Load イベントにコードを追加し、BorderStyle プロパティを Fixed3D、FixedSingle、Light3D、None、
、XpThemes の
いずれかに設定します。以下のコードは、BorderStyle プロパティを Fixed3D に設定します。
Visual Basic コードの書き方
Visual Basic
flex.BorderStyle = C1.Win.C1FlexGrid.Util.BaseControls.BorderStyleEnum.Fixed3D
C# コードの書き方
C#
flex.BorderStyle = C1.Win.C1FlexGrid.Util.BaseControls.BorderStyleEnum.Fixed3D;
グリッドの境界線スタイルを設定する
グリッドの境界線スタイルを設定するには、Style プロパティを Dotted、
、Double、
、Fillet、
、Flat、
、Groove、
、Inset、
、None、
、
Raised のいずれかに設定します。このプロパティは、デザイナまたはコードで、C1FlexGrid の組み込みスタイルを使用して
設定できます。
境界線
説明
Dotted
点線の境界線
Double
二重線の境界線
Fillet
フィレット付きの境界線
Flat
実線のフラットな境界線(デフォル
ト設定)
Groove
溝付きの境界線
Inset
くぼんだ境界線
None
境界線なし
Raised
浮き出た境界線
【実行例】
点線の境界線 (Dotted))
セル境界線は点線になります。
226
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
二重線の境界線 (Double))
セル境界線は二重線になります。
フィレット付きの境界線 (Fillet))
セル境界線はフィレット付きになります。
227
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
フラットな境界線 (Flat))
セル境界線はフラットな実線になります。
溝付きの境界線 (Groove))
セル境界線は溝付きになります。
228
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
くぼんだ境界線 (Inset))
セル境界線はくぼんだ状態になります。
境界線なし (None))
セル境界線はありません。
229
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
浮き出た境界線 (Raised))
セル境界線は浮き出た状態になります。
【デザイナで設定する場合】
1. 「スタイルエディタ」を開きます。スタイルエディタへのアクセス方法の詳細については、「スタイルエディタにアクセス」を
参照してください。
2. [組み込みスタイル
組み込みスタイル]で、Normal を選択します。右列で、Border プロパティを探して展開します。Style プロパティを
Dotted、Double、Fillet、Flat、Groove、Inset、None、Raised のいずれかに設定します。この例では、Style プロパ
ティは Dotted に設定されます。
230
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
3. 〈OK〉をクリックし、エディタを閉じます。
【コードで設定する場合】
Form_Load イベントにコードを追加し、Normal スタイルの Style プロパティを
Dotted、Double、Fillet、Flat、Groove、Inset、None、Raised のいずれかのオプションに設定します。以下のコード
は、Style プロパティを Dotted に設定します。
Visual Basic コードの書き方
Visual Basic
' グリッドの境界線スタイルを変更する
flex.Styles.Normal.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.Dotted
C# コードの書き方
C#
// グリッドの境界線スタイルを変更する
flex.Styles.Normal.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.Dotted;
グリッドの境界線を変更する
グリッドの境界線を変更する(非表示、色変更
非表示、色変更)
Normal 組み込みスタイルの Border プロパティを変更します。
【実行例】
231
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 垂直方向のみ境界線を表示します
flex.Styles.Normal.Border.Direction = C1.Win.C1FlexGrid.BorderDirEnum.Vertical
' 境界線の色を赤にします
flex.Styles.Normal.Border.Color = Color.Red
C# コードの書き方
C#
// 垂直方向のみ境界線を表示します
flex.Styles.Normal.Border.Direction = C1.Win.C1FlexGrid.BorderDirEnum.Vertical;
// 境界線の色を赤にします
flex.Styles.Normal.Border.Color = Color.Red;
注意: CellBorder クラスの Direction プロパティで設定できる値は、垂直/水平/両方のいずれかになります。また、
垂直および水平で別々の線種や色を設定することはできません。
行/列の境界線を設定する
行や列 の Border プロパティを変更します。
【実行例】
232
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 1列目の境界線スタイルを変更します
flex.Cols(1).StyleNew.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.Double
' 1列目の境界線の色を黒にします
flex.Cols(1).Style.Border.Color = Color.Black
' 2列目の境界線を垂直方向のみにします
flex.Cols(2).StyleNew.Border.Direction = C1.Win.C1FlexGrid.BorderDirEnum.Vertical
' 2列目の境界線の色を赤にします
flex.Cols(2).Style.Border.Color = Color.Red
' 3行目の境界線スタイルを水平方向のみにします
flex.Rows(3).StyleNew.Border.Direction = C1.Win.C1FlexGrid.BorderDirEnum.Horizontal
' 3行目の境界線の色を青にします
flex.Rows(3).Style.Border.Color = Color.Blue
C# コードの書き方
C#
// 1列目の境界線スタイルを変更します
flex.Cols[1].StyleNew.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.Double;
// 1列目の境界線の色を黒にします
flex.Cols[1].Style.Border.Color = Color.Black;
// 2列目の境界線を垂直方向のみにします
flex.Cols[2].StyleNew.Border.Direction = C1.Win.C1FlexGrid.BorderDirEnum.Vertical;
// 2列目の境界線の色を赤にします
flex.Cols[2].Style.Border.Color = Color.Red;
// 3行目の境界線スタイルを水平方向のみにします
flex.Rows[3].StyleNew.Border.Direction = C1.Win.C1FlexGrid.BorderDirEnum.Horizontal;
// 3行目の境界線の色を青にします
flex.Rows[3].Style.Border.Color = Color.Blue;
注意:
233
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
CellBorder クラスの Direction プロパティで設定できる値は、垂直/水平/両方のいずれかになります。ま
た、垂直および水平で別々の線種や色を設定することはできません。
行/列の設定が重複した場合、列の設定が優先されます。
行や列にスタイルが設定されていない場合は、 StyleNew プロパティを使用して新しいスタイルを作成する必要
があります。
セルに線を描画する
CellBorder クラスの Direction プロパティで設定できる値は、垂直/水平/両方のいずれかになります。例え
ば、Direction プロパティに BorderDirEnum.Horizontal (水平) を設定すると、垂直の線 (列の境界線) が表示されなくなり
ます。また、CellBorder クラスの Style や Width 、Color といった設定は、Direction プロパティで設定された種類 (垂直/
水平/両方のいずれか) 全体に適用されるため、垂直線は赤色、水平線は青色といった設定はできません。
そのため、特定のセルで自由に線を描画したい場合は、オーナー描画の機能を使用します。OwnerDrawCell イベントを使用
してグリッドのセルに描画を行う場合は、セルの右側や下側に対して行う必要がある点に注意してください。これは、FlexGrid
のそれぞれのセル枠線が各セルの右側と下側の線の集まりから形成されているためです。例えば、グリッドの2行毎に線を描
画する場合、下記のサンプルコードのように、セルの下側に対して線を描画する必要があります。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' オーナー描画の機能を使用
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' セルの描画を開始
e.DrawCell()
' 固定列を除いたセルで2行毎に下線を描画
If (e.Col <> 0) And ((e.Row Mod 2) = 0) Then
' セルを描画
234
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
e.DrawCell()
Dim p1 As Pen = New Pen(Color.Red, 1)
Dim b As Integer = e.Bounds.Bottom - p1.Width
e.Graphics.DrawLine(p1, e.Bounds.Left, b, e.Bounds.Right, b)
End If
' 3列目は右側にも線を描画
If e.Col = 3 Then
Dim p2 As Pen = New Pen(Color.YellowGreen, 1)
Dim r As Integer = e.Bounds.Right - p2.Width
e.Graphics.DrawLine(p2, r, e.Bounds.Top, r, e.Bounds.Bottom)
End If
' 描画終了
e.Handled = True
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// オーナー描画の機能を使用
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// セルの描画を開始
e.DrawCell();
// 固定列を除いたセルで2行毎に下線を描画
if ((e.Col != 0) && ((e.Row % 2) == 0))
{
Pen p1 = new Pen(Color.Red, 1);
float b = e.Bounds.Bottom - p1.Width;
e.Graphics.DrawLine(p1, e.Bounds.Left, b, e.Bounds.Right, b);
}
// 3列目は右側にも線を描画
if (e.Col == 3)
{
スクロールバー
スクロールバーに関するタスクを紹介します。
スクロールバーの表示
スクロールバーの表示/非表示を設定する
非表示を設定する
スクロールバーの表示は、ScrollBars プロパティで制御します。(デフォルト Both)
ScrollBars.Horizontal(水平スクロールバーのみ)、ScrollBars.Vertical(垂直スクロールバーのみ)、ScrollBars.Both(両方)の
いずれかに設定すると、スクロールバーが表示されます。ScrollBars.None に設定すると、スクロールバーは表示されません。
【実行例:
【実行例:Horizontal】】
235
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例:
【実行例:Vertical】】
【実行例:
【実行例:Both】】
236
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例:
【実行例:None】】
Visual Basic コードの書き方
Visual Basic
' 水平スクロールバーのみ表示
flex.ScrollBars = ScrollBars.Horizontal
C# コードの書き方
C#
// 水平スクロールバーのみ表示
flex.ScrollBars = ScrollBars.Horizontal;
注意:
237
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ScrollBars.None 以外に設定しても、グリッド内に行・列がすべて表示されている場合、スクロールバーは表示さ
れません。スクロールバーはグリッドの内容がコントロールに収まらない場合にのみ表示されます。
スクロールバーの幅を変更する機能は用意されていません。C1FlexGrid コントロールではシステムのスクロー
ルバーを使用します。
関連項目
「常にスクロールバーを表示する」
常にスクロールバーを表示する
ScrollOptions プロパティに ScrollFlags.AlwaysVisible を設定することで、行や列がFlexGridコントロール内にすべて表示
されている場合でも、スクロールバーを表示することができます。垂直
垂直(または水平
水平)スクロールバーのみを常に表示したい場
合は、ScrollOptionsプロパティに ScrollFlags.AlwaysVisibleを設定した上で、ScrollBars プロパティを設定します。
【実行例】
Visual Basic コードの書き方
Visual Basic
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.AlwaysVisible
flex.ScrollBars = ScrollBars.Both
' 水平スクロールバーのみを表示
'flex.ScrollBars = ScrollBars.Horizontal
' 垂直スクロールバーのみを表示
'flex.ScrollBars = ScrollBars.Vertical
C# コードの書き方
C#
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.AlwaysVisible;
flex.ScrollBars = ScrollBars.Both;
// 水平スクロールバーのみを表示
238
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
//flex.ScrollBars = ScrollBars.Horizontal;
// 垂直スクロールバーのみを表示
//flex.ScrollBars = ScrollBars.Vertical;
スクロールバーの表示状態を取得する
現在のスクロールバーの表示状態を取得するには、ScrollBarsVisible プロパティを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object,
ByVal e As System.EventArgs) Handles Button1.Click
MessageBox.Show(flex.ScrollBarsVisible.ToString)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
MessageBox.Show(flex.ScrollBarsVisible.ToString());
}
スクロール動作を変更する
ScrollOptions プロパティを設定します。(デフォルトは ScrollFlags.None)
スクロール動作のオプション、ScrollFlags列挙体の設定を2つ以上設定するには、Or(|)を使用します。
Visual Basic コードの書き方
239
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
' スクロールバーを常に表示しつつ、行列単位でスクロールする
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.AlwaysVisible Or _
C1.Win.C1FlexGrid.ScrollFlags.ScrollByRowColumn
C# コードの書き方
C#
// スクロールバーを常に表示しつつ、行列単位でスクロールする
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.AlwaysVisible |
C1.Win.C1FlexGrid.ScrollFlags.ScrollByRowColumn;
VS-FlexGrid と同様のスクロール動作にする
ActiveX 製品 VS-FlexGrid Pro のスクロール動作には、行・列単位でスクロールすることと、スクロールバーを動かしている
間はスクロールしないといった特徴があります。FlexGrid for WinForms でこの動作を実現するには、ScrollOptions プロパ
ティに ScrollFlags.DelayedScroll と ScrollFlags.ScrollByRowColumn を設定します。
ScrollFlags 列挙体を組み合わせて設定する際は、VB:「Or」 C#:「|」を使用します。
Visual Basic コードの書き方
Visual Basic
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.DelayedScroll Or _
C1.Win.C1FlexGrid.ScrollFlags.ScrollByRowColumn
C# コードの書き方
C#
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.DelayedScroll |
C1.Win.C1FlexGrid.ScrollFlags.ScrollByRowColumn;
スクロールチップを表示する
ScrollOptions プロパティに ScrollFlags.ShowScrollTips を設定し、ShowScrollTip イベントを使用します。
【実行例】
240
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' スクロールチップを表示する
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.ShowScrollTips
End Sub
Private Sub flex_ShowScrollTip(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.ToolTipEventArgs) Handles flex.ShowScrollTip
e.ToolTipText = String.Format("row {0}", e.Row)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// スクロールチップを表示する
flex.ScrollOptions = C1.Win.C1FlexGrid.ScrollFlags.ShowScrollTips;
}
private void flex_ShowScrollTip(object sender, C1.Win.C1FlexGrid.ToolTipEventArgs e)
{
e.ToolTipText = string.Format("row {0}", e.Row);
}
スクロール位置を変更する
TopRow プロパティで垂直方向の位置を、LeftCol プロパティで水平方向の位置を設定します。
【実行例】
241
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
For i As Integer = 1 To flex.Rows.Count - 1
flex(i, 0) = i
Next
For j As Integer = 0 To flex.Cols.Count - 1
flex(0, j) = j
Next
flex.Cols(0).Width = 30
' スクロール位置を変更する
flex.TopRow = 10
flex.LeftCol = 3
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
for(int i=1; i
{
flex[i, 0] = i;
}
for(int j=0; j
{
flex[0, j] = j;
}
// スクロール位置を変更する
flex.TopRow = 10;
flex.LeftCol = 3;
}
242
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
注意:
ピクセル単位でスクロールするには、ScrollPosition プロパティを使用します。
特定のセルを表示するには、ShowCell メソッドを使用します。
関連項目
「任意のセルを表示する」
スタイル
組み込みスタイルやカスタムスタイルに関するタスクを紹介します。「スタイルの要素」にあるタスクは、組み込みスタイルとカ
スタムスタイル、どちらでも使用できます。
関連項目
「セルの外観」
組み込みスタイルの位置について
243
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
通常セルの外観を変更する
Normal 組み込みスタイルを利用することで、通常セル全体のデフォルトスタイルを設定できます。これは、グリッド上の通常
セル全てに対して同一スタイルを設定したいような場合に有効な手法です。
【実行例】
244
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' デフォルトスタイルを設定する
flex.Styles.Normal.BackColor = Color.LemonChiffon
flex.Styles.Normal.ForeColor = Color.Red
flex.Styles.Normal.DataType = GetType(Double)
flex.Styles.Normal.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
flex.Styles.Normal.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.Double
flex.Styles.Normal.Border.Color = Color.Green
flex.Styles.Normal.Format = "#.#0"
' Normalスタイルから継承されているFixedスタイルのFormatをクリア
flex.Styles.Fixed.Format = ""
C# コードの書き方
C#
// デフォルトスタイルを設定する
flex.Styles.Normal.BackColor = Color.LemonChiffon;
flex.Styles.Normal.ForeColor = Color.Red;
flex.Styles.Normal.DataType = typeof(double);
flex.Styles.Normal.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
flex.Styles.Normal.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.Double;
flex.Styles.Normal.Border.Color = Color.Green;
flex.Styles.Normal.Format = "#.#0";
// Normalスタイルから継承されているFixedスタイルのFormatをクリア
flex.Styles.Fixed.Format = "";
注意:
Fixed 組み込みスタイルの何も設定していないプロパティの値は、親スタイルの Normal スタイルから継承され
ます。
Normal 組み込みスタイルは、スタイルエディタからも設定できます。
245
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
関連項目
CellStyle クラス
「スタイルエディタにアクセス」
固定セルの外観を変更する
Fixed 組み込みスタイルを利用することで、固定セル全体の外観を変更します。
【実行例】
Visual Basic コードの書き方
Visual Basic
' 固定セルの背景色を黄色に設定
flex.Styles.Fixed.BackColor = Color.Yellow
C# コードの書き方
C#
// 固定セルの背景色を黄色に設定
flex.Styles.Fixed.BackColor = Color.Yellow;
注意:
Fixed 組み込みスタイルの何も設定していないプロパティの値は、親スタイルのNormal スタイルから継承され
ます。
Fixed 組み込みスタイルは、スタイルエディタからも設定できます。
関連項目
CellStyle クラス
246
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
「スタイルエディタにアクセス」
選択されているセルの外観を変更する
Highlight 組み込みスタイルの背景色や文字色などを変更します。
【実行例】
Visual Basic コードの書き方
Visual Basic
' 選択色を黄緑にします
flex.Styles.Highlight.BackColor = Color.YellowGreen
C# コードの書き方
C#
// 選択色を黄緑にします
flex.Styles.Highlight.BackColor = Color.YellowGreen;
注意:
組み込みスタイルは、スタイルエディタ からも設定できます。
カレントセルの外観は、Focus 組み込みスタイルで変更します。
コントロールにフォーカスがないときにセルを強調表示するかどうかを指定するには、Highlight プロパティを使
用します。
選択方法を変更するには、SelectionMode プロパティを変更します。
カレントセルの外観を変更する
Focus 組み込みスタイルの背景色や文字色などを変更します。
247
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
' カレントセルの背景色を黄色に変更
flex.Styles.Focus.BackColor = Color.Yellow
' カレントセルの文字色を赤に変更
flex.Styles.Focus.ForeColor = Color.Red
C# コードの書き方
C#
// カレントセルの背景色を黄色に変更
flex.Styles.Focus.BackColor = Color.Yellow;
// カレントセルの文字色を赤に変更
flex.Styles.Focus.ForeColor = Color.Red;
注意: 組み込みスタイルは、スタイルエディタ からも設定できます。
カレントセルのフォーカス枠を変更する
FocusRect プロパティを変更します。(デフォルトは Light)
【実行例】 太いフォーカス矩形(
太いフォーカス矩形(Heavy))
248
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 くぼんだフォーカス矩形(
くぼんだフォーカス矩形(Inset))
【実行例】 細いフォーカス矩形(
細いフォーカス矩形(Light))
249
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 浮き出たフォーカス矩形(
浮き出たフォーカス矩形(Raised))
【実行例】 実線のフォーカス矩形(
実線のフォーカス矩形(Solid))
矩形の色は、Highlight 組み込みスタイルのBackColor プロパティの色になります。
250
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 フォーカス矩形なし(
フォーカス矩形なし(None))
フォーカス枠をなしにすると、カレントセルはHighlight 組み込みスタイルで描画されます。
Visual Basic コードの書き方
Visual Basic
flex.FocusRect = C1.Win.C1FlexGrid.FocusRectEnum.Heavy
C# コードの書き方
C#
flex.FocusRect = C1.Win.C1FlexGrid.FocusRectEnum.Heavy;
注意:
注意:組み込みスタイルは、スタイルエディタ からも設定できます。
251
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
カレントセルのフォーカス枠の色を変更する
FocusRect プロパティを Solid にします。矩形の色は、Highlight 組み込みスタイルの BackColor プロパティの色になりま
す。
【実行例】
Visual Basic コードの書き方
Visual Basic
' フォーカス枠を Solid にします
flex.FocusRect = C1.Win.C1FlexGrid.FocusRectEnum.Solid
' フォーカス枠の色を赤にします
flex.Styles.Highlight.BackColor = Color.Red
' カレントセルの背景色を黄色にします
flex.Styles.Focus.BackColor = Color.Yellow
C# コードの書き方
C#
// フォーカス枠を Solid にします
flex.FocusRect = C1.Win.C1FlexGrid.FocusRectEnum.Solid;
// フォーカス枠の色を赤にします
flex.Styles.Highlight.BackColor = Color.Red;
// カレントセルの背景色を黄色にします
flex.Styles.Focus.BackColor = Color.Yellow;
注意:
線種は Solid のみになります。また、線の太さを変更することはできません。
組み込みスタイルは、スタイルエディタ からも設定できます。
1行おきのスタイルを設定する
行おきのスタイルを設定する
252
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Alternate 組み込みスタイルとNormal スタイルを設定します。
【実行例】
Visual Basic コードの書き方
Visual Basic
' 1行おきのスタイルを設定します
flex.Styles.Alternate.BackColor = Color.YellowGreen
' 通常セルのスタイルを設定します
flex.Styles.Normal.BackColor = Color.Yellow
C# コードの書き方
C#
// 1行おきのスタイルを設定します
flex.Styles.Alternate.BackColor = Color.YellowGreen;
// 通常セルのスタイルを設定します
flex.Styles.Normal.BackColor = Color.Yellow;
注意
注意:
Alternate 組み込みスタイルの何も設定していないプロパティの値は、親スタイルの Normal スタイルから継承
されます。
Alternate や Normal 組み込みスタイルは、スタイルエディタからも設定できます。
関連項目
CellStyle クラス
スタイルエディタにアクセス
固定セルや静止セルも1行おきに外観を変更する
253
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
固定セルや静止セルも
固定セルや静止セルも1行おきに外観を変更する
行おきに外観を変更する
1行おきに行のスタイルを変更する場合、組み込みスタイルAlternate を使用します。ただし、Alternate 組み込みスタイルの
対象には、固定セルや静止セルが含まれていません。また、固定/静止セルについては、Fixed/Frozen 組み込みスタイル
にて設定しますが、こちらは固定/静止セル全体に影響することになります。
そのため、固定セルや静止セルも1行おきに背景色などを変更する場合は、カスタムスタイルを作成して1行おきの固定/静
止セルに適用する方法で対応します。下記のように2通りの方法があります。
【実行例】
ループ処理でカスタムスタイルを設定
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Cols.Fixed = 1
flex.Cols.Frozen = 1
' Alternate プロパティを設定
flex.Styles.Alternate.BackColor = Color.SkyBlue
' 静止セルの背景色を通常セルと同じにします
flex.Styles.Frozen.BackColor = flex.Styles.Normal.BackColor
' Alternate と同じ背景色のカスタムスタイルを作成
flex.Styles.Add("AlternateFrozen")
flex.Styles("AlternateFrozen").BackColor = flex.Styles.Alternate.BackColor
' 作成したカスタムスタイル1行おきに固定/静止セルに設定
For i As Integer = flex.Rows.Fixed To flex.Rows.Count - 1
If i Mod 2 = 1 Then
' 固定列
flex.SetCellStyle(i, 0, flex.Styles("AlternateFrozen"))
' 静止列
254
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.SetCellStyle(i, 1, flex.Styles("AlternateFrozen"))
End If
Next
flex.Cols(0).Caption = "固定列"
flex.Cols(1).Caption = "静止列"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Cols.Fixed = 1;
flex.Cols.Frozen = 1;
// Alternate プロパティを設定
flex.Styles.Alternate.BackColor = Color.AliceBlue;
// 静止セルの背景色を通常セルと同じにします
flex.Styles.Frozen.BackColor = flex.Styles.Normal.BackColor;
// Alternate と同じ背景色のカスタムスタイルを作成
flex.Styles.Add("AlternateFrozen");
flex.Styles["AlternateFrozen"].BackColor = flex.Styles.Alternate.BackColor;
// 作成したカスタムスタイル1行おきに固定/静止セルに設定
for (int i = flex.Rows.Fixed; i < flex.Rows.Count; i++)
{
if (i % 2 == 1)
{
// 固定列
flex.SetCellStyle(i, 0, flex.Styles["AlternateFrozen"]);
// 静止列
flex.SetCellStyle(i, 1, flex.Styles["AlternateFrozen"]);
}
}
flex.Cols[0].Caption = "固定列";
flex.Cols[1].Caption = "静止列";
}
オーナー描画を使用してカスタムスタイルを設定
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
flex.Cols.Fixed = 1
flex.Cols.Frozen = 1
flex.Cols(0).Caption = "固定列"
flex.Cols(1).Caption = "静止列"
' Alternate プロパティを設定
flex.Styles.Alternate.BackColor = Color.SkyBlue
' 静止セルの背景色を通常セルと同じにします
flex.Styles.Frozen.BackColor = flex.Styles.Normal.BackColor
255
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' Alternate と同じ背景色のカスタムスタイルを作成
flex.Styles.Add("AlternateCell")
flex.Styles("AlternateCell").BackColor = flex.Styles.Alternate.BackColor
' オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
If e.Row >= flex.Rows.Fixed And e.Row Mod 2 = 1 Then
If e.Col < flex.Cols.Fixed + flex.Cols.Frozen Then
' 作成したカスタムスタイル1行おきに
' 固定/静止セルに設定
e.Style = flex.Styles("AlternateCell")
End If
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Cols.Fixed = 1;
flex.Cols.Frozen = 1;
flex.Cols[0].Caption = "固定列";
flex.Cols[1].Caption = "静止列";
// Alternate プロパティを設定
flex.Styles.Alternate.BackColor = Color.SkyBlue;
// 静止セルの背景色を通常セルと同じにします
flex.Styles.Frozen.BackColor = flex.Styles.Normal.BackColor;
// Alternate と同じ背景色のカスタムスタイルを作成
flex.Styles.Add("AlternateCell");
flex.Styles["AlternateCell"].BackColor = flex.Styles.Alternate.BackColor;
// オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
if ((e.Row % 2 == 1) && (e.Row >= flex.Rows.Fixed))
{
if (e.Col < flex.Cols.Fixed + flex.Cols.Frozen)
{
// 作成したカスタムスタイル1行おきに
// 固定/静止セルに設定
e.Style = flex.Styles["AlternateCell"];
}
}
}
関連項目
256
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
CellStyle クラス
スタイルエディタにアクセス
1行おきのスタイルを設定する
Excel スタイルのヘッダを使用する
ShowThemedHeaders プロパティをShowThemedHeadersEnum.None に設定し、組み込みスタイル
の SelectedRowHeader/SelectedColumnHeader を変更します。
【実行例】
Visual Basic コードの書き方
Visual Basic
flex.ShowThemedHeaders = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.None
flex.Styles.SelectedRowHeader.BackColor = Color.Yellow
flex.Styles.SelectedColumnHeader.BackColor = Color.YellowGreen
C# コードの書き方
C#
flex.ShowThemedHeaders = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.None;
flex.Styles.SelectedRowHeader.BackColor = Color.Yellow;
flex.Styles.SelectedColumnHeader.BackColor = Color.YellowGreen;
注意:
注意:SelectedColumnHeader/
/SelectedRowHeader スタイルは、行または列のヘッダがXPのテーマで描画されて
いない場合、およびVisualStyle プロパティがVisualStyle.Custom に設定されている場合に有効になります。
行/列の外観を変更する
列の外観を変更する
行および列の外観は Style プロパティで、特定の行/列ヘッダの外観は StyleFixed プロパティにて制御しま
257
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
す。StyleNew/StyleFixedNew プロパティで新しいスタイルを作成するか、作成したカスタムスタイルを行や列に適用しま
す。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 2列目の列ヘッダに新しいスタイルを作成、背景色・文字色を変更
flex.Cols(2).StyleFixedNew.BackColor = Color.YellowGreen
flex.Cols(2).StyleFixed.ForeColor = Color.LightPink
' 2列目に新しいスタイルを作成、背景色・文字色を変更
flex.Cols(2).StyleNew.BackColor = Color.Yellow
flex.Cols(2).Style.ForeColor = Color.Red
' 3行目に新しいスタイルを作成、背景色・文字色を変更
flex.Rows(3).StyleNew.BackColor = Color.Beige
flex.Rows(3).Style.ForeColor = Color.Blue
' 3行目の行ヘッダに新しいスタイルを作成、背景色・文字色を変更
flex.Rows(3).StyleFixedNew.BackColor = Color.Orange
flex.Rows(3).StyleFixed.ForeColor = Color.White
' データの設定
flex(0, 2) = "2列目"
flex(1, 2) = "1行2列"
flex(3, 0) = "3行目"
flex(3, 1) = "3行1列"
' カスタムスタイルを適用する場合
'flex.Styles.Add("Col2Style")
'flex.Styles("Col2Style").BackColor = Color.Yellow
'flex.Styles("Col2Style").ForeColor = Color.Red
'flex.Cols(2).Style = flex.Styles("Col2Style")
End Sub
258
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
rivate void Form1_Load(object sender, EventArgs e)
{
// 2列目の列ヘッダに新しいスタイルを作成、背景色・文字色を変更
flex.Cols[2].StyleFixedNew.BackColor = Color.YellowGreen;
flex.Cols[2].StyleFixed.ForeColor = Color.LightPink;
// 2列目に新しいスタイルを作成、背景色・文字色を変更
flex.Cols[2].StyleNew.BackColor = Color.Yellow;
flex.Cols[2].Style.ForeColor = Color.Red;
// 3行目に新しいスタイルを作成、背景色・文字色を変更
flex.Rows[3].StyleNew.BackColor = Color.Beige;
flex.Rows[3].Style.ForeColor = Color.Blue;
// 3行目の行ヘッダに新しいスタイルを作成、背景色・文字色を変更
flex.Rows[3].StyleFixedNew.BackColor = Color.Orange;
flex.Rows[3].StyleFixed.ForeColor = Color.White;
// データの設定
flex[0, 2] = "2列目";
flex[1, 2] = "1行2列";
flex[3, 0] = "3行目";
flex[3, 1] = "3行1列";
// カスタムスタイルを適用する場合
//flex.Styles.Add("Col2Style");
//flex.Styles["Col2Style"].BackColor = Color.Yellow;
//flex.Styles["Col2Style"].ForeColor = Color.Red;
//flex.Cols[2].Style = flex.Styles["Col2Style"];
}
注意:
行、列両方のスタイルが設定されている場合、列のスタイルが優先されます。
カスタムスタイルは、スタイルエディタからも作成できます。
関連項目
セルの外観
カスタムスタイルを作成する
スタイルエディタにアクセス
カスタムスタイルを作成する
Add メソッドで作成します。作成したカスタムスタイルは、行や列、セル(範囲)に自由に適用できます。
注意:
カスタムスタイルは繰り返し使用できます。同じ要素を持つスタイルを何度も作成しないようにしてください。
作成したカスタムスタイルの要素を変更すると、スタイルを適用しているすべてのセルが影響を受けます。
【実行例】
259
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムスタイルを作成します
flex.Styles.Add("CustomStyle1")
' スタイルの要素を変更します
flex.Styles("CustomStyle1").BackColor = Color.YellowGreen
flex.Styles("CustomStyle1").ForeColor = Color.AliceBlue
' 同じ処理です
'Dim cs As C1.Win.C1FlexGrid.CellStyle
'cs = flex.Styles.Add("CustomStyle1")
'cs.BackColor = Color.Red
'cs.ForeColor = Color.AliceBlue
' 行に適用します
flex.Rows(1).Style = flex.Styles("CustomStyle1")
' 列に適用します
flex.Cols(1).Style = flex.Styles("CustomStyle1")
' セルに適用します
flex.SetCellStyle(3, 4, "CustomStyle1")
' セル範囲に適用します
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(4, 2, 5, 3)
cr.Style = flex.Styles("CustomStyle1")
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' ご注意
' 下記のようにスタイルの要素を変更すると、
' カスタムスタイル"CustomStyle1"を
' 適用したすべてのセルが影響を受けます
'flex.Cols(1).Style.BackColor = Color.Yellow
260
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 回避するには、別のスタイルを適用します
flex.Styles.Add("CustomStyle2")
flex.Styles("CustomStyle2").BackColor = Color.Yellow
flex.Cols(1).Style = flex.Styles("CustomStyle2")
' または、スタイルをクリアして、再度スタイルを作成します
'flex.Cols(1).Clear(C1.Win.C1FlexGrid.ClearFlags.Style)
'flex.Cols(1).StyleNew.BackColor = Color.Yellow
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムスタイルを作成します
flex.Styles.Add("CustomStyle1");
// スタイルの要素を変更します
flex.Styles["CustomStyle1"].BackColor = Color.YellowGreen;
flex.Styles["CustomStyle1"].ForeColor = Color.AliceBlue;
// 同じ処理です
//C1.Win.C1FlexGrid.CellStyle cs;
//cs = flex.Styles.Add("CustomStyle1");
//cs.BackColor = Color.Red;
//cs.ForeColor = Color.AliceBlue;
// 行に適用します
flex.Rows[1].Style = flex.Styles["CustomStyle1"];
// 列に適用します
flex.Cols[1].Style = flex.Styles["CustomStyle1"];
// セルに適用します
flex.SetCellStyle(3, 4, "CustomStyle1");
// セル範囲に適用します
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(4, 2, 5, 3);
cr.Style = flex.Styles["CustomStyle1"];
}
private void button1_Click(object sender, EventArgs e)
{
// ご注意
// 下記のようにスタイルの要素を変更すると、
// カスタムスタイル"CustomStyle1"を
// 適用したすべてのセルが影響を受けます
//flex.Cols[1].Style.BackColor = Color.Yellow;
// 回避するには、別のスタイルを適用します
flex.Styles.Add("CustomStyle2");
flex.Styles["CustomStyle2"].BackColor = Color.Yellow;
flex.Cols[1].Style = flex.Styles["CustomStyle2"];
// または、スタイルをクリアして、再度スタイルを作成します
//flex.Cols[1].Clear(C1.Win.C1FlexGrid.ClearFlags.Style);
//flex.Cols[1].StyleNew.BackColor = Color.Yellow;
}
注意:
261
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
行、列両方のスタイルが設定されている場合、列のスタイルが優先されます。
カスタムスタイルは、スタイルエディタからも作成できます。
関連項目
セルの外観
セル(範囲)の外観を変更する
セル(範囲)の外観を変更する
カスタムスタイルを作成して任意のセル、セル範囲に適用します。スタイルの適用には、SetCellStyle メソッドやStyle プロパ
ティを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムスタイルを作成
Dim cs As C1.Win.C1FlexGrid.CellStyle
cs = flex.Styles.Add("OrangeStyle")
cs.BackColor = Color.Orange
' 2行3列目のセルに適用
flex.SetCellStyle(2, 3, "OrangeStyle")
' セル範囲に適用
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(5, 1, 6, 3)
cr.Style = flex.Styles("OrangeStyle")
End Sub
262
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムスタイルを作成
C1.Win.C1FlexGrid.CellStyle cs;
cs = flex.Styles.Add("OrangeStyle");
cs.BackColor = Color.Orange;
// 2行3列目のセルに適用
flex.SetCellStyle(2, 3, "OrangeStyle");
// セル範囲に適用
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(5, 1, 6, 3);
cr.Style = flex.Styles["OrangeStyle"];
}
注意:
行、列両方のスタイルが設定されている場合、列のスタイルが優先されます。
カスタムスタイルは、スタイルエディタからも作成できます。
関連項目
セルの外観
カスタムスタイルを作成する
適用したスタイルをクリアする
行や列の Clear メソッドやグリッドの Clear メソッドを使用します。
【実行例】 (クリア前)
263
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 (クリア後)
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムスタイルを作成します
flex.Styles.Add("CustomStyle1")
' スタイルの要素を変更します
flex.Styles("CustomStyle1").BackColor = Color.YellowGreen
flex.Styles("CustomStyle1").ForeColor = Color.AliceBlue
' 行に適用します
flex.Rows(1).Style = flex.Styles("CustomStyle1")
' 列に適用します
264
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Cols(1).Style = flex.Styles("CustomStyle1")
' セルに適用します
flex.SetCellStyle(3, 4, "CustomStyle1")
' セル範囲に適用します
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(4, 2, 5, 3)
cr.Style = flex.Styles("CustomStyle1")
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 1行目のスタイルをクリアします
flex.Rows(1).Clear(C1.Win.C1FlexGrid.ClearFlags.Style)
'flex.Rows(1).Style = Nothing
' 1列目のスタイルをクリアします
flex.Cols(1).Clear(C1.Win.C1FlexGrid.ClearFlags.Style)
'flex.Cols(1).Style = Nothing
' セルに設定したスタイルをクリアします
'flex.Clear(C1.Win.C1FlexGrid.ClearFlags.Style, 3, 4)
' セル範囲に設定したスタイルをクリアします
'flex.Clear(C1.Win.C1FlexGrid.ClearFlags.Style, 4, 2, 5, 3)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムスタイルを作成します
flex.Styles.Add("CustomStyle1");
// スタイルの要素を変更します
flex.Styles["CustomStyle1"].BackColor = Color.YellowGreen;
flex.Styles["CustomStyle1"].ForeColor = Color.AliceBlue;
// 行に適用します
flex.Rows[1].Style = flex.Styles["CustomStyle1"];
// 列に適用します
flex.Cols[1].Style = flex.Styles["CustomStyle1"];
// セルに適用します
flex.SetCellStyle(3, 4, "CustomStyle1");
// セル範囲に適用します
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(4, 2, 5, 3);
cr.Style = flex.Styles["CustomStyle1"];
}
private void button1_Click(object sender, EventArgs e)
{
// 1行目のスタイルをクリアします
flex.Rows[1].Clear(C1.Win.C1FlexGrid.ClearFlags.Style);
//flex.Rows[1].Style = null;
// 1列目のスタイルをクリアします
flex.Cols[1].Clear(C1.Win.C1FlexGrid.ClearFlags.Style);
//flex.Cols[1].Style = null;
265
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
//// セルに設定したスタイルをクリアします
//flex.Clear(C1.Win.C1FlexGrid.ClearFlags.Style, 3, 4);
//// セル範囲に設定したスタイルをクリアします
//flex.Clear(C1.Win.C1FlexGrid.ClearFlags.Style, 4, 2, 5, 3);
}
注意:
注意:スタイルの各要素のみをクリアする(デフォルトに戻す)処理については、「スタイル要素の設定をクリアする」を参
照してください。
データの内容に応じてスタイルを適用する
CellChanged イベントまたは ValidateEdit イベントを使用して編集後のデータを取得・判別し、作成したカスタムスタイルを
適用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 大きな値に適用するカスタムスタイルを作成します
Dim cs As C1.Win.C1FlexGrid.CellStyle
cs = flex.Styles.Add("BigValue")
cs.Font = New Font(Font, FontStyle.Italic)
cs.BackColor = Color.Gold
End Sub
' ValidateEditイベントを使用する場合
Private Sub flex_ValidateEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.ValidateEditEventArgs) Handles flex.ValidateEdit
' 50,000より大きい値の場合、カスタムスタイルを適用します
' それ以外はスタイルに Nothing を設定してリセットします
Dim cs As C1.Win.C1FlexGrid.CellStyle
266
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
cs = Nothing
If Val(flex.Editor.Text) >= 50000 Then
cs = flex.Styles("BigValue")
End If
flex.SetCellStyle(e.Row, e.Col, cs)
End Sub
'Private Sub flex_CellChanged(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.CellChanged
' 50,000より大きい値の場合、カスタムスタイルを適用します
' それ以外はスタイルに Nothing を設定してリセットします
' Dim cs As C1.Win.C1FlexGrid.CellStyle
' cs = Nothing
' If Val(flex(e.Row, e.Col)) >= 50000 Then
' cs = flex.Styles("BigValue")
' End If
' flex.SetCellStyle(e.Row, e.Col, cs)
'End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 大きな値に適用するカスタムスタイルを作成します
C1.Win.C1FlexGrid.CellStyle cs;
cs = flex.Styles.Add("BigValue");
cs.Font = new Font(Font, FontStyle.Italic);
cs.BackColor = Color.Gold;
}
// ValidateEditイベントを使用する場合
private void flex_ValidateEdit(object sender, C1.Win.C1FlexGrid.ValidateEditEventArgs
e)
{
// 50,000より大きい値の場合、カスタムスタイルを適用します
// それ以外はスタイルに null を設定してリセットします
C1.Win.C1FlexGrid.CellStyle cs;
cs = null;
if (int.Parse(flex.Editor.Text) >= 50000)
{
cs = flex.Styles["BigValue"];
}
flex.SetCellStyle(e.Row, e.Col, cs);
}
//private void flex_CellChanged(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
//{
// 50,000より大きい値の場合、カスタムスタイルを適用します
//
// それ以外はスタイルに null を設定してリセットします
//C1.Win.C1FlexGrid.CellStyle cs;
// cs = null;
// if (int.Parse(flex[e.Row, e.Col].ToString()) >= 50000)
// {
// cs = flex.Styles["BigValue"];
267
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// }
// flex.SetCellStyle(e.Row, e.Col, cs);
//}
カスタムスタイルは、設計時に作成することもできます。次の手順では、スタイルエディタを使用して BigValue という新し
いCellStyle を作成し、BackColor プロパティを Gold に設定します。
1. [スタイルエディタ
スタイルエディタ]を開きます。スタイルエディタ
スタイルエディタへのアクセス方法の詳細については、「スタイルエディタにアクセス」を
参照してください。
2. 〈追加
追加〉をクリックし、新しいスタイルを作成します。
3. CustomStyle1 をダブルクリックし、名前を BigValue に変更します。終わったら[Enter]を押します。
4. 右ペインの BackColor プロパティを探し、それを Gold に設定します。
5. Font プロパティを探し、その横の〈...〉ボタンをクリックして[フォント
フォント]ダイアログボックスを開きます。
6. [スタイル
スタイル]ボックスで斜体
斜体に設定します。
268
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
7. 〈OK〉をクリックし、[フォント
フォント]ダイアログを閉じます。
8. 〈OK〉をクリックし、[FlexGrid スタイルエディタ
スタイルエディタ]を閉じます。
関連項目
セルの外観
カスタムスタイルを作成する
設定したスタイルを優先させる
カスタムスタイルを作成し、行や列、セルに適用している場合でも、フォーカスのあるセルやハイライト(選択)されているセルの
外観は、Focus や Highlight といった組み込みスタイルにて制御されることになります。
FocusやHiglightの外観よりも優先させたい外観がある場合は、オーナー描画の機能を使用します。OwnerDrawCell イベン
ト内で任意のセルにスタイルを適用することで、フォーカスが移動した際やハイライトされた場合でも、変更したセルの外観が
表示されます。下記サンプルコードでは、3行目を通常のカスタムスタイルで、5行目をオーナー描画で外観を変更しています。
5行目のみ変更したスタイルが優先されていることを確認してください。
【実行例】
269
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
With flex
.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.Row
.Styles.Highlight.BackColor = Color.Blue
.Styles.Highlight.ForeColor = Color.Red
.Styles.Focus.BackColor = Color.Yellow
.Styles.Focus.ForeColor = Color.Black
End With
' 通常のカスタムスタイル
' FocusやHiglightの外観が優先される
flex.Styles.Add("Style1")
With flex.Styles("Style1")
.BackColor = Color.Red
.ForeColor = Color.Yellow
End With
flex.Rows(3).Style = flex.Styles("Style1")
' オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' オーナー描画の利用
' FocusやHiglightの外観よりも優先される
If e.Row = 5 And e.Col >= flex.Cols.Fixed Then
e.Style = flex.Styles("Style1")
End If
End Sub
C# コードの書き方
270
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.Row;
flex.Styles.Highlight.BackColor = Color.Blue;
flex.Styles.Highlight.ForeColor = Color.Red;
flex.Styles.Focus.BackColor = Color.Yellow;
flex.Styles.Focus.ForeColor = Color.Black;
// 通常のカスタムスタイル
// FocusやHiglightの外観が優先される
flex.Styles.Add("Style1");
flex.Styles["Style1"].BackColor = Color.Red;
flex.Styles["Style1"].ForeColor = Color.Yellow;
flex.Rows[3].Style = flex.Styles["Style1"];
// オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// オーナー描画の利用
// FocusやHiglightの外観よりも優先される
if ((e.Row == 5) && (e.Col >= flex.Cols.Fixed))
{
e.Style = flex.Styles["Style1"];
}
}
関連項目
セルの外観
組み込みスタイルの位置について
カスタムスタイルを作成する
スタイルの要素
「セルの外観」にもありますが、CellStyle オブジェクトには背景色やフォント、データ型、エディタ、コンボボックスなど様々な要
素があります。このトピックで紹介している以外にもスタイルの要素はありますが、基本的な使用方法は同じです。スタイルの
要素を理解し、組み込みスタイルやカスタムスタイル、行/列のスタイルをを使用することで FlexGrid の外観や動作を簡単に
変更することができます。
スタイルの要素については、CellStyle クラスを参照してください。(組み込み、カスタム)スタイルを設定してグリッドや行、列、
セルの外観を変更する例は、これ以前のトピックを参照してください。また、カスタムスタイルや組み込みスタイル、列のスタイ
ルは設計時にデザイナ画面を通じて設定することができます。詳細については、「設計時のサポート」を参照してください。
背景色/文字色を変更する
スタイルの要素:BackColor プロパティを変更します。
【実行例】
271
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 背景色/文字色を変更する
' この例ではカスタムスタイルを作成して
' 行に適用します
flex.Styles.Add("YellowCell")
flex.Styles("YellowCell").BackColor = Color.Yellow
flex.Styles("YellowCell").ForeColor = Color.Red
flex.Rows(2).Style = flex.Styles("YellowCell")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 背景色/文字色を変更する
// この例ではカスタムスタイルを作成して
// 行に適用します
flex.Styles.Add("YellowCell");
flex.Styles["YellowCell"].BackColor = Color.Yellow;
flex.Styles["YellowCell"].ForeColor = Color.Red;
flex.Rows[2].Style = flex.Styles["YellowCell"];
}
フォントを変更する
スタイルの要素: Font プロパティを変更します。
272
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' この例ではカスタムスタイルを作成して
' 列に適用します
flex.Styles.Add("ItalicStyle")
flex.Styles("ItalicStyle").Font = New Font("verdana", 10, FontStyle.Italic)
flex.Styles("ItalicStyle").BackColor = Color.AliceBlue
flex.Cols(2).Style = flex.Styles("ItalicStyle")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// この例ではカスタムスタイルを作成して
// 列に適用します
flex.Styles.Add("ItalicStyle");
flex.Styles["ItalicStyle"].Font = new Font("verdana", 10, FontStyle.Italic);
flex.Styles["ItalicStyle"].BackColor = Color.AliceBlue;
flex.Cols[2].Style = flex.Styles["ItalicStyle"];
}
注意:
注意:Font プロパティの詳細は、MSDN を参照してください。
データの表示位置を変更する
スタイルの要素: TextAlign プロパティを使用します。データの表示位置は、行/列の TextAlign プロパティを使用しても変
273
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
更できます。
【実行例】
Visual Basic コードの書き方
Visual Basic
' データの表示位置を変更する
' この例では列のスタイルを作成して設定します
flex.Cols(2).StyleNew.ForeColor = Color.Red
flex.Cols(2).Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.RightBottom
' flex.Cols(2).TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
C# コードの書き方
C#
// データの表示位置を変更する
// この例では列のスタイルを作成して設定します
flex.Cols[2].StyleNew.ForeColor = Color.Red;
flex.Cols[2].Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.RightBottom;
//flex.Cols[2].TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
画像の表示位置を変更する
スタイルの要素: ImageAlign プロパティを使用します。画像の表示位置は、行/列の ImageAlign プロパティを使用しても
変更できます。
【実行例】
274
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 画像の表示位置を変更する
' この例では列のスタイルを作成して設定します
flex.Cols(2).StyleNew.ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter
' flex.Cols(2).ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter
flex.SetCellImage(2, 2, New Bitmap("c1icon.gif"))
C# コードの書き方
C#
// 画像の表示位置を変更する
// この例では列のスタイルを作成して設定します
flex.Cols[2].StyleNew.ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter;
//flex.Cols[2].ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter;
flex.SetCellImage(2, 2, new Bitmap("c1icon.gif"));
3Dテキストを表示する
テキストを表示する
スタイルの要素:TextEffect プロパティを使用します。TextEffectEnum.Inset または TextEffectEnum.Raised に設定する
ことで3D効果のテキストを表示できます。
【実行例】
275
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' この例では Fixed 組み込みスタイルを変更しています
' 固定セル全体が3Dテキストで表示されます
flex.Styles.Fixed.TextEffect = C1.Win.C1FlexGrid.TextEffectEnum.Raised
flex.Cols(1).Caption = "1列目"
flex.Rows(3).Caption = "3行目"
C# コードの書き方
C#
// この例では Fixed 組み込みスタイルを変更しています
/ 固定セル全体が3Dテキストで表示されます
flex.Styles.Fixed.TextEffect = C1.Win.C1FlexGrid.TextEffectEnum.Raised;
flex.Cols[1].Caption = "1列目";
flex.Rows[3].Caption = "3行目";
背景画像を設定する
スタイルの要素:BackgroundImage プロパティを使用します。
【実行例】
276
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' この例ではカスタムスタイルを作成、適用します
Dim cs As C1.Win.C1FlexGrid.CellStyle
cs = flex.Styles.Add("CustomImage")
' スタイルの要素:BackgroundImageを設定
' 背景画像を設定します
cs.BackgroundImage = New Bitmap("logo_grapecity.jpg")
cs.BackgroundImageLayout = C1.Win.C1FlexGrid.ImageAlignEnum.Stretch
cs.ForeColor = Color.Orange
cs.Font = New Font("verdana", 12, FontStyle.Bold Or FontStyle.Italic)
cs.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftTop
' セル範囲を取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(2, 1, 3, 3)
' セルの結合
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Custom
flex.MergedRanges.Add(cr)
cr.Data = "PowerTools"
' セル範囲にスタイルを適用
cr.Style = flex.Styles("CustomImage")
C# コードの書き方
C#
// この例ではカスタムスタイルを作成、適用します
C1.Win.C1FlexGrid.CellStyle cs;
cs = flex.Styles.Add("CustomImage");
// スタイルの要素:BackgroundImageを設定
// 背景画像を設定します
cs.BackgroundImage = new Bitmap("logo_grapecity.jpg");
cs.BackgroundImageLayout = C1.Win.C1FlexGrid.ImageAlignEnum.Stretch;
cs.ForeColor = Color.Orange;
277
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
cs.Font = new Font("verdana", 12, FontStyle.Bold
cs.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftTop;
// セル範囲を取得
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(2, 1, 3, 3);
// セルの結合
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Custom;
flex.MergedRanges.Add(cr);
cr.Data = "PowerTools";
// セル範囲にスタイルを適用
cr.Style = flex.Styles["CustomImage"];
関連項目
グリッドの背景画像を設定する
透明度を指定して背景画像を設定する
折り返して表示する
スタイルの要素:WordWrapプロパティを使用します。True(デフォルト:False)に設定すると、自動的に折り返して表示されま
す。
【実行例】
.
Visual Basic コードの書き方
Visual Basic
' この例では組み込みの Normal スタイルを使用しています
flex.Styles.Normal.WordWrap = True
flex(1, 1) = "テキストを折り返して表示"
' 行の高さを調整します
flex.AutoSizeRow(1)
278
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
// この例では組み込みの Normal スタイルを使用しています
flex.Styles.Normal.WordWrap = true;
flex[1, 1] = "テキストを折り返して表示";
// 行の高さを調整します
flex.AutoSizeRow(1);
注意:
注意:WordWrap プロパティを True に設定してテキストを折り返して表示しても、すべてのテキストが表示されるよう自
動的に行の高さが調整されるわけではありません。AutoSizeRow / AutoSizeRows メソッドなどを使用して調整する
必要があります。製品付属の「AutoSizeEditサンプル
サンプル」やトピック:「行の高さ/列の幅を変更する」を参照してください。
トリミングして表示する
スタイルの要素:Trimming プロパティ(デフォルト:StringTrimming.None)を設定します。セル内に収まらない長いテキスト
が切り詰められて表示されます。
【実行例】
.
Visual Basic コードの書き方
Visual Basic
' トリミングして表示する
' この例では列のスタイルを使用しています
flex.Cols(1).StyleNew.Trimming = StringTrimming.EllipsisCharacter
flex(1, 1) = "トリミングして表示する"
C# コードの書き方
C#
// トリミングして表示する
279
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// この例では列のスタイルを使用しています
flex.Cols[1].StyleNew.Trimming = StringTrimming.EllipsisCharacter;
flex[1, 1] = "トリミングして表示する";
注意:
注意:StringTrimming 列挙体
列挙体の詳細については、MSDN を参照してください。
縦書きで表示する
スタイルの要素:TextDirection プロパティ(デフォルト:TextDirectionEnum.Normal)を設定しま
す。TextDirectionEnum.Down の場合は上から下へ、TextDirectionEnum.Up の場合は下から上へテキストが描画され
ます。
【実行例】
.
Visual Basic コードの書き方
Visual Basic
' 縦書きで表示する
' この例では行・列のスタイルを使用しています
flex.Rows(1).StyleNew.BackColor = Color.Yellow
flex.Rows(1).Style.TextDirection = C1.Win.C1FlexGrid.TextDirectionEnum.Down
flex.Rows(2).StyleNew.BackColor = Color.YellowGreen
flex.Rows(2).Style.TextDirection = C1.Win.C1FlexGrid.TextDirectionEnum.Up
flex.Cols(3).StyleNew.BackColor = Color.AliceBlue
flex.Cols(3).Style.TextDirection = C1.Win.C1FlexGrid.TextDirectionEnum.Normal
flex.Styles.Normal.Font = New Font("verdana", 11)
flex(1, 1) = "Down"
flex(1, 2) = "ダウン"
flex(2, 1) = "Up"
flex(2, 2) = "アップ"
flex(1, 3) = "Normal"
flex(2, 3) = "ノーマル"
280
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
// 縦書きで表示する
// この例では行・列のスタイルを使用しています
flex.Rows[1].StyleNew.BackColor = Color.Yellow;
flex.Rows[1].Style.TextDirection = C1.Win.C1FlexGrid.TextDirectionEnum.Down;
flex.Rows[2].StyleNew.BackColor = Color.YellowGreen;
flex.Rows[2].Style.TextDirection = C1.Win.C1FlexGrid.TextDirectionEnum.Up;
flex.Cols[3].StyleNew.BackColor = Color.AliceBlue;
flex.Cols[3].Style.TextDirection = C1.Win.C1FlexGrid.TextDirectionEnum.Normal;
flex.Styles.Normal.Font = new Font("verdana", 11);
flex[1, 1] = "Down";
flex[1, 2] = "ダウン";
flex[2, 1] = "Up";
flex[2, 2] = "アップ";
flex[1, 3] = "Normal";
flex[2, 3] = "ノーマル";
注意:
半角英数字は、実行例のように横書きのまま上から下(または下から上)へ描画されます。
2バイト文字は、
バイト文字は、TextDirectionEnum.Downまたは
またはTextDirectionEnum.Upのどちらを設定しても、実行例の
のどちらを設定しても、実行例の
ように上から下へ描画されます。
TextDirection プロパティの設定を行っても入力時は通常どおり横書きとなります。入力後に TextDirection プロ
パティの設定でセルの内容がレンダリングされるのみとなります。
行と列のスタイルが同時に設定された場合、列のスタイルが優先されます。
データ型を設定する
スタイルの要素:DataType プロパティを使用します。
【実行例】
281
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
.
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' データ型を設定する
' この例ではカスタムスタイルを作成してセルに適用します
flex.Styles.Add("CheckStyle")
flex.Styles("CheckStyle").DataType = GetType(Boolean)
flex.Styles("CheckStyle").BackColor = Color.AliceBlue
flex.Styles("CheckStyle").ImageAlign =
C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter
' 3行2列目のセルに適用
flex.SetCellStyle(3, 2, "CheckStyle")
' セル範囲に適用
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(6, 1, 7, 4)
cr.Style = flex.Styles("CheckStyle")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// データ型を設定する
// この例ではカスタムスタイルを作成してセルに適用します
flex.Styles.Add("CheckStyle");
flex.Styles["CheckStyle"].DataType = typeof(bool);
flex.Styles["CheckStyle"].BackColor = Color.AliceBlue;
flex.Styles["CheckStyle"].ImageAlign =
C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter;
// 3行2列目のセルに適用
282
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.SetCellStyle(3, 2, "CheckStyle");
// セル範囲に適用
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(6, 1, 7, 4);
cr.Style = flex.Styles["CheckStyle"];
}
注意:
GetType メソッドや typeof 式の詳細は、MSDN を参照してください。
行や列単位でデータ型を設定する方法は、「データ型を設定する」を参照してください。
連結(バウンド)モードのグリッドにおけるセルのデータ型は、C1FlexGrid コントロールと接続しているデータソー
スに依存します。
書式を設定する
スタイルの要素:Format プロパティを使用します。
注意:
注意:Format プロパティを設定したセル(列)の DataType プロパティが、Int32やDouble等の数値型や日付型に設定さ
れていることを確認してください。Format プロパティは数値や日付データの書式を行うための機能ですので、DataType
プロパティが Object や String 等に設定されている場合には機能しません。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 書式を設定する
' この例ではカスタムスタイルを作成してセルに適用します
flex.Cols(1).DataType = GetType(Date)
flex.Styles.Add("LongDateStyle")
283
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Styles("LongDateStyle").Format = "D"
flex.Styles("LongDateStyle").BackColor = Color.AliceBlue
' 3行1列目のセルに適用
flex.SetCellStyle(3, 1, "LongDateStyle")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 書式を設定する
// この例ではカスタムスタイルを作成してセルに適用します
flex.Cols[1].DataType = typeof(DateTime);
flex.Styles.Add("LongDateStyle");
flex.Styles["LongDateStyle"].Format = "D";
flex.Styles["LongDateStyle"].BackColor = Color.AliceBlue;
// 3行1列目のセルに適用
flex.SetCellStyle(3, 1, "LongDateStyle");
}
注意:
GetType メソッドや typeof 式の詳細は、MSDN を参照してください。
数値型、日付型の書式指定についての詳細は、MSDN を参照してください。
行や列単位で書式を設定する方法は、「行列の書式を設定する」を参照してください。
マージンを設定する
スタイルの要素:Margins プロパティを使用します。セルの端から内容までのマージンをピクセル単位で設定できます。
【実行例】
.
284
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
rivate Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' マージンを設定する
' この例ではカスタムスタイルを作成して行に適用します
' 通常セルのスタイルを左寄せに設定
flex.Styles.Normal.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftCenter
' カスタムスタイルを作成
Dim cs As C1.Win.C1FlexGrid.CellStyle = flex.Styles.Add("MyMargins")
cs.BackColor = Color.AliceBlue
' 親スタイルからマージンのクローンオブジェクトを作成
cs.Margins = CType(flex.Styles.Normal.Margins.Clone(),
System.Drawing.Printing.Margins)
' 左側のマージンを設定
cs.Margins.Left = 10
' 3行目に設定
flex.Rows(3).Style = flex.Styles("MyMargins")
flex.Rows(3).Caption = "3行目"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// マージンを設定する
// この例ではカスタムスタイルを作成して行に適用します
// 通常セルのスタイルを左寄せに設定
flex.Styles.Normal.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftCenter;
// カスタムスタイルを作成
C1.Win.C1FlexGrid.CellStyle cs = flex.Styles.Add("MyMargins");
cs.BackColor = Color.AliceBlue;
// 親スタイルからマージンのクローンオブジェクトを作成
cs.Margins = (System.Drawing.Printing.Margins)flex.Styles.Normal.Margins.Clone();
// 左側のマージンを設定
cs.Margins.Left = 10;
// 3行目に設定
flex.Rows[3].Style = flex.Styles["MyMargins"];
flex.Rows[3].Caption = "3行目";
}
注意:
注意:Margins クラス(System.Drawing.Printing)についての詳細は、MSDN を参照してください。
スタイル要素の設定をクリアする
Clear メソッドを使用します。StyleElementFlags 列挙体でクリアするスタイル要素を指定します。
【実行例】(
【実行例】(Clear メソッド実行前)
285
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】(
【実行例】(Clear メソッド実行後)
メソッド実行後):
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' この例では行のスタイルを使用しています
' 1列目のスタイル要素を設定
flex.Cols(1).StyleNew.BackColor = Color.Yellow
flex.Cols(1).Style.ForeColor = Color.Red
flex.Cols(1).Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
flex.Cols(1).Style.DataType = GetType(Date)
flex.Cols(1).Style.Format = "yy/MM/dd"
286
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 背景色の設定をクリアします
flex.Cols(1).Style.Clear(C1.Win.C1FlexGrid.StyleElementFlags.BackColor)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// この例では行のスタイルを使用しています
// 1列目のスタイル要素を設定
flex.Cols[1].StyleNew.BackColor = Color.Yellow;
flex.Cols[1].Style.ForeColor = Color.Red;
flex.Cols[1].Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
flex.Cols[1].Style.DataType = typeof(bool);
flex.Cols[1].Style.Format = "yy/MM/dd";
}
private void button1_Click(object sender, EventArgs e)
{
// 背景色の設定をクリアします
flex.Cols[1].Style.Clear(C1.Win.C1FlexGrid.StyleElementFlags.BackColor);
}
注意:
注意:設定されているスタイル自体をクリアする方法については、「適用したスタイルをクリアする」を参照してください。
行/列
列
行/列に関するタスクを デザイン と操作 に分けて紹介します。
デザイン
固定行列や静止行列、行列ヘッダなどを使用してグリッドのデザインを変更するタスクを紹介します。
行列数を設定する
行数は RowCollection の Count プロパティ、列数はColumnCollection の Count プロパティにより設定します。
【実行例】
287
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 行数:12
flex.Rows.Count = 12
' 列数:5
flex.Cols.Count = 5
' データ設定
For i As Integer = 0 To flex.Rows.Count - 1
flex(i, 0) = i
Next
For i As Integer = 0 To flex.Cols.Count - 1
flex(0, i) = i
Next
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 行数:12
flex.Rows.Count = 12;
// 列数:5
flex.Cols.Count = 5;
// データ設定
for (int i = 0; i < flex.Rows.Count; i++)
{
flex[i, 0] = i;
}
for (int i = 0; i < flex.Cols.Count; i++)
288
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
{
flex[0, i] = i;
}
}
注意:
注意:連結(バウンド)モード時の行数・列数は、C1FlexGrid と接続しているデータソースに依存します。連結モードのグ
リッドで列数を設定すると非連結列
非連結列として追加されますが、行数を設定した場合は例外が発生します。
固定行または固定列を設定する
固定行数は RowCollection の Fixed プロパティ、固定列数は ColumnCollection の Fixed プロパティにて設定します。固
定行はユーザーがグリッドを垂直方向にスクロールしても常にグリッドの一番上に、固定列はユーザーがグリッドを水平方向
にスクロールしても常にグリッドの左端に表示される編集不可のセルです。
【実行例】
Visual Basic コードの書き方
Visual Basic
' 行数:50
flex.Rows.Count
' 固定行数:3
flex.Rows.Fixed
' 列数:10
flex.Cols.Count
' 固定列数:2
flex.Cols.Fixed
= 50
= 3
= 10
= 2
C# コードの書き方
C#
// 行数:50
289
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Rows.Count
// 固定行数:3
flex.Rows.Fixed
// 列数:10
flex.Cols.Count
// 固定列数:2
flex.Cols.Fixed
= 50;
= 3;
= 10;
= 2;
関連項目
行列数を設定する
静止行または静止列を設定する
静止行または静止列を設定する
静止行数は RowCollection の Frozen プロパティ、静止列数は ColumnCollection の Frozen プロパティにて設定します。
静止行・静止列は、固定行・固定列と同様にスクロールされませんが、ユーザーによる編集が可能です。
【実行例】
Visual Basic コードの書き方
Visual Basic
行数:50
flex.Rows.Count = 50
' 固定行数:1
flex.Rows.Fixed = 1
' 静止行数:3
290
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Rows.Frozen = 3
' 列数:10
flex.Cols.Count = 10
' 固定列数:0
flex.Cols.Fixed = 0
' 静止列数:2
flex.Cols.Frozen = 2
C# コードの書き方
C#
// 行数:50
flex.Rows.Count = 50;
// 固定行数:1
flex.Rows.Fixed = 1;
// 静止行数:3
flex.Rows.Frozen = 3;
// 列数:10
flex.Cols.Count = 10;
// 固定列数:0
flex.Cols.Fixed = 0;
// 静止列数:2
flex.Cols.Frozen = 2;
関連項目
行列数を設定する
固定行または固定列を設定する
列ヘッダを設定する
Caption プロパティ、または直接セルに値を設定します。
291
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
For i As Integer = flex.Cols.Fixed To flex.Cols.Count - 1
flex.Cols(i).Caption = "Col" & i
' 直接セルに設定する場合
' flex(0, i) = "Col" & i
Next
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
for (int i = flex.Cols.Fixed; i < flex.Cols.Count; i++)
{
flex.Cols[i].Caption = "Col" + i.ToString();
// 直接セルに設定する場合
//flex[0, i] = "Col" + i.ToString();
}
}
注意:
直接セルに値を設定する方法については、「セルに値を設定する」を参照してください。
C1FlexGrid を連結モードで使用した場合、デフォルトでは Caption プロパティ、Name プロパティにはデータ
ソースの列名が設定されます。
固定行を複数にしている場合、Caption プロパティの設定は0行目になります。
292
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
関連項目
行列数を設定する
固定行または固定列を設定する
行ヘッダを設定する
Caption プロパティ、または直接セルに値を設定します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
For i As Integer = flex.Rows.Fixed To flex.Rows.Count - 1
flex.Rows(i).Caption = "Row" & i
' 直接セルに表示する場合
' flex(i, 0) = "Row" & i
Next
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
for (int i = flex.Rows.Fixed; i < flex.Rows.Count; i++)
{
flex.Rows[i].Caption = "Row" + i.ToString();
293
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 直接セルに表示する場合
//flex[i, 0] = "Row" + i.ToString();
}
}
注意:
直接セルに値を設定する方法については、「セルに値を設定する」を参照してください。
固定列を複数にしている場合、Caption プロパティの設定は0列目になります。
関連項目
行列数を設定する
固定行または固定列を設定する
すべての行の高さ/列の幅を変更する
DefaultSize プロパティを変更します。(デフォルトは行:16pix、列:80pix)
DefaultSize プロパティは行の高さ/列幅のデフォルト値です。Height プロパティに-1が設定されている行は、デフォルトの
高さが使用されます。同様に、Width プロパティが-1になっている列は、デフォルトの幅が使用されます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Rows.Count = 5
flex.Cols.Count = 10
' すべての行の高さを変更
flex.Rows.DefaultSize = 30
294
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' すべての列の幅を変更
flex.Cols.DefaultSize = 30
End Sub
<
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Rows.Count = 5;
flex.Cols.Count = 10;
// すべての行の高さを変更
flex.Rows.DefaultSize = 30;
// すべての列の幅を変更
flex.Cols.DefaultSize = 30;
}
注意:
グリッドの Font プロパティに新しい値を設定すると、DefaultSize プロパティはそのフォントに合わせて自動調
整されます。
Height や Width プロパティはデフォルトが -1 のため、実際のサイズを参照する際
は、HeightDisplay/WidthDisplay プロパティを使用します。
連結(バウンド)モードで DefaultSize プロパティを設定する場合は、データソースと連結する前にAutoResize
プロパティを False(デフォルト)に設定して列幅の自動調整を行わないようにする必要があります。
行の高さ/列の幅を変更する
各行の高さを変更するには Height プロパティを、各列の幅を変更するには Width プロパティを設定します。(デフォルトは 1)
【実行例】
295
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 2行目の高さを変更します
flex.Rows(2).Height = 40
' 2列目の幅を変更します
flex.Cols(2).Width = 120
C# コードの書き方
C#
// 2行目の高さを変更します
flex.Rows[2].Height = 40;
// 2列目の幅を変更します
flex.Cols[2].Width = 120;
注意:
Height や Width プロパティは、デフォルトが -1 のため、実際のサイズを参照する際
は、HeightDisplay/WidthDisplay プロパティを使用します。
各列の幅は、設計時にデザイン画面や列エディタを通して設定することも可能です。
関連項目
列エディタにアクセス
自動で列幅を調整する
デザイン時に設定した列幅が無効になってしまう場合の対処方法
データソースとグリッドを接続する前に列幅などを設定している場合
データソースとグリッドを接続する前、つまり DataSource プロパティを設定する前に、列幅や列名を設定した場合、列幅など
の設定はデータソースになにも設定していないグリッドに対して行っていることになります。また、グリッドにデータソースを設定
した時点でグリッドはデータソースの内容(情報)で列の設定を再構築します。そのため、DataSource プロパティによりデータ
ソースが設定されると、データソースになにも設定されていないグリッドに対して行われた列幅などの設定は、データソースと
接続後のグリッドの設定に上書きされることになります。
バウンドモードで使用するグリッドに対して列幅や列名などを設定する場合は、データソースを設定した後のグリッドに対して、
列幅などの設定を行う必要があります。設計時にプロパティウィンドウから DataSource プロパティを設定後、列エディタにて
列名や列幅などを設定するか、Form_Load イベントなどで DataSource プロパティを設定後、列名や列幅をコードで設定してく
ださい。
上記以外の場合
データソースを設定後にデザイナより列幅を変更しているにも関わらず、列幅が無効になってしまう場合は、AutoResize プロ
パティの設定を確認してください。AutoResize プロパティが True(デフォルト値:False)になっている場合、データ読み込み時
に列幅が自動的に調整され、コントロールは列幅を最も幅の広い入力データに合わせてリサイズします。
関連項目
296
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
列エディタにアクセス
自動で列幅を調整する
列の順序を変更する
列の順序を変更するには、デザイナで列をグリッド内の新しい位置にドラッグするか、列エディタ を使用するか、実行時にコー
ドで MoveRange メソッドを設定します。
デザイナの場合
1. グリッドで、移動する列を選択します。この例では、C列を移動します。
2. 列をクリックして左にドラッグします。列をドロップできる場所に縦の点線が表示されます。
3. B列の前にC列をドロップします。
297
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
[FlexGrid 列エディタ
列エディタ]の場合
の場合
1. 列エディタ を開きます。[FlexGrid 列エディタ
列エディタ]へのアクセス方法の詳細については、「列エディタにアクセス 」を参照し
てください。
2. デザイナで、移動する列を選択します。この例では、C列を移動します。.
3. 列をクリックして左にドラッグします。列をドロップできる場所に縦の点線が表示されます。
4. B列の前にC列をドロップします。
298
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
5. 〈OK〉をクリックし、エディタを閉じます。
コードの場合
以下のコードにて、列3(この例ではC列)を列2の位置に移動します。
Visual Basic コードの書き方
Visual Basic
flex.Cols.MoveRange(3, 1, 2)
299
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
flex.Cols.MoveRange(3, 1, 2);
【実行例】
行列のデータ型を設定する
行や列単位でデータ型を設定するには、DataType プロパティを使用します。
【実行例】
300
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 2列目のデータ型を設定
flex.Cols(2).DataType = GetType(Date)
flex.Cols(2).Caption = "Date型"
' 3行目のデータ型を設定
flex.Rows(3).DataType = GetType(Boolean)
flex.Rows(3).Caption = "Boolean型"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 2列目のデータ型を設定
flex.Cols[2].DataType = typeof(DateTime);
flex.Cols[2].Caption = "DateTime型";
// 3行目のデータ型を設定
flex.Rows[3].DataType = typeof(bool);
flex.Rows[3].Caption = "bool型";
}
注意:
GetType メソッドや typeof 式の詳細は、MSDNを参照してください。
DataType プロパティは設計時に設定することも可能です。
行、列両方のデータ型が設定されている場合、列の設定が優先されます。
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid と接続しているデータソースに依存しま
す。
関連項目
列エディタ
Column タスク
データ型を設定する
行列の書式を設定する
行や列単位で書式を設定するには、Format プロパティを使用します。
注意:
注意:Format プロパティを設定したセル(列)の DataType プロパティが、Int32やDouble等の数値型や日付型に設定さ
れていることを確認してください。Format プロパティは数値や日付データの書式を行うための機能ですので、DataType
プロパティが Object や String 等に設定されている場合には機能しません。
【実行例】
301
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 2列目のデータ型を設定
flex.Cols(2).DataType = GetType(Date)
' 2列目の書式を設定
flex.Cols(2).Format = "D"
flex.Cols(2).Caption = "長い日付"
' 3行目のデータ型を設定
flex.Rows(3).DataType = GetType(Date)
' 3行目の書式を設定
flex.Rows(3).Format = "d"
flex.Rows(3).Caption = "短い日付"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 2列目のデータ型を設定
flex.Cols[2].DataType = typeof(DateTime);
// 2列目の書式を設定
flex.Cols[2].Format = "D";
flex.Cols[2].Caption = "長い日付";
// 3行目のデータ型を設定
flex.Rows[3].DataType = typeof(DateTime);
// 3行目の書式を設定
flex.Rows[3].Format = "d";
flex.Rows[3].Caption = "短い日付";
}
302
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
注意:
GetType メソッドや typeof 式の詳細は、MSDNを参照してください。
数値型、日付型の書式指定についての詳細は、MSDNを参照してください。
DataType プロパティは設計時に設定することも可能です。
行、列両方のデータ型・書式が設定されている場合、列の設定が優先されます。
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid と接続しているデータソースに依存しま
す。
関連項目
関連項目列エディタ
列エディタ
C1FlexGrid タスク
データ型を設定する
セルの内容
固定列に行番号を表示する
行番号の自動採番機能はありませんが、オーナー描画を使用する方法で自動採番と同様の処理が可能です。
【実行例】
【実行例:行追加後に自動採番】
303
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Rows.Count = 10
flex.AllowAddNew = True
flex.Styles.NewRow.BackColor = Color.Beige
' オーナー描画の機能を使用
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
' 自動的に行番号を表示する
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' 0列目に行番号を表示
If e.Col = 0 And e.Row >= flex.Rows.Fixed And e.Row <= flex.Rows.Count - 2 Then
e.Text = e.Row
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Rows.Count = 10;
flex.AllowAddNew = true;
flex.Styles.NewRow.BackColor = Color.Beige;
// オーナー描画の機能を使用
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
// 自動的に行番号を表示する
private void flex_OwnerDrawCell(object sender,
304
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// 0列目に行番号を表示
if (e.Col == 0 & e.Row >= flex.Rows.Fixed & e.Row <= flex.Rows.Count - 2)
{
e.Text = e.Row.ToString();
}
}
単純に固定列に行番号を表示する場合は、ループ処理で固定列に直接値を設定してください。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Rows.Count = 12
For i As Integer = 0 To flex.Rows.Count - 1
flex(i, 0) = i
' Caption プロパティを使用する場合
' flex.Rows(i).Caption = i
Next
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Rows.Count = 10;
305
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.AllowAddNew = true;
flex.Styles.NewRow.BackColor = Color.Beige;
private void Form1_Load(object sender, EventArgs e)
{
flex.Rows.Count = 12;
for (int i = 0; i < flex.Rows.Count; i++)
{
flex[i, 0] = i;
// Caption プロパティを使用する場合
// flex.Rows[i].Caption = i.ToString();
}
}
操作
行列の操作に関するタスクを紹介します。
行を追加する
行を追加するには、RowCollection クラスのAdd メソッドやC1FlexGridBase クラスのAddItem メソッドを使用しま
す。RowCollection クラスのCount プロパティを使用して行数を変更する方法もあります。
注意:
注意:RowCollection クラスの Count プロパティを変更できるのは、非連結モードで使用している場合のみです。連結
モードで使用すると、例外が発生します。
【実行例】
追加後イメージ
306
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' AddItemメソッドを使用する
' 行を追加してデータを設定
flex.AddItem("4" & vbTab & "4行目")
' RowCollection.Addメソッドを使用する
Dim r As C1.Win.C1FlexGrid.Row
' 行を追加
r = flex.Rows.Add()
' データを設定
r.Item(0) = "4"
r.Item(1) = "4行目"
' RowCollection.Countプロパティを変更する
' 行を追加
flex.Rows.Count += 1
' データを設定
flex(flex.Rows.Count - 1, 0) = "4"
flex(flex.Rows.Count - 1, 1) = "4行目"
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// AddItemメソッドを使用する
// 行を追加してデータを設定
flex.AddItem("4" + "\t" + "4行目");
// RowCollection.Addメソッドを使用する
C1.Win.C1FlexGrid.Row r;
307
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 行を追加
r = flex.Rows.Add();
// データを設定
r[0] = "4";
r[1] = "4行目";
// RowCollection.Countプロパティを変更する
// 行を追加
flex.Rows.Count += 1;
// データを設定
flex[flex.Rows.Count - 1, 0] = "4";
flex[flex.Rows.Count - 1, 1] = "4行目";
}
注意:
注意:付属の LoadSpeed サンプルも参照してください。
列を追加する
\
行を追加するには、ColumnCollection クラスの Add メソッドを使用するか、ColumnCollection クラスの Count プロパティ
を変更します。
注意:
注意:連結モードで列を追加した場合、非連結列として追加されます。
【実行例】
追加後イメージ
308
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' ColumnCollection.Addメソッドを使用する
Dim c As C1.Win.C1FlexGrid.Column
c = flex.Cols.Add
c.Caption = "追加した列"
' ColumnCollection.Countプロパティを変更する
flex.Cols.Count += 1
flex.Cols(flex.Cols.Count -1).Caption = "追加した列"
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// ColumnCollection.Addメソッドを使用する
C1.Win.C1FlexGrid.Column c;
c = flex.Cols.Add();
c.Caption = "追加した列";
// ColumnCollection.Countプロパティを変更する
flex.Cols.Count += 1;
309
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Cols[flex.Cols.Count - 1].Caption = "追加した列";
}
行/列を削除する
列を削除する
行を削除するには、RowCollection クラスの Remove メソッドや C1FlexGridBase クラスのRemoveItem メソッドを使用し
ます。RowCollection クラスの Count プロパティを使用して行数を変更する方法もあります。
列を削除するには、Remove メソッドを使用するか、ColumnCollection クラスの Count プロパティを使用して列数を変更し
ます。
また、RemoveRange/RemoveRange メソッドを使用すると、複数行/列を削除できます。
注意:
注意:RowCollection クラスの Count プロパティを変更できるのは、非連結モードで使用している場合のみです。連結
モードで使用すると、例外が発生します。
【実行例】
削除後イメージ
310
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' RowCollection.Removeメソッドを使用して2行目を削除
flex.Rows.Remove(2)
' RemoveItemメソッドを使用して2行目を削除
flex.RemoveItem(2)
' RowCollection.Countプロパティを変更:最後の行を削除
flex.Rows.Count -= 1
' RemoveRangeメソッドを使用して2行目から3行削除
flex.Rows.RemoveRange(2, 3)
End Sub
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button2.Click
' ColumnCollection.Removeメソッドを使用して2列目を削除
flex.Cols.Remove(2)
' ColumnCollection.Countプロパティを変更:最後の行を削除
flex.Cols.Count -= 1
' RemoveRangeメソッドを使用して2列目から3列削除
flex.Cols.RemoveRange(2, 3)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// RowCollection.Removeメソッドを使用して2行目を削除
flex.Rows.Remove(2);
// RemoveItemメソッドを使用して2行目を削除
flex.RemoveItem(2);
311
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// RowCollection.Countプロパティを変更:最後の行を削除
flex.Rows.Count -= 1;
// RemoveRangeメソッドを使用して2行目から3行削除
flex.Rows.RemoveRange(2, 3);
}
private void button2_Click(object sender, EventArgs e)
{
// ColumnCollection.Removeメソッドを使用して2列目を削除
flex.Cols.Remove(2);
// ColumnCollection.Countプロパティを変更:最後の行を削除
flex.Cols.Count -= 1;
// RemoveRangeメソッドを使用して2列目から3列削除
flex.Cols.RemoveRange(2, 3);
}
行を挿入する
行を挿入するには、RowCollection クラスのInsert メソッドを使用します。InsertRange メソッドを使用すると、指定した位置
に複数行を挿入できます。
注意:
注意:行の挿入は非連結モード時のみ可能です。連結モードでは行の追加のみがサポートされま
す。Insert/
/InsertRange メソッドを連結モードで使用すると、例外が発生します。
【実行例】
挿入後イメージ
312
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
Dim r As C1.Win.C1FlexGrid.Row
' Insertメソッドで2行目の位置に挿入
r = flex.Rows.Insert(2)
r(1) = "挿入行"
' InsertRangeメソッドで2行目の位置に3行を挿入
'flex.Rows.InsertRange(2, 3)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
C1.Win.C1FlexGrid.Row r;
// Insertメソッドで2行目の位置に挿入
r = flex.Rows.Insert(2);
r[1] = "挿入行";
// InsertRangeメソッドで2行目の位置に3行を挿入
//flex.Rows.InsertRange(2, 3);
}
列を挿入する
行を挿入するには、ColumnCollection クラスの Insert メソッドを使用します。InsertRange メソッドを使用すると、指定した
位置に複数行を挿入できます。
注意:
注意:連結モードで列を挿入した場合、非連結列として挿入されます。
313
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
挿入後イメージ
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
Dim c As C1.Win.C1FlexGrid.Column
' Insertメソッドで2列目の位置に挿入
c = flex.Cols.Insert(2)
c.Caption = "挿入列"
' InsertRangeメソッドで2列目の位置に3列を挿入
314
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
'flex.Cols.InsertRange(2, 3)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
C1.Win.C1FlexGrid.Column c;
// Insertメソッドで2列目の位置に挿入
c = flex.Cols.Insert(2);
c.Caption = "挿入列";
// InsertRangeメソッドで2列目の位置に3列を挿入
//flex.Cols.InsertRange(2, 3);
}
ユーザーによる行の追加を許可する
AllowAddNew プロパティを True に変更します。行の追加を許可すると、最終行に新規追加のテンプレート行が表示されま
す。
また、NewRowWatermark プロパティを使用して新規追加のテンプレート行に任意の文字列を表示し、ユーザーに新規行
への入力を促す処理を実装することも可能です。
【実行例】
Visual Basic コードの書き方
Visual Basic
flex.AllowAddNew = True
flex.NewRowWatermark = "新しいレコードは、ここに追加してください"
C# コードの書き方
315
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
flex.AllowAddNew = true;
flex.NewRowWatermark = "新しいレコードは、ここに追加してください";
注意:
注意:AllowAddNew プロパティは、[C1FlexGrid タスク] からも設定できます。
ユーザーによる行の削除を許可する
AllowDelete プロパティを True に変更すると、ユーザーは行を選択して Delete キー
キーを押すことで、それらの行を削除できま
す。
【実行例】 5行目を選択して、
行目を選択して、Delete キーを押します。
316
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
削除後イメージ
Visual Basic コードの書き方
Visual Basic
flex.AllowDelete = True
C# コードの書き方
C#
flex.AllowDelete = true;
注意:
注意:AllowDelete プロパティは、[C1FlexGrid タスク] からも設定できます。
317
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ユーザーによる行
ユーザーによる行/列の移動を許可する
列の移動を許可する
AllowDragging プロパティを変更します(デフォルトは AllowDraggingEnum.Columns)。また、行や列の
AllowDragging プロパティを False に設定すると、特定行または列のドラッグを禁止できます。
注意:
注意:行の移動は非連結モードでのみ可能です。連結モードでの行の移動はサポートされません。
【実行例】 5行目をドラッグして移動
行目をドラッグして移動
318
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
移動後イメージ
Visual Basic コードの書き方
Visual Basic
' ユーザーによる行/列の移動をを許可する
flex.AllowDragging = C1.Win.C1FlexGrid.AllowDraggingEnum.Both
' 2列目の移動は禁止
flex.Cols(2).AllowDragging = False
C# コードの書き方
C#
// ユーザーによる行/列の移動をを許可する
flex.AllowDragging = C1.Win.C1FlexGrid.AllowDraggingEnum.Both;
// 2列目の移動は禁止
flex.Cols[2].AllowDragging = false;
注意:
各列の移動許可/禁止は、列エディタ や Column タスク からも設定できます。
列の移動のみを許可する場合は、「C1FlexGrid タスク」 からも設定できます。
319
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ユーザーによる行の高さ
ユーザーによる行の高さ/列幅の変更を許可する
列幅の変更を許可する
AllowResizing プロパティを変更します(デフォルトは AllowResizingEnum.Columns)。また、行や列の AllowResizing プ
ロパティを False に設定すると、特定行または列のサイズ変更を禁止できます。
【実行例】
Visual Basic コードの書き方
320
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
' ユーザーによる行の高さ/列幅の変更を許可する
flex.AllowResizing = C1.Win.C1FlexGrid.AllowResizingEnum.Both
' 2列目のサイズ変更は禁止
flex.Cols(2).AllowResizing = False
C# コードの書き方
C#
// ユーザーによる行の高さ/列幅の変更を許可する
flex.AllowResizing = C1.Win.C1FlexGrid.AllowResizingEnum.Both;
// 2列目のサイズ変更は禁止
flex.Cols[2].AllowResizing = false;
注意:
注意:各列のサイズ変更許可/禁止は、列エディタ や Column タスク からも設定できます。
データにあわせて行
データにあわせて行/列のサイズを調整する
列のサイズを調整する
AutoSizeRow/AutoSizeRows メソッドで行のサイズを、AutoSizeCol/AutoSizeCols メソッドで列のサイズをデータにあ
わせて調整できます。
また、行や列のサイズ変更が許可されている場合、ユーザーは行/列の境界線をダブルクリックすることで表示されている
データにあわせてサイズを調整できます。
【実行例】
サイズ調整後イメージ
321
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 1列目の列幅を調整
flex.AutoSizeCol(1)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 1列目の列幅を調整
flex.AutoSizeCol(1);
}
注意:AutoSizeRow/AutoSizeRows、AutoSizeCol/AutoSizeCols メソッドは、行・列のサイズ変更を禁止している
場合でも使用できます。
関連項目
自動で列幅を調整する
行/列の最小、最大サイズを設定する
列の最小、最大サイズを設定する
MinSize プロパティで最小サイズを、MaxSize プロパティで最大サイズを設定します。この設定は、ユーザーによるサイズ変
更時、コードでのサイズ変更時の両方で有効です。
【実行例】
322
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 列幅の最大サイズを50にします
flex.Cols.MaxSize = 50
' 行の高さの最小サイズを16にします
flex.Rows.MinSize = 16
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 列幅の自動調整を行っても最大サイズ以上にはなりません
flex.AutoSizeCol(1)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 列幅の最大サイズを50にします
flex.Cols.MaxSize = 50;
// 行の高さの最小サイズを16にします
flex.Rows.MinSize = 16;
}
private void button1_Click(object sender, EventArgs e)
{
// 列幅の自動調整を行っても最大サイズ以上にはなりません
flex.AutoSizeCol(1);
}
注意:
MinSize/MaxSize プロパティを0にすると、最小/最大サイズの設定は無効になります。
323
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
最小サイズが DefaultSize よりも小さい場合、最小サイズの値で行や列が表示されます。
ユーザーによる行
ユーザーによる行/列の静止を許可する
列の静止を許可する
ユーザーがマウスで行と列を静止(フリーズ)できるようにするには、AllowFreezing プロパティ
を、AllowFreezingEnum.Columns(列のみをフリーズする場合)、AllowFreezingEnum.Rows(行のみをフリーズする場
合)、 AllowFreezingEnum.Both(列と行の両方をフリーズする場合)のいずれかに設定します。反対に、フリーズを無効に
するには、AllowFreezing プロパティを AllowFreezingEnum.None(デフォルト設定)に設定します。
【実行例】
マウスポインタ が行 の ロック
または列のロック(
324
)アイコンになったとき、フリーズする行または列の上にマウスをドラッグします。
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
静止後イメージ
Visual Basic コードの書き方
Visual Basic
flex.AllowFreezing = C1.Win.C1FlexGrid.AllowFreezingEnum.Both
C# コードの書き方
C#
flex.AllowFreezing = C1.Win.C1FlexGrid.AllowFreezingEnum.Both;
ユーザーによるデータ検索を有効にする
325
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ユーザーが入力した値で列内のデータを検索するには、AutoSearch プロパティを AutoSearchEnum.FromCursor(現在の
行から検索を開始する場合)、または AutoSearchEnum.FromTop(最初のスクロール可能な行から検索を開始する場合)
に設定します。反対に、検索を無効にするには、AutoSearch プロパティを AutoSearchEnum.None(デフォルト設定)に設
定します。
【実行例】
データ検索を有効にすると、ユーザーが入力した文字を含むセルをハイライト表示します。この例では、2列目にCと入力する
と、「CCC」がハイライト表示されます。
Visual Basic コードの書き方
Visual Basic
flex.AutoSearch = C1.Win.C1FlexGrid.AutoSearchEnum.FromTop
C# コードの書き方
C#
flex.AutoSearch = C1.Win.C1FlexGrid.AutoSearchEnum.FromTop;
注意:
同じ文字で始まる複数の値がある場合、次の文字を入力すると、それらの文字を含むセルがハイライト表示され
ます。たとえば、ABと入力すると、「ABC」がハイライト表示されます。
検索文字のバッファがクリアされるまでの時間は、AutoSearchDelay プロパティで変更します。
データ検索を有効にした場合、ユーザーは[Enter]、[Space]、または[F2]キーを押してセルの編集を開始する
必要があります。その他のキーは検索に使用されます。
セルの値
セルやセル範囲のデータを参照および設定する方法を紹介します。
326
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セルに値を設定する
Item プロパティ(インデクサ)、または SetData メソッドを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 2行3列目のセルに値を設定
flex(2, 3) = " 2行3列目"
' flex.Item(2, 3) = "2行3列目"
' flex.SetData(2, 3, "2行3列目", True)
' セルの移動(選択)
flex.Select(2, 3)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 2行3列目のセルに値を設定
flex[2, 3] = "2行3列目";
// flex.SetData(2, 3, "2行3列目", true);
// セルの移動(選択)
flex.Select(2, 3);
}
関連項目
327
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
データの取得と設定
セル範囲に値を設定する
Data プロパティ、または SetData メソッドを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 1行2列-2行3列のセル範囲に値を設定
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(1, 2, 2, 3)
cr.Data = "セル範囲"
' flex.SetData(cr, "セル範囲", True)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 1行2列-2行3列のセル範囲に値を設定
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(1, 2, 2, 3);
cr.Data = "セル範囲";
// flex.SetData(cr, "セル範囲", true);
}
328
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セルの値を取得する
以下のプロパティ、メソッドを使用します。
プロパティ/メソッド
説明
Item プロパティ(インデクサ)
セルに格納されている生データ(書式設定などがされていない値)
GetData メソッド
セルに格納されている生データ(書式設定などがされていない値)
GetDataDisplay メソッド
セルに表示されている(書式設定を含む)データ
Data プロパティ
セル範囲に格納されている生データ(書式設定などがされていない値)
DataDisplay プロパティ
セル範囲に表示されている(書式設定を含む)データ
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Cols(1).Format = "###,#"
flex(1, 1) = 1000
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
Dim str As String
str = "インデクサ:" & flex(1, 1) & vbCrLf
str += "GetData:" & flex.GetData(1, 1) & vbCrLf
str += "GetDataDisplay:" & flex.GetDataDisplay(1, 1)
MessageBox.Show(str)
End Sub
329
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Cols[1].Format = "###,#";
flex[1, 1] = 1000;
}
private void button1_Click(object sender, EventArgs e)
{
String str;
str = "インデクサ:" + flex[1, 1] + "\n";
str += "GetData:" + flex.GetData(1, 1) + "\n";
str += "GetDataDisplay:" + flex.GetDataDisplay(1, 1);
MessageBox.Show(str);
セル(範囲)の値をクリアする
AutoClipboard プロパティを True に設定してクリップボードの自動処理を実装することで、ユーザーは Delete キー
キーを押して
セルのデータをクリアすることができます。
【実行例】
クリア後イメージ
330
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.AutoClipboard = True
C# コードの書き方
C#
flex.AutoClipboard = true;
また、コードからデータをクリアする場合は、SetData メソッドを使用します。
注意:
注意:値をセルに格納すると、グリッドはその値を列のデータ型に変換しようとします。変換できない場合、グリッド
は GridError イベントを発生させてセルを変更しません。””(空文字)を設定してデータをクリアする場合は、注意が必要
です。SetData メソッドを使用して coerce 引数を False に設定することでこの動作を変更できます。
【実行例】
331
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
クリア後イメージ
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' カレントセルにDBNull.Valueを設定してクリア
flex.SetData(flex.Row, flex.Col, System.DBNull.Value, False)
End Sub
C# コードの書き方
C#
332
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
private void button1_Click(object sender, EventArgs e)
{
// カレントセルにDBNull.Valueを設定してクリア
flex.SetData(flex.Row, flex.Col, System.DBNull.Value, false);
}
関連項目
データの取得と設定
画像
画像/表示
表示
主にグリッドの表示に関するタスクを紹介します。
オーナー描画を使用する
このタスク内でも「セルに線を描画する」や「グラデーション背景を描画する」などの処理でオーナー描画を使用していますが、
オーナー描画の変更は表示上のみ影響します。そのため、罫線や背景色といった外観だけではなく、「パスワード入力を行う」
のように表示されているデータに対して描画を行っても実際のデータは変更されません。
たとえば、下記のサンプルでは実際のデータに対して”(済)”という文字列を追加する処理を実装しています。入力されたデータ
には変更がないことを確認できます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' オーナー描画を使用する
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
333
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' 1列目のみ変更
If e.Col = 1 Then
If e.Row >= flex.Rows.Fixed And e.Text <> "" Then
e.Text = e.Text & " (済)"
End If
End If
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
MessageBox.Show("実際のデータ:" & flex(2, 1))
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// オーナー描画を使用する
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// 1列目のみ変更
if (e.Col == 1)
{
if ((e.Row >= flex.Rows.Fixed) && (e.Text != ""))
{
e.Text = e.Text + " (済)";
}
}
}
private void button1_Click(object sender, EventArgs e)
{
MessageBox.Show("実際のデータ:" + flex[2, 1]);
}
グラデーション背景を描画する
セル範囲にグラデーション背景を適用するには、OwnerDrawCell イベントを使用してセルの描画を行います。
【実行例】
セル範囲のみに Navy のグラデーション背景を表示します。
334
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
1. フォームクラスレベルに以下のコードを追加し、LinearGradient ブラシと CellRange を作成します。
Visual Basic コードの書き方
Visual Basic
Dim GradientStyleBrush As System.Drawing.Drawing2D.LinearGradientBrush
Dim rng As C1.Win.C1FlexGrid.CellRange
C# コードの書き方
C#
System.Drawing.Drawing2D.LinearGradientBrush GradientStyleBrush;
C1.Win.C1FlexGrid.CellRange rng;
2. Form_Load イベントに以下のコードを追加し、DrawMode プロパティを OwnerDraw に設定します。
Visual Basic コードの書き方
Visual Basic
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
C# コードの書き方
C#
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
3. GetCellRange メソッドを使用し、2行2列目から4行4列目の CellRange を設定します。
Visual Basic コードの書き方
Visual Basic
rng = flex.GetCellRange(2, 2, 4, 4)
C# コードの書き方
C#
rng = flex.GetCellRange(2, 2, 4, 4)
4. グラデーションの LinearGradient ブラシの色と角度を設定します。
Visual Basic コードの書き方
335
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
GradientStyleBrush = New
System.Drawing.Drawing2D.LinearGradientBrush(ClientRectangle, Color.Navy,
Color.Transparent, 270)
C# コードの書き方
C#
GradientStyleBrush = new
System.Drawing.Drawing2D.LinearGradientBrush(ClientRectangle, Color.Navy,
Color.Transparent, 270);
5. OwnerDrawCell イベントを追加し、CellRange にグラデーションを描画します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' グラデーションブラシを使用して
' セルの背景を描画します
If (e.Row >= rng.r1) And (e.Row <= rng.r2) Then
If (e.Col >= rng.c1) And (e.Col <= rng.c2) Then
' 背景を描画
e.Graphics.FillRectangle(GradientStyleBrush, e.Bounds)
' セルの内容を描画
e.DrawCell(C1.Win.C1FlexGrid.DrawCellFlags.Content)
' 描画の終了
e.Handled = True
End If
End If
End Sub
C# コードの書き方
C#
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// グラデーションブラシを使用して
// セルの背景を描画します
if ((e.Row >= rng.r1) && (e.Row <= rng.r2))
{
if ((e.Col >= rng.c1) && (e.Col <= rng.c2))
{
// 背景を描画
e.Graphics.FillRectangle(GradientStyleBrush, e.Bounds);
// セルの内容を描画
e.DrawCell(C1.Win.C1FlexGrid.DrawCellFlags.Content);
// 描画の終了
e.Handled = true;
}
336
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
セルを塗りつぶす
FlexGrid には、VS-FlexGrid(ActiveX製品)の CellFloodPercent プロパティのような、セルを塗りつぶすための直接的な機能
はありません。ただ、オーナー描画セルとして、セル上に任意のグラフィックを表示する機能が実装されています。この場合、
実際の描画処理は .NET Framework の System.Drawing クラスを使用しますが、同クラスの FillRectangle メソッドを使用し
て、任意の四角形の領域を塗りつぶす動作が可能です。
セルを塗りつぶす具体的な処理・コードについては、製品付属の BarChart サンプルを確認してください。また、オーナー描画
機能の詳細については、「オーナー描画セル」や「OwnerDrawCell イベント」を参照してください。
【BarChar サンプル実行例】
セルラベルを表示する
ShowCellLabels プロパティを True に設定します。
【実行例】
337
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.ShowCellLabels = True
C# コードの書き方
C#
flex.ShowCellLabels = true;
注意:
セル内にすべてのデータが表示されている場合、そのセルではラベルは表示されません。
付属の各サンプル、CellLabels、CellLabelDelay、CellLabelsNew も参照してください。
セルに画像を設定する
下記の方法でセル(範囲)に画像を設定します。例えば、Image.FromFile メソッドを使用することで、GDI+でサポートされて
いる画像フォーマット.png/JPEG/GIF/EMF/WMF/TIFF/PNG/ICOなど)を表示することができます。
【SetCellImageメソッドを使用する】
メソッドを使用する】
SetCellImage メソッドを使用して、セルに直接画像を設定します。
338
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 2行3列目のセルに画像を設定
flex.SetCellImage(2, 3, Image.FromFile("soccer.gif"))
flex(2, 3) = "サッカー"
C# コードの書き方
C#
// 2行3列目のセルに画像を設定
flex.SetCellImage(2, 3, Image.FromFile("soccer.gif"));
flex[2, 3] = "サッカー";
【Image プロパティを使用する】
Image プロパティを使用して、任意のセル(範囲)に画像を設定します。
339
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 5行3列目-6行3列目に画像を表示
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(5, 3, 6, 3)
cr.Image = Image.FromFile("baseball.gif")
cr.Data = "野球"
C# コードの書き方
C#
// 5行3列目-6行3列目に画像を表示
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(5, 3, 6, 3);
cr.Image = Image.FromFile("baseball.gif");
cr.Data = "野球";
【オーナー描画の機能を使用する】
OwnerDrawCell イベントの e.Image に画像を設定します。
340
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Dim img As Image
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
img = Image.FromFile("basketball.gif")
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' 3行4列目に画像を表示
If e.Row = 3 And e.Col = 4 Then
e.Image = img
e.Text = "バスケット"
End If
End Sub
C# コードの書き方
C#
Image img;
private void Form1_Load(object sender, EventArgs e)
{
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
img = Image.FromFile("basketball.gif");
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// 3行4列目に画像を表示
if((e.Row == 3) && (e.Col == 4))
{
341
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
e.Image = img;
e.Text = "バスケット";
}
}
注意:
MultiColumnDictionary クラスを使用したマルチカラムコンボボックスの使用例について
は、MultiColumnDictionary サンプルを確認してください。
ImageAndText プロパティを使用して、セルにテキストと画像を表示するか、画像のみを表示するかを指定でき
ます。
新規追加行を示すアイコンを変更する
Glyphs プロパティで GlyphEnum.DBAdd を指定して変更します。
【実行例】
変更前(デフォルト)
342
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 新規追加行を表示
flex.AllowAddNew = True
' 新規追加行の背景色を変更
flex.Styles.NewRow.BackColor = Color.Beige
' 新規追加行を示すアイコンを変更
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.DBAdd) = Image.FromFile("C:\arrow.png")
C# コードの書き方
C#
// 新規追加行を表示
flex.AllowAddNew = true;
// 新規追加行の背景色を変更
flex.Styles.NewRow.BackColor = Color.Beige;
// 新規追加行を示すアイコンを変更
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.DBAdd] = Image.FromFile(@"C:\arrow.png");
注意:
注意:Glyphs プロパティに Nothing(Null) を設定すると、デフォルトの画像が復元されます。アイコンを非表示にする
場合は、小さなブランク画像に設定してください。
エラー情報を表示する
ShowErrors プロパティを True に設定し、GetCellErrorInfo/GetRowErrorInfo イベントを使用して制御します。
【実行例】
343
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' エラー情報を表示
flex.ShowErrors = True
End Sub
Private Sub flex_GetCellErrorInfo(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.GetErrorInfoEventArgs) Handles flex.GetCellErrorInfo
' 1列目のデータが空白の場合、
' セルにエラーアイコンを表示
If e.Col = 1 And flex(e.Row, e.Col) = "" Then
e.ErrorText = "未入力"
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// エラー情報を表示
flex.ShowErrors = true;
}
private void flex_GetCellErrorInfo(object sender,
C1.Win.C1FlexGrid.GetErrorInfoEventArgs e)
{
// 1列目のデータが空白の場合、
// セルにエラーアイコンを表示
if((e.Col == 1) && (flex[e.Row, e.Col].ToString() == ""))
{
e.ErrorText = "未入力";
344
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
注意:
注意:エラー情報の表示については、付属の ErrorInfo サンプルも参照してください。
エラー情報のアイコンを変更する
Glyphs プロパティで GlyphEnum.ErrorInfo を指定して変更します。
【実行例】
変更前(デフォルト)
345
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.ShowErrors = True
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.ErrorInfo) = Image.FromFile("C:\bikuri.gif")
C# コードの書き方
C#
flex.ShowErrors = true;
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.ErrorInfo] = Image.FromFile(@"C:\bikuri.gif")
注意:
Glyphs プロパティに Nothing(Null) を設定すると、デフォルトの画像が復元されます。アイコンを非表示にする
場合は、ShowErrors プロパティを False に設定してください。
エラー情報の表示方法については、「エラー情報を表示する」を参照してください。
カレント行を示すアイコンを表示する
ShowCursor プロパティを True に設定(デフォルトは False )すると、固定列に DB 形式のカーソルを表示することができま
す。
【実行例】
346
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.ShowCursor = True
C# コードの書き方
C#
flex.ShowCursor = true;
注意:
注意:アイコンを変更する場合は、Glyphs プロパティで GlyphEnum.DBCursor を指定して変更します。
イメージを拡大
イメージを拡大/縮小する
縮小する
セルに表示されている画像の表示方法は、行列やスタイルの ImageAlign プロパティを使用して変更します。
列単位でイメージを拡大
列単位でイメージを拡大/縮小
縮小
グリッドの行がリサイズされたとき単一列のイメージを拡大/縮小するには、ImageAlign プロパティを Scale に設定します。
【行のリサイズ前】
347
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【行のリサイズ後】
デザイナの場合
1. [FlexGrid 列エディタ
列エディタ]を開きます。列エディタへのアクセス方法の詳細については、「列エディタにアクセス」を参照し
てください。
2. 右ペインからイメージを含む列を選択し、左ペインの ImageAlign プロパティを Scale に設定します。
348
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
3. 〈OK〉〉をクリックし、エディタを閉じます。
コードの場合
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 行の高さを設定
flex.Rows(1).Height = 2 * flex.Rows.DefaultSize
flex.Rows(2).Height = 2 * flex.Rows.DefaultSize
’ 3列目のみ設定
flex.Cols(3).ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.Scale
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 行の高さを設定
flex.Rows[1].Height = 2 * flex.Rows.DefaultSize;
flex.Rows[2].Height = 2 * flex.Rows.DefaultSize;
// 3列目のみ設定
flex.Cols[3].ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.Scale;
}
グリッド全体でイメージを拡大
グリッド全体でイメージを拡大/縮小
縮小
1つの列だけでなく、グリッド全体でイメージを拡大/縮小するには、Normal 組み込みスタイルの ImageAlign プロパティを
Scale に設定します。
349
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【行のリサイズ前】
【行のリサイズ後】
デザイナの場合
1. [FlexGrid スタイルエディタ
スタイルエディタ]を開きます。スタイルエディタへのアクセス方法の詳細については、「 スタイルエディタに
アクセス」を参照してください。
2. [組み込みスタイル]のリストで Normal を選択します。
3. 右ペインで、ImageAlign プロパティを探し、それを Scale に設定します。
350
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
4. 〈OK〉をクリックし、エディタを閉じます。
コードの場合
Form_Load イベントに次のコードを追加します。
Visual Basic コードの書き方
Visual Basic
flex.Styles("Normal").ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.Scale
C# コードの書き方
C#
flex.Styles("Normal").ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.Scale;
描画方法を変更する
C1FlexGrid の描画はデフォルトで GDI+ で行われますが、UseCompatibleTextRendering プロパティを False に設定する
ことで GDI で描画できます。
また、編集エディタは GDI で描画されます。そのため、編集中と非編集時で描画が少し異なります。このような場合には、
UseCompatibleTextRendering プロパティを False に設定し、非編集時の描画を GDI で行った上で、Editor 組み込みスタイ
ルの Margins プロパティ(マージン)を調整することで対応できます。
351
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' GDIで描画します
flex.UseCompatibleTextRendering = False
flex.Font = New Font("MS Pゴシック", 11)
' 編集時のマージンを設定
flex.Styles.Editor.Margins = New System.Drawing.Printing.Margins(3, 1, 2, 1)
flex.Cols(2).DataType = GetType(String)
flex(2, 2) = "12345678901234567890"
flex(3, 2) = "12345678901234567890"
flex.AutoSizeCol(2)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// GDIで描画します
flex.UseCompatibleTextRendering = false;
flex.Font = new Font("MS Pゴシック", 11);
// 編集時のマージンを設定
flex.Styles.Editor.Margins = new System.Drawing.Printing.Margins(3, 1, 2, 1);
flex.Cols[2].DataType = typeof(string);
flex[2, 2] = "12345678901234567890";
flex[3, 2] = "12345678901234567890";
flex.AutoSizeCol(2);
}
352
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コンテキストメニューを表示する
非編集時の場合
ContextMenuStrip コントロールを使用して任意のコンテキストメニューを作成し、C1FlexGrid の ContextMenuStrip プロ
パティに設定します。
注意:
ContextMenuStrip コントロールの詳細は、MSDN を参照してください。
C1FlexGrid には ContextMenu プロパティも用意されています。以前のバージョンの ContextMenu コント
ロールを利用する場合に使用してください。
【実行例】
Visual Basic コードの書き方
Visual Basic
Dim cm As New ContextMenuStrip
cm.Items.Add("Menu1")
cm.Items.Add("Menu2")
cm.Items.Add("Menu3")
flex.ContextMenuStrip = cm
C# コードの書き方
C#
ContextMenuStrip cm = new ContextMenuStrip();
cm.Items.Add("Menu1");
cm.Items.Add("Menu2");
cm.Items.Add("Menu3");
flex.ContextMenuStrip = cm;
353
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
編集中の場合
編集中は編集用エディタに設定されているデフォルトのコンテキストメニューが表示されます。デフォルトのコンテキストメ
ニューを変更する場合は、StartEdit イベントで編集用エディタを取得し、別の ContextMenuStrip コントロールを設定しま
す。
【実行例 (デフォルトの状態)】
【実行例 (変更時)】
354
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub flex_StartEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.StartEdit
' 1列目のみコンテキストメニューを変更
If e.Col = 1 Then
' 編集用エディタを取得
Dim tb As TextBox
tb = CType(flex.Editor, TextBox)
' コンテキストメニューを作成
Dim cm2 As New ContextMenuStrip
cm2.Items.Add("Menu1-Edit")
cm2.Items.Add("Menu2-Edit")
cm2.Items.Add("Menu3-Edit")
' コンテキストメニューを設定
tb.ContextMenuStrip = cm2
Else
' コンテキストメニューをクリア(デフォルトに戻す)
flex.Editor.ContextMenuStrip = Nothing
End If
End Sub
C# コードの書き方
C#
private void flex_StartEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// 1列目のみコンテキストメニューを変更
if (e.Col == 1)
{
// 編集用エディタを取得
TextBox tb = (TextBox)flex.Editor;
// コンテキストメニューを作成
ContextMenuStrip cm2 = new ContextMenuStrip();
cm2.Items.Add("Menu1-Edit");
cm2.Items.Add("Menu2-Edit");
cm2.Items.Add("Menu3-Edit");
// コンテキストメニューを設定
tb.ContextMenuStrip = cm2;
}
else
{
// コンテキストメニューをクリア(デフォルトに戻す)
flex.Editor.ContextMenuStrip = null; ;
}
}
ユーザーデータをツールチップに表示する
ユーザーデータを表示するツールチップを追加するには、MouseMove や MouseEnterCell/MouseLeaveCell イベントを
355
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
使用し、UserData プロパティを取得して ToolTip コントロールに表示します。ここでは、行、列、セル、セル範囲、スタイルの
UserData を ToolTips に表示する方法を紹介します。
行のユーザーデータをツールチップに表示
行のユーザーデータをツールチップに表示するには、MouseEnterCell イベントを使用し、UserData プロパティを取得して
ToolTip コントロールに表示します。
【実行例】
ツールチップは、行全体にわたって表示されます。
1. ツールボックスの ToolTip コントロールを探し、それをフォームに追加します。
2. Form_Load イベントで、行の UserData プロパティを設定します。この例では、LastName/FirstName 列のデータを
使用しています。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
For i As Integer = flex.Rows.Fixed To flex.Rows.Count - 1
flex.Rows(i).UserData = "顧客名:" & flex(i, 2) & " " & flex(i, 3)
Next
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
for (int i = flex.Rows.Fixed; i < flex.Rows.Count; i++)
{
flex.Rows[i].UserData = "顧客名:" + flex[i, 2] + " " + flex[i, 3];
}
}
356
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
3. 以下のコードを MouseEnterCell イベントとMouseLeaveCell イベントに追加し、行の UserData をツールチップに表
示します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseEnterCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseEnterCell
If e.Row >= flex.Rows.Fixed Then
Dim tip As String
tip = flex.Rows(e.Row).UserData
' ToolTipを表示
ToolTip1.SetToolTip(flex, tip)
End If
End Sub
Private Sub flex_MouseLeaveCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseLeaveCell
' ToolTipを非表示
ToolTip1.SetToolTip(flex, "")
End Sub
C# コードの書き方
C#
private void flex_MouseEnterCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
if (e.Row >= flex.Rows.Fixed)
{
string tip;
tip = flex.Rows[e.Row].UserData.ToString();
// ToolTipを表示
toolTip1.SetToolTip(flex, tip);
}
}
private void flex_MouseLeaveCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
// ToolTipを非表示
toolTip1.SetToolTip(flex, "");
}
注意:
注意:ToolTip コントロールの詳細は、MSDNなどを参照してください。
列のユーザーデータをツールチップに表示する
列のユーザーデータをツールチップに表示するには、MouseEnterCell イベントを使用し、UserData プロパティを取得して
ToolTip コントロールに表示します。
【実行例】
357
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ツールチップは2列目のみに表示されます。
1. ツールボックスの ToolTip コントロールを探し、それをフォームに追加します。
2. Form_Load イベントで、2列目の UserData プロパティを設定します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
flex.Cols(2).UserData = "LastName"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Cols[2].UserData = "LastName";
}
3. 以下のコードを MouseEnterCell イベントとMouseLeaveCell イベントに追加し、列の UserData をツールチップに表
示します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseEnterCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseEnterCell
If e.Col = 2 Then
Dim tip As String
tip = flex.Cols(2).UserData
' ToolTipを表示
ToolTip1.SetToolTip(flex, tip)
End If
End Sub
Private Sub flex_MouseLeaveCell(ByVal sender As Object, ByVal e As
358
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseLeaveCell
' ToolTipを非表示
ToolTip1.SetToolTip(flex, "")
End Sub
C# コードの書き方
C#
private void flex_MouseEnterCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
if (e.Col == 2)
{
string tip;
tip = flex.Cols[2].UserData.ToString();
// ToolTipを表示
toolTip1.SetToolTip(flex, tip);
}
}
private void flex_MouseLeaveCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
// ToolTipを非表示
toolTip1.SetToolTip(flex, "");
}
注意:
注意:ToolTip コントロールの詳細は、MSDN などを参照してください。
セルのユーザーデータをツールチップに表示
単一セルのユーザーデータをツールチップに表示するには、 MouseEnterCell イベントを使用し、 GetUserData プロパティ
を取得して ToolTip コントロールに表示します。
【実行例】
3行2列目のセルにマウスを移動すると、ツールチップが表示されます。
1. ツールボックスの ToolTip コントロールを探し、それをフォームに追加します。
359
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
2. Form_Load イベントで、行の GetUserData プロパティを設定します。この例では、LastName/FirstName 列のデー
タを使用しています。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
Dim ud As String
ud = flex(3, 2) & " " & flex(3, 3) & "さんの誕生日:" & flex(3, 6)
flex.SetUserData(3, 2, ud)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
string ud;
ud = flex[3, 2] + " " + flex[3, 3] + "さんの誕生日:" +
((DateTime)flex[3, 6]).ToString("yyyy/MM/dd");
flex.SetUserData(3, 2, ud);
}
3. 以下のコードを MouseLeaveCell イベントに追加し、GetUserData メソッドで取得したセルの UserData をツールチッ
プに表示します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseEnterCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseEnterCell
Dim tip As String = ""
If e.Row = 3 And e.Col = 2 Then
tip = flex.GetUserData(3, 2)
End If
ToolTip1.SetToolTip(flex, tip)
End Sub
C# コードの書き方
C#
private void flex_MouseEnterCell(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
string tip = "";
if((e.Row == 3) && (e.Col == 2))
{
tip = flex.GetUserData(3, 2).ToString();
}
toolTip1.SetToolTip(flex, tip);
}
360
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
注意:
注意:ToolTip コントロールの詳細は、MSDNなどを参照してください。
セル範囲のユーザーデータをツールチップに表示
セル範囲のユーザーデータをツールチップに表示するには、MouseEnterCell イベントを使用し、UserData プロパティを取得
して ToolTip コントロールに表示します。
【実行例】
セル範囲全体で ToolTip が表示されます。
1. ツールボックスの ToolTip コントロールを探し、それをフォームに追加します。
2. Form_Load イベントでセル範囲に対して UserData プロパティを設定します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
' 6行1列目-8行3列目のセル範囲を取得します
Dim rng As C1.Win.C1FlexGrid.CellRange
rng = flex.GetCellRange(6, 1, 8, 3)
' セル範囲を見やすくするために背景色を設定します
rng.StyleNew.BackColor = Color.AliceBlue
' セル範囲のユーザーデータを設定します
rng.UserData = "EmployeeID 6~8"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 6行1列目-8行3列目のセル範囲を取得します
C1.Win.C1FlexGrid.CellRange rng = flex.GetCellRange(6, 1, 8, 3);
361
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// セル範囲を見やすくするために背景色を設定します
rng.StyleNew.BackColor = Color.AliceBlue;
// セル範囲のユーザーデータを設定します
rng.UserData = "EmployeeID 6~8";
}
3. MouseEnterCell イベントを使用して、ツールチップを表示します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseEnterCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseEnterCell
Dim tip As String = ""
If Not flex.GetUserData(e.Row, e.Col) Is Nothing Then
tip = flex.GetUserData(e.Row, e.Col)
End If
ToolTip1.SetToolTip(flex, tip)
End Sub
C# コードの書き方
C#
private void flex_MouseEnterCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
string tip = "";
if (flex.GetUserData(e.Row, e.Col) != null)
{
tip = flex.GetUserData(e.Row, e.Col).ToString();
}
toolTip1.SetToolTip(flex, tip);
}
注意:
注意:ToolTip コントロールの詳細は、MSDNなどを参照してください。
スタイルのユーザーデータをツールチップに表示
スタイルのユーザーデータをツールチップに表示するには、MouseEnterCell イベントを使用し、UserData プロパティを取得
して ToolTip コントロールに表示します。
【実行例】
スタイル全体で ToolTip が表示されます。
362
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
1. ツールボックスの ToolTip コントロールを探し、それをフォームに追加します。
2. Form_Load イベントで行と列のカスタムスタイルを作成して、スタイルを割り当てます。CellStyle の作成方法につい
ての詳細は、「行/列の外観を変更する」を参照してください。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
' 列のCellStyleを作成します
Dim cc As C1.Win.C1FlexGrid.CellStyle
cc = flex.Styles.Add("ColumnColor")
cc.BackColor = Color.Cornsilk
' スタイル名を持つUserDataを追加します
cc.UserData = "ColumnColor Style"
' 行のCellStyleを作成します
Dim rs As C1.Win.C1FlexGrid.CellStyle
rs = flex.Styles.Add("RowColor")
rs.BackColor = Color.PowderBlue
' スタイル名を持つUserDataを追加します
rs.UserData2 = "RowColor Style"
' ColumnColorスタイルを列に割り当てます
flex.Cols(2).Style = flex.Styles("ColumnColor")
' RowColor スタイルを行に割り当てます。
flex.Rows(4).Style = flex.Styles("RowColor")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 列のCellStyleを作成します
C1.Win.C1FlexGrid.CellStyle cc;
cc = flex.Styles.Add("ColumnColor");
cc.BackColor = Color.Cornsilk;
363
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// スタイル名を持つUserDataを追加します
cc.UserData = "ColumnColor Style";
// 行のCellStyleを作成します
C1.Win.C1FlexGrid.CellStyle rs;
rs = flex.Styles.Add("RowColor");
rs.BackColor = Color.PowderBlue;
// スタイル名を持つUserDataを追加します
rs.UserData = "RowColor Style";
// ColumnColorスタイルを列に割り当てます
flex.Cols[2].Style = flex.Styles["ColumnColor"];
// RowColor スタイルを行に割り当てます。
flex.Rows[4].Style = flex.Styles["RowColor"];
}
3. 以下のコードを MouseEnterCell イベントと MouseLeaveCell イベントに追加し、UserData をツールチップを表示し
ます。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseEnterCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseEnterCell
Dim tip As String = ""
If e.Row = 4 Then
tip = flex.Rows(4).Style.UserData
End If
If e.Col = 2 Then
tip = flex.Cols(2).Style.UserData
End If
' ToolTipを表示
ToolTip1.SetToolTip(flex, tip)
End Sub
Private Sub flex_MouseLeaveCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseLeaveCell
' ToolTipを非表示
ToolTip1.SetToolTip(flex, "")
End Sub
C# コードの書き方
C#
private void flex_MouseEnterCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
string tip = "";
if (e.Row == 4)
{
tip = flex.Rows[4].Style.UserData.ToString();
}
if (e.Col == 2)
{
tip = flex.Cols[2].Style.UserData.ToString();
}
364
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// ToolTipを表示
toolTip1.SetToolTip(flex, tip);
}
private void flex_MouseLeaveCell(object sender,
C1.Win.C1FlexGrid.RowColEventArgs e)
{
// ToolTipを非表示
toolTip1.SetToolTip(flex, "");
}
注意:
注意:ToolTip コントロールの詳細は、MSDNなどを参照してください。
マウス下のセルをハイライト表示する
MouseEnterCell/MouseLeaveCellイベントを使用することで、セル内にマウスポインタが入ったとき、およびマウスポインタ
がセルから離れたときを判別できます。MouseEnterCell イベントでスタイルを設定し、MouseLeaveCell イベントで設定した
スタイルを削除することでマウス下のセルをハイライト表示します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムスタイルを作成
flex.Styles.Add("track")
flex.Styles("track").BackColor = Color.Gold
End Sub
Private Sub flex_MouseEnterCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseEnterCell
' セル内にマウスポインタが入ればスタイルを設定
365
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.SetCellStyle(e.Row, e.Col, flex.Styles("track"))
End Sub
Private Sub flex_MouseLeaveCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.MouseLeaveCell
' セルから出た際にスタイルを削除
flex.SetCellStyle(e.Row, e.Col, CType(Nothing, C1.Win.C1FlexGrid.CellStyle))
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムスタイルを作成
flex.Styles.Add("track");
flex.Styles["track"].BackColor = Color.Gold;
}
private void flex_MouseEnterCell(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// セル内にマウスポインタが入ればスタイルを設定
flex.SetCellStyle(e.Row, e.Col, flex.Styles["track"]);
}
private void flex_MouseLeaveCell(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// セルから出た際にスタイルを削除
flex.SetCellStyle(e.Row, e.Col, (C1.Win.C1FlexGrid.CellStyle)null);
}
マージ
マージに関するタスクを紹介します。
隣接する同一データを自動マージする
グリッドの AllowMerging プロパティを Free にし(デフォルトはNone)、行や列の AllowMerging プロパティを True に設
定することで、固定セル・通常セルを自動的にマージして表示します。
【実行例】
2列目、5・7・8行目をマージ。8行目は列のマージが優先されます。
366
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Free
' 固定行数を設定
flex.Rows.Fixed = 2
' 各行、列のAllowMergingプロパティを設定
flex.Cols(2).AllowMerging = True
flex.Rows(5).AllowMerging = True
flex.Rows(8).AllowMerging = True
' データの設定
flex(0, 2) = "列のマージ"
flex(1, 2) = "列のマージ"
flex(2, 2) = "列のマージ"
flex(3, 2) = "列のマージ"
flex(5, 3) = "行のマージ"
flex(5, 4) = "行のマージ"
flex(7, 2) = "列のマージが優先"
flex(8, 2) = "列のマージが優先"
flex(8, 3) = "列のマージが優先"
C# コードの書き方
C#
// グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Free;
// 固定行数を設定
flex.Rows.Fixed = 2;
// 各行、列のAllowMergingプロパティを設定
flex.Cols[2].AllowMerging = true;
flex.Rows[5].AllowMerging = true;
flex.Rows[8].AllowMerging = true;
// データの設定
367
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex[0,
flex[1,
flex[2,
flex[3,
flex[5,
flex[5,
flex[7,
flex[8,
flex[8,
2]
2]
2]
2]
3]
4]
2]
2]
3]
=
=
=
=
=
=
=
=
=
"列のマージ";
"列のマージ";
"列のマージ";
"列のマージ";
"行のマージ";
"行のマージ";
"列のマージが優先";
"列のマージが優先";
"列のマージが優先";
注意:
固定セルと通常セルはマージされません。
自動マージの場合、特定の位置でのみマージする(同一データをマージしない)といった動作はできません。この
場合は、自動マージのカスタマイズや制限付きマージ、カスタムマージを検討してください。
行と列のマージが同時に行われた場合、列のマージが優先されます。
カスタムマージと自動マージを同時に実装することはできません。
隣接する同一データを自動マージする(制限付き)
グリッドの AllowMerging プロパティを RestrictRows(上にあるセルもマージされる場合)、またはRestrictCols(左にあるセ
ルもマージされる場合)、RestrictAll(上または左にあるセルもマージされる場合)にし、行や列の AllowMerging プロパティ
を True に設定します。
【実行例】 上にあるセルもマージされる場合(
上にあるセルもマージされる場合(RestrictRows))
1. 2行目をマージ。2行目のCCCのセルは、1行目がマージされているセルのみマージされます。
Visual Basic コードの書き方
Visual Basic
' グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.RestrictRows
' 各行、列のAllowMergingプロパティを設定
368
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Rows(1).AllowMerging = True
flex.Rows(2).AllowMerging = True
' 列ヘッダの設定
flex.Rows(1).Caption = "1行目"
flex.Rows(2).Caption = "2行目"
' データの設定
flex(1, 1) = "AAA"
flex(1, 2) = "AAA"
flex(1, 3) = "BBB"
flex(1, 4) = "BBB"
flex(2, 1) = "CCC"
flex(2, 2) = "CCC"
flex(2, 3) = "CCC"
flex(2, 4) = "CCC"
C# コードの書き方
C#
// グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.RestrictRows;
// 各行、列のAllowMergingプロパティを設定
flex.Rows[1].AllowMerging = true;
flex.Rows[2].AllowMerging = true;
// 列ヘッダの設定
flex.Rows[1].Caption = "1行目";
flex.Rows[2].Caption = "2行目";
// データの設定
flex[1, 1] = "AAA";
flex[1, 2] = "AAA";
flex[1, 3] = "BBB";
flex[1, 4] = "BBB";
flex[2, 1] = "CCC";
flex[2, 2] = "CCC";
flex[2, 3] = "CCC";
flex[2, 4] = "CCC";
【実行例】 左にあるセルもマージされる場合(
左にあるセルもマージされる場合(RestrictCols))
1. 2列目をマージ。2列目のCCCのセルは、1列目がマージされているセルのみマージされます。
369
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.RestrictCols
' 各行、列のAllowMergingプロパティを設定
flex.Cols(1).AllowMerging = True
flex.Cols(2).AllowMerging = True
' 列ヘッダの設定
flex.Cols(1).Caption = "1列目"
flex.Cols(2).Caption = "2列目"
' データの設定
flex(1, 1) = "AAA"
flex(2, 1) = "AAA"
flex(3, 1) = "BBB"
flex(4, 1) = "BBB"
flex(1, 2) = "CCC"
flex(2, 2) = "CCC"
flex(3, 2) = "CCC"
flex(4, 2) = "CCC"
C# コードの書き方
C#
// グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.RestrictCols;
// 各行、列のAllowMergingプロパティを設定
flex.Cols[1].AllowMerging = true;
flex.Cols[2].AllowMerging = true;
// 列ヘッダの設定
flex.Cols[1].Caption = "1列目";
flex.Cols[2].Caption = "2列目";
// データの設定
370
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex[1,
flex[2,
flex[3,
flex[4,
flex[1,
flex[2,
flex[3,
flex[4,
1]
1]
1]
1]
2]
2]
2]
2]
=
=
=
=
=
=
=
=
"AAA";
"AAA";
"BBB";
"BBB";
"CCC";
"CCC";
"CCC";
"CCC";
注意:
固定セルと通常セルはマージされません。
行と列のマージが同時に行われた場合、列のマージが優先されます。
カスタムマージと自動マージを同時に実装することはできません。
自動マージ処理をカスタマイズする
C1FlexGrid コントロールの自動マージでは、行のマージよりも列のマージが優先される仕様になっているため、行および列の
両方にまたがるブロックのセル範囲をマージすることができません。また、隣接するセルの値が同じ場合でも特定の位置では
マージしないといった動作もできないといった制限があります。
この場合、カスタムマージ(セル結合)で対応するか、C1FlexGrid を継承、GetMergeRange メソッドをオーバーライドし、自
動マージ処理をカスタマイズする方法があります。
【実行例】 ブロックのセル範囲をマージ (CustomCellMerge サンプル)
曜日(列)や時間(行)をまたがってブロック単位にマージされています。
【実行例】 マージ範囲を限定 (CustomCellMerge2 サンプル)
上下の隣接するセル同士が同じ値でもマージを行わず、[ID] 列ごとにマージしています。
371
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
注意:
注意:コード例については、付属の CustomCellMerge/CustomCellMerge2 サンプルを参照してください。
カスタムマージ(セル結合)を行う
グリッドのAllowMerging プロパティをCustom にし、マージ(結合)したいセル範囲を MergedRanges コレクションに追加し
ます。
【実行例】 2行
行2列目から
列目から5行
行3列目を結合
列目を結合
Visual Basic コードの書き方
Visual Basic
' グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Custom
372
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' マージ(結合)したいセル範囲を取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(2, 2, 5, 3)
' セル範囲にデータを設定
cr.Data = "マージ(セル結合)"
' セル範囲の背景色を設定
cr.StyleNew.BackColor = Color.AliceBlue
' セル範囲のテキスト表示位置を設定
cr.Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
' セル範囲をMergedRangesコレクションに追加
flex.MergedRanges.Add(cr)
C# コードの書き方
C#
// グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Custom;
// マージ(結合)したいセル範囲を取得
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(2, 2, 5, 3);
// セル範囲にデータを設定
cr.Data = "マージ(セル結合)";
// セル範囲の背景色を設定
cr.StyleNew.BackColor = Color.AliceBlue;
// セル範囲のテキスト表示位置を設定
cr.Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
// セル範囲をMergedRangesコレクションに追加
flex.MergedRanges.Add(cr);
注意:
マージ(結合)を解除する場合は、MergedRanges コレクションから削除(Clear/
/RemoveAt)します。
カスタムマージと自動マージを同時に実装することはできません。
オーバーフロー表示を行う
グリッドの AllowMerging プロパティを Spill にします。1つのセル内に収まらない長いデータが隣のセル(空白の場合に限
り)にはみ出して表示されます。
【実行例】
373
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Spill
' データの設定
flex(2, 1) = "セル内に収まらない長いデータをオーバーフロー表示"
C# コードの書き方
C#
// グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Spill;
// データの設定
flex[2, 1] = "セル内に収まらない長いデータをオーバーフロー表示";
注意:
注意:カスタムマージや自動マージと同時に実装することはできません。
ノード行をマージする
グリッドの AllowMerging プロパティを Nodes にします。ノード行全体がマージされて表示されます。
【実行例】
374
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' グリッドの AllowMerging プロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Nodes
' 列数:6
flex.Cols.Count = 6
' 固定列:0
flex.Cols.Fixed = 0
' ツリー列:0
flex.Tree.Column = 0
' ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' 1行目をノード行に設定
flex.Rows(1).IsNode = True
' 階層レベルを0に設定
flex.Rows(1).Node.Level = 0
' 3行目をノード行に設定
flex.Rows(3).IsNode = True
' 階層レベルを0に設定
flex.Rows(3).Node.Level = 0
flex(1, 0) = "ノード行1"
flex(3, 0) = "ノード行2"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// グリッドのAllowMergingプロパティを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Nodes;
// 列数:6
flex.Cols.Count = 6;
// 固定列:0
flex.Cols.Fixed = 0;
375
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// ツリー列:0
flex.Tree.Column = 0;
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
// 1行目をノード行に設定
flex.Rows[1].IsNode = true;
// 階層レベルを0に設定
flex.Rows[1].Node.Level = 0;
// 3行目をノード行に設定
flex.Rows[3].IsNode = true;
// 階層レベルを0に設定
flex.Rows[3].Node.Level = 0;
flex[1, 0] = "ノード行1";
flex[3, 0] = "ノード行2";
}
固定セルと通常セルのマージモードを別々に設定する
AllowMergingFixed プロパティで固定セルのマージモードを、AllowMerging プロパティで通常セルのマージモードを設定
します。
注意:
注意:グリッドの AllowMerging プロパティを FixedOnly に設定すると、固定行/列のみが自動マージの対象になり、
通常セルがマージされません。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 固定行数の設定
flex.Rows.Fixed = 3
' 固定セルのマージモードを設定
376
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.AllowMergingFixed = C1.Win.C1FlexGrid.AllowMergingEnum.Custom
' マージ(結合)したいセル範囲を取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(0, 1, 2, 3)
' セル範囲にデータを設定
cr.Data = "マージ(セル結合)"
' セル範囲のテキスト表示位置を設定
cr.StyleNew.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter
' セル範囲をMergedRangesコレクションに追加
flex.MergedRanges.Add(cr)
' 通常セルのマージモードを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Free
' 各列のAllowMergingプロパティを設定
flex.Cols(1).AllowMerging = True
flex.Cols(2).AllowMerging = True
flex.Cols(3).AllowMerging = True
' データの設定
flex(3, 1) = "AAA"
flex(4, 1) = "AAA"
flex(5, 1) = "AAA"
flex(3, 2) = "BBB"
flex(4, 2) = "BBB"
flex(5, 2) = "BBB"
flex(6, 2) = "CCC"
flex(7, 2) = "CCC"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 固定行数の設定
flex.Rows.Fixed = 3;
// 固定セルのマージモードを設定
flex.AllowMergingFixed = C1.Win.C1FlexGrid.AllowMergingEnum.Custom;
// マージ(結合)したいセル範囲を取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(0, 1, 2, 3);
// セル範囲にデータを設定
cr.Data = "マージ(セル結合)";
// セル範囲のテキスト表示位置を設定
cr.StyleNew.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.CenterCenter;
// セル範囲をMergedRangesコレクションに追加
flex.MergedRanges.Add(cr);
// 通常セルのマージモードを設定
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Free;
// 各列のAllowMergingプロパティを設定
flex.Cols[1].AllowMerging = true;
flex.Cols[2].AllowMerging = true;
flex.Cols[3].AllowMerging = true;
// データの設定
377
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex[3,
flex[4,
flex[5,
flex[3,
flex[4,
flex[5,
flex[6,
flex[7,
1]
1]
1]
2]
2]
2]
2]
2]
=
=
=
=
=
=
=
=
"AAA";
"AAA";
"AAA";
"BBB";
"BBB";
"BBB";
"CCC";
"CCC";
}
注意:
行と列のマージが同時に行われた場合、列のマージが優先されます。
固定セルまたは通常セル内でカスタムマージと自動マージを同時に実装することはできません。
マージセルかどうかを判別する
GetMergedRange メソッドで任意のセルを含むセル範囲を取得し、CellRange オブジェクトの IsSingleCell プロパティで、取
得したセル範囲が単一セルで構成されるかどうかを参照します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムマージ(セル結合)
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Custom
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(1, 1, 2, 3)
flex.MergedRanges.Add(cr)
End Sub
' 2行3列目のセルがマージセルかどうかを判別します
378
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 2行3列目のセルを含むCellRangeオブジェクトを取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetMergedRange(2, 3)
' マージセルかどうかを判別
If cr.IsSingleCell = False Then
' マージセルの場合の処理
MessageBox.Show("マージセルです")
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムマージ(セル結合)
flex.AllowMerging = C1.Win.C1FlexGrid.AllowMergingEnum.Custom;
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(1, 1, 2, 3);
flex.MergedRanges.Add(cr);
}
// 2行3列目のセルがマージセルかどうかを判別します
private void button1_Click(object sender, EventArgs e)
{
// 2行3列目のセルを含むCellRangeオブジェクトを取得
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetMergedRange(2, 3);
// マージセルかどうかを判別
if(cr.IsSingleCell == false)
{
// マージセルの場合の処理
MessageBox.Show("マージセルです");
}
}
選択/移動
セルの選択や移動に関するタスクを紹介します。付属の下記サンプルも参照してください。
サンプル
説明
CustomSelection
テキストエディタのような非長方形の行範囲選択を実現します
LockedColumns
列単位でフォーカス不可に設定します
MultiSelection
Excel のような複数の範囲選択を実現します
SelectionMode
FlexGrid に実装されている選択方法の種類を紹介します
選択モードを変更する
379
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
SelectionMode プロパティを変更します。(デフォルトはDefault)
【実行例】 単一セルの選択(
単一セルの選択(Cell))
【実行例】 単一セル、セル範囲の選択(
単一セル、セル範囲の選択(CellRange))
【実行例】 単一列の選択(
単一列の選択(Column))
380
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 単一列、連続する複数列の選択(
単一列、連続する複数列の選択(ColumnRange))
【実行例】 行、複数行、連続しない複数行の選択(
行、複数行、連続しない複数行の選択(ListBox))
381
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 単一行の選択(
単一行の選択(Row))
【実行例】 連続する複数行の選択(
連続する複数行の選択(ScrollFlags.AlwaysVisible))
382
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox
C# コードの書き方
C#
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox;
注意:
注意:コントロールにフォーカスがないときにセルを強調表示するかどうかを指定するには、HighLight プロパティを使
用します。
複数の選択モードを利用する
行ヘッダをクリックした際に SelectionMode プロパティを ListBox に設定し、その他の部分をクリックした場合には Default
に戻します。このような処理で、Default+ListBox の選択モードを実装します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_BeforeMouseDown(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.BeforeMouseDownEventArgs) Handles flex.BeforeMouseDown
' 行ヘッダがクリックされた場合、選択モードをListBoxに設定
If flex.HitTest(e.X, e.Y).Type = C1.Win.C1FlexGrid.HitTestTypeEnum.RowHeader Then
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox
Else
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.Default
End If
End Sub
C# コードの書き方
383
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void flex_BeforeMouseDown(object sender,
C1.Win.C1FlexGrid.BeforeMouseDownEventArgs e)
{
// 行ヘッダがクリックされた場合、選択モードをListBoxに設定
if (flex.HitTest(e.X, e.Y).Type == C1.Win.C1FlexGrid.HitTestTypeEnum.RowHeader)
{
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox;
}
else
{
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.Default;
}
}
行全体をハイライト表示する
SelectionMode プロパティを Row や RowRange、ListBox に設定して行選択にした上で、FocusRect プロパティを None
にしてカレントセルのフォーカス枠を非表示にします。
【実行例】
Visual Basic コードの書き方
Visual Basic
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox
flex.FocusRect = C1.Win.C1FlexGrid.FocusRectEnum.None
C# コードの書き方
C#
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox;
384
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.FocusRect = C1.Win.C1FlexGrid.FocusRectEnum.None;
選択範囲を作成する
2つの対角(カレントセルと、セル範囲の最後のセル)でセル範囲を作成します。Row/Col プロパティにてカレントセル
を、RowSel/ColSel プロパティにてセル範囲の最後のセルを設定します。Select メソッドでも同様の処理が可能です。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 3行2列目から6行3列目を選択範囲に設定
flex.Row = 3
flex.Col = 2
flex.RowSel = 6
flex.ColSel = 3
' 同じ処理
'flex.Select(3, 2, 6, 3)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 3行2列目から6行3列目を選択範囲に設定
flex.Row = 3;
flex.Col = 2;
flex.RowSel = 6;
385
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.ColSel = 3;
// 同じ処理
//flex.Select(3, 2, 6, 3);
}
注意:
注意:カレントセルを変更すると、選択範囲は自動的にリセットされます。
選択範囲を取得する
Selection プロパティを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.Selection
MessageBox.Show("選択範囲" & vbCrLf & _
cr.r1 & ":" & cr.c1 & "から" & cr.r2 & ":" & cr.c2)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.Selection;
MessageBox.Show("選択範囲\n" +
cr.r1 + ":" + cr.c1 + "から" + cr.r2 + ":" + cr.c2);
386
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
注意:
注意:カレントセルを変更すると、選択範囲は自動的にリセットされます。
複数行を選択する(
複数行を選択する(ListBox))
コードから複数行を選択する場合、SelectionMode プロパティを ListBox に設定し、選択したい行のSelected プロパティを
True にする方法があります。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 3、4行目を選択
' ※この場合、カレントセルは移動しません
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox
flex.Rows(3).Selected = True
flex.Rows(4).Selected = True
' 3、4行目全体を選択範囲に設定
' flex.Row = 3
' flex.Col = flex.Cols.Fixed
' flex.RowSel = 4
' flex.ColSel = flex.Cols.Count - 1
' 同じ処理
'flex.Select(3, flex.Cols.Fixed, 4, flex.Cols.Count - 1, False)
End Sub
C# コードの書き方
C#
387
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
private void button1_Click(object sender, EventArgs e)
{
// 3、4行目を選択
// ※この場合、カレントセルは移動しません
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox;
flex.Rows[3].Selected = true;
flex.Rows[4].Selected = true;
// 3、4行目全体を選択範囲に設定
//flex.Row = 3;
//flex.Col = flex.Cols.Fixed;
//flex.RowSel = 4;
//flex.ColSel = flex.Cols.Count - 1;
// 同じ処理
//flex.Select(3, flex.Cols.Fixed, 4, flex.Cols.Count - 1, false);
}
行の選択状態を取得する(
行の選択状態を取得する(ListBox))
SelectionMode プロパティを ListBox に設定している場合は、Selected プロパティから選択されている行を取得することが
できます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
Dim s As String = flex.Rows.Selected.Count & _
"行が選択されています。" & vbCrLf
For Each r As C1.Win.C1FlexGrid.Row In flex.Rows.Selected
388
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
s = s & r.Index & "行目" & vbCrLf
Next
' 同じ結果になります
For i As Integer = flex.Rows.Fixed To flex.Rows.Count - 1
If flex.Rows(i).Selected = True Then
s = s & i & "行目" & vbCrLf
End If
Next
MessageBox.Show(s)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
flex.SelectionMode = C1.Win.C1FlexGrid.SelectionModeEnum.ListBox;
String s = flex.Rows.Selected.Count + "行が選択されています。\n";
foreach (C1.Win.C1FlexGrid.Row r in flex.Rows.Selected)
{
s = s + r.Index + "行目\n";
}
// 同じ処理です
for (int i = flex.Rows.Fixed; i < flex.Rows.Count; i++)
{
if (flex.Rows[i].Selected = true)
{
s = s + i.ToString() + "行目\n";
}
}
MessageBox.Show(s);
}
カレントセルを移動/取得する
Row プロパティにてカレント行を、Col プロパティにてカレント列を設定することで、カレントセルを移動します。Select メソッド
を使用することでもカレントセルを移動できます。
カレントセルを取得する場合は、Row/
/Col プロパティを参照します。
【実行例】
3行2列目にカレントセルを移動
389
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 行を移動
flex.Row = 3
' 列を移動
flex.Col = 2
' カレントセルを移動
flex.Select(3, 2, True)
C# コードの書き方
C#
// 行を移動
flex.Row = 3;
// 列を移動
flex.Col = 2;
// カレントセルを移動
flex.Select(3, 2, true);
Enter/Tab キーによりカレントセルを移動する
Enter キーでセルを移動するには、KeyActionEnter プロパティを変更します。(デフォルトMoveDown)
また、Tab キーでセルを移動するには、KeyActionTab プロパティを変更します。(デフォルトNone)
Visual Basic コードの書き方
Visual Basic
flex.KeyActionEnter = C1.Win.C1FlexGrid.KeyActionEnum.MoveAcross
flex.KeyActionTab = C1.Win.C1FlexGrid.KeyActionEnum.MoveAcrossOut
C# コードの書き方
390
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
flex.KeyActionEnter = C1.Win.C1FlexGrid.KeyActionEnum.MoveAcross;
flex.KeyActionTab = C1.Win.C1FlexGrid.KeyActionEnum.MoveAcrossOut;
注意:
注意:KeyActionEnter プロパティの設定は、編集時に Enter キーが押された際の動作になります。非編集時に Enter
キーを押すと、編集状態(編集モードに移行)になります。「Enter キーを押した際、編集モードに移行しないようにする」
も参照してください。
なお、KeyActionEnter プロパティでは、MoveAcrossOut の設定は有効になりません。最終行・最終列のセルで Enter キー
が押された際に別のコントロールに移動する場合は、別途コードで制御する必要があります。
【実行例】
移動後イメージ(
移動後イメージ(Button コントロールにフォーカスが移動)
391
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.KeyActionEnter = C1.Win.C1FlexGrid.KeyActionEnum.MoveAcross
End Sub
' 編集時に最終行・最終列で[Enter]キーを押した際
' 次のコントロール(ボタン)にフォーカスを移動
Private Sub flex_KeyDownEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.KeyEditEventArgs) Handles flex.KeyDownEdit
If flex.Row = flex.Rows.Count - 1 And _
flex.Col = flex.Cols.Count - 1 And _
e.KeyCode = Keys.Enter Then
flex.FinishEditing()
Button1.Focus()
End If
End Sub
' 非編集時に最終行・最終列で[Enter]キーを押した際
' 次のコントロール(ボタン)にフォーカスを移動
Private Sub flex_KeyPress(ByVal sender As Object, ByVal e As
System.Windows.Forms.KeyPressEventArgs) Handles flex.KeyPress
If flex.Row = flex.Rows.Count - 1 And _
flex.Col = flex.Cols.Count - 1 And _
Asc(e.KeyChar) = Keys.Enter Then
e.Handled = True
Button1.Focus()
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.KeyActionEnter = C1.Win.C1FlexGrid.KeyActionEnum.MoveAcross;
}
// 編集時に最終行・最終列で[Enter]キーを押した際
// 次のコントロール(ボタン)にフォーカスを移動
private void flex_KeyDownEdit(object sender, C1.Win.C1FlexGrid.KeyEditEventArgs e)
{
if ((flex.Row == flex.Rows.Count - 1) &&
(flex.Col == flex.Cols.Count - 1) &&
(e.KeyCode == Keys.Enter))
{
flex.FinishEditing();
button1.Focus();
}
}
// 非編集時に最終行・最終列で[Enter]キーを押した際
// 次のコントロール(ボタン)にフォーカスを移動
private void flex_KeyPress(object sender, KeyPressEventArgs e)
392
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
{
if ((flex.Row == flex.Rows.Count - 1) &&
(flex.Col == flex.Cols.Count - 1) &&
(e.KeyChar == '\r'))
{
e.Handled = true;
button1.Focus();
}
}
右クリックでカレントセルを移動する
デフォルトの動作では、右クリックでセルは移動しません。BeforeMouseDown や MouseDown イベントなどを利用して右ク
リックを判別し、カレントセルを移動します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_BeforeMouseDown(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.BeforeMouseDownEventArgs) Handles flex.BeforeMouseDown
' 右クリック時
If e.Button = Windows.Forms.MouseButtons.Right Then
' クリックされた位置を取得
Dim h As C1.Win.C1FlexGrid.HitTestInfo
h = flex.HitTest(e.X, e.Y)
' カレントセルを移動
flex.Select(h.Row, h.Column)
End If
End Sub
C# コードの書き方
C#
private void flex_BeforeMouseDown(object sender,
C1.Win.C1FlexGrid.BeforeMouseDownEventArgs e)
{
// 右クリック時
if (e.Button == MouseButtons.Right)
{
// クリックされた位置を取得
C1.Win.C1FlexGrid.HitTestInfo h;
h = flex.HitTest(e.X, e.Y);
// カレントセルを移動
flex.Select(h.Row, h.Column);
}
}
関連項目
クリックされたセルを取得する
393
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
カレントセルを移動/取得する
任意のセルを表示する
Select メソッド、または ShowCell メソッドを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 任意のセル(10行5列目)を表示する
flex.Select(10, 5, True)
' flex.ShowCell(10, 5)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 任意のセル(10行5列目)を表示する
flex.Select(10, 5, true);
// flex.ShowCell(10, 5);
}
注意:
注意:ShowCell メソッドの場合、カレントセルは移動しません。
カレントセルのカーソルを非表示にする
394
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Row またはCol プロパティに -1 を設定します。
【実行例】
カーソル非表示後イメージ
Visual Basic コードの書き方
Visual Basic
' カレントセルのカーソルを非表示にする
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' Row(または Col)に-1を設定
flex.Row = -1
395
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
'flex.Col = -1
End Sub
C# コードの書き方
C#
// カレントセルのカーソルを非表示にする
private void button1_Click(object sender, EventArgs e)
{
// Row(または Col)に-1を設定
flex.Row = -1;
//flex.Col = -1;
}
注意:
注意:ユーザーがセルをクリックするか、-1 を設定した Row(または Col)プロパティに適切な値にすると、カーソルは再
度表示されます。
クリックされたセルを取得する
MouseRow/MouseCol プロパティにより取得します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseDown(ByVal sender As Object, ByVal e As
System.Windows.Forms.MouseEventArgs) Handles flex.MouseDown
MessageBox.Show("クリックされたセル" & vbCrLf & _
"行:" & flex.MouseRow & vbCrLf & _
"列:" & flex.MouseCol)
End Sub
396
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void flex_MouseDown(object sender, MouseEventArgs e)
{
MessageBox.Show("クリックされたセル\n" +
"行:" + flex.MouseRow + "\n" +
"列:" + flex.MouseCol);
}
注意:
注意:HitTest メソッドを使用することでもセル位置を取得できます。(参照:「クリックされたセルの種類を判別する」)
クリックされたセルの種類を判別する
HitTest メソッドを使用してマウス位置の情報(HitTestInfo 構造体)を取得し、Type フィールドから判別します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub flex_MouseDown(ByVal sender As Object, ByVal e As
System.Windows.Forms.MouseEventArgs) Handles flex.MouseDown
' マウス位置の情報を取得
Dim ht As C1.Win.C1FlexGrid.HitTestInfo
ht = flex.HitTest(e.X, e.Y)
' セルタイプ、行・列のインデックスを表示
MessageBox.Show("クリックされたセル" & vbCrLf & _
"セルタイプ:" & ht.Type.ToString & vbCrLf & _
"行:" & ht.Row & vbCrLf & _
"列:" & ht.Column)
End Sub
397
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void flex_MouseDown(object sender, MouseEventArgs e)
{
// マウス位置の情報を取得
C1.Win.C1FlexGrid.HitTestInfo ht;
ht = flex.HitTest(e.X, e.Y);
// セルタイプ、行・列のインデックスを表示
MessageBox.Show("クリックされたセル\n" +
"セルタイプ:" + ht.Type.ToString() + "\n" +
"行:" + ht.Row + "\n" +
"列:" + ht.Column);
}
ダブルクリック時にテキストを選択状態にする
「セルの編集」にもありますが、セルをダブルクリックすると編集モードに移行してクリックした場所の近くに入力キャレットが表
示されます。この動作を変更し、ダブルクリック時にセル内の値を選択状態にするには、次の処理を実装します。
BeforeDoubleClick イベントでダブルクリックを検出、無効にする
StartEditing メソッドで編集モードに移行する
編集用エディタを TextBox クラスに変換し、SelectAll メソッドで選択状態にする
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub flex_BeforeDoubleClick(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.BeforeMouseDownEventArgs) Handles flex.BeforeDoubleClick
' ダブルクリックを無効にする
e.Cancel = True
398
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 編集モードに移行
flex.StartEditing()
' TextBoxクラスに変換し、SelectAllメソッドで選択状態にする
Dim tb As TextBox = CType(flex.Editor, TextBox)
tb.SelectAll()
End Sub
C# コードの書き方
C#
private void flex_BeforeDoubleClick(object sender,
C1.Win.C1FlexGrid.BeforeMouseDownEventArgs e)
{
// ダブルクリックを無効にする
e.Cancel = true;
// 編集モードに移行
flex.StartEditing();
// TextBoxクラスに変換し、SelectAllメソッドで選択状態にする
TextBox tb = (TextBox)flex.Editor;
tb.SelectAll();
}
入力
入力/編集
編集
セルの編集に関するタスクを紹介します。
常時入力モードにする
EditOptions プロパティのEditOnRequest フラグを False にします。
このフラグが True に設定されている場合(デフォルトの設定)、ユーザーが入力を開始するかまたはセルをダブルクリック、
[F2]キーを押すまで、グリッドは編集モードに入りません(MS Excel と同じ動作)。
このフラグが False に設定されている場合、グリッドがフォーカスを得たとき、また選択セルが変更されたときには、グリッドは
自動的に編集モードに入ります(MS Access と同じ動作)。
【実行例】
399
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 全部のフラグを False にします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.None
' EditOnRequestのみをFalseにします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.AutoSearch Or _
C1.Win.C1FlexGrid.EditFlags.CycleOnDoubleClick Or _
C1.Win.C1FlexGrid.EditFlags.DelayedCommit Or _
C1.Win.C1FlexGrid.EditFlags.ExitOnLeftRightKeys Or _
C1.Win.C1FlexGrid.EditFlags.MultiCheck Or _
C1.Win.C1FlexGrid.EditFlags.UseNumericEditor
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 全部のフラグを False にします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.None;
// EditOnRequestのみをFalseにします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.AutoSearch |
C1.Win.C1FlexGrid.EditFlags.CycleOnDoubleClick |
C1.Win.C1FlexGrid.EditFlags.DelayedCommit |
C1.Win.C1FlexGrid.EditFlags.ExitOnLeftRightKeys |
C1.Win.C1FlexGrid.EditFlags.MultiCheck |
C1.Win.C1FlexGrid.EditFlags.UseNumericEditor;
}
編集中のセルの外観を変更する
Editor 組み込みスタイルを使用して、編集中のセルの外観を変更します。非編集時のカレントセルの外観を変更する方法
は、「カレントセルの外観を変更する」を参照してください。
【実行例】
400
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 編集中のセルの外観を変更する
Dim cs As C1.Win.C1FlexGrid.CellStyle
cs = flex.Styles.Editor
cs.BackColor = Color.Yellow
cs.ForeColor = Color.Red
cs.Font = New Font(cs.Font.Name, 10, FontStyle.Italic)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 編集中のセルの外観を変更する
C1.Win.C1FlexGrid.CellStyle cs;
cs = flex.Styles.Editor;
cs.BackColor = Color.Yellow;
cs.ForeColor = Color.Red;
cs.Font = new Font(cs.Font.Name, 10, FontStyle.Italic);
}
注意:
注意:組み込みスタイルは、スタイルエディタ からも設定できます。
グリッド全体の編集を禁止する
グリッド全体の編集を無効にするには、デザイナまたはコードで、AllowEditing プロパティを False に設定します。反対に、編
集を有効にするには AllowEditing プロパティを True(デフォルト)に設定します。
401
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
デザイナの場合
C1FlexGrid タスク メニューで、[編集を有効にする]チェックボックスを OFF にします。
または、プロパティウィンドウで AllowEditing プロパティを探し、それを False に設定します。
コードの場合
Form_Load イベントに以下のコードを追加します。
Visual Basic コードの書き方
Visual Basic
flex.AllowEditing = False
C# コードの書き方
C#
flex.AllowEditing = false;
列単位で編集を禁止する
特定の列の編集を禁止するには、デザイナまたはコードで、AllowEditingプロパティを False に設定します。反対に、編集を
有効にするには AllowEditing プロパティを True(デフォルト)に設定します。
402
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
デザイナの場合
1. グリッドで編集を無効にしたい列を選択します。選択した列の Column タスク メニューが開きます。
2. [編集を有効にする]チェックボックスを OFF にします。
また、AllowEditing プロパティは、[FlexGrid 列エディタ]を使用して設定することもできます。
1. 列エディタ を開きます。[ FlexGrid 列エディタ]へのアクセス方法の詳細については、「列エディタにアクセス」を参照し
てください。
2. 右ペインから編集を無効にしたい列を選択し、左ペインで AllowEditing プロパティを False に設定します。
403
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
3. 〈OK〉をクリックし、列エディタを閉じます。
コードの場合
Form_Load イベントに以下のコードを追加し、1列目(Col1)の編集を制限します。
Visual Basic コードの書き方
Visual Basic
flex.Cols("Col1").AllowEditing = False
' 次のコードと同じ
'flex.Cols(1).AllowEditing = False
C# コードの書き方
C#
flex.Cols["Col1"].AllowEditing = false;
// 次のコードと同じ
//flex.Cols[1].AllowEditing = false;
行単位で編集を禁止する
特定の行の編集を禁止するには、AllowEditing プロパティを False に設定します。反対に、編集を有効にするには
AllowEditing プロパティを True(デフォルト)に設定します。このコード例では、6行目の編集を制限します。
Visual Basic コードの書き方
Visual Basic
flex.Rows(5).AllowEditing = False
C# コードの書き方
404
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
flex.Rows(5).AllowEditing = False;
セル単位で編集を禁止する
BeforeEdit/StartEdit イベントを使用して入力セルを判別し、e.Cancel を True に設定します。下記のサンプルコードでは、
2行3列目のセルを編集不可としています。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_BeforeEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.BeforeEdit
' 2行3列目のセルの編集を禁止
If e.Row = 2 And e.Col = 3 Then
e.Cancel = True
End If
End Sub
C# コードの書き方
C#
private void flex_BeforeEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// 2行3列目のセルの編集を禁止
if((e.Row == 2) && (e.Col == 3))
{
e.Cancel = true;
}
}
Enter キーを押した際、編集モードに移行しないようにする
編集中ではないセルで Enter キーを押すと、(そのセルの編集が許可されていれば)セルは編集状態になります。この動作を
変更するには、KeyPress イベントで Enter キーの入力を無効にします。下記のサンプルコードでは、Enter キーが入力された
際、編集モードに移行せず、セルを移動しています。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_KeyPress(ByVal sender As Object, ByVal e As
System.Windows.Forms.KeyPressEventArgs) Handles flex.KeyPress
If e.KeyChar = Chr(Keys.Enter) Then
' Enter キーの入力を無効にする
e.Handled = True
' セルの移動
' KeyActionEnum.MoveAcross+最終セルの場合は先頭へ移動
If flex.Col = flex.Cols.Count - 1 Then
flex.Col = flex.Cols.Fixed
If flex.Row = flex.Rows.Count - 1 Then
405
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Row = flex.Rows.Fixed
Else
flex.Row += 1
End If
Else
flex.Col += 1
End If
End If
End Sub
C# コードの書き方
C#
private void flex_KeyPress(object sender, KeyPressEventArgs e)
{
if (e.KeyChar == (char)Keys.Enter)
{
// Enter キーの入力を無効にする
e.Handled = true;
// セルの移動
// KeyActionEnum.MoveAcross+最終セルの場合は先頭へ移動
if (flex.Col == flex.Cols.Count - 1)
{
flex.Col = flex.Cols.Fixed;
if (flex.Row == flex.Rows.Count - 1)
{
flex.Row = flex.Rows.Fixed;
}
else
{
flex.Row += 1;
}
}
else
{
flex.Col += 1;
}
}
}
注意:
上記コードを使用しても、F2 キーの入力やダブルクリック時にセルは編集モードに移行します。
KeyPress イベントの詳細は、MSDN を参照してください。
KeyActionEnter プロパティの設定は、編集中に Enter キーが押された際の動作を制御します(「Enter/Tab
キーによりカレントセルを移動する」)。
IMEモードを切り替える
モードを切り替える
C1FlexGrid コントロールにおいてIME制御を行う場合、編集モードに移行する前に発生する BeforeEdit イベント内
で、ImeMode プロパティを設定するという方法になります。
406
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub flex_BeforeEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.BeforeEdit
Select Case e.Col
Case 1
' 1列目は半角カタカナ
flex.ImeMode = Windows.Forms.ImeMode.KatakanaHalf
Case 2
' 2列目はカタカナ
flex.ImeMode = Windows.Forms.ImeMode.Katakana
Case 3
' 3列目はひらがな
flex.ImeMode = Windows.Forms.ImeMode.Hiragana
Case Else
' 上記以外はIMEオフ
flex.ImeMode = Windows.Forms.ImeMode.Off
End Select
End Sub
C# コードの書き方
C#
private void flex_BeforeEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
switch (flex.Col)
{
case 1:
// 1列目は半角カタカナ
flex.ImeMode = ImeMode.KatakanaHalf;
break;
case 2:
// 2列目はカタカナ
flex.ImeMode = ImeMode.Katakana;
break;
case 3:
// 3列目はひらがな
flex.ImeMode = ImeMode.Hiragana;
break;
default:
// 上記以外はIMEオフ
flex.ImeMode = ImeMode.Off;
break;
}
}
キー入力を検知する
非編集時にキーを入力すると、KeyDown/KeyPress/KeyUpイベントが発生します。また、編集中は
KeyDownEdit/KeyPressEdit/KeyUpEdit イベントが発生します。非編集時と編集時で発生するイベントが異なりますの
407
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
で、注意してください。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub flex_KeyDownEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.KeyEditEventArgs) Handles flex.KeyDownEdit
' 編集中に入力されたキーをラベルに出力
Label1.Text = Label1.Text & ":" & e.KeyCode.ToString
End Sub
C# コードの書き方
C#
private void flex_KeyDownEdit(object sender, C1.Win.C1FlexGrid.KeyEditEventArgs e)
{
// 編集中に入力されたキーをラベルに出力
label1.Text = label1.Text + ":" + e.KeyCode.ToString();
}
注意:
注意:KeyDown/KeyPress/KeyUp イベントの詳細は、MSDN を参照してください
セル単位で編集データをチェックする
セルの編集後に発生するValidateEdit イベント内で、編集エディタ(Editor.Text)の内容をチェックします。チェックの結果、編
集状態を維持して再度入力を促す場合などは Cancel 引数を True に設定します。また、セルは変更前の内容になっているた
め、編集エディタにセルの値を設定すると編集を無効にすることもできます。
【実行例】
408
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目を日付型にします
flex.Cols(1).DataType = GetType(Date)
End Sub
Private Sub flex_ValidateEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.ValidateEditEventArgs) Handles flex.ValidateEdit
If e.Col = 1 Then
' 過去の日付の場合、変更を許可しません
Dim d As Date = Date.Parse(flex.Editor.Text)
If d >= Date.Today Then
MessageBox.Show("過去の日付を入力してください。", "注意")
e.Cancel = True
End If
'変更の確認で No の場合、変更前の値に戻します
If MessageBox.Show("変更しますか?", "確認", _
MessageBoxButtons.YesNo) = Windows.Forms.DialogResult.No Then
flex.Editor.Text = flex(e.Row, e.Col)
End If
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目を日付型にします
flex.Cols[1].DataType = typeof(DateTime);
}
409
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
private void flex_ValidateEdit(object sender, C1.Win.C1FlexGrid.ValidateEditEventArgs
e)
{
if(e.Col == 1)
{
// 過去の日付の場合、変更を許可しません
DateTime d = DateTime.Parse(flex.Editor.Text);
if (d >= DateTime.Today)
{
MessageBox.Show("過去の日付を入力してください。", "注意");
e.Cancel = true;
}
// 変更の確認で No の場合、変更前の値に戻します
if (MessageBox.Show("変更しますか?", "確認",
MessageBoxButtons.YesNo) == DialogResult.No)
{
flex.Editor.Text = flex[e.Row, e.Col].ToString();
}
}
}
注意:
注意:GetType メソッドや typeof 式、MssageBox.Show メソッドの詳細は、MSDNを参照してください。
関連項目
入力値の正当性検査
行単位で編集データをチェックする
行の移動時や他のコントロールにフォーカスが移動する際に発生するRowValidating/RowValidated イベントを利用でき
ます。チェックの結果、対象行から移動させないようにする場合は、Cancel 引数を True に設定します。
【実行例】
Visual Basic コードの書き方
410
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
Private Sub flex_RowValidating(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.RowValidating
' 1列目の値は100以上とします
If flex(e.Row, 1) < 100 Then
e.Cancel = True
MessageBox.Show("データが不正です")
End If
End Sub
C# コードの書き方
C#
private void flex_RowValidating(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// 1列目の値は100以上とします
if (int.Parse(flex[e.Row, 1].ToString()) < 100)
{
e.Cancel = true;
MessageBox.Show("データが不正です");
}
}
左右の矢印キーによる編集の終了を無効にする
EditOptions プロパティの ExitOnLeftRightKeys フラグを False にします。
このフラグが True に設定されている場合(デフォルトの設定)、組み込みの編集エディタは、キャレットが先頭位置にある状態
でユーザーが左矢印キーを押したとき、またはキャレットが末尾位置(TextLengthの位置)にある状態でユーザーが右矢印
キーを押したとき、編集モードを抜けます。
このフラグが False に設定されている場合、組み込みの編集エディタは、ユーザーが[Enter]キーを押すか、または別なセル
をクリックする、上下の矢印キーで隣接する行に移動するまで、編集モードを抜けません。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 全部のフラグを False にします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.None
' ExitOnLeftRightKeysのみをFalseにします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.AutoSearch Or _
C1.Win.C1FlexGrid.EditFlags.CycleOnDoubleClick Or _
C1.Win.C1FlexGrid.EditFlags.DelayedCommit Or _
C1.Win.C1FlexGrid.EditFlags.EditOnRequest Or _
C1.Win.C1FlexGrid.EditFlags.MultiCheck Or _
C1.Win.C1FlexGrid.EditFlags.UseNumericEditor
End Sub
C# コードの書き方
411
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
// 全部のフラグを False にします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.None;
// ExitOnLeftRightKeysのみをFalseにします
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.AutoSearch |
C1.Win.C1FlexGrid.EditFlags.CycleOnDoubleClick |
C1.Win.C1FlexGrid.EditFlags.DelayedCommit |
C1.Win.C1FlexGrid.EditFlags.EditOnRequest |
C1.Win.C1FlexGrid.EditFlags.MultiCheck |
C1.Win.C1FlexGrid.EditFlags.UseNumericEditor;
}
セル編集時の改行を禁止する
デフォルトではセル編集時に [Alt]+[Enter]、または [Ctrl]+[Enter]、 または [Shift]+[Enter]、[Ctrl]+[J]、[Ctrl]+[Shift]+
[J])で、テキストを改行することができます。この動作を禁止するには、KeyDownEdit/KeyPressEdit イベントを使用して
キー入力を無効にします。
Visual Basic コードの書き方
Visual Basic
' キー入力無効用のフラグ
Dim key_flag As Boolean = False
Private Sub flex_KeyDownEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.KeyEditEventArgs) Handles flex.KeyDownEdit
' [Alt]+[Enter]のキー入力を無効にします
If e.Alt = True And e.KeyCode = Keys.Enter Then
e.Handled = True
End If
' 次のキー入力はKeyPressEditイベントで無効にします
If e.Shift = True And e.KeyCode = Keys.Enter Or _
e.Control = True And e.KeyCode = Keys.Enter Or _
e.Control = True And e.KeyCode = Keys.J Or _
e.Control = True And e.KeyCode = Keys.J And e.Shift = True Then
key_flag = True
End If
End Sub
Private Sub flex_KeyPressEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.KeyPressEditEventArgs) Handles flex.KeyPressEdit
If key_flag = True Then
e.Handled = True
key_flag = False
End If
End Sub
C# コードの書き方
C#
// キー入力無効用のフラグ
412
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
bool key_flag = false;
private void flex_KeyDownEdit(object sender, C1.Win.C1FlexGrid.KeyEditEventArgs e)
{
// [Alt]+[Enter]のキー入力を無効にします
if ((e.Alt == true) && (e.KeyCode == Keys.Enter))
{
e.Handled = true;
}
// 次のキー入力はKeyPressEditイベントで無効にします
else if (((e.Shift == true) && (e.KeyCode == Keys.Enter)) ||
((e.Control == true) && (e.KeyCode == Keys.Enter)) ||
((e.Control == true) && (e.KeyCode == Keys.J)) ||
((e.Control == true) && (e.KeyCode == Keys.J) && (e.Shift == true)))
{
key_flag = true;
}
}
private void flex_KeyPressEdit(object sender, C1.Win.C1FlexGrid.KeyPressEditEventArgs
e)
{
if (key_flag == true)
{
e.Handled = true;
key_flag = false;
}
}
注意:
注意:EditOptions プロパティは、プロパティページからも設定できます。
文字数単位で入力を制限する
入力文字数を制限する方法としては、下記の方法があります。
EditMask プロパティを使用する
たとえば下記のコードでは、1列目の入力文字数を7文字に制限しています。EditMask プロパティは、郵便番号や電話番号な
ど、桁数が固定されているデータを入力する場合に有効です。
Visual Basic コードの書き方
Visual Basic
' 下線を表示
flex.Cols(1).EditMask = "&&&&&&&&"
' 下線を表示しない
flex.Cols(2).EditMask = "&&&&&&&&; "
' 電話番号
flex.Cols(3).EditMask = "(000)-(000)-0000"
C# コードの書き方
C#
413
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 下線を表示
flex.Cols[1].EditMask = "&&&&&&&&";
// 下線を表示しない
flex.Cols[2].EditMask = "&&&&&&&&; ";
// 電話番号
flex.Cols[3].EditMask = "(000)-(000)-0000";
注意:
注意:EditMask プロパティを使用した入力マスクの設定は、設計時に Column タスク メニューや 列エディタ からも設定
できます。
カスタムエディタに TextBox コントロールを使用する
カスタムエディタの機能を使用して、エディタとして TextBox コントロールを使用します。また、TextBox コントロールの
MaxLength プロパティにより入力文字数を制限します。この方法は、桁数が可変のデータを入力制御する目的の場合に適し
ています。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
Dim tb As TextBox = New TextBox
' 入力を7文字に制限
tb.MaxLength = 7
' カスタムエディタに設定
flex.Cols(1).Editor = tb
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
TextBox tb = new TextBox();
// 入力を7文字に制限
tb.MaxLength = 7;
// カスタムエディタに設定
flex.Cols[1].Editor = tb;
}
SetupEditor イベントを使用する
SetupEditor イベント内で、編集用エディタを TextBox クラスのオブジェクトにセット(変換)し、MaxLength プロパティを設定
することで、入力制御を行うことも可能です。この方法は、桁数が可変のデータを入力制御する目的の場合に適しています。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
' 1列目のみ入力制限
If e.Col = 1 Then
414
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 入力を7文字に制限
Dim tb As TextBox = CType(flex.Editor, TextBox)
tb.MaxLength = 7
End If
End Sub
C# コードの書き方
C#
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// 1列目のみ入力制限
if (e.Col == 1)
{
// 入力を7文字に制限
TextBox tb = (TextBox)flex.Editor;
tb.MaxLength = 7;
}
}
ChangeEdit イベントを使用する
セルの値が変更された際には、ChangeEdit イベントが発生します。このイベント内で入力された文字数を判別し、指定文字
数以上の場合は入力文字をカットするような制御方法です。この方法は、桁数が可変のデータを入力制御する目的の場合に
適しています。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_ChangeEdit(ByVal sender As Object, ByVal e As System.EventArgs)
Handles flex.ChangeEdit
' 1列目のみ
If flex.Col = 1 Then
Dim tb As TextBox = CType(flex.Editor, TextBox)
' 7文字以上が入力された場合
If tb.TextLength > 7 Then
' 先頭から7文字のみをエディタに設定
flex.Editor.Text = Mid(tb.Text, 1, 7)
tb.SelectionStart = tb.TextLength
End If
End If
End Sub
C# コードの書き方
C#
private void flex_ChangeEdit(object sender, EventArgs e)
{
// 1列目のみ
if (flex.Col == 1)
{
415
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
TextBox tb = (TextBox)flex.Editor;
// 7文字以上が入力された場合
if (tb.TextLength > 7)
{
// 先頭から7文字のみをエディタに設定
flex.Editor.Text = flex.Editor.Text.Substring(0, 7);
tb.SelectionStart = tb.TextLength;
}
}
}
バイト単位で入力を制限する
セルの内容を変更すると発生するChangeEdit イベントを使用します。バイト関連の処理は(.NET Framework)Encoding クラ
スの GetByte、GetByteCount、GetString メソッドを使用します。下記のコードでは、10バイト以上が入力された場合に、先
頭から10バイト分のみを有効にしています。
Visual Basic コードの書き方
Visual Basic
' 入力を10バイトに制限
Private Sub flex_ChangeEdit(ByVal sender As Object, ByVal e As System.EventArgs)
Handles flex.ChangeEdit
' 1列目のみチェック
If flex.Col = 1 Then
Dim enc As System.Text.Encoding
enc = System.Text.Encoding.GetEncoding("shift-jis")
Dim tb As TextBox = Ctype(flex.Editor, TextBox)
' 10バイト以上が入力された場合
If enc.GetByteCount(tb.Text) > 10 Then
' 先頭から10バイトのみをエディタに設定
flex.Editor.Text = enc.GetString(enc.GetBytes(tb.Text), 0, 10)
tb.SelectionStart = tb.TextLength
End If
End If
End Sub
C# コードの書き方
C#
// 入力を10バイトに制限
private void flex_ChangeEdit(object sender, EventArgs e)
{
// 1列目のみチェック
if (flex.Col == 1)
{
System.Text.Encoding enc;
enc = System.Text.Encoding.GetEncoding("shift-jis");
TextBox tb = (TextBox)flex.Editor;
// 10バイト以上が入力された場合
if (enc.GetByteCount(tb.Text) > 10)
416
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
{
// 先頭から10バイトのみをエディタに設定
flex.Editor.Text = enc.GetString(enc.GetBytes(tb.Text), 0, 10);
tb.SelectionStart = tb.TextLength;
}
}
}
注意:
注意:クラスや GetByte メソッドなどの詳細は、MSDN をご覧ください。
数値のみの入力を許可する
セルに数値のみの入力を許可するには、KeyPressEdit イベントを使用し、無効なキーに対して e.Handled パラメータを True
に設定します。以下のコードを使用し、4番目の列を数値、[Back Space]、[Del]、[.]キーのみを受け付けるように設定しま
す。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_KeyPressEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.KeyPressEditEventArgs) Handles flex.KeyPressEdit
If e.Col = 3 Then
' 0-9、ピリオド、DELETE、BACKSPACEキー以外の入力を不可にします
If Not (e.KeyChar = Chr(48) Or e.KeyChar = Chr(49) Or _
e.KeyChar = Chr(50) Or e.KeyChar = Chr(51) Or _
e.KeyChar = Chr(52) Or e.KeyChar = Chr(53) Or _
e.KeyChar = Chr(54) Or e.KeyChar = Chr(55) Or _
e.KeyChar = Chr(56) Or e.KeyChar = Chr(57) Or _
e.KeyChar = Chr(46) Or e.KeyChar = Chr(127) Or _
e.KeyChar = Chr(8)) Then
' 不正な値として入力をキャンセル
e.Handled = True
End If
End If
End Sub
C# コードの書き方
C#
private void flex_KeyPressEdit(object sender, C1.Win.C1FlexGrid.KeyPressEditEventArgs
e)
{
if (e.Col == 3)
{
// 0-9、ピリオド、DELETE、BACKSPACEキー以外の入力を不可にします
if (!((e.KeyChar == 48) || (e.KeyChar == 49) ||
(e.KeyChar == 50) || (e.KeyChar == 51) || (e.KeyChar == 52) ||
(e.KeyChar == 53) || (e.KeyChar == 54) || (e.KeyChar == 55) ||
(e.KeyChar == 56) || (e.KeyChar == 57) || (e.KeyChar == 46) ||
(e.KeyChar == 127) |
// 不正な値として入力をキャンセル
e.Handled = true;
417
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
注意:
注意:セルのデータ型が数値型の場合、デフォルトで組み込み数値型エディタが使用され、数値以外の入力は禁止され
ます。
カスタムエディタを設定する
行や列単位でカスタムエディタを設定する場合はEditor プロパティを、スタイルごとに設定する場合は Editor プロパティを使
用して任意のコントロールを設定します。また、SetupEditor イベントを使用してセル単位での設定も可能です。
注意:
注意:設計時は、列エディタを使用してカスタムエディタ の設定を行えます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムエディタを作成します
Dim editor As New NumericUpDown()
editor.BorderStyle = BorderStyle.None
' カスタムエディタを1列目に割り当てます
flex.Cols(1).Editor = editor
End Sub
Private Sub flex_StartEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.StartEdit
' 2行1列目のセルではTextBoxをカスタムエディタに割り当てます
If e.Row = 2 And e.Col = 1 Then
Dim tb As New TextBox
tb.BackColor = Color.Yellow
flex.Editor = tb
End If
End Sub
C# コードの書き方
418
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムエディタを作成します
NumericUpDown editor = new NumericUpDown();
editor.BorderStyle = BorderStyle.None;
// カスタムエディタを1列目に割り当てます
flex.Cols[1].Editor = editor;
}
private void flex_StartEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// 2行1列目のセルではTextBoxをカスタムエディタに割り当てます
if((e.Row == 2) && (e.Col == 1))
{
TextBox tb = new TextBox();
tb.BackColor = Color.Yellow;
flex.Editor = tb;
}
}
入力マスクを設定する
グリッド全体ではEditMask プロパティを、行や列単位では EditMask プロパティを、スタイルごとの場合は EditMask プロパ
ティを使用します。
注意:
設計時は、[定型入力]ダイアログボックスを使用して入力マスクの設定を行えます。
入力マスクの詳細は「マスク」を参照してください。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
419
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Handles MyBase.Load
' 電話番号を入力するためのマスクを1列目に設定します
flex.Cols(1).EditMask = "(999) 999-9999"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 電話番号を入力するためのマスクを設定します
flex.Cols[1].EditMask = "(999) 999-9999;
}
パスワード入力を行う
パスワードの入力に使用するセルにプレースホルダ文字(*)を表示するには、SetupEditor イベントを使用します。
【実行例】
ユーザーがパスワード列に入力すると、テキストは自動的にアスタリスク(*)に変換されます。入力中もアスタリスク(*)で表示
されます。
1. グリッドにパスワード用の列を作成し、描画モードを設定します。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
flex.Cols(0).Width = flex.Rows(0).HeightDisplay
flex.ShowCursor = True
flex.Cols(1).Caption = "パスワード"
flex.Cols(1).Name = "パスワード"
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
420
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Cols[0].Width = flex.Rows[0].HeightDisplay;
flex.ShowCursor = true;
flex.Cols[1].Caption = flex.Cols[1].Name = "パスワード";
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
2. 次のコードを SetupEditor イベントに追加します。このコードは、ユーザーが入力中のテキストを自動的にアスタリスク
(*)に変換します。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
Dim tb As TextBox = flex.Editor
If Not (tb Is Nothing) Then
If flex.Cols(e.Col).Name = "パスワード" Then
tb.PasswordChar = "*"c
Else
tb.PasswordChar = CChar(ChrW(0))
End If
End If
End Sub
C# コードの書き方
C#
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs
e)
{
TextBox tb = flex.Editor as TextBox;
if (tb != null)
{
if (flex.Cols[e.Col].Name == "パスワード")
tb.PasswordChar = '*';
else
tb.PasswordChar = (char)0;
}
}
3. 次のコードを OwnerDrawCell イベントに追加します。このコードにより入力後のテキストを自動的にアスタリスク(*)に
変換し、非表示にします。
Visual Basic コードの書き方
Visual Basic
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
421
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
If e.Row >= flex.Rows.Fixed And flex.Cols(e.Col).Name = "パスワード" Then
e.Text = New String("*"c, e.Text.Length)
End If
End Sub
C# コードの書き方
C#
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
if (e.Row >= flex.Rows.Fixed && flex.Cols[e.Col].Name == "パスワード")
{
e.Text = new string('*', e.Text.Length);
}
}
大文字に変換して入力する
列に入力されたテキストを自動的に小文字から大文字にするには、SetupEditorイベントにて編集エディタを TextBox に変
換し、CharacterCasing プロパティを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
' UCASECOL列では、大文字に変換して入力します
If flex.Cols(e.Col).Name = "UCASECOL" Then
Dim tb As TextBox = flex.Editor
tb.CharacterCasing = CharacterCasing.Upper
End If
End Sub
422
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
// UCASECOL列では、大文字に変換して入力します
if (flex.Cols[e.Col].Name == "UCASECOL")
{
TextBox tb = flex.Editor as TextBox;
tb.CharacterCasing = CharacterCasing.Upper;
}
}
注意:
注意:TextBox コントロールや CharacterCasing プロパティの詳細は、MSDN を参照してください。
セルボタン
セルボタン/コンボボックス
コンボボックス
セルボタンやコンボボックスに関するタスクを紹介します。
関連項目
リストボックスとコンボボックス | セルボタン
セルボタンを表示する
グリッドの ComboList、行・列の ComboList、スタイルの ComboList プロパティの何れかに省略符号("...")を設定します。
注意:
セルボタンのセルで入力を許可する場合は、省略符号("...")前にパイプ文字を追加します。
セルボタンは、設計時に 列エディタ や Column タスク から設定することもできます。「リストボックスとコンボボッ
クス」の項目も参照してください。
【実行例】
423
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.Cols(2).Caption = "セルボタン編集不可"
flex.Cols(3).Caption = "セルボタン編集可"
' 編集不可のセルボタン
flex.Cols(2).ComboList = "..."
' 編集可能なセルボタン
flex.Cols(3).ComboList = "
' 常にセルボタンを表示
flex.ShowButtons = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.NoneAlways
C# コードの書き方
C#
flex.Cols[2].Caption = "セルボタン編集不可";
flex.Cols[3].Caption = "セルボタン編集可";
// 編集不可のセルボタン
flex.Cols[2].ComboList = "...";
// 編集可能なセルボタン
flex.Cols[3].ComboList = "
// 常にセルボタンを表示
flex.ShowButtons = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.NoneAlways;
セルボタンの画像を変更する
CellButtonImage プロパティに任意の画像を設定します。
【実行例】
424
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
flex.Cols(2).Caption = "セルボタン"
' セルボタンを表示
flex.Cols(2).ComboList = "..."
' セルボタンの画像を変更
flex.CellButtonImage = Image.FromFile("Mycellbutton.ico")
' 常にセルボタンを表示
flex.ShowButtons = C1.Win.C1FlexGrid.ShowThemedHeadersEnum.Always
C# コードの書き方
C#
flex.Cols[2].Caption = "セルボタン";
// セルボタンを表示
flex.Cols[2].ComboList = "...";
// セルボタンの画像を変更
flex.CellButtonImage = Image.FromFile("Mycellbutton.ico");
// 常にセルボタンを表示
flex.ShowButtons = C1.Win.C1FlexGrid.ShowButtonsEnum.Always;
注意:
注意:行や列、セルごとに表示するセルボタンのイメージを変更する場合は、BeforeEdit イベントを使用します。(参照:
行や列、セルごとにセルボタンのイメージを変更する)
コンボボックスを表示する
グリッドの ComboList、行・列の ComboList、スタイルの ComboList プロパティの何れかにパイプ文字で区切った文字列を
設定します。
注意:
リスト以外の入力を許可する(ドロップダウンコンボ)場合は、文字列の先頭にパイプ文字を追加します。
425
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
コンボボックスは、設計時に 列エディタ や Column タスク から設定することもできます。「リストボックスとコンボ
ボックス」の項目も参照してください。
【実行例】
Visual Basic コードの書き方
Visual Basic
' リストから選択のみのコンボボックス
flex.Cols(2).Caption = "ドロップダウンリスト"
flex.Cols(2).ComboList = "Red|Blue
' リスト以外の入力を許可するコンボボックス
flex.Cols(3).Caption = "ドロップダウンコンボ"
flex.Cols(3).ComboList = "|Red|Blue
C# コードの書き方
C#
// リストから選択のみのコンボボックス
flex.Cols[2].Caption = "ドロップダウンリスト";
flex.Cols[2].ComboList = "Red|Blue
// リスト以外の入力を許可するコンボボックス
flex.Cols[3].Caption = "ドロップダウンコンボ";
flex.Cols[3].ComboList = "|Red|Blue
コンボボックスの背景色を変更する
グリッドが編集モードに入る前に発生するStartEdit イベントにおいて、組み込み CellStyle.Editor プロパティの背景色を設定
します。
【実行例】
426
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目にコンボボックスを表示
flex.Cols(1).ComboList = "リスト1|リスト2
End Sub
Private Sub flex_StartEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.StartEdit
If e.Col = 1 Then
flex.Styles.Editor.BackColor = Color.AliceBlue
Else
flex.Styles.Editor.Clear(C1.Win.C1FlexGrid.StyleElementFlags.BackColor)
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目にコンボボックスを表示
flex.Cols[1].ComboList = "リスト1|リスト2
}
private void flex_StartEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
if(e.Col == 1)
{
flex.Styles.Editor.BackColor = Color.AliceBlue;
}
else
427
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
{
flex.Styles.Editor.Clear(C1.Win.C1FlexGrid.StyleElementFlags.BackColor);
}
}
リストにアイコンを表示させる
イメージマップの機能を使用します。行や列の ImageMap または、スタイルの ImageMap プロパティを使用することでリスト
にアイコンを表示できます。イメージマップは、特定のセル値に画像を関連付けます。セルの内容が変更されると、画像も自動
的に更新されます。
【実行例】
Visual Basic コードの書き方
Visual Basic
' イメージマップを設定
Dim imgMap As New Hashtable
imgMap.Add("サッカー", Image.FromFile("soccer.gif"))
imgMap.Add("野球", Image.FromFile("baseball.gif"))
imgMap.Add("バスケット", Image.FromFile("basketball.gif"))
imgMap.Add("ギター", Image.FromFile("guitar.gif"))
imgMap.Add("マイク", Image.FromFile("mike.gif"))
flex.Cols(1).ComboList = "|サッカー|野球|バスケット|ギター
flex.Cols(1).ImageMap = imgMap
flex.Cols(1).ImageAndText = True
flex.Cols(1).ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.LeftCenter
flex.Cols(1).ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.LeftCenter
C# コードの書き方
C#
428
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// イメージマップを設定
Hashtable imgMap = new Hashtable();
imgMap.Add("サッカー", Image.FromFile("soccer.gif"));
imgMap.Add("野球", Image.FromFile("baseball.gif"));
imgMap.Add("バスケット", Image.FromFile("basketball.gif"));
imgMap.Add("ギター", Image.FromFile("guitar.gif"));
imgMap.Add("マイク", Image.FromFile("mike.gif"));
flex.Cols[1].ComboList = "サッカー|野球|バスケット|ギター
flex.Cols[1].ImageMap = imgMap;
flex.Cols[1].ImageAndText = true;
flex.Cols[1].ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.LeftCenter;
flex.Cols[1].TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftCenter;
注意:
注意:ImageAndText プロパティを使用して、セルにテキストと画像を表示するか、画像のみを表示するかを指定でき
ます。
表示値/実値のように2種類のデータを持たせる
データマップの機能を使用します。行や列のDataMap または、スタイルの DataMap プロパティを使用することでグリッド上
に表示する値と、実際に設定される値を別々に持たせることができます。
また、GetDataDisplay/GetData メソッドを使用することで表示値と実値を取得できます。
【実行例】
429
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
Dim dtMap As Hashtable = New Hashtable()
dtMap.Add("001", "東京")
dtMap.Add("002", "仙台")
dtMap.Add("003", "大坂")
flex.Cols(1).DataMap = dtMap
flex.Cols(1).Caption = "データマップ"
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
MessageBox.Show("実値:" & flex.GetData(flex.Row, flex.Col) & vbCrLf & _
"表示値:" & flex.GetDataDisplay(flex.Row, flex.Col))
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
System.Collections.Hashtable dtMap;
dtMap = new System.Collections.Hashtable();
dtMap.Add("001", "東京");
dtMap.Add("002", "仙台");
dtMap.Add("003", "大坂");
flex.Cols[1].DataMap = dtMap;
flex.Cols[1].Caption = "データマップ";
}
private void button1_Click(object sender, EventArgs e)
{
430
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
MessageBox.Show("実値:" + flex.GetData(flex.Row, flex.Col) + "\n" +
"表示値:" + flex.GetDataDisplay(flex.Row, flex.Col));
}
注意:
「マップリスト」も参照してください。
クリップボードの自動処理(AutoClipboard プロパティを True に設定)で対象となるのは、表示値になります。
選択されたインデックスを取得する
選択されたインデックスは、SelectedIndex プロパティで、アイテムはSelectedItem プロパティで取得します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' コンボボックスを設定
flex.Cols(2).Caption = "ドロップダウンリスト"
flex.Cols(2).ComboList = "東京|仙台
End Sub
Private Sub flex_ComboCloseUp(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.ComboCloseUp
MessageBox.Show("選択されたインデックス:" & _
flex.ComboBoxEditor.SelectedIndex & vbCrLf & _
"選択されたアイテム:" & _
flex.ComboBoxEditor.SelectedItem)
End Sub
C# コードの書き方
431
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
// コンボボックスを設定
flex.Cols[2].Caption = "ドロップダウンリスト";
flex.Cols[2].ComboList = "東京|仙台
}
private void flex_ComboCloseUp(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
MessageBox.Show("選択されたインデックス:" +
flex.ComboBoxEditor.SelectedIndex + "\n" +
"選択されたアイテム:" +
flex.ComboBoxEditor.SelectedItem);
}
注意:
注意:ComboBoxEditor プロパティはコンボボックスがアクティブではない場合、null または -1 を返します。
マルチカラムコンボボックスを表示する
MultiColumnDictionary クラスを使用します。
【実行例】
432
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 文字列に基づくMultiColumnDictionaryを作成
' 表示値:0列目、実値:自動生成される int 型のキー
Dim s As String = "泉スタジアム" & vbTab & "泉区|" & _
"紫山武道館" & vbTab & "富谷|" & _
"新劇場" & vbTab & "仙台区|" & _
"GCスタジアム" & vbTab & "長町"
Dim map As C1.Win.C1FlexGrid.MultiColumnDictionary
map = New C1.Win.C1FlexGrid.MultiColumnDictionary(s, 0, True)
flex.Cols(2).DataMap = map
flex.Cols(2).Caption = "マルチカラムコンボ"
' イメージマップを設定
Dim imgMap As New Hashtable
imgMap.Add(0, Image.FromFile("soccer.gif"))
imgMap.Add(1, Image.FromFile("guitar.gif"))
imgMap.Add(2, Image.FromFile("mike.gif"))
imgMap.Add(3, Image.FromFile("baseball.gif"))
flex.Cols(2).ImageMap = imgMap
End Sub
Private Sub flex_ComboCloseUp(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.ComboCloseUp
Console.WriteLine("選択されたインデックス:" & _
flex.ComboBoxEditor.SelectedIndex & vbCrLf & _
"選択されたアイテム:" & _
flex.ComboBoxEditor.SelectedItem)
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
MessageBox.Show("実値:" & flex.GetData(flex.Row, flex.Col) & vbCrLf & _
"表示値:" & flex.GetDataDisplay(flex.Row, flex.Col))
433
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 文字列に基づくMultiColumnDictionaryを作成
// 表示値:0列目、実値:自動生成される int 型のキー
String s = "泉スタジアム\t泉区
"紫山武道館\t富谷
"新劇場\t仙台区
"GCスタジアム\t長町";
C1.Win.C1FlexGrid.MultiColumnDictionary map;
map = new C1.Win.C1FlexGrid.MultiColumnDictionary(s, 0, true);
flex.Cols[2].DataMap = map;
flex.Cols[2].Caption = "マルチカラムコンボ";
// イメージマップを設定
System.Collections.Hashtable imgMap;
imgMap = new System.Collections.Hashtable();
imgMap.Add(0, Image.FromFile("soccer.gif"));
imgMap.Add(1, Image.FromFile("guitar.gif"));
imgMap.Add(2, Image.FromFile("mike.gif"));
imgMap.Add(3, Image.FromFile("baseball.gif"));
flex.Cols[2].ImageMap = imgMap;
}
private void flex_ComboCloseUp(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
Console.WriteLine("選択されたインデックス:" +
flex.ComboBoxEditor.SelectedIndex + "\n" +
"選択されたアイテム:" +
flex.ComboBoxEditor.SelectedItem);
}
private void button1_Click(object sender, EventArgs e)
{
MessageBox.Show("実値:" + flex.GetData(flex.Row, flex.Col) + "\n" +
"表示値:" + flex.GetDataDisplay(flex.Row, flex.Col));
}
注意:
注意:製品付属の MultiColumnDropDown サンプルも参照してください。
コンボボタン
コンボボタン/セルボタンを表示するタイミングを変更する
セルボタンを表示するタイミングを変更する
コンボボタンやセルボタンを表示するタイミングは、ShowButtons プロパティで設定します。(デフォルト
はShowButtonsEnum.WithFocus)
【実行例】
常に表示(ShowButtonsEnum.Always)
434
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' コンボボックスを表示
flex.Cols(2).Caption = "コンボボックス"
flex.Cols(2).ComboList = "Red|Blue
' セルボタンを表示
flex.Cols(3).Caption = "セルボタン"
flex.Cols(3).ComboList = "..."
' コンボボタン・セルボタンを表示するタイミングを変更
flex.ShowButtons = C1.Win.C1FlexGrid.ShowButtonsEnum.Always
C# コードの書き方
C#
// コンボボックスを表示
flex.Cols[2].Caption = "コンボボックス";
flex.Cols[2].ComboList = "Red|Blue
// セルボタンを表示
flex.Cols[3].Caption = "セルボタン";
flex.Cols[3].ComboList = "...";
// コンボボタン・セルボタンを表示するタイミングを変更
flex.ShowButtons = C1.Win.C1FlexGrid.ShowButtonsEnum.Always;
注意:
注意:行や列単位で表示するタイミングを変更する機能は用意されていません。ShowButtons プロパティの設定は、グ
リッド全体に影響します。
コンボボックスの幅を設定する
編集用のエディタ(コンボボックス)が表示される前に発生するSetupEditor イベントにおいて、組み込みエディタを
ComboBox 型の変数に設定した上で、DropDownWidth プロパティにて指定します。
435
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目にコンボボックスを表示
flex.Cols(1).ComboList = "リスト1|リスト2
End Sub
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
If e.Col = 1 Then
Dim cb As ComboBox = CType(flex.Editor, ComboBox)
' コンボボックスの幅を250pxにします
cb.DropDownWidth = 250
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目にコンボボックスを表示
flex.Cols[1].ComboList = "リスト1|リスト2
}
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
if(e.Col == 1)
{
// コンボボックスの幅を250pxにします
ComboBox cb = (ComboBox)flex.Editor;
436
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
cb.DropDownWidth = 250;
}
}
注意:
注意:ComboBox.DropDownWidth プロパティ(System.Windows.Forms)の詳細は、MSDN を参照してください。
表示するリストの数を変更する
SetupEditor イベント内で編集用エディタを取得、ComboBox クラスのオブジェクトに設定した上で、(ComboBox クラス
の)MaxDropDownItems プロパティを使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.Cols(1).ComboList = "|item1|item2|item3|item4|item5|item6|item7|item8|item9
End Sub
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
If e.Col = 1 Then
CType(flex.Editor, ComboBox).MaxDropDownItems = 4
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.Cols[1].ComboList = "|item1|item2|item3|item4|item5|item6|item7|item8|item9
437
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
if(e.Col == 1)
{
((ComboBox)flex.Editor).MaxDropDownItems = 4;
}
}
注意:
注意:ComboBox クラスの MaxDropDownItems プロパティなどの詳細は、MSDN を参照してください。
表示するリストの順番を設定する
ComboList プロパティを使用した場合は文字列順にリストが表示されます。また、DataMap プロパティを使用する場合
は、Hashtable クラスではなく、SortedList/
/ListDictionary クラスを使用することで、コンボリスト内のデータ並び順を設定
することが可能です。
注意:
注意:Hashtable、SortedList、ListDictionary クラスの詳細は、MSDN を参照してください。
SortedList クラス
SortedList クラスを使用することで、コンボリスト内のデータをキーの昇順でソートできます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' SortedListにデータを追加
' キーで項目をソート
438
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Dim sl As SortedList = New SortedList
sl.Add(3, "three")
sl.Add(5, "five")
sl.Add(2, "two")
sl.Add(1, "one")
sl.Add(4, "four")
' 列のデータ型を設定
flex.Cols(1).DataType = GetType(Integer)
' データマップを使用
flex.Cols(1).DataMap = sl
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// SortedListにデータを追加
// キーで項目をソート
System.Collections.SortedList sl = new System.Collections.SortedList();
sl.Add(3, "three");
sl.Add(5, "five");
sl.Add(2, "two");
sl.Add(1, "one");
sl.Add(4, "four");
// 列のデータ型を設定
flex.Cols[1].DataType = typeof(int);
// データマップを使用
flex.Cols[1].DataMap = sl;
}
ListDictionary クラス
ListDictionary クラスを使用することで、コンボボックス内の並び順序をデータを追加した順番にすることができます。詳細につ
いては、製品ヘルプの下記項目をご参照ください。
【実行例】
439
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' ListDictionaryにデータを追加
' リストに追加された順序を維持
Dim ld As New Specialized.ListDictionary()
ld.Add(3, "three")
ld.Add(5, "five")
ld.Add(2, "two")
ld.Add(1, "one")
ld.Add(4, "four")
' 列のデータ型を設定
flex.Cols(1).DataType = GetType(Integer)
' データマップを使用
flex.Cols(1).DataMap = ld
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// ListDictionaryにデータを追加
// リストに追加された順序を維持
System.Collections.Specialized.ListDictionary ld;
ld = new System.Collections.Specialized.ListDictionary();
ld.Add(3, "three");
ld.Add(5, "five");
ld.Add(2, "two");
ld.Add(1, "one");
ld.Add(4, "four");
// 列のデータ型を設定
440
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Cols[1].DataType = typeof(int);
// データマップを使用
flex.Cols[1].DataMap = ld;
}
関連項目
マップリスト
リストの内容を行ごとに変更する
SetupEditor イベントを使用して動的にComboList プロパティの値を変更します。
【実行例】
奇数行と偶数行でリストを変更
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目にコンボボックスを表示
flex.Cols(1).Caption = "コンボボックス"
flex.Cols(1).ComboList = "奇数行1|奇数行2
End Sub
Private Sub flex_StartEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.StartEdit
If e.Col = 1 Then
If e.Row Mod 2 = 0 Then
' 偶数行の設定
flex.Cols(1).ComboList = "偶数行1|偶数行2
441
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Else
' 奇数行の設定
flex.Cols(1).ComboList = "奇数行1|奇数行2
End If
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目にコンボボックスを表示
flex.Cols[1].Caption = "コンボボックス";
flex.Cols[1].ComboList = "奇数行1|奇数行2
}
private void flex_StartEdit(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
if(e.Col == 1)
{
if(e.Row % 2 == 0)
{
// 偶数行の設定
flex.Cols[1].ComboList = "偶数行1|偶数行2
}
else
{
// 奇数行の設定
flex.Cols[1].ComboList = "奇数行1|奇数行2
}
}
}
注意:
注意:表示したいリストごとにカスタムスタイルを作成し、ComboList プロパティを設定、任意のセルに割り当てる方法
でも可能です。カスタムスタイルを使用した方法については、「セルごとにコンボボックスを設定する」を参照してくださ
い。
データマップの内容を行ごとに変更する
列内でデータマップの内容を変更する場合は、カスタムスタイルを作成してCellStyle クラスの DataMap プロパティを使用す
る必要があります。通常のコンボボックスのように行・列のDataMap プロパティを変更してしまうと、表示値-実値のマッピング
ができなくなってしまうためです。
【実行例】
奇数行と偶数行でデータマップを変更
442
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムスタイルを作成し、DataMap1を設定
Dim dtMap1 As Specialized.ListDictionary
dtMap1 = New Specialized.ListDictionary
dtMap1.Add("001", "青森")
dtMap1.Add("002", "秋田")
dtMap1.Add("003", "宮城")
flex.Styles.Add("DataMap1")
flex.Styles("DataMap1").DataMap = dtMap1
' 別のカスタムスタイルを作成し、DataMap2を設定
Dim dtMap2 As Specialized.ListDictionary
dtMap2 = New Specialized.ListDictionary
dtMap2.Add("004", "東京")
dtMap2.Add("005", "神奈川")
dtMap2.Add("006", "千葉")
flex.Styles.Add("DataMap2")
flex.Styles("DataMap2").DataMap = dtMap2
' 2列目のスタイルにDataMap1を設定
flex.Cols(1).Style = flex.Styles("DataMap1")
' 奇数行にはDataMap2を設定
For i As Integer = flex.Rows.Fixed To flex.Rows.Count - 1
If i Mod 2 = 1 Then
flex.SetCellStyle(i, 1, flex.Styles("DataMap2"))
End If
Next
flex.Cols(1).Caption = "データマップ"
End Sub
C# コードの書き方
443
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムスタイルを作成し、DataMap1を設定
System.Collections.Specialized.ListDictionary dtMap1;
dtMap1 = new System.Collections.Specialized.ListDictionary();
dtMap1.Add("001", "青森");
dtMap1.Add("002", "秋田");
dtMap1.Add("003", "宮城");
flex.Styles.Add("DataMap1");
flex.Styles["DataMap1"].DataMap = dtMap1;
// 別のカスタムスタイルを作成し、DataMap2を設定
System.Collections.Specialized.ListDictionary dtMap2;
dtMap2 = new System.Collections.Specialized.ListDictionary();
dtMap2.Add("004", "東京");
dtMap2.Add("005", "神奈川");
dtMap2.Add("006", "千葉");
flex.Styles.Add("DataMap2");
flex.Styles["DataMap2"].DataMap = dtMap2;
// 2列目のスタイルにDataMap1を設定
flex.Cols[1].Style = flex.Styles["DataMap1"];
// 奇数行にはDataMap2を設定
for (int i = flex.Rows.Fixed; i < flex.Rows.Count; i++)
{
if (i % 2 == 1)
{
flex.SetCellStyle(i, 1, "DataMap2");
}
}
flex.Cols[1].Caption = "データマップ";
}
セルごとにコンボボックスを設定する
カスタムスタイルを使用します。カスタムスタイルのComboList プロパティを設定し、作成したスタイルを任意の行や列、セル
(範囲)に割りあってることで、任意のセルにコンボボックスを表示することができます。
【実行例】
444
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' カスタムスタイル"Combo1"を作成、
' ComboListプロパティを設定
flex.Styles.Add("Combo1")
flex.Styles("Combo1").ComboList = "東京|神奈川
flex.Styles("Combo1").BackColor = Color.AliceBlue
flex.Styles("Combo1").ForeColor = Color.Blue
' カスタムスタイル"Combo2"を作成、
' ComboListプロパティを設定
flex.Styles.Add("Combo2")
flex.Styles("Combo2").ComboList = "京都|大阪
flex.Styles("Combo2").BackColor = Color.YellowGreen
flex.Styles("Combo2").ForeColor = Color.Yellow
' カスタムスタイル"Combo3"を作成、
' ComboListプロパティを設定
flex.Styles.Add("Combo3")
flex.Styles("Combo3").ComboList = "青森|秋田
flex.Styles("Combo3").BackColor = Color.Beige
' 2行目全体にカスタムスタイル"Combo1"を設定
flex.Rows(2).Style = flex.Styles("Combo1")
' 4列目全体にカスタムスタイル"Combo2"を設定
flex.Cols(4).Style = flex.Styles("Combo2")
' 9行1列-10行2列目のセル範囲にカスタムスタイル"Combo3"を設定
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(9, 1, 10, 2)
cr.Style = flex.Styles("Combo3")
' 4行1列目のセルにカスタムスタイル"Combo3"を設定
flex.SetCellStyle(4, 1, flex.Styles("Combo3"))
End Sub
445
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// カスタムスタイル"Combo1"を作成、
// ComboListプロパティを設定
flex.Styles.Add("Combo1");
flex.Styles["Combo1"].ComboList = "東京|神奈川
flex.Styles["Combo1"].BackColor = Color.AliceBlue;
flex.Styles["Combo1"].ForeColor = Color.Blue;
// カスタムスタイル"Combo2"を作成、
// ComboListプロパティを設定
flex.Styles.Add("Combo2");
flex.Styles["Combo2"].ComboList = "京都|大阪
flex.Styles["Combo2"].BackColor = Color.YellowGreen;
flex.Styles["Combo2"].ForeColor = Color.Yellow;
// カスタムスタイル"Combo3"を作成、
// ComboListプロパティを設定
flex.Styles.Add("Combo3");
flex.Styles["Combo3"].ComboList = "青森|秋田
flex.Styles["Combo3"].BackColor = Color.Beige;
// 2行目全体にカスタムスタイル"Combo1"を設定
flex.Rows[2].Style = flex.Styles["Combo1"];
// 4列目全体にカスタムスタイル"Combo2"を設定
flex.Cols[4].Style = flex.Styles["Combo2"];
// 9行1列-10行2列目のセル範囲にカスタムスタイル"Combo3"を設定
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(9, 1, 10, 2);
cr.Style = flex.Styles["Combo3"];
// 4行1列目のセルにカスタムスタイル"Combo3"を設定
flex.SetCellStyle(4, 1, flex.Styles["Combo3"]);
}
注意:
カスタムスタイルを使用すれば、コンボボックス以外にもデータマップや背景色など、さまざまな要素をセル単位
で設定することができます。
行・列のスタイルを両方とも設定したセルでは、列に適用したスタイルが優先されます。
チェックボックス
チェックボックスに関するタスクを紹介します。
関連項目
チェックボックス(セルの編集)
チェックボックスを表示する
446
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
セルに適用されているスタイルのデータ型(DataType)や、行や列のデータ型(DataType)がブール型であれば、自動的に
チェックボックスが表示されます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目のデータ型をブール型に設定
flex.Cols(1).DataType = GetType(Boolean)
flex.Cols(1).Caption = "チェックボックス"
' カスタムスタイル"CheckBox1"を作成、
' データ型をブール型に設定
flex.Styles.Add("CheckBox1")
flex.Styles("CheckBox1").DataType = GetType(Boolean)
flex.Styles("CheckBox1").BackColor = Color.AliceBlue
flex.Styles("CheckBox1").ImageAlign =
C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter
' 4行3列-5行4列目のセル範囲にカスタムスタイル"CheckBox1"を適用
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(4, 3, 5, 4)
cr.Style = flex.Styles("CheckBox1")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目のデータ型をブール型に設定
flex.Cols[1].DataType = typeof(bool);
447
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Cols[1].Caption = "チェックボックス";
// カスタムスタイル"CheckBox1"を作成、
// データ型をブール型に設定
flex.Styles.Add("CheckBox1");
flex.Styles["CheckBox1"].DataType = typeof(bool);
flex.Styles["CheckBox1"].BackColor = Color.AliceBlue;
flex.Styles["CheckBox1"].ImageAlign =
C1.Win.C1FlexGrid.ImageAlignEnum.CenterCenter;
// 4行3列-5行4列目のセル範囲にカスタムスタイル"CheckBox1"を適用
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(4, 3, 5, 4);
cr.Style = flex.Styles["CheckBox1"];
}
注意:
注意:連結(バウンド)モードのグリッドにおける列のデータ型は、FlexGridと接続しているデータソースに依存します。
チェックボックスを表示する(
チェックボックスを表示する(SetCellCheck))
SetCellCheck メソッドを使用してセルにチェックボックスを表示します。この場合、セルのデータ型をブール型にする必要はあ
りません。チェックボックスとテキストの両方を表示することもできます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 3行2列目のセルにチェックボックス(Checked)を設定
flex.SetCellCheck(3, 2, C1.Win.C1FlexGrid.CheckEnum.Checked)
' 3行2列目のセルにデータを設定
flex(3, 2) = "チェック"
' 3行3列目のセルにチェックボックス(Unchecked)を設定
448
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.SetCellCheck(3, 3, C1.Win.C1FlexGrid.CheckEnum.Unchecked)
' 3行3列目のセルにデータを設定
flex(3, 3) = "未チェック"
' 4行2列目のセルにチェックボックス(TSChecked)を設定
flex.SetCellCheck(4, 2, C1.Win.C1FlexGrid.CheckEnum.TSChecked)
' 4行2列目のセルにデータを設定
flex(4, 2) = "チェック"
' 4行3列目のセルにチェックボックス(TSUnchecked)を設定
flex.SetCellCheck(4, 3, C1.Win.C1FlexGrid.CheckEnum.TSUnchecked)
' 4行3列目のセルにデータを設定
flex(4, 3) = "未チェック"
' 4行4列目のセルにチェックボックス(TSGrayed)を設定
flex.SetCellCheck(4, 4, C1.Win.C1FlexGrid.CheckEnum.TSGrayed)
' 4行4列目のセルにデータを設定
flex(4, 4) = "グレー"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 3行2列目のセルにチェックボックス(Checked)を設定
flex.SetCellCheck(3, 2, C1.Win.C1FlexGrid.CheckEnum.Checked);
// 3行2列目のセルにデータを設定
flex[3, 2] = "チェック";
// 3行3列目のセルにチェックボックス(Unchecked)を設定
flex.SetCellCheck(3, 3, C1.Win.C1FlexGrid.CheckEnum.Unchecked);
// 3行3列目のセルにデータを設定
flex[3, 3] = "未チェック";
// 4行2列目のセルにチェックボックス(TSChecked)を設定
flex.SetCellCheck(4, 2, C1.Win.C1FlexGrid.CheckEnum.TSChecked);
// 4行2列目のセルにデータを設定
flex[4, 2] = "チェック";
// 4行3列目のセルにチェックボックス(TSUnchecked)を設定
flex.SetCellCheck(4, 3, C1.Win.C1FlexGrid.CheckEnum.TSUnchecked);
// 4行3列目のセルにデータを設定
flex[4, 3] = "未チェック";
// 4行4列目のセルにチェックボックス(TSGrayed)を設定
flex.SetCellCheck(4, 4, C1.Win.C1FlexGrid.CheckEnum.TSGrayed);
// 4行4列目のセルにデータを設定
flex[4, 4] = "グレー";
}
チェックボックスのイメージを変更する
Glyphs プロパティでGlyphEnum.Checked/GlyphEnum.Unchecked を指定して変更します。
【実行例】
449
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目のデータ型をブール型にしてチェックボックスを表示
flex.Cols(1).DataType = GetType(Boolean)
flex.Cols(1).Caption = "チェックボックス"
' 3行3列目のセルにチェックボックス(Checked)を設定
flex.SetCellCheck(3, 3, C1.Win.C1FlexGrid.CheckEnum.Checked)
flex(3, 3) = "オン"
' 3行4列目のセルにチェックボックス(Unchecked)を設定
flex.SetCellCheck(3, 4, C1.Win.C1FlexGrid.CheckEnum.Unchecked)
flex(3, 4) = "オフ"
' オンのチェックボックスイメージを変更
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.Checked) = New Bitmap("ok.gif")
' オフのチェックボックスイメージを変更
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.Unchecked) = New Bitmap("cancel.gif")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目のデータ型をブール型にしてチェックボックスを表示
flex.Cols[1].DataType = typeof(bool);
flex.Cols[1].Caption = "チェックボックス";
// 3行3列目のセルにチェックボックス(Checked)を設定
flex.SetCellCheck(3, 3, C1.Win.C1FlexGrid.CheckEnum.Checked);
flex[3, 3] = "オン";
// 3行4列目のセルにチェックボックス(Unchecked)を設定
flex.SetCellCheck(3, 4, C1.Win.C1FlexGrid.CheckEnum.Unchecked);
450
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex[3, 4] = "オフ";
// オンのチェックボックスイメージを変更
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.Checked] = new Bitmap("ok.gif");
// オフのチェックボックスイメージを変更
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.Unchecked] = new Bitmap("cancel.gif");
}
チェックボックスのセルにテキストを表示する
SetCellCheck メソッドを使用するか、オーナー描画の機能を使用します。オーナー描画を使用すると、チェックボックスの値に
応じてテキストを表示することもできます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目のデータ型をブール型にしてチェックボックスを表示
flex.Cols(1).DataType = GetType(Boolean)
flex.Cols(1).Caption = "チェックボックス"
flex.Cols(1).Style.Display = C1.Win.C1FlexGrid.DisplayEnum.Stack
flex.Cols(1).Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftCenter
flex.Cols(1).Style.ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.LeftCenter
' オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
If e.Row >= flex.Rows.Fixed And e.Col = 1 Then
' True/Falseで異なるデータを表示
451
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
If flex(e.Row, e.Col) Is Nothing Or flex(e.Row, e.Col) = "False" Then
e.Text = "OFF"
Else
e.Text = "ON"
End If
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目のデータ型をブール型にしてチェックボックスを表示
flex.Cols[1].DataType = typeof(bool);
flex.Cols[1].Caption = "チェックボックス";
flex.Cols[1].Style.Display = C1.Win.C1FlexGrid.DisplayEnum.Stack;
flex.Cols[1].Style.TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.LeftCenter;
flex.Cols[1].Style.ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.LeftCenter;
// オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
if ((e.Row >= flex.Rows.Fixed) && (e.Col == 1))
{
// True/Falseで異なるデータを表示
if ((flex[e.Row, e.Col] == null) |
{
e.Text = "OFF";
}
else
{
e.Text = "ON";
}
}
注意:
注意:SetCellCheck メソッドを使用する方法については、「チェックボックスを表示する(SetCellCheck)」を参照してくだ
さい。
日付型セル
日付型に設定されたセルにおけるタスクを紹介します。
カレンダーコントロールを使用して日付の入力を行う
セルに適用されているスタイルのデータ型(DataType)や、行や列のデータ型(DataType)が日付型であれば、自動的にカレ
ンダー(DateTimePicker)コントロールによる入力ができます。
452
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目のデータ型を日付型に設定
flex.Cols(1).DataType = GetType(Date)
flex.Cols(1).Caption = "日付"
' カスタムスタイル"DatePicker1"を作成、
' データ型を日付型に設定
flex.Styles.Add("DatePicker1")
flex.Styles("DatePicker1").DataType = GetType(Date)
flex.Styles("DatePicker1").BackColor = Color.AliceBlue
' 4行3列-5行4列目のセル範囲にカスタムスタイル"DatePicker1"を適用
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(4, 3, 5, 4)
cr.Style = flex.Styles("DatePicker1")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目のデータ型を日付型に設定
flex.Cols[1].DataType = typeof(DateTime);
flex.Cols[1].Caption = "日付";
// カスタムスタイル"DatePicker1"を作成、
// データ型を日付型に設定
flex.Styles.Add("DatePicker1");
flex.Styles["DatePicker1"].DataType = typeof(DateTime);
453
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Styles["DatePicker1"].BackColor = Color.AliceBlue;
// 4行3列-5行4列目のセル範囲にカスタムスタイル"DatePicker1"を適用
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(4, 3, 5, 4);
cr.Style = flex.Styles["DatePicker1"];
}
注意:
注意:連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソースに
依存します。
カレンダーコントロールを表示しない
「カレンダーコントロールを使用して日付の入力を行う」にもありますが、セルのデータ型が日付型に設定されていれば、セル
編集時、自動的にカレンダーコントロールが表示されます。カレンダーコントロールを表示しないようにするには、「スピンボタン
を使用して日付の入力を行う」方法に加えて、EditMask プロパティにてセルにマスクを設定する方法があります。日付として
正しい入力かどうかは、ValidateEdit イベントを使用してチェック可能です。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 列のデータ型を Date 型に設定
flex.Cols(1).DataType = GetType(Date)
' マスクを設定
flex.Cols(1).EditMask = "0000/00/00"
End Sub
' 入力チェック
Private Sub flex_ValidateEdit(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.ValidateEditEventArgs) Handles flex.ValidateEdit
If e.Col = 1 Then
454
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Dim d As Date
If Date.TryParse(flex.Editor.Text, d) = False Then
e.Cancel = True
MessageBox.Show("無効な日付です")
End If
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 列のデータ型を Date 型に設定
flex.Cols[1].DataType = typeof(DateTime);
// マスクを設定
flex.Cols[1].EditMask = "0000/00/00";
}
// 入力チェック
private void flex_ValidateEdit(object sender, C1.Win.C1FlexGrid.ValidateEditEventArgs
e)
{
if (e.Col == 1)
{
DateTime d;
if (DateTime.TryParse(flex.Editor.Text, out d) == false)
{
e.Cancel = true;
MessageBox.Show("無効な日付です");
}
}
}
注意:
注意:連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソースに
依存します。
関連項目
カレンダーコントロールを使用して日付の入力を行う
スピンボタンを使用して日付の入力を行う
スピンボタンを使用して日付の入力を行う
SetupEditor イベントを使用し、日付型セルで編集用エディタを DateTimePicker に変換した上で、ShowUpDown プロパ
ティを True に設定します。
【実行例】
455
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Pivate Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目のデータ型を日付型に設定
flex.Cols(1).DataType = GetType(Date)
flex.Cols(1).Caption = "日付"
End Sub
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
If e.Col = 1 Then
' 編集エディタをDateTimePickerに変換
Dim dt As DateTimePicker
dt = CType(flex.Editor, DateTimePicker)
' スピンボタンを表示
dt.ShowUpDown = True
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目のデータ型を日付型に設定
flex.Cols[1].DataType = typeof(DateTime);
flex.Cols[1].Caption = "日付";
}
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
if(e.Col == 1)
{
456
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 編集エディタをDateTimePickerに変換
DateTimePicker dt;
dt = (DateTimePicker)flex.Editor;
// スピンボタンを表示
dt.ShowUpDown = true;
}
}
注意:
DateTimePicker コントロールの詳細については、MSDN を参照してください。
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソース
に依存します。
日付の書式を設定する
日付型セルの書式を設定するには、セルに適用されているスタイルのFormat や、行や列の Format を設定します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1列目のデータ型を日付型に設定
flex.Cols(1).DataType = GetType(Date)
flex.Cols(1).Caption = "日付"
' 日付の書式を設定:Long Date(長い日付)
flex.Cols(1).Format = "D"
' カスタムスタイル"Date1"を作成、
' データ型、書式を設定
flex.Styles.Add("Date1")
457
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Styles("Date1").DataType = GetType(Date)
' 日付の書式を設定:カスタムDateTime書式指定文字列
flex.Styles("Date1").Format = "yyyy年MM月dd日"
flex.Styles("Date1").BackColor = Color.AliceBlue
' 4行3列-5行4列目のセル範囲にカスタムスタイル"Date1"を適用
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.GetCellRange(4, 3, 5, 4)
cr.Style = flex.Styles("Date1")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 1列目のデータ型を日付型に設定
flex.Cols[1].DataType = typeof(DateTime);
flex.Cols[1].Caption = "日付";
// 日付の書式を設定:Long Date(長い日付)
flex.Cols[1].Format = "D";
// カスタムスタイル"Date1"を作成、
// データ型、書式を設定
flex.Styles.Add("Date1");
flex.Styles["Date1"].DataType = typeof(DateTime);
// 日付の書式を設定:カスタムDateTime書式指定文字列
flex.Styles["Date1"].Format = "yyyy年MM月dd日";
flex.Styles["Date1"].BackColor = Color.AliceBlue;
// 4行3列-5行4列目のセル範囲にカスタムスタイル"Date1"を適用
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.GetCellRange(4, 3, 5, 4);
cr.Style = flex.Styles["Date1"];
}
注意:
列の書式設定は、設計時に Column タスク メニューや 列エディタ からも設定できます。
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソース
に依存します。
和暦で表示する
C1FlexGrid コントロールの書式設定に和暦表示はありません。そのため、JapaneseCalendarクラスを使用して和暦に変換
し、オーナー描画にて表示します。
【実行例】
458
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Dim c As System.Globalization.CultureInfo
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 1、2列目のデータ型を日付型に設定
flex.Cols(1).DataType = GetType(Date)
flex.Cols(1).Caption = "日付"
flex.Cols(2).DataType = GetType(Date)
flex.Cols(2).Caption = "和暦表示"
' データの設定
flex(1, 1) = "2007/09/16"
flex(1, 2) = "2007/09/16"
flex(2, 1) = "2010/09/21"
flex(2, 2) = "2010/09/21"
flex(3, 1) = "2008/02/29"
flex(3, 2) = "2008/02/29"
flex(4, 1) = "1973/09/01"
flex(4, 2) = "1973/09/01"
flex(5, 1) = "1895/12/24"
flex(5, 2) = "1895/12/24"
flex(6, 1) = "1994/05/13"
flex(6, 2) = "1994/05/13"
' オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
flex.AutoSizeCol(2)
' JapanseCalendarクラスを使用
c = New System.Globalization.CultureInfo("ja-JP")
c.DateTimeFormat.Calendar = New System.Globalization.JapaneseCalendar
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
' 2列目を和暦で表示
459
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
If e.Col = 2 And e.Row > 0 Then
If e.Text = "" Or e.Text Is Nothing Then
Return
End If
' 表示データの設定(和暦表示)
e.Text = Date.Parse(e.Text).ToString("ggyy年MM月dd日(dddd)", c)
End If
End Sub
C# コードの書き方
C#
System.Globalization.CultureInfo c;
Private void Form1_Load(object sender, EventArgs e)
{
// 1、2列目のデータ型を日付型に設定
flex.Cols[1].DataType = typeof(DateTime);
flex.Cols[1].Caption = "日付";
flex.Cols[2].DataType = typeof(DateTime);
flex.Cols[2].Caption = "和暦表示";
// データの設定
flex[1, 1] = "2007/09/16";
flex[1, 2] = "2007/09/16";
flex[2, 1] = "2010/09/21";
flex[2, 2] = "2010/09/21";
flex[3, 1] = "2008/02/29";
flex[3, 2] = "2008/02/29";
flex[4, 1] = "1973/09/01";
flex[4, 2] = "1973/09/01";
flex[5, 1] = "1895/12/24";
flex[5, 2] = "1895/12/24";
flex[6, 1] = "1994/05/13";
flex[6, 2] = "1994/05/13";
// オーナー描画
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
flex.AutoSizeCol(2);
// JapanseCalendarクラスを使用
c = new System.Globalization.CultureInfo("ja-JP");
c.DateTimeFormat.Calendar = new System.Globalization.JapaneseCalendar();
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
// 2列目を和暦で表示
if ((e.Col == 2) && (e.Row > 0))
{
if((e.Text == "") |
{
return;
}
// 表示データの設定(和暦表示)
e.Text = DateTime.Parse(e.Text).ToString("ggyy年MM月dd日(dddd)", c);
460
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
注意:
JapaneseCalendar クラスの詳細は、MSDN を参照してください。
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソース
に依存します。
時刻のみを表示する
日付型のセルで時刻のみを表示するには、セルに適用されているスタイルのFormat や、行や列の Format をShort
Time(短い時刻)やLong Time(長い時刻)に設定し、スピンボタンにより編集します。
【実行例】
Visual Basic コードの書き方
Visual Basic
' Short Time(短い時刻)
flex.Cols(1).DataType = GetType(Date)
flex.Cols(1).Format = "t"
C# コードの書き方
C#
// Short Time(短い時刻)
flex.Cols[1].DataType = typeof(DateTime);
flex.Cols[1].Format = "t";
注意:
列の書式設定は、設計時に Column タスク メニューや 列エディタ からも設定できます。
461
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソース
に依存します。
入力可能な日付を設定する
SetupEditor イベントを使用して、日付型セルの編集用エディタを DateTimePicker に変換した上で、DateTimePicker クラス
の MinDate/MaxDate プロパティを設定します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 列のデータ型を Date 型に設定
flex.Cols(1).DataType = GetType(Date)
End Sub
Private Sub flex_SetupEditor(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.RowColEventArgs) Handles flex.SetupEditor
If e.Col = 1 Then
Dim dt As DateTimePicker = CType(flex.Editor, DateTimePicker)
dt.MinDate = "2009/02/08"
dt.MaxDate = "2009/02/21"
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 列のデータ型を Date 型に設定
462
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Cols[1].DataType = typeof(DateTime);
}
private void flex_SetupEditor(object sender, C1.Win.C1FlexGrid.RowColEventArgs e)
{
if (e.Col == 1)
{
DateTimePicker dt;
dt = (DateTimePicker)flex.Editor;
dt.MinDate = DateTime.Parse("2009/02/08");
dt.MaxDate = DateTime.Parse("2009/02/21");
}
}
注意:
DateTimePicker コントロールの詳細は、MSDN を参照してください。
連結(バウンド)モードのグリッドにおける列のデータ型は、C1FlexGrid コントロールと接続しているデータソース
に依存します。
数値型セル
数値型に設定されたセルにおけるタスクを紹介します。
数値エディタを使用する
EditOptions プロパティにUseNumericEditor フラグを追加します。
組み込みの数値エディタには、下記の特長があります。
数値エディタはスタイルや列に割り当てられた Format プロパティを使用して入力中の書式設定を行います。そのた
め、入力中に3桁区切りでカンマを表示するといった動作が可能です。
数値エディタはキーチェックを行うため、数値型のセルで文字列が入力されることを防ぎます。
数値エディタはデータ型に応じた範囲チェックを提供します。Intege r 型のセルでは、Integer 型の最小値から最大値
までの入力のみを提供します。
EditFlags 列挙体に UseNumericEditor フラグを含めないことで、組み込み数値エディタを無効にできます。
デザイナの場合
プロパティページで EditOptions プロパティを選択し、All をチェックするか、UseNumericEditor をチェックします。
コードの場合
Visual Basic コードの書き方
463
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.All
' UseNumericEditorとCycleOnDoubleClickのみ
' flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.UseNumericEditor Or _
' C1.Win.C1FlexGrid.EditFlags.CycleOnDoubleClick
C# コードの書き方
C#
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.All;
// UseNumericEditorとCycleOnDoubleClickのみ
// flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.UseNumericEditor |
// C1.Win.C1FlexGrid.EditFlags.CycleOnDoubleClick;
数値型セルの書式を設定する
行や列、各スタイルの Format プロパティを使用して書式を設定します。また、EditOptions プロパティにUseNumericEditor
フラグを追加して数値エディタを使用することで、編集中も書式設定が有効になります。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 組み込みの数値エディタを使用
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.All
' 1列目のデータ型を数値型に設定
flex.Cols(1).DataType = GetType(Decimal)
' 1列目の書式を設定
flex.Cols(1).Format = "C"
End Sub
464
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 組み込みの数値エディタを使用
flex.EditOptions = C1.Win.C1FlexGrid.EditFlags.All;
// 1列目のデータ型を数値型に設定
flex.Cols[1].DataType = typeof(decimal);
// 1列目の書式を設定
flex.Cols[1].Format = "C";
}
注意:
列の書式設定は、設計時に Column タスク メニューや 列エディタ からも設定できます。
行や列単位で書式を設定する方法は、「行列の書式を設定する」を参照してください。
スタイルを使用して書式を設定する方法は、「書式を設定する」を参照してください。
ツリー表示/小計行
アウトラインツリーや小計行に関するタスクを紹介します。
小計行を表示する
小計行は、Subtotal メソッドを使用して表示します。小計行の表示位置は、SubtotalPosition プロパティで上下どちらかに
設定することができます。
【実行例】
Visual Basic コードの書き方
Visual Basic
465
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Prvate Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(1, 2) = 180
flex(2, 2) = 20
flex(3, 2) = 74
' 2列目を合計した小計行を表示
' 計算:合計、レベル:-1(総計行)、境界の開始列:-1(なし)、計算対象の列:2
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, -1, -1, 2)
' 総計行の組み込みスタイルを変更
flex.Styles("GrandTotal").BackColor = Color.YellowGreen
flex.Styles("GrandTotal").ForeColor = Color.Red
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 2] = 180;
flex[2, 2] = 20;
flex[3, 2] = 74;
// 2列目を合計した小計行を表示
// 計算:合計、レベル:-1(総計行)、境界の開始列:-1(なし)、計算対象の列:2
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, -1, -1, 2);
// 総計行の組み込みスタイルを変更
flex.Styles["GrandTotal"].BackColor = Color.YellowGreen;
flex.Styles["GrandTotal"].ForeColor = Color.Red;
}
関連項目
組み込みスタイルの位置について
小計行をカスタマイズして表示する
Subtotal メソッドを使用すると、BeforeSubtotal/AfterSubtotal イベントが発生します。これらのイベントを使用して新しい
小計行で使用されるキャプション、スタイル、および集計値をカスタマイズできます。
【実行例】
466
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(1, 2) = 180
flex(2, 2) = 20
flex(3, 2) = 74
' 2列目を合計した小計行を表示
' 計算:合計、レベル:-1(総計行)、境界の開始列:-1(なし)、計算対象の列:2
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, -1, -1, 2)
' 総計行の組み込みスタイルを変更
flex.Styles("GrandTotal").BackColor = Color.YellowGreen
flex.Styles("GrandTotal").ForeColor = Color.Yellow
flex.Styles("GrandTotal").TextAlign = C1.Win.C1FlexGrid.TextAlignEnum.RightCenter
End Sub
Private Sub flex_BeforeSubtotal(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.SubtotalEventArgs) Handles flex.BeforeSubtotal
e.AggregateValue = "<" & e.AggregateValue & ">"
End Sub
Private Sub flex_AfterSubtotal(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.SubtotalEventArgs) Handles flex.AfterSubtotal
flex(e.NewRowIndex, 1) = "合計:"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 2] = 180;
flex[2, 2] = 20;
flex[3, 2] = 74;
// 2列目を合計した小計行を表示
// 計算:合計、レベル:-1(総計行)、境界の開始列:-1(なし)、計算対象の列:2
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, -1, -1, 2);
467
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 総計行の組み込みスタイルを変更
flex.Styles["GrandTotal"].BackColor = Color.YellowGreen;
flex.Styles["GrandTotal"].ForeColor = Color.Yellow;
flex.Styles["GrandTotal"].TextAlign =
C1.Win.C1FlexGrid.TextAlignEnum.RightCenter;
}
private void flex_BeforeSubtotal(object sender, C1.Win.C1FlexGrid.SubtotalEventArgs
e)
{
e.AggregateValue = "<" + e.AggregateValue + ">";
}
private void flex_AfterSubtotal(object sender, C1.Win.C1FlexGrid.SubtotalEventArgs e)
{
flex[e.NewRowIndex, 1] = "合計:";
}
関連項目
組み込みスタイルの位置について
小計行を使用してアウトラインツリーを表示する
Column プロパティでツリーが表示される列を、Style プロパティでツリーの外観を指定します。その上で、Subtotal メソッドを
使用して小計行を表示します。小計行の表示位置は、SubtotalPosition プロパティで上下どちらかに設定することができま
す。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
468
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Handles MyBase.Load
flex(1, 0) = "AAA"
flex(1, 1) = 10
flex(2, 0) = "AAA"
flex(2, 1) = 20
flex(3, 0) = "BBB"
flex(3, 1) = 30
flex(4, 0) = "BBB"
flex(4, 1) = 40
flex(5, 0) = "BBB"
flex(5, 1) = 50
' 固定列:0
flex.Cols.Fixed = 0
' ツリー列:0
flex.Tree.Column = 0
' ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' 小計行(全ての合計)を表示
' 計算:合計、レベル:0、境界の開始列:-1(なし)、計算対象の列:1, キャプション
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, 0, -1, 1, "全ての合計")
' 小計行(0列目ごとの合計)を表示
' 計算:合計、レベル:1、境界の開始列:0、計算対象の列:1, キャプション
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, 1, 0, 1, "{0}の合計")
' レベル0の組み込みスタイルを変更
flex.Styles2("Subtotal0").BackColor = Color.YellowGreen
flex.Styles("Subtotal0").ForeColor = Color.Red
' レベル1の組み込みスタイルを変更
flex.Styles("Subtotal1").BackColor = Color.AliceBlue
flex.Styles("Subtotal1").ForeColor = Color.Green
' 列幅の自動調整
flex.AutoSizeCol(0)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 0] = "AAA";
flex[1, 1] = 10;
flex[2, 0] = "AAA";
flex[2, 1] = 20;
flex[3, 0] = "BBB";
flex[3, 1] = 30;
flex[4, 0] = "BBB";
flex[4, 1] = 40;
flex[5, 0] = "BBB";
flex[5, 1] = 50;
// 固定列:0
flex.Cols.Fixed = 0;
// ツリー列:0
flex.Tree.Column = 0;
469
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
// 小計行(全ての合計)を表示
// 計算:合計、レベル:0、境界の開始列:-1(なし)、計算対象の列:1, キャプション
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, 0, -1, 1, "全ての合計");
// 小計行(0列目ごとの合計)を表示
// 計算:合計、レベル:1、境界の開始列:0、計算対象の列:1, キャプション
flex.Subtotal(C1.Win.C1FlexGrid.AggregateEnum.Sum, 1, 0, 1, "{0}の合計");
// レベル0の組み込みスタイルを変更
flex.Styles["Subtotal0"].BackColor = Color.YellowGreen;
flex.Styles["Subtotal0"].ForeColor = Color.Red;
// レベル1の組み込みスタイルを変更
flex.Styles["Subtotal1"].BackColor = Color.AliceBlue;
flex.Styles["Subtotal1"].ForeColor = Color.Green;
// 列幅の自動調整
flex.AutoSizeCol(0);
}
関連項目
組み込みスタイルの位置について
組み込みスタイルの位置について組み込みスタイルの位置について
データにあわせて行/列のサイズを調整する
ノード行を指定してアウトラインツリーを表示する
Column プロパティでツリーが表示される列を、Style プロパティでツリーの外観を指定します。また、任意の行のIsNode プロ
パティを True にしてノード行とすることでアウトラインツリーを表示します。ノード行の階層レベルは、各ノード行のNode オブ
ジェクトを取得し、そのLevel プロパティを設定することで定義します。大きい値ほど、アウトラインツリー上のより深い(よりイン
デントした)階層レベルを意味します。
注意:
注意:IsNode プロパティは、非連結時のみ設定可能です。連結モード時は使用できません。
【実行例】
470
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 固定列:0
flex.Cols.Fixed = 0
' ツリー列:0
flex.Tree.Column = 0
' ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' 1行目をノード行に設定
flex.Rows(1).IsNode = True
' 階層レベルを0に設定
flex.Rows(1).Node.Level = 0
' 3行目をノード行に設定
flex.Rows(3).IsNode = True
' 階層レベルを0に設定
flex.Rows(3).Node.Level = 0
flex(1, 0) = "ノード行1"
flex(3, 0) = "ノード行2"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 固定列:0
flex.Cols.Fixed = 0;
// ツリー列:0
flex.Tree.Column = 0;
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
471
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 1行目をノード行に設定
flex.Rows[1].IsNode = true;
// 階層レベルを0に設定
flex.Rows[1].Node.Level = 0;
// 3行目をノード行に設定
flex.Rows[3].IsNode = true;
// 階層レベルを0に設定
flex.Rows[3].Node.Level = 0;
flex[1, 0] = "ノード行1";
flex[3, 0] = "ノード行2";
}
連結グリッドでアウトラインツリーを表示する
IsNode プロパティは連結時に使用できないため、InsertNode メソッドでノード行を挿入してアウトラインツリーを表示します。
階層レベルは、InsertNode メソッドの引数で指定します。大きい値ほど、アウトラインツリー上のより深い(よりインデントした)
階層レベルを意味します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
...
' 連結グリッド
flex.DataSource = dt
' 固定列:0
flex.Cols.Fixed = 0
' ツリー列:0
flex.Tree.Column = 0
' ツリースタイルを設定
472
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' ノード行を挿入(レベル:0)
Dim n As C1.Win.C1FlexGrid.Node
n = flex.Rows.InsertNode(1, 0)
n.Data = "A~B"
n = flex.Rows.InsertNode(13, 0)
n.Data = "C~F"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
...
// 連結グリッド
flex.DataSource = dt;
// 固定列:0
flex.Cols.Fixed = 0;
// ツリー列:0
flex.Tree.Column = 0;
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
// ノード行を挿入(レベル:0)
C1.Win.C1FlexGrid.Node n;
n = flex.Rows.InsertNode(1, 0);
n.Data = "A~B";
n = flex.Rows.InsertNode(13, 0);
n.Data = "C~F";
}
ノード行にチェックボックスを表示する
Checked プロパティ、または C1FlexGridBase.SetCellChecked メソッドを使用します。
【実行例】
473
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 固定列:0
flex.Cols.Fixed = 0
' ツリー列:0
flex.Tree.C2olumn = 0
' ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' 1行目をノード行に設定
flex.Rows(1).IsNode = True
' 階層レベルを0に設定
flex.Rows(1).Node.Level = 0
' 3行目をノード行に設定
flex.Rows(3).IsNode = True
' 階層レベルを1に設定
flex.Rows(3).Node.Level = 1
' チェックボックスを表示
flex.Rows(3).Node.Checked = C1.Win.C1FlexGrid.CheckEnum.Checked
flex(1, 0) = "ノード行1"
flex(3, 0) = "ノード行2"
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 固定列:0
flex.Cols.Fixed = 0;
// ツリー列:0
flex.Tree.Column = 0;
474
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
// 1行目をノード行に設定
flex.Rows[1].IsNode = true;
// 階層レベルを0に設定
flex.Rows[1].Node.Level = 0;
// 3行目をノード行に設定
flex.Rows[3].IsNode = true;
// 階層レベルを1に設定
flex.Rows[3].Node.Level = 1;
// チェックボックスを表示
flex.Rows[3].Node.Checked = C1.Win.C1FlexGrid.CheckEnum.Checked;
flex[1, 0] = "ノード行1";
flex[3, 0] = "ノード行2";
}
縮小・展開をコードで実行する
Show メソッドを使用します。Show メソッドは、指定された階層レベルを折りたたみ、それより上位のレベルを展開します。各
ノード行が縮小・展開されているかどうかは、Expanded プロパティを使用して参照できます。
注意:
注意:Show メソッドによるノード行の展開/縮小は、Subtotal メソッドやIsNode プロパティ、InsertNode メソッドのい
ずれの方法で作成したアウトラインツリー表示でも使用できます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 固定列:0
flex.Cols.Fixed = 0
475
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' ツリー列:0
flex.Tree.Column = 0
' ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' 1行目をノード行に設定
flex.Rows(1).IsNode = True
' 階層レベルを0に設定
flex.Rows(1).Node.Level = 0
' 2行目をノード行に設定
flex.Rows(2).IsNode = True
' 階層レベルを1に設定
flex.Rows(2).Node.Level = 1
' 3行目をノード行に設定
flex.Rows(3).IsNode = True
' 階層レベルを2に設定
flex.Rows(3).Node.Level = 2
flex(1, 0) = "階層レベル0"
flex(2, 0) = "階層レベル1"
flex(3, 0) = "階層レベル2"
flex.AutoSizeCol(0)
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 階層レベル1で縮小
flex.Tree.Show(1)
End Sub
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button2.Click
' 全階層レベルを展開
flex.Tree.Show(flex.Tree.MaximumLevel + 1)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 固定列:0
flex.Cols.Fixed = 0;
// ツリー列:0
flex.Tree.Column = 0;
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
// 1行目をノード行に設定
flex.Rows[1].IsNode = true;
// 階層レベルを0に設定
flex.Rows[1].Node.Level = 0;
// 2行目をノード行に設定
flex.Rows[2].IsNode = true;
// 階層レベルを1に設定
flex.Rows[2].Node.Level = 1;
// 3行目をノード行に設定
476
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Rows[3].IsNode = true;
// 階層レベルを2に設定
flex.Rows[3].Node.Level = 2;
flex[1, 0] = "階層レベル0";
flex[2, 0] = "階層レベル1";
flex[3, 0] = "階層レベル2";
flex.AutoSizeCol(0);
}
private void button1_Click(object sender, EventArgs e)
{
// 階層レベル1で縮小
flex.Tree.Show(1);
}
private void button2_Click(object sender, EventArgs e)
{
// 全階層レベルを展開
flex.Tree.Show(flex.Tree.MaximumLevel + 1);
}
縮小・展開イメージを変更する
Glyphs プロパティで、展開の場合はGlyphEnum.Expanded を、縮小の場合はGlyphEnum.Collapsed を指定して変更しま
す。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 固定列:0
flex.Cols.Fixed = 0
477
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' ツリー列:0
flex.Tree.Column = 0
' ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf
' 1行目をノード行に設定
flex.Rows(12).IsNode = True
' 階層レベルを0に設定
flex.Rows(1).Node.Level = 0
' 2行目をノード行に設定
flex.Rows(2).IsNode = True
' 階層レベルを1に設定
flex.Rows(2).Node.Level = 1
' 3行目をノード行に設定
flex.Rows(3).IsNode = True
' 階層レベルを2に設定
flex.Rows(3).Node.Level = 2
flex(1, 0) = "階層レベル0"
flex(2, 0) = "階層レベル1"
flex(3, 0) = "階層レベル2"
flex.AutoSizeCol(0)
' 展開のアイコンを変更
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.Expanded) = Image.FromFile("arrow.gif")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// 固定列:0
flex.Cols.Fixed = 0;
// ツリー列:0
flex.Tree.Column = 0;
// ツリースタイルを設定
flex.Tree.Style = C1.Win.C1FlexGrid.TreeStyleFlags.SimpleLeaf;
// 1行目をノード行に設定
flex.Rows[1].IsNode = true;
// 階層レベルを0に設定
flex.Rows[1].Node.Level = 0;
// 2行目をノード行に設定
flex.Rows[2].IsNode = true;
// 階層レベルを1に設定
flex.Rows[2].Node.Level = 1;
// 3行目をノード行に設定
flex.Rows[3].IsNode = true;
// 階層レベルを2に設定
flex.Rows[3].Node.Level = 2;
flex[1, 0] = "階層レベル0";
flex[2, 0] = "階層レベル1";
flex[3, 0] = "階層レベル2";
flex.AutoSizeCol(0);
// 展開のアイコンを変更
478
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.Expanded] = Image.FromFile("arrow.gif");
}
注意:
注意:Image.FromFile メソッドを使用すると、アプリケーション起動時に画像ファイルがロックされます。詳細は、MSDN
などを参照してください。
フィルタリング
フィルタリングにおけるタスクを紹介します。
ユーザーによるフィルタリングを許可する
グリッドのAllowFiltering プロパティを True に変更します。また、列の AllowFiltering プロパティを None 以外に設定(デ
フォルト値:Default)します。
データフィルタリング機能は、Windows7 や Vista において Microsoft が使用しているスタイルに従っています。ユーザーが列
ヘッダ上にマウスポインタを動かしたときに、グリッドはヘッダ上にフィルタボタンを表示します。フィルタボタンのクリックによ
り、表示するデータを選択するフィルタエディタが起動します。また、フィルタが適用されている列には、マウスが列ヘッダ上に
置かれていないときでも、ヘッダにフィルタアイコンが表示されます。
【実行例】 値フィルタ+条件フィルタ(
値フィルタ+条件フィルタ(Default))
479
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 条件フィルタ(
条件フィルタ(ByCondition))
ユーザーが“指定の値より大きい”、”指定の値を含む” といった条件を指定できる条件フィルタ
【実行例】 値フィルタ(
値フィルタ(ByValue))
ユーザーが表示する特定の値を選択できる値フィルタ
480
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 フィルタリングを許可しない(
フィルタリングを許可しない(None))
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
481
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
' グリッドのAllowFilteringプロパティをTrueに設定
flex.AllowFiltering = True
' 各列のAllowFilteringプロパティを設定
flex.Cols(1).AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.Default
flex.Cols(2).AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.ByCondition
flex.Cols(3).AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.ByValue
flex.Cols(4).AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.None
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, " Customers ");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
// グリッドのAllowFilteringプロパティをTrueに設定
flex.AllowFiltering = true;
// 各列のAllowFilteringプロパティを設定
flex.Cols[1].AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.Default;
flex.Cols[2].AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.ByCondition;
flex.Cols[3].AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.ByValue;
flex.Cols[4].AllowFiltering = C1.Win.C1FlexGrid.AllowFiltering.None;
}
注意:
ユーザーによるフィルタリングの許可は、設計時にスマートタグの C1FlexGrid タスク や Column タスク メニュー
からも設定できます。
任意の列でフィルタリングを禁止する場合は、AllowFiltering プロパティを None に設定します。
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
コードによりフィルタリングを適用する
グリッドの AllowFiltering プロパティを True に変更した上で、ConditionFilter を作成し、フィルタ条件を指定します。ま
482
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
た、ApplyFilters メソッドで作成したフィルタ条件をグリッドに適用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' グリッドのフィルタリングを有効にします
flex.AllowFiltering = True
' 新しいConditionFilterを作成します
Dim Filter = New C1.Win.C1FlexGrid.ConditionFilter()
' "C"で始まる要素を選択するフィルタを構成します
Filter.Condition1.Operator = C1.Win.C1FlexGrid.ConditionOperator.BeginsWith
Filter.Condition1.Parameter = "C"
' 新しいフィルタを"CustomerID"列に割り当てます
flex.Cols("CustomerID").Filter = Filter
' フィルタ条件を適用します
flex.ApplyFilters()
End Sub
483
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, " Customers ");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
}
private void button1_Click(object sender, EventArgs e)
{
// グリッドのフィルタリングを有効にします
flex.AllowFiltering = true;
// 新しいConditionFilterを作成します
C1.Win.C1FlexGrid.ConditionFilter Filter;
Filter = new C1.Win.C1FlexGrid.ConditionFilter();
// "C"で始まる要素を選択するフィルタを構成します
Filter.Condition1.Operator = C1.Win.C1FlexGrid.ConditionOperator.BeginsWith;
Filter.Condition1.Parameter = "C";
// 新しいフィルタを"CustomerID"列に割り当てます
flex.Cols["CustomerID"].Filter = Filter;
// フィルタ条件を適用します
flex.ApplyFilters();
}
注意:
任意の列でフィルタリングを禁止する場合は、AllowFiltering プロパティを None に設定します。
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
フィルタアイコンに独自のアイコンを表示する
フィルタが適用されている列のヘッダに表示されるフィルタアイコンは、Glyphs プロパティで、GlyphEnum.FilteredColumn
を指定して変更します。
【実行例】
484
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(0, 1) = "苗字"
flex(1, 1) = "山田"
flex(2, 1) = "川田"
flex(3, 1) = "尾田"
flex(4, 1) = "竹中"
flex(5, 1) = "皆藤"
flex(6, 1) = "北島"
flex(7, 1) = "小林"
' グリッドのフィルタリングを有効にします
flex.AllowFiltering = True
' 新しいConditionFilterを作成します
Dim Filter = New C1.Win.C1FlexGrid.ConditionFilter()
' "田"で終わる要素を選択するフィルタを構成します
Filter.Condition1.Operator = C1.Win.C1FlexGrid.ConditionOperator.EndsWith
Filter.Condition1.Parameter = "田"
' 新しいフィルタを1列目に割り当てます
flex.Cols(1).Filter = Filter
' フィルタ条件を適用します
flex.ApplyFilters()
' 独自のアイコンをフィルタアイコンに適用します
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.FilteredColumn) =
Image.FromFile("myBack.png")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
485
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex[0, 1] = "苗字";
flex[1, 1] = "山田";
flex[2, 1] = "川田";
flex[3, 1] = "尾田";
flex[4, 1] = "竹中";
flex[5, 1] = "皆藤";
flex[6, 1] = "北島";
flex[7, 1] = "小林";
// グリッドのフィルタリングを有効にします
flex.AllowFiltering = true;
// 新しいConditionFilterを作成します
C1.Win.C1FlexGrid.ConditionFilter Filter;
Filter = new C1.Win.C1FlexGrid.ConditionFilter();
// 田"で終わる要素を選択するフィルタを構成します
Filter.Condition1.Operator = C1.Win.C1FlexGrid.ConditionOperator.EndsWith;
Filter.Condition1.Parameter = "田";
// 新しいフィルタを1列目に割り当てます
flex.Cols["CustomerID"].Filter = Filter;
// フィルタ条件を適用します
flex.ApplyFilters();
// 独自のアイコンをフィルタアイコンに適用します
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.FilteredColumn] =
Image.FromFile("myBack.png");
}
注意:
注意:任意の列でフィルタリングを禁止する場合は、AllowFiltering プロパティを None に設定します。
フィルタボタンに独自のアイコンを表示する
フィルタエディタを起動するフィルタボタンは、Glyphs プロパティで、GlyphEnum.FilterEditor を指定して変更します。
【実行例】
486
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
' 独自のアイコンをフィルタボタンに適用します
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.FilterEditor) =
Image.FromFile("myNote.png")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, " Customers ");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
// 独自のアイコンをフィルタボタンに適用します
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.FilterEditor] =
Image.FromFile("myNote.png");
}
注意:
フィルタボタンは、ユーザーが列ヘッダ上にマウスポインタを動かしたときに、ヘッダ上に表示されます。
任意の列でフィルタリングを禁止する場合は、AllowFiltering プロパティを None に設定します。
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
ソート
ソートに関するタスクを紹介します。
487
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ユーザーによるソートを許可する
AllowSorting プロパティを AllowSortingEnum.SingleColumn(デフォルト) またはAllowSortingEnum.MultiColumn
に設定します。各列の AllowSorting プロパティを False にすることで、ユーザーが特定の列を基準にしたソートを不可にする
ことができます。
【実行例】
Visual Basic コードの書き方
Visual Basic
flex.AllowSorting = C1.Win.C1FlexGrid.AllowSortingEnum.SingleColumn
C# コードの書き方
C#
flex.AllowSorting = C1.Win.C1FlexGrid.AllowSortingEnum.SingleColumn;
注意:
注意:AllowSorting プロパティは、「C1FlexGrid タスク」や「Column タスク」からも設定できます。
関連項目
特定列でのソートを制限する
特定列でのソートを制限する
特定の列でソートを制限するには、デザイナまたはコードのいずれかで、AllowSorting プロパティを False に設定します。
【デザイナを使用する場合】
1. 編集するグリッドの列を選択します。その列の[列タスク
列タスク]メニューが開きます。
488
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
2. [ソートを有効にする
ソートを有効にする]チェックボックスをオフにします。
または、C1FlexGrid 列エディタを使用して
列エディタを使用して、AllowSorting プロパティを設定することができます。
3. C1FlexGrid 列エディタを開きます。C1FlexGrid 列エディタにアクセスする方法について詳しくは、「列エディタにアクセ
ス」を参照してください。
4. 右ペインから編集する列を選択し、左ペインで AllowSorting プロパティを False に設定します。
5. [OK]をクリックして、エディタを閉じます。
【コードを使用する場合】
次のコードを Form_Load イベントに追加して、[AtomicNumber]列のソートを制限します。
Visual Basic コードの書き方
Visual Basic
flex.Cols("AtomicNumber").AllowSorting = False
' 同じです: flex.Cols(1).AllowEditing = False
C# コードの書き方
C#
flex.Cols["AtomicNumber"].AllowSorting = false;
489
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// 同じです: flex.Cols[1].AllowEditing = false;
ソート順序について
連結モードと非連結モードでソート順序が異なります。
連結モード
連結モードの C1FlexGrid で列ヘッダをクリックされた際は、DataTable の DefaultView.Sort プロパティを設定した場合と同じ
ソート順序になります。DefaultView.Sort プロパティの詳細については、MSDN を参照してください。
非連結モード
非連結モードの C1FlexGrid におけるソート順序は、下記のようになります。
String.Compare メソッドに準拠
現在のカルチャを使用し、大文字と小文字は区別します。
非連結モードのソート例
ソート前
ソート後(昇順)
注意:
注意:カスタムソートを実装する方法については、SortNulls サンプルを参照してください。
ソート処理を無効にする
C1FlexGrid を連結モードで使用している場合は、グリッドのソート条件を消去(DefaultView.Sort プロパティに空文字を設
490
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
定)することで行ったソート処理を無効にします。ソート条件を消去した場合、グリッドの表示もソートされていない状態に戻りま
す(ソート条件のみをクリアし、グリッド上の表示順序は変更しないといった機能は用意されていません)。
注意:
注意:連結モードの C1FlexGrid では、一旦ソートを行うとソート条件がグリッドに残ります。そのため、ソートを行った
キー列のデータを変更した場合、編集終了後(ValidateEdit やAfterEdit イベントが発生した後)、他のセルにカレント
セルを移動した際などに、変更後のデータで再ソートされます。この動作は、FlexGrid for WinForms の仕様です。
1. DataTable を作成してグリッドに連結します。たとえば、次のコードを入力し、9人の顧客から成るテーブルを作成し
てC1FlexGrid に連結します。
Visual Basic コードの書き方
Visual Basic
Dim CustTable As DataTable
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
' DataTable を作成します。
CustTable = New DataTable("Customers")
' 列を DataTable に追加します。
CustTable.Columns.Add("顧客ID", GetType(Int32))
CustTable.Columns.Add("姓", GetType(String))
' 行を DataTable に追加します。
Dim CustRow As DataRow
For i As Integer = 1 To 9
CustRow = CustTable.NewRow()
CustRow(0) = i
CustRow(1) = "姓" & i.ToString()
CustTable.Rows.Add(CustRow)
Next
' DataTable に連結します。
flex.DataSource = CustTable
End Sub
C# コードの書き方
C#
DataTable CustTable;
private void Form1_Load(object sender, EventArgs e)
{
// DataTable を作成します。
CustTable = new DataTable("Customers");
// 列を DataTable に追加します。
CustTable.Columns.Add("顧客ID", typeof(Int32));
CustTable.Columns.Add("姓", typeof(string));
// 行を DataTable に追加します。
DataRow CustRow;
for (int i = 1; i <= 9; i++)
{
CustRow = CustTable.NewRow();
CustRow[0] = i;
CustRow[1] = "姓" + i.ToString();
CustTable.Rows.Add(CustRow);
491
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
// DataTable に連結します。
flex.DataSource = CustTable;
}
グリッドは次のような外観になります。
【実行例】
2. クリックされたときテーブルのソートを元に戻すボタンを作成します。次のコードを Button1_Click イベントに追加しま
す。
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles Button1.Click
CustTable.DefaultView.Sort = ""
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
CustTable.DefaultView.Sort = "";
}
注意:
注意:DataTable.DefaultView は DataTable の DataView を返します。ソート文字列を null に設定すると、DataView
は直前のソートを元に戻します。
【実行例】
「姓」列を降順にソートします。
492
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
〈ソートを元に戻す
ソートを元に戻す〉ボタンをクリックします。ソートは元に戻ります。
なお、(列ヘッダに表示されている)ソート方向を示すインジケータのみを消去したい場合は、ShowSort プロパティを False に
設定してアイコンを非表示にするか、ShowSortAt メソッドを使用します。ShowSort プロパティを False に設定した場合は、
再度ソートを行ってもアイコンは表示されなくなりますので、注意してください。非連結モードのグリッドでも使用可能です。
関連項目
インジケータを非表示にする
コードによりソートする
Sort メソッドを使用します。ソート方法は、SortFlags 列挙体
列挙体で指定します。複数のソート方法を同時に設定する場合は、Or
(C# では ”|”)を使用します。
493
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(1, 1) = "AAA"
flex(2, 1) = "bbb"
flex(3, 1) = "aaa"
flex(4, 1) = "BBB"
' 1列目をソート:降順、大文字と小文字を無視する
flex.Sort(C1.Win.C1FlexGrid.SortFlags.Descending Or
C1.Win.C1FlexGrid.SortFlags.IgnoreCase, 1)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 1] = "AAA";
flex[2, 1] = "bbb";
flex[3, 1] = "aaa";
flex[4, 1] = "BBB";
// 1列目をソート:降順、大文字と小文字を無視する
flex.Sort(C1.Win.C1FlexGrid.SortFlags.Descending
}
複数列のソートを実行する
複数列をソートするには、各列の Sort プロパティを設定し、Sort メソッドを使用して列設定に基づいてソートします。
494
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
1. Form_Load イベントに以下のコードを追加し、1列目の列を昇順で、2列目の列を降順でソートするように設定します。
Visual Basic コードの書き方
Visual Basic
flex.Cols(1).Sort = C1.Win.C1FlexGrid.SortFlags.Ascending
flex.Cols(2).Sort = C1.Win.C1FlexGrid.SortFlags.Descending
C# コードの書き方
C#
flex.Cols(1).Sort = C1.Win.C1FlexGrid.SortFlags.Ascending;
flex.Cols(2).Sort = C1.Win.C1FlexGrid.SortFlags.Descending;
2. 次の Sort メソッドを追加し、列1と列2の設定に基づいてソートします。
Visual Basic コードの書き方
Visual Basic
flex.Sort(C1.Win.C1FlexGrid.SortFlags.UseColSort, 1, 2)
C# コードの書き方
C#
flex.Sort(C1.Win.C1FlexGrid.SortFlags.UseColSort, 1, 2);
【実行例】
[Order Details]テーブル例
グリッドは、以下のように、1列目の列が昇順で、2列目列が降順でソートされた外観になります。この例では、グリッドはま
ず、OrderID 列に基づいて昇順ソートされ、次に、ProductID 列に基づいて降順ソートされます。
インジケータを明示的に表示する
495
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
列ヘッダ部分にソートインジケータを表示するには、ShowSortAt メソッドを使用します。
注意:
ShowSortAt メソッドを使用してソートインジケータを表示してもソートは実行されません。
ソートインジケータが表示されるのは1列のみです。複数列に対してインジケータを表示することはできません。
【実行例】
1列目にソートインジケータを表示(ソートは未実行)
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(1, 1) = "444"
flex(2, 1) = "222"
flex(3, 1) = "333"
flex(4, 1) = "111"
' 1列目に降順のソートインジケータを表示
' ソートは実行されません
flex.ShowSortAt(C1.Win.C1FlexGrid.SortFlags.Descending, 1)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 1] = "444";
flex[2, 1] = "222";
flex[3, 1] = "333";
496
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex[4, 1] = "111";
// 1列目に降順のソートインジケータを表示
// ソートは実行されません
flex.ShowSortAt(C1.Win.C1FlexGrid.SortFlags.Descending, 1);
}
インジケータを非表示にする
ShowSort プロパティを False に設定します。
注意:
注意:ShowSort プロパティを使用してソートインジケータを非表示にしてもソートは無効になりません。
【実行例】
ソートは実行されていますが、インジケータは非表示になります。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(1, 1) = "111"
flex(2, 1) = "222"
flex(3, 1) = "333"
flex(4, 1) = "444"
' 1列目をソート:降順
flex.Sort(C1.Win.C1FlexGrid.SortFlags.Descending, 1)
' ソートインジケータを非表示にする
flex.ShowSort = False
End Sub
C# コードの書き方
497
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 1] = "111";
flex[2, 1] = "222";
flex[3, 1] = "333";
flex[4, 1] = "444";
// 1列目をソート:降順
flex.Sort(C1.Win.C1FlexGrid.SortFlags.Descending, 1);
// ソートインジケータを非表示にする
flex.ShowSort = false;
}
インジケータに独自のアイコンを表示する
Glyphs プロパティで、昇順のインジケータはGlyphEnum.Ascending を、降順のインジケータはGlyphEnum.Descending
を指定して変更します。
【実行例】
降順のソートインジケータを変更
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex(1, 1) = "111"
flex(2, 1) = "222"
flex(3, 1) = "333"
flex(4, 1) = "444"
' 1列目をソート:降順
flex.Sort(C1.Win.C1FlexGrid.SortFlags.Descending, 1)
498
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 降順のインジケータを変更
flex.Glyphs(C1.Win.C1FlexGrid.GlyphEnum.Descending) = Image.FromFile("back.gif")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex[1, 1] = "111";
flex[2, 1] = "222";
flex[3, 1] = "333";
flex[4, 1] = "444";
// 1列目をソート:降順
flex.Sort(C1.Win.C1FlexGrid.SortFlags.Descending, 1);
// 降順のインジケータを変更
flex.Glyphs[C1.Win.C1FlexGrid.GlyphEnum.Descending] = Image.FromFile("back.gif");
}
データ連結
データ連結に関するタスクを紹介します。
非連結列を追加する
C1FlexGrid を連結モードで使用している場合、連結しているデータソースのデータがグリッドに表示されます。しかし、この場
合でもデータソースに存在しない列を使ってデータを表示したいことがあります。このような場合には、非連結列を使用します。
非連結列は、グリッドにデータソースを連結した後に、デザイン時またはコードにより追加します。非連結列のデータは連結し
ているデータソースにないため、GetUnboundValue イベントやOwnerDrawCell イベントを使用して非連結列にデータを表
示する必要ガあります。
注意:
非連結列の使用方法については、UnboundColumnsサンプル
サンプルも参照してください。
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Employees テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
【実行例】 Employees テーブル
499
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT FirstName, LastName FROM Employees"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Employees")
' グリッドに接続します
flex.DataSource = ds.Tables("Employees")
' 非連結列を追加
Dim col As C1.Win.C1FlexGrid.Column = flex.Cols.Add()
col.Name = "FullName"
col.Caption = "FullName(Unbound)"
' 変更を許可しません
col.AllowEditing = False
flex.AutoSizeCol(3)
End Sub
Private Sub flex_GetUnboundValue(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.UnboundValueEventArgs) Handles flex.GetUnboundValue
If e.Row >= flex.Rows.Fixed Then
' "FullName"列(非連結列)の値を設定します
If flex.Cols(e.Col).Name = "FullName" Then
e.Value = flex(e.Row, "FirstName") + " " + flex(e.Row, "LastName")
End If
End If
End Sub
C# コードの書き方
500
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT FirstName, LastName FROM Employees";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Employees");
// グリッドに接続します
flex.DataSource = ds.Tables["Employees"];
// 非連結列を追加
C1.Win.C1FlexGrid.Column col = flex.Cols.Add();
col.Name = "FullName";
col.Caption = "FullName(Unbound)";
// 変更を許可しません
col.AllowEditing = false;
flex.AutoSizeCol(3);
}
private void flex_GetUnboundValue(object sender,
C1.Win.C1FlexGrid.UnboundValueEventArgs e)
{
if(e.Row >= flex.Rows.Fixed)
{
// "FullName"列(非連結列)の値を設定します
if(flex.Cols[e.Col].Name == "FullName")
{
e.Value = flex[e.Row, "FirstName"] + " " + flex[e.Row, "LastName"];
}
}
}
非連結列の入力を許可する
ユーザーに非連結列の入力(更新)を許可する場合、SetUnboundValue イベントでユーザーが非連結列に入力(更新)した
データを取得し、GetUnboundValue イベントで更新されたデータを表示する必要があります。下記のサンプルコードでは、
HashTable オブジェクトを使用して非連結列に表示するデータを保持しています。
注意:
注意:非連結列の使用方法については、UnboundColumnsサンプル
サンプルも参照してください。
【実行例】
501
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
' 非連結列の値を保持する Hashtable
Dim _hash As New Hashtable()
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' DataTableオブジェクトを作成
Dim dt As New DataTable()
dt.Columns.Add("背番号", GetType(Integer))
dt.Columns.Add("選手名", GetType(String))
Dim dtRow As DataRow
dtRow = dt.NewRow
dtRow("背番号") = 10
dtRow("選手名") = "財前"
dt.Rows.Add(dtRow)
' DataTableを連結(連結モード)
flex.DataSource = dt
flex.AllowAddNew = True
' 非連結列を追加
Dim col As C1.Win.C1FlexGrid.Column = flex.Cols.Add()
col.Name = "得点"
col.Caption = "得点(Unbound)"
' 非連結列に表示する初期値
_hash(10) = "11"
End Sub
' "背番号"の値をキーにして、
' Hashtable からデータを取得し、非連結列に表示
Private Sub flex_GetUnboundValue(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.UnboundValueEventArgs) Handles flex.GetUnboundValue
Dim drv As DataRowView = CType(flex.Rows(e.Row).DataSource, DataRowView)
e.Value = _hash(drv("背番号"))
End Sub
' "背番号"の値をキーにして、
502
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 非連結列上に表示されているデータを Hashtable に保存
Private Sub flex_SetUnboundValue(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.UnboundValueEventArgs) Handles flex.SetUnboundValue
Dim drv As DataRowView = CType(flex.Rows(e.Row).DataSource, DataRowView)
_hash(drv("背番号")) = e.Value
End Sub
C# コードの書き方
C#
// 非連結列の値を保持する Hashtable
System.Collections.Hashtable _hash = new System.Collections.Hashtable();
private void Form1_Load(object sender, EventArgs e)
{
// DataTableオブジェクトを作成
DataTable dt = new DataTable();
dt.Columns.Add("背番号", typeof(int));
dt.Columns.Add("選手名", typeof(string));
DataRow dtRow;
dtRow = dt.NewRow();
dtRow["背番号"] = 10;
dtRow["選手名"] = "財前";
dt.Rows.Add(dtRow);
// DataTableを連結(連結モード)
flex.DataSource = dt;
flex.AllowAddNew = true;
// 非連結列を追加
C1.Win.C1FlexGrid.Column col = flex.Cols.Add();
col.Name = col.Caption = "得点";
// 非連結列に表示する初期値
_hash[10] = "11";
}
// "背番号"の値をキーにして、
// Hashtable からデータを取得し、非連結列に表示
private void flex_GetUnboundValue(object sender,
C1.Win.C1FlexGrid.UnboundValueEventArgs e)
{
DataRowView drv = (DataRowView)flex.Rows[e.Row].DataSource;
e.Value = _hash[drv["背番号"]];
}
// "背番号"の値をキーにして、
// 非連結列上に表示されているデータを Hashtable に保存
private void flex_SetUnboundValue(object sender,
C1.Win.C1FlexGrid.UnboundValueEventArgs e)
{
DataRowView drv = (DataRowView)flex.Rows[e.Row].DataSource;
_hash[drv["背番号"]] = e.Value;
}
固定列にデータを表示する
503
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1FlexGrid を連結(バウンド)モードで使用する場合、固定列に特定のフィールドを連結して表示する機能は用意されていま
せん。連結しているデータは、通常の列から表示されます。そのため、下記2通りの方法で対応してください。
注意:
注意:サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
固定列にデータをコピーする
固定列にデータをコピーして対応します。例えば、グリッドの固定列が1でデータソースと連結している場合、連結後に1列目
(データソースの最初の列)の値を0列目(固定列)にコピーします。また、コピーした1列目は非表示にすることで固定列が連結
されているように表示されます。
【実行例 Customers テーブル
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' 連結モード
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
' 固定列に表示したいデータをコピーします
For i As Integer = 0 To flex.Rows.Count - 1
flex(i, 0) = flex(i, 1)
504
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Next
' 固定列に表示した列は非表示
flex.Cols(1).Visible = False
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// 連結モード
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
// 固定列に表示したいデータをコピーします
for (int i = 0; i < flex.Rows.Count; i++)
{
flex[i, 0] = flex[i, 1];
}
// 固定列に表示した列は非表示
flex.Cols[1].Visible = false;
}
静止列を使用する
固定列の代わりに静止列を使用します。スタイルを固定列と同様にすることで静止列を固定列のように使用します。
【実行例 Customers テーブル
505
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' 連結モード
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
' 固定列は0
flex.Cols.Fixed = 0
' 静止列を使用
flex.Cols.F2rozen = 1
' 編集を不可に設定
flex.Cols(0).AllowEditing = False
' 静止セルのスタイルを設定
flex.Styles.Frozen.BackColor = flex.Styles.Fixed.BackColor
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
506
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// 連結モード
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
// 固定列は0
flex.Cols.Fixed = 0;
// 静止列を使用
flex.Cols.Frozen = 1;
// 編集を不可に設定
flex.Cols[0].AllowEditing = false;
// 静止セルのスタイルを設定
flex.Styles.Frozen.BackColor = flex.Styles.Fixed.BackColor;
}
フィールドにビットマップイメージを表示する
ビットマップイメージ(OLE オブジェクト型)のフィールド連結時にイメージを表示させたい場合は、バイト配列であるデータを適
切に処理したうえでオーナー描画の機能を使用して表示する必要があります。
注意:
ビットマップイメージの表示方法については、DBImagesサンプル
サンプルも参照してください。
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Employees テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
MemoryStream クラスなどの詳細は、MSDN を参照してください。
【実行例】 Employees テーブル
Visual Basic コードの書き方
507
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT Photo, FirstName, LastName, Country, City, Address
FROM Employees"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Employees")
' グリッドに接続します
flex.DataSource = ds.Tables("Employees")
' "Photo"列を表示し、編集不可に設定します
flex.Cols("Photo").Visible = True
flex.Cols("Photo").AllowEditing = False
flex.Cols("Photo").ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.Scale
' 画像を表示するために、行の高さなどを調整します
Dim hei As Integer = flex.Rows.DefaultSize
flex.Rows.DefaultSize = hei * 4
flex.Rows(0).Height = hei
flex.Cols(0).Width = 20
flex.Cols(1).Width = 60
' OwnerDrawCellイベントを発生させます
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw
End Sub
Private Sub flex_OwnerDrawCell(ByVal sender As Object, ByVal e As
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs) Handles flex.OwnerDrawCell
If e.Row >= flex.Rows.Fixed Then
' "Photo"列:画像はバイト配列としてデータベースに格納されています
If flex.Cols(e.Col).Name = "Photo" Then
' 画像をロードします
e.Image = LoadImage(flex(e.Row, e.Col))
' 画像を取得できた場合は、TextはNullにします
If Not (e.Image Is Nothing) Then
e.Text = Nothing
End If
End If
End If
End Sub
Function LoadImage(ByVal picData() As Byte) As Image
' オブジェクトを確認します
Const bmData As Integer = 78
If picData Is Nothing Or picData.Length < bmData + 2 Then
Return Nothing
End If
If picData(0) <> &H15 Or picData(1) <> &H1C Then
Return Nothing
End If
' Bitmapのみを処理します
' 画像をロードします
508
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Dim img As Image = Nothing
Try
Dim ms As New IO.MemoryStream(picData, bmData, picData.Length - bmData)
img = Image.FromStream(ms)
Catch
End Try
Return img
End Function
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT Photo, FirstName, LastName, Country, City, Address FROM
Employees";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Employees");
// グリッドに接続します
flex.DataSource = ds.Tables["Employees"];
// "Photo"列を表示し、編集不可に設定します
flex.Cols["Photo"].Visible = true;
flex.Cols["Photo"].AllowEditing = false;
flex.Cols["Photo"].ImageAlign = C1.Win.C1FlexGrid.ImageAlignEnum.Scale;
// 画像を表示するために、行の高さなどを調整します
int hei = flex.Rows.DefaultSize;
flex.Rows.DefaultSize = hei * 4;
flex.Rows[0].Height = hei;
flex.Cols[0].Width = 20;
flex.Cols[1].Width = 60;
// OwnerDrawCellイベントを発生させます
flex.DrawMode = C1.Win.C1FlexGrid.DrawModeEnum.OwnerDraw;
}
private void flex_OwnerDrawCell(object sender,
C1.Win.C1FlexGrid.OwnerDrawCellEventArgs e)
{
if (e.Row >= flex.Rows.Fixed)
{
// "Photo"列:画像はバイト配列としてデータベースに格納されています
if (flex.Cols[e.Col].Name == "Photo")
{
// 画像をロードします
e.Image = LoadImage(flex[e.Row, e.Col] as byte[]);
// 画像を取得できた場合は、TextはNullにします
if (e.Image != null) e.Text = null;
}
}
509
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
Image LoadImage(byte[] picData)
{
// オブジェクトを確認します
const int bmData = 78;
if (picData == null || picData.Length < bmData + 2) return null;
if (picData[0] != 0x15 |
// Bitmap のみを処理します
if (picData[bmData] != 'B' |
// 画像をロードします
Image img = null;
try
{
System.IO.MemoryStream ms = new System.IO.MemoryStream(picData, bmData,
picData.Length - bmData);
img = Image.FromStream(ms);
}
catch { }
return img;
}
自動で列幅を調整する
グリッドとデータソースを連結する前に、C1FlexGridBase.AutoResize プロパティを True (デフォルト)に設定します。
AutoResize プロパティは、データのロード時に列幅を自動的に調節するかどうかを決定します。
注意:
注意:サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
【実行例】 Customers テーブル 列幅の自動調整
【実行例】 Customers テーブル 列幅の自動調整なし
510
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' 列幅の自動調節機能を使用
flex.AutoResize = True
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// 列幅の自動調節機能を使用
511
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.AutoResize = true;
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
}
印刷
印刷に関するタスクを紹介します。
印刷(プレビュー)を実行する
PrintGrid メソッドを使用します。印刷プレビューを表示する場合は、引数に PrintGridFlags.ShowPreviewDialog を指定し
ます。複数の印刷オプションを同時に設定する場合は、Or (C# では ”|”)を使用します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 印刷プレビュー+FitToPage
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog
Or C1.Win.C1FlexGrid.PrintGridFlags.FitToPage)
End Sub
C# コードの書き方
C#
512
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
private void button1_Click(object sender, EventArgs e)
{
// 印刷プレビュー+FitToPage
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog
}
ページ範囲を指定して印刷する
PrintRange プロパティに SomePages を設定した上で、FromPage/
/ToPage プロパティを設定します。
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 2ページ目から3ページ目を印刷
With flex.PrintParameters.PrintDocument.PrinterSettings
.PrintRange = Printing.PrintRange.SomePages
.MaximumPage = Short.MaxValue
.MinimumPage = 1
.FromPage = 2
.ToPage = 3
End With
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 2ページ目から3ページ目を印刷
flex.PrintParameters.PrintDocument.PrinterSettings.PrintRange =
System.Drawing.Printing.PrintRange.SomePages;
flex.PrintParameters.PrintDocument.PrinterSettings.MaximumPage = short.MaxValue;
flex.PrintParameters.PrintDocument.PrinterSettings.MinimumPage = 1;
flex.PrintParameters.PrintDocument.PrinterSettings.FromPage = 2;
flex.PrintParameters.PrintDocument.PrinterSettings.ToPage = 3;
flex.PrintGrid("TEST", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog);
}
注意:
注意:PrintRange や FromPage/ToPage プロパティの詳細は、MSDN を参照してください。
印刷ページの余白を設定する
PrintGrid メソッドにて印刷を行う前に、DefaultPageSettings.Margins プロパティを使用してマージンを設定しま
す。Margins クラスは、.NET Framework の Margins クラスと同様になりますので、各余白を 1/100 インチ単位で取得または
設定します。
【実行例】
513
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 印刷マージンを設定します(1.5インチ)。
With flex.PrintParameters.PrintDocument.DefaultPageSettings
.Margins.Top = 150
.Margins.Bottom = 150
'.Margins = New System.Drawing.Printing.Margins(100, 100, 150, 150)
End With
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog
Or _
C1.Win.C1FlexGrid.PrintGridFlags.ShowPageSetupDialog)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 印刷マージンを設定します(1.5インチ)。
flex.PrintParameters.PrintDocument.DefaultPageSettings.Margins.Top = 150;
flex.PrintParameters.PrintDocument.DefaultPageSettings.Margins.Bottom = 150;
//flex.PrintParameters.PrintDocument.DefaultPageSettings.Margins =
//new System.Drawing.Printing.Margins(100, 100, 150, 150);
flex.PrintGrid("TEST", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog |
514
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1.Win.C1FlexGrid.PrintGridFlags.ShowPageSetupDialog);
}
注意:
注意:Margins クラスの詳細は、MSDN を参照してください。
印刷ヘッダ/フッタを設定する
印刷ヘッダ/フッタは、PrintGrid メソッドの引数で指定します。
また、印刷ヘッダおよびフッタ文字列は、タブ記号で左右位置(左揃え、中央揃え、右揃え)を、改行コードで行を設定します。設
定する順番に注意してください。まず、左揃えにしたい行を設定します。改行コードを設定することで任意の行を左揃えに設定
できます。次に、タブ記号を追加し、中央揃えにしたい行を設定します。中央揃えにしたい行も改行コードを設定することで任
意の行を中央揃えに設定できます。最後に、タブ記号をもう1つ追加し、右揃えにしたい行を設定します。同様に改行コードを
設定することで任意の行を右揃えに設定することが可能です。
フォントは、PrintParameters.HeaderFont/
/FooterFont プロパティで変更します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
flex.PrintGrid("C1FlexGrid", _
C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog, _
vbCrLf + "2行目(ヘッダ左揃え)" + _
vbTab + "1行目(ヘッダ中央揃え)" + _
vbCrLf + vbCrLf + vbCrLf + "4行目(ヘッダ中央揃え)" + _
vbTab + vbCrLf + vbCrLf + "3行目(ヘッダ右揃え)", _
vbCrLf + "2行目(フッタ左揃え)" + _
515
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
vbTab + "1行目(フッタ中央揃え)" + _
vbTab + vbCrLf + vbCrLf + "3行目(フッタ右揃え)")
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
flex.PrintGrid("C1FlexGrid",
C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog,
"\n" + "2行目(ヘッダ左揃え)" +
"\t" + "1行目(ヘッダ中央揃え)" +
"\n" + "\n" + "\n" + "4行目(ヘッダ中央揃え)" +
"\t" + "\n" + "\n" + "3行目(ヘッダ右揃え)",
"\n" + "2行目(フッタ左揃え)" +
"\t" + "1行目(フッタ中央揃え)" +
"\t" + "\n" + "\n" + "3行目(フッタ右揃え)");
}
印刷フッタにページ番号を出力する
現在のページ番号とページ総数は、プレースホルダ({0} と {1})を使用して出力します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
516
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 印刷ヘッダ/フッタのフォント変更
flex.PrintParameters.HeaderFont = New Font("メイリオ", 14, FontStyle.Bold)
flex.PrintParameters.FooterFont = New Font("メイリオ", 20, FontStyle.Italic)
' フッタにページ番号/ページ総数を表示
flex.PrintGrid("C1FlexGrid", _
C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog, _
"ヘッダ", vbTab + "ページ {0} / {1}")
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 印刷ヘッダ/フッタのフォント変更
flex.PrintParameters.HeaderFont = new Font("メイリオ", 14, FontStyle.Bold);
flex.PrintParameters.FooterFont = new Font("メイリオ", 20, FontStyle.Italic);
// フッタにページ番号/ページ総数を表示
flex.PrintGrid("C1FlexGrid",
C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog,
"ヘッダ", "\t" + "ページ {0} / {1}");
}
ページごとに印刷ヘッダ(フッタ)を設定する
PrintPage イベントを使用して、GridPrinterHeader(GridPrinterFooter)プロパティを動的に変更することで、ページごとに印
刷ヘッダ(フッタ)を変更することができます。PrintPage イベントは「グリッドがページの出力を終了した後に発生」するた
め、PrintPage イベントで設定したヘッダやフッタは次のページに反映される点に注意してください。
【実行例】
Visual Basic コードの書き方
Visual Basic
517
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 印刷ヘッダの設定(1ページ目はこの設定で印刷される)
flex.PrintParameters.Header = "ページヘッダ:印刷1枚目"
flex.PrintParameters.HeaderFont = New Font("メイリオ", 10)
flex.PrintParameters.Footer = "Page {0} of {1}"
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog)
End Sub
' 1ページ目が印刷された後、以降繰り返し発生
Private Sub flex_PrintPage(ByVal sender As Object, ByVal e As
System.Drawing.Printing.PrintPageEventArgs) Handles flex.PrintPage
' ヘッダを動的に変更
Dim gp As C1.Win.C1FlexGrid.GridPrinter
gp = flex.PrintParameters
gp.Header = "ページヘッダ:印刷" & gp.PageNumber + 1 & "枚目"
Select Case gp.PageNumber
Case 1
gp.HeaderFont = New Font("メイリオ", 10, FontStyle.Bold)
Case 2
gp.HeaderFont = New Font("メイリオ", 10, FontStyle.Italic)
Case Else
gp.HeaderFont = New Font("メイリオ", 10, FontStyle.Underline)
End Select
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 印刷ヘッダの設定(1ページ目はこの設定で印刷される)
flex.PrintParameters.Header = "ページヘッダ:印刷1枚目";
flex.PrintParameters.HeaderFont = new Font("MS ゴシック", 10);
flex.PrintParameters.Footer = "Page {0} of {1}";
flex.PrintGrid("TEST", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog);
}
// 1ページ目が印刷された後、以降繰り返し発生
private void flex_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs
e)
{
// ヘッダを動的に変更
C1.Win.C1FlexGrid.GridPrinter gp;
gp = flex.PrintParameters;
gp.Header = "ページヘッダ:印刷" + (gp.PageNumber + 1) + "枚目";
switch (gp.PageNumber)
{
case 1:
gp.HeaderFont = new Font("MS ゴシック", 10, FontStyle.Bold);
break;
case 2:
gp.HeaderFont = new Font("MS ゴシック", 10, FontStyle.Italic);
break;
518
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
default:
gp.HeaderFont = new Font("MS ゴシック", 10, FontStyle.Underline);
break;
}
}
用紙サイズを指定する
コードから印刷する用紙サイズを設定する場合は、PrintDocument クラスを使用します。PrintDocument クラスは .NET
Framework の一部で、System.Drawing.Printing 名前空間で定義され、このクラスには、文書のページ設定およびプリンタ設
定を指定するプロパティが含まれます。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
Dim flag As Boolean = False
Dim paperSize As System.Drawing.Printing.PaperSize
With flex.PrintParameters.PrintDocument
For Each paperSize In .PrinterSettings.PaperSizes
' 印刷可能な用紙サイズを確認
Debug.WriteLine(paperSize)
If paperSize.Kind = Printing.PaperKind.B4 Then
519
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 用紙サイズを指定します
.DefaultPageSettings.PaperSize = paperSize
' 横向きにします
.DefaultPageSettings.Landscape = True
flag = True
End If
Next
End With
If flag = True Then
Debug.WriteLine("指定の用紙がありました。")
Else
Debug.WriteLine("指定の用紙がありませんでした。")
End If
' 印刷プレビュー + ページ設定ダイアログ
flex.PrintGrid("C1FlexGrid", _
C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog Or _
C1.Win.C1FlexGrid.PrintGridFlags.ShowPageSetupDialog)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
bool flag = false;
foreach (System.Drawing.Printing.PaperSize paperSize
in flex.PrintParameters.PrintDocument.PrinterSettings.PaperSizes)
{
// 印刷可能な用紙サイズを確認
Console.WriteLine(paperSize);
if (paperSize.Kind == System.Drawing.Printing.PaperKind.B4)
{
// 用紙サイズを指定します
flex.PrintParameters.PrintDocument
.DefaultPageSettings.PaperSize = paperSize;
// 横向きにします
flex.PrintParameters.PrintDocument
.DefaultPageSettings.Landscape = true;
flag = true;
}
}
if (flag == true)
{
Console.WriteLine("指定の用紙がありました。");
}
else
{
Console.WriteLine("指定の用紙がありませんでした。");
}
// 印刷プレビュー + ページ設定ダイアログ
flex.PrintGrid("C1FlexGrid",
C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog |
520
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C1.Win.C1FlexGrid.PrintGridFlags.ShowPageSetupDialog);
}
注意:
注意:PrintDocument クラス(System.Drawing.Printing)の詳細は、MSDN を参照してください。
コントロールの境界線を表示せずに印刷する
組み込みスタイルEmptyArea の境界線のスタイルを None に設定します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 印刷時のグリッドの枠線を非表示
flex.Styles.EmptyArea.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.None
' 印刷プレビュー
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog)
' グリッドの枠線を元に戻します
flex.Styles.EmptyArea.Clear(C1.Win.C1FlexGrid.StyleElementFlags.Border)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 印刷時のグリッドの枠線を非表示
flex.Styles.EmptyArea.Border.Style = C1.Win.C1FlexGrid.BorderStyleEnum.None;
// 印刷プレビュー
521
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog);
// グリッドの枠線を元に戻します
flex.Styles.EmptyArea.Clear(C1.Win.C1FlexGrid.StyleElementFlags.Border);
}
印刷プレビュー画面を最大化して表示する
WindowState プロパティを Maximized に設定することで、印刷プレビュー画面を最大化して表示します。(Minimized に設
定した場合は最小化して表示)
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 最大化
flex.PrintParameters.PrintPreviewDialog.WindowState = FormWindowState.Maximized
' 印刷プレビューを表示
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 最大化
flex.PrintParameters.PrintPreviewDialog.WindowState = FormWindowState.Maximized;
// 印刷プレビューを表示
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog);
}
注意:
注意:WindowState プロパティの詳細は、MSDN を参照してください。
印刷プレビュー画面をカスタマイズする
C1FlexGrid における印刷処理は独自のものではなく、.NET Framework によって提供されている各印刷処理を用いてその機
能を実現しています。そのため、PrintPreviewDialog プロパティからグリッドの印刷プレビューの表示に使用される
PrintPreviewDialog への参照を取得し各設定を変更することで、カスタマイズした印刷プレビュー画面を表示できます。
【実行例】 デフォルト
522
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
【実行例】 カスタマイズ
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 印刷プレビューに使用するPrintPreviewDialogを取得
Dim pi As PrintPreviewDialog = flex.PrintParameters.PrintPreviewDialog
' キャプションを設定
pi.Text = "カスタマイズされたプレビュー画面"
' Iconを変更
Dim.png As Bitmap = Image.FromFile("printer.gif")
pi.Icon = System.Drawing.Icon.FromHandle.png.GetHicon())
' 各プロパティを変更します
Dim ts As ToolStrip = pi.Controls(1)
ts.BackColor = Color.LemonChiffon
ts.ForeColor = Color.Blue
ts.Items(0).Visible = False
523
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
ts.Items(1).Text = "拡大/縮小"
ts.Items(1).TextAlign = ContentAlignment.BottomCenter
ts.Items(3).Visible = False
ts.Items(4).Visible = False
ts.Items(5).Visible = False
ts.Items(9).Text = "終わり"
ts.Items(9).BackColor = Color.Cyan
ts.Items(11).Text = "頁"
' 印刷プレビュー
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// 印刷プレビューに使用するPrintPreviewDialogを取得
PrintPreviewDialog pi = flex.PrintParameters.PrintPreviewDialog;
// キャプションを設定
pi.Text = "カスタマイズされたプレビュー画面";
// Iconを変更
Bitmap.png = (Bitmap)Image.FromFile("printer.gif");
pi.Icon = System.Drawing.Icon.FromHandle.png.GetHicon());
// 各プロパティを変更します
ToolStrip ts = (ToolStrip)pi.Controls[1];
ts.BackColor = Color.LemonChiffon;
ts.ForeColor = Color.Blue;
ts.Items[0].Visible = false;
ts.Items[1].Text = "拡大/縮小";
ts.Items[1].TextAlign = ContentAlignment.BottomCenter;
ts.Items[3].Visible = false;
ts.Items[4].Visible = false;
ts.Items[5].Visible = false;
ts.Items[9].Text = "終わり";
ts.Items[9].BackColor = Color.Cyan;
ts.Items[11].Text = "頁";
// 印刷プレビュー
flex.PrintGrid("C1FlexGrid", C1.Win.C1FlexGrid.PrintGridFlags.ShowPreviewDialog);
}
注意:
注意:PrintPreviewDialog クラス(System.Windows.Forms)の詳細は、MSDN を参照してください。
複数のグリッドを印刷する
出力するグリッドごとに1つの PrintDocumentGridRenderer を作成します。また、ドキュメントのイベントを処理し
て、CurrentPage プロパティの値がPageCount プロパティの値に等しくなるまでレンダラのPrintPage イベントを呼び出しま
す。以下は、フォームに配置されている2つのグリッドを単一の PrintDocument にレンダリングする例です。
【実行例】
524
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private _g1, _g2 As C1.Win.C1FlexGrid.PrintDocumentGridRenderer
Private printDocument1 As Printing.PrintDocument
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex1(1, 1) = "グリッド1"
flex1.Styles.Normal.BackColor = Color.AliceBlue
flex2(1, 1) = "グリッド2"
flex2.Styles.Normal.BackColor = Color.YellowGreen
' PrintDocumentを生成し、イベントハンドラを追加
Me.printDocument1 = New Printing.PrintDocument
AddHandler printDocument1.BeginPrint, AddressOf printDocument1_BeginPrint
525
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
AddHandler printDocument1.PrintPage, AddressOf printDocument1_PrintPage
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 印刷プレビューダイアログを表示
Using dlg As New PrintPreviewDialog()
dlg.Document = Me.printDocument1
dlg.ShowDialog(Me)
End Using
End Sub
Private Sub printDocument1_BeginPrint(ByVal sender As System.Object, ByVal e As
System.Drawing.Printing.PrintEventArgs)
' 1つ目のグリッドのレンダラを作成し、印刷オプションを設定
_g1 = New C1.Win.C1FlexGrid.PrintDocumentGridRenderer(flex1)
_g1.Options = C1.Win.C1FlexGrid.PrintGridFlags.FitToPageWidth
' 2つ目のグリッドのレンダラを作成し、印刷オプションを設定
_g2 = New C1.Win.C1FlexGrid.PrintDocumentGridRenderer(flex2)
_g2.Options = C1.Win.C1FlexGrid.PrintGridFlags.FitToPageWidth
End Sub
Private Sub printDocument1_PrintPage(ByVal sender As System.Object, ByVal e As
System.Drawing.Printing.PrintPageEventArgs)
' 印刷ヘッダの表示
Dim fnt As Font = New Font(Control.DefaultFont.FontFamily, 10.0F,
FontStyle.Regular)
e.Graphics.DrawString("複数グリッドの印刷", fnt, Brushes.Black, 50, 50)
If (_g1.CurrentPage < _g1.PageCount) Then
' 1つ目のグリッドをレンダリングします
_g1.PrintPage(e)
e.HasMorePages = True
ElseIf (_g2.CurrentPage < _g2.PageCount) Then
' 2つ目のグリッドをレンダリングします
_g2.PrintPage(e)
e.HasMorePages = _g2.CurrentPage < _g2.PageCount
End If
End Sub
C# コードの書き方
C#
private C1.Win.C1FlexGrid.PrintDocumentGridRenderer _g1, _g2;
private System.Drawing.Printing.PrintDocument printDocument1;
private void Form1_Load(object sender, EventArgs e)
{
flex1[1, 1] = "グリッド1";
flex1.Styles.Normal.BackColor = Color.AliceBlue;
flex2[1, 1] = "グリッド2";
flex2.Styles.Normal.BackColor = Color.YellowGreen;
// PrintDocumentを生成し、イベントハンドラを追加
this.printDocument1 = new System.Drawing.Printing.PrintDocument();
printDocument1.BeginPrint += new
System.Drawing.Printing.PrintEventHandler(printDocument1_BeginPrint);
printDocument1.PrintPage += new
526
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
System.Drawing.Printing.PrintPageEventHandler(printDocument1_PrintPage);
}
private void button1_Click(object sender, EventArgs e)
{
// 印刷プレビューダイアログを表示
using (PrintPreviewDialog dlg = new PrintPreviewDialog())
{
dlg.Document = this.printDocument1;
dlg.ShowDialog(this);
}
}
void printDocument1_BeginPrint(object sender, System.Drawing.Printing.PrintEventArgs
e)
{
// 1つ目のグリッドのレンダラを作成し、印刷オプションを設定
_g1 = new C1.Win.C1FlexGrid.PrintDocumentGridRenderer(flex1);
_g1.Options = C1.Win.C1FlexGrid.PrintGridFlags.FitToPageWidth;
// 2つ目のグリッドのレンダラを作成し、印刷オプションを設定
_g2 = new C1.Win.C1FlexGrid.PrintDocumentGridRenderer(flex2);
_g2.Options = C1.Win.C1FlexGrid.PrintGridFlags.FitToPageWidth;
}
void printDocument1_PrintPage(object sender,
System.Drawing.Printing.PrintPageEventArgs e)
{
// 1つ目のグリッドをレンダリングします
if (_g1.CurrentPage < _g1.PageCount)
{
_g1.PrintPage(e);
e.HasMorePages = true;
}
// 2つ目のグリッドをレンダリングします
else if (_g2.CurrentPage < _g2.PageCount)
{
_g2.PrintPage(e);
e.HasMorePages = _g2.CurrentPage < _g2.PageCount;
}
}
注意:
複数のグリッドを同一ページ内に印刷することはできません。
PrintDocument クラス(System.Drawing.Printing)や PrintPreviewDialog クラス(System
ファイル入出力
ファイル入出力に関するタスクを紹介します。
Excel ファイルの保存とロード
グリッドの内容を Excel ファイルに保存するには、SaveExcel メソッド、またはSaveGrid メソッドを使用します。
Excel ファイルの内容をグリッドにロードするには、LoadExcel メソッド、またはLoadGrid メソッドを使用します。
527
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
使用できるオプション(FileFlags 列挙体
列挙体)は以下のとおりです。
FileFlags 列挙体
説明
AsDisplayed
表示された状態の値をファイルに保存します(書式設定とマッピングがある場合はそれらを含む)。
IncludeFixedCells
ファイルの保存またはロード時に固定セルを含めます。
IncludeMergedRanges SaveExcel/LoadExcel メソッドを使用したファイルの保存/ロード時にマージ状態を含めます。
LoadMergedRanges
LoadExcel メソッドを使用したファイルのロード時にマージ状態を含めます。
NoFreezing
SaveExcel/LoadExcel メソッドを使用したファイルの保存/ロード時に行と列をフリーズしませ
ん。
None
デフォルトの設定を使用してファイルの保存とロードを行います。
OpenXm
ファイルを OpenXml(Office 2007)フォーマットで読み込むか、または保存します。
SaveMergedRanges
SaveExcel メソッドを使用したファイルの保存時にマージ状態を含めます。
SelectedRowsOnly
選択されている行だけをファイルに保存します。
VisibleOnly
表示されている行と列だけをファイルに保存します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
528
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' 保存ファイル名:flex.xls
' 保存シート名:Customers
' オプション:保存時に固定セルを含める
flex.SaveExcel("flex.xls", "Customers",
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells)
MessageBox.Show("ファイルを保存しました")
End Sub
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button2.Click
' バウンドモード時、Excel ファイルからのロードはできません
flex.DataSource = Nothing
' ロードするファイル名:flex.xls
' ロードするシート名:Customers
' オプション:ロード時に固定セルを含める
flex.LoadExcel("flex.xls", "Customers",
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells)
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
}
private void button1_Click(object sender, EventArgs e)
{
// 保存ファイル名:flex.xls
// 保存シート名:Customers
// オプション:保存時に固定セルを含める
flex.SaveExcel("flex.xls", "Customers",
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells);
MessageBox.Show("ファイルを保存しました");
}
private void button2_Click(object sender, EventArgs e)
{
529
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// バウンドモード時、Excel ファイルからのロードはできません
flex.DataSource = null;
// ロードするファイル名:flex.xls
// ロードするシート名:Customers
// オプション:ロード時に固定セルを含める
flex.LoadExcel("flex.xls", "Customers",
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells);
}
注意:
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
Excel ファイルへの保存時、イメージやデータマップ、およびセルボーダーなどの特性は保存されません。
Excel ファイルからのロード時、イメージやセルボーダー、計算式などの特性はロードされません。
バウンドモード時、Excel ファイルからのロードはできません。実行すると例外が発生します。
XMLファイルの保存とロード
ファイルの保存とロード
WriteXml/ReadXml メソッドを使用します。
ReadXml/WriteXml メソッドによる XML ドキュメントの入出力では、データ以外にもプロパティやスタイルなどのグリッド設
定も対象になります。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
530
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
flex.WriteXml("flex.xml")
MessageBox.Show("ファイルを保存しました")
End Sub
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button2.Click
flex.ReadXml("flex.xml")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
}
private void button1_Click(object sender, EventArgs e)
{
flex.WriteXml("flex.xml");
MessageBox.Show("ファイルを保存しました");
}
private void button2_Click(object sender, EventArgs e)
{
flex.ReadXml("flex.xml");
}
注意:
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
保存される XML ファイルは、C1FlexGrid の独自ファイル形式です。
バウンドモード時にファイルをロードした場合、DataSource プロパティはクリアされます。
関連項目
531
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
レイアウトを保存/ロードする
テキストファイルの保存とロード
SaveGrid/LoadGrid メソッドを使用します。
使用できるオプション(FileFlags 列挙体
列挙体)は以下のとおりです。
FileFlags 列挙体
説明
IncludeFixedCells
ファイルの保存またはロード時に固定セルを含めます。
None
デフォルトの設定を使用してファイルの保存とロードを行います。
SelectedRowsOnly
選択されている行だけをファイルに保存します。
VisibleOnly
表示されている行と列だけをファイルに保存します。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
532
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e
Handles Button1.Click
' 保存するファイル名:flex.txt
' 列の区切り文字:Tab
' オプション:固定セルを含める
' エンコード:SHIFT-JIS
flex.SaveGrid("flex.txt", _
C1.Win.C1FlexGrid.FileFormatEnum.TextTab, _
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells,
System.Text.Encoding.GetEncoding(932))
MessageBox.Show("ファイルを保存しました")
End Sub
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e
Handles Button2.Click
' ロードするファイル名:flex.txt
' 列の区切り文字:Tab
' オプション:固定セルを含める
' エンコード:SHIFT-JIS
flex.LoadGrid("flex.txt", _
C1.Win.C1FlexGrid.FileFormatEnum.TextTab, _
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells,
System.Text.Encoding.GetEncoding(932))
End Sub
As System.EventArgs)
_
As System.EventArgs)
_
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
}
private void button1_Click(object sender, EventArgs e)
{
// 保存するファイル名:flex.txt
// 列の区切り文字:Tab
// オプション:固定セルを含める
// エンコード:SHIFT-JIS
C1.Win.C1FlexGrid.FileFormatEnum.TextTab,
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells,
System.Text.Encoding.GetEncoding(932));
MessageBox.Show("ファイルを保存しました");
}
533
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
private void button2_Click(object sender, EventArgs e)
{
// ロードするファイル名:flex.txt
// 列の区切り文字:Tab
// オプション:固定セルを含める
// エンコード:SHIFT-JIS
flex.LoadGrid("flex.txt",
C1.Win.C1FlexGrid.FileFormatEnum.TextTab,
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells,
System.Text.Encoding.GetEncoding(932));
}
注意:
サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
テキストファイルの保存では、常に表示されている値が格納されます。
バウンドモード時にテキストファイルをロードした場合、DataSource プロパティはクリアされます。
ファイル入出力時に複数のオプションを設定する
SaveExcel/LoadExcel メソッドやSaveGrid/LoadGrid メソッドにてファイルの入出力を行う際、FileFlags 列挙体
列挙体を使用し
て、入出力時のオプションを設定することが可能です。複数のオプションを同時に設定する場合は、Or (C# では ”|”)を使用し
ます。
Visual Basic コードの書き方
Visual Basic
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' Excel ファイルへ出力
' マージ状態と固定セルを含めるオプションを同時に指定
flex.SaveExcel("flex.xls", _
"sheet1", _
C1.Win.C1FlexGrid.FileFlags.SaveMergedRanges Or _
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells)
End Sub
C# コードの書き方
C#
private void button1_Click(object sender, EventArgs e)
{
// Excel ファイルへ出力
// マージ状態と固定セルを含めるオプションを同時に指定
flex.SaveExcel("flex.xls",
"sheet1",
C1.Win.C1FlexGrid.FileFlags.SaveMergedRanges |
C1.Win.C1FlexGrid.FileFlags.IncludeFixedCells);
}
534
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
グリッドを画像として出力する
CreateImage メソッドを使用します。グリッド全体を画像として保存することも、任意のセル範囲のみを画像として保存するこ
とも可能です。下記のコードでは、0行0列目-5行2列目のセル範囲を画像として保存しています。
注意:
注意:サンプルコードでは一般的なMDBサンプル(Nwind.mdb)の Customers テーブルに接続しています。実行の際
にはご利用の環境に適したパス名を設定する必要があります。
【実行例】 イメージ出力例
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' MDBファイルへの接続&データ取得(データセットの作成)
Dim MDBFILE As String = "Nwind.mdbのパス名"
Dim conn As String = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE +
";"
Dim rs As String = "SELECT * FROM Customers"
Dim da As OleDb.OleDbDataAdapter = New OleDb.OleDbDataAdapter(rs, conn)
Dim ds As DataSet = New DataSet()
da.Fill(ds, "Customers")
' グリッドに接続します
flex.DataSource = ds.Tables("Customers")
' VisualStyleを設定
flex.VisualStyle = C1.Win.C1FlexGrid.VisualStyle.Office2007Blue
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' カレントセルのカーソルを非表示
flex.Row = -1
flex.Col = -1
' 0行0列目-5行2列目のセルを画像に出力
Dim img As Image
img = flex.CreateImage(0, 0, 5, 2)
' 画像を保存
img.Save("flex.png")
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
535
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
// MDBファイルへの接続&データ取得(データセットの作成)
string MDBFILE = @"Nwind.mdbのパス名";
string conn = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + MDBFILE + ";";
string rs = "SELECT * FROM Customers";
System.Data.OleDb.OleDbDataAdapter da = new
System.Data.OleDb.OleDbDataAdapter(rs, conn);
DataSet ds = new DataSet();
da.Fill(ds, "Customers");
// グリッドに接続します
flex.DataSource = ds.Tables["Customers"];
// VisualStyleを設定
flex.VisualStyle = C1.Win.C1FlexGrid.VisualStyle.Office2007Blue;
}
private void button1_Click(object sender, EventArgs e)
{
// カレントセルのカーソルを非表示
flex.Row = -1;
flex.Col = -1;
// 0行0列目-5行2列目のセルを画像に出力
Image img;
img = flex.CreateImage(0, 0, 5, 2);
// 画像を保存
img.Save("flex.png");
}
クリップボード
クリップボードの処理に関するタスクを紹介します。
自動クリップボードの機能を有効にする
AutoClipboard プロパテを True に設定(デフォルト:False)することで、C1FlexGrid はクリップボードに関連する標準のキー
ボードコマンドのすべてを自動的に処理します。Excel ファイルとデータをコピー&ペーストでやり取りする際も自動で処理しま
す。
アクション
ショートカットキー
切り取り
[Ctrl+X] または [Shift+Delete]
コピー
[Ctrl+C] または [Ctrl+Insert]
貼り付け
[Ctrl+V] または [Shift+Insert]
削除
[Delete]
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.AutoClipboard = True
End Sub
536
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.AutoClipboard = true;
}
注意
注意:
フォントなどのスタイルやイメージは、自動クリップボード機能の対象になりません。
データマップやマルチカラムコンボボックスのセルでコピーをした際は、表示されている値がコピーされます。
セル範囲をコピーした場合、非表示になっている行や列も対象になります。
行ヘッダや列ヘッダを含めてコピーする
AutoClipboard プロパテを True に設定ィ(デフォルト:False)することで、C1FlexGrid はクリップボードに関連する標準の
キーボードコマンドのすべてを自動的に処理します。また、ClipboardCopyMode プロパティを設定して行ヘッダや列ヘッダ、
行列ヘッダを含めてコピーすることができます。
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
flex.AutoClipboard = True
' 行ヘッダ、列ヘッダを含めて選択されているデータをコピー
flex.ClipboardCopyMode =
C1.Win.C1FlexGrid.ClipboardCopyModeEnum.DataAndAllHeaders
' 列ヘッダを含めて選択されているデータをコピー
flex.ClipboardCopyMode =
C1.Win.C1FlexGrid.ClipboardCopyModeEnum.DataAndColumnHeaders
' 行ヘッダを含めて選択されているデータをコピー
flex.ClipboardCopyMode =
C1.Win.C1FlexGrid.ClipboardCopyModeEnum.DataAndRowHeaders
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
flex.AutoClipboard = true;
// 行ヘッダ、列ヘッダを含めて選択されているデータをコピー
flex.ClipboardCopyMode =
C1.Win.C1FlexGrid.ClipboardCopyModeEnum.DataAndAllHeaders;
// 列ヘッダを含めて選択されているデータをコピー
flex.ClipboardCopyMode =
C1.Win.C1FlexGrid.ClipboardCopyModeEnum.DataAndColumnHeaders;
// 行ヘッダを含めて選択されているデータをコピー
flex.ClipboardCopyMode =
C1.Win.C1FlexGrid.ClipboardCopyModeEnum.DataAndRowHeaders;
537
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
注意
注意:
フォントなどのスタイルやイメージは、自動クリップボード機能の対象になりません。
データマップやマルチカラムコンボボックスのセルでコピーをした際は、表示されている値がコピーされます。
セル範囲をコピーした場合、非表示になっている行や列も対象になります。
コピー&ペースト処理をコードで実装する
コピー処理では、Clip プロパティからから取得したセルデータの最後に改行コードを追加して、クリップボードに設定します。ま
た、ペースト処理では、クリップボードから取得したデータの最後の改行コードを削除して使用します。ペーストする際に
は、Select メソッドで範囲選択を行った上で Clip プロパティに設定する必要があります。
【実行例】
Visual Basic コードの書き方
Visual Basic
' コピー処理
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button1.Click
' Clip プロパティに改行コードを追加して、
' クリップボードに設定
Clipboard.SetDataObject(flex.Clip & vbCrLf)
MessageBox.Show(flex.Row & "行" & flex.Col & "列-" & _
flex.RowSel & "行" & flex.ColSel & "列目をコピー")
End Sub
' ペースト処理
Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles Button2.Click
' クリップボードにあるテキストを取得
Dim data As IDataObject = Clipboard.GetDataObject()
538
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
If data.GetDataPresent(DataFormats.Text) Then
Dim str1, str2 As String
' クリップボードからデータを取得
str1 = CType(data.GetData(DataFormats.Text), String)
' クリップボードにある最後の改行コードを削除
str2 = str1.Remove(str1.Length - 2, 2)
' 範囲選択、データを貼り付け
flex.Select(flex.Row, flex.Col, flex.Rows.Count - 1, flex.Cols.Count - 1,
False)
flex.Clip = str2
flex.Select(flex.Row, flex.Col)
End If
End Sub
C# コードの書き方
C#
// コピー処理
private void button1_Click(object sender, EventArgs e)
{
// Clip プロパティに改行コードを追加して、
// クリップボードに設定
Clipboard.SetDataObject(flex.Clip + "\r");
MessageBox.Show(flex.Row + "行" + flex.Col + "列-" +
flex.RowSel + "行" + flex.ColSel + "列目をコピー");
}
// ペースト処理
private void button2_Click(object sender, EventArgs e)
{
// クリップボードにあるテキストを取得
IDataObject data = Clipboard.GetDataObject();
if (data.GetDataPresent(DataFormats.Text))
{
string str1, str2;
// クリップボードからデータを取得
str1 = (string)data.GetData(DataFormats.Text);
// クリップボードにある最後の改行コードを削除
str2 = str1.Remove(str1.Length - 1, 1);
// 範囲選択、データを貼り付け
flex.Select(flex.Row, flex.Col, flex.Rows.Count - 1, flex.Cols.Count - 1,
false);
flex.Clip = str2;
flex.Select(flex.Row, flex.Col);
}
}
注意:
注意:ClipBoard クラスの詳細は、MSDN を参照してください。
非表示になっている行や列を除いてコピーする
AutoClipBoard プロパティを True にした自動クリップボード処理では、セル範囲をコピーした際、非表示になっている行や列
539
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
も対象になります。表示になっている行や列を除いてコピーするには、コードでコピー処理を実装する必要があります。
【実行例】
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' 非表示になっている行や列を除いてコピーする
' クリップボードの自動処理
flex.AutoClipboard = True
' 3行目を非表示
flex.Rows(3).Visible = False
' 2列目を非表示
flex.Cols(2).Visible = False
' 簡単なデータを設定
For i As Integer = 0 To flex.Rows.Count - 1
For j As Integer = 0 To flex.Cols.Count - 1
flex(i, j) = i & ":" & j
Next
Next
End Sub
Private Sub flex_KeyDown(ByVal sender As Object, ByVal e As
System.Windows.Forms.KeyEventArgs) Handles flex.KeyDown
' [Ctrl + C]によるコピー
If e.Control = True And e.KeyCode = Keys.C Then
540
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
' 自動処理を行わないため、キー入力を無効
e.Handled = True
' 選択されているセル範囲のCellRangeオブジェクトを取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.Selection
' 選択されているセル範囲から
' VisibleプロパティがFalseになっている行や列の値を除いて
' タブ記号や改行コードを追加した文字列にします
Dim StrCopy As String = ""
For i As Integer = cr.r1 To cr.r2
If flex.Rows(i).Visible = True Then
For j As Integer = cr.c1 To cr.c2
If flex.Cols(j).Visible = True Then
StrCopy = StrCopy + flex(i, j)
If j <> cr.c2 Then
StrCopy = StrCopy + vbTab
End If
End If
Next
StrCopy = StrCopy + vbCrLf
End If
Next
' クリップボードに設定
Clipboard.SetDataObject(StrCopy)
MessageBox.Show("コピーしたデータ:" & vbCrLf & StrCopy)
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// クリップボードの自動処理
flex.AutoClipboard = true;
// 3行目を非表示
flex.Rows[3].Visible = false;
// 2列目を非表示
flex.Cols[2].Visible = false;
// 簡単なデータを設定
for (int i = 0; i < flex.Rows.Count; i++)
{
for (int j = 0; j < flex.Cols.Count; j++)
{
flex[i, j] = i + ":" + j;
}
}
}
private void flex_KeyDown(object sender, KeyEventArgs e)
{
// [Ctrl + C]によるコピー
if ((e.Control == true) && (e.KeyCode == Keys.C))
541
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
{
// 自動処理を行わないため、キー入力を無効
e.Handled = true;
// 選択されているセル範囲のCellRangeオブジェクトを取得
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.Selection;
// 選択されているセル範囲から
// VisibleプロパティがFalseになっている行や列の値を除いて
// タブ記号や改行コードを追加した文字列にします
string StrCopy = "";
for (int i = cr.r1; i <= cr.r2; i++)
{
if (flex.Rows[i].Visible == true)
{
for (int j = cr.c1; j <= cr.c2; j++)
{
if (flex.Cols[j].Visible == true)
{
StrCopy = StrCopy + flex[i, j].ToString();
if(j != cr.c2)
{
StrCopy = StrCopy + "\t";
}
}
}
StrCopy = StrCopy + "\n";
}
}
// クリップボードに設定
Clipboard.SetDataObject(StrCopy);
MessageBox.Show("コピーしたデータ:\n" + StrCopy);
}
}
データの実値をコピーする
AutoClipBoard プロパティを True にした自動クリップボード処理では、データマップやマルチカラムコンボボックスのセルでコ
ピーをした際は、表示されている値がコピーされます。実値をコピーするには、GetData メソッドを使用してコードでコピー処理
を実装する必要があります。
【実行例】
542
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
Visual Basic コードの書き方
Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
Handles MyBase.Load
' クリップボードの自動処理
flex.AutoClipboard = True
' データマップの機能を使用
Dim dtMap As Hashtable = New Hashtable()
dtMap.Add("001", "東京")
dtMap.Add("002", "仙台")
dtMap.Add("003", "大坂")
flex.Cols(1).DataMap = dtMap
flex.Cols(1).Caption = "データマップ"
End Sub
Private Sub flex_KeyDown(ByVal sender As Object, ByVal e As
System.Windows.Forms.KeyEventArgs) Handles flex.KeyDown
' [Ctrl + C]によるコピー
If e.Control = True And e.KeyCode = Keys.C Then
' 自動処理を行わないため、キー入力を無効
e.Handled = True
' 選択されているセル範囲のCellRangeオブジェクトを取得
Dim cr As C1.Win.C1FlexGrid.CellRange
cr = flex.Selection
' GetDataメソッドを使用して
' 選択されているセル範囲から実値をコピー
Dim StrCopy As String = ""
For i As Integer = cr.r1 To cr.r2
For j As Integer = cr.c1 To cr.c2
StrCopy = StrCopy + flex.GetData(i, j)
If j <> cr.c2 Then
StrCopy = StrCopy + vbTab
End If
Next
543
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
StrCopy = StrCopy + vbCrLf
Next
' クリップボードに設定
Clipboard.SetDataObject(StrCopy)
MessageBox.Show("コピーしたデータ:" & vbCrLf & StrCopy)
End If
End Sub
C# コードの書き方
C#
private void Form1_Load(object sender, EventArgs e)
{
// データの実値をコピーする
// クリップボードの自動処理
flex.AutoClipboard = true;
// データマップの機能を使用
System.Collections.Hashtable dtMap = new System.Collections.Hashtable();
dtMap.Add("001", "東京");
dtMap.Add("002", "仙台");
dtMap.Add("003", "大坂");
flex.Cols[1].DataMap = dtMap;
flex.Cols[1].Caption = "データマップ";
}
private void flex_KeyDown(object sender, KeyEventArgs e)
{
// [Ctrl + C]によるコピー
if ((e.Control == true) && (e.KeyCode == Keys.C))
{
// 自動処理を行わないため、キー入力を無効
e.Handled = true;
// 選択されているセル範囲のCellRangeオブジェクトを取得
C1.Win.C1FlexGrid.CellRange cr;
cr = flex.Selection;
// GetDataメソッドを使用して
// 選択されているセル範囲から実値をコピー
string StrCopy = "";
for (int i = cr.r1; i <= cr.r2; i++)
{
for (int j = cr.c1; j <= cr.c2; j++)
{
StrCopy = StrCopy + flex.GetData(i, j).ToString();
if (j != cr.c2)
{
StrCopy = StrCopy + "\t";
}
}
StrCopy = StrCopy + "\n";
}
// クリップボードに設定
Clipboard.SetDataObject(StrCopy);
MessageBox.Show("コピーしたデータ:\n" + StrCopy);
544
Copyright © GrapeCity inc. All rights reserved. ComponentOne FlexGrid for WinForms
}
}
関連項目
表示値/実値のように2種類のデータを持たせる
545
Copyright © GrapeCity inc. All rights reserved.