# グリッドコントロール

マニュアル > コントロールリファレンス > 基本 > # グリッドコントロール |

| グリッドコントロール (GRIDCONTROL)
プロパティ | メソッド | イベント
グリッドコントロールは、表形式のデータの表示、編集が行える強力なコントロールです。 グリッドコントロールには、以下の３つの重要なメソッドがあります。 1)SetCellType 2)SetCellProperty 3)SetData ■すべてのセルがエディットボックス型の例 ■列ごとにセルのタイプを設定した例 SetCellType
SetCellTypeメソッドを用いて、セル毎にセルのタイプを設定できます。なにも設定していないセルはデフォルトでラベル型になります。
タイプ | 説明
ラベル型 | 文字を表示するとき使用します。
エディットボックス型 | ユーザーが入力を行うとき使用します。
コンボボックス型 | ユーザーが入力を行うとき使用します。リストからの選択が可能です。
メータ型 | バーメーターとして数値を表示します。
ランプ型 | ON/OFFをランプで表示します。
スイッチ型 | ON/OFFをユーザーが設定するときに使用します。
ボタン型 | セルをボタンにするときに使用します。
サイドボタン型 | セルの右端にボタンを置くときに使用します。
イメージ型 | 画像ファイルを表示するとき使用します。
SetCellProperty
SetCellPropertyでセルのプロパティ（背景色、文字の色、文字の位置、点滅など）を設定します。下記はセルタイプ毎のプロパティ一覧です。 ラベル型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する FALSE - 点滅しない
TextColor | 色文字 | "#000000" | テキストの色。
TextAlignX | 文字 | "CENTER" | テキストの位置。"LEFT" - 左表示 "CENTER" - 左右中央表示 "RIGHT" - 右表示
TextAlignY | 文字 | "CENTER" | テキストの位置。"TOP" - 上表示 "CENTER" - 上下中央表示 "BOTTOM" - 下表示
エディットボックス型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
TextColor | 色文字 | "#000000" | テキストの色。
TextAlignX | 文字 | "CENTER" | テキストの位置。"LEFT" - 左表示 "CENTER" - 左右中央表示 "RIGHT" - 右表示
TextAlignY | 文字 | "CENTER" | テキストの位置。"TOP" - 上表示 "CENTER" - 上下中央表示 "BOTTOM" - 下表示
TextType | 文字 | "TEXT" | テキストタイプです。詳しくはエディットボックスコントロールを参照下さい。
TextFormat | 文字 | "" | テキストフォーマットです。詳しくはエディットボックスコントロールを参照下さい。
コンボボックス型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
TextColor | 色文字 | "#000000" | テキストの色。
TextAlignX | 文字 | "CENTER" | テキストの位置。"LEFT" - 左表示 "CENTER" - 左右中央表示 "RIGHT" - 右表示
TextAlignY | 文字 | "CENTER" | テキストの位置。"TOP" - 上表示 "CENTER" - 上下中央表示 "BOTTOM" - 下表示
TextType | 文字 | "TEXT" | テキストタイプです。詳しくはエディットボックスコントロールを参照下さい。
TextFormat | 文字 | "" | テキストフォーマットです。詳しくはエディットボックスコントロールを参照下さい。
ComboType | 文字 | "DROPDOWN" | コンボボックスのタイプ。 "DROPDOWN" - リストから選択する以外にテキストを入力できます。 "DROPDOWNLIST" - リストから選択のみで、テキストを入力できません。
TextList | 文字 | "" | ドロップダウンしたときに表示するテキスト。複数のテキストを表示させる場合は改行入力します。
VisibleRows | 数値 | 5 | ドロップダウンしたときに表示されるテキストの行数。表示しきれない場合はスクロールバーが有効になります。
SelectedIndex | 文字 | "" | 現在選択されている行のインデックス。TextList設定後有効になります。リストにないテキストがセルに設定されている場合、SelectedIndexは-1になります。SelectedIndexに-1を設定すると、空文字がセルに設定されます。
メーター型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
ShowText | ブール | FALSE | TRUE - 表示する。 FALSE - 表示しない。
TextColor | 色文字 | "#000000" | テキストの色。
BorderColor | 色文字 | "#808080 | メータの枠線の色。
MeterForeColor | 色文字 | "#00FF00" | メータの値により変化する部分の色。
MeterBackColor | 色文字 | "#000000" | メータの背景色。
Max | 数値 | 100 | メータの最大値。
Min | 数値 | 0 | メータの最小値。
XMargin | 数値 | 0.15 | X方向のメータの余白の割合（0から１）。
YMargin | 数値 | 0.15 | Y方向のメータの余白の割合（0から１）。
ランプ型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
Shape | 文字 | "SQUARE" | ランプの形。SQUARE - 正方形。RECTANGLE - 長方形。 CIRCLE - 円。
BorderColor | 色文字 | "#808080" | ランプの枠線の色。
OnColor | 色文字 | "#FF0000" | Onの時の色。
OffColor | 色文字 | "#FFFFFF" | Offの時の色。
Margin | 数値 | 0.3 | ランプの余白の割合（0から１）。
MarkColor | 色文字 | "#000000" | マークの色。
MarkStyle | 文字 | "NONE" | マークのタイプ。 NONE - 表示しない。TICK - チェック。CROSS - クロス。 DOT - ドット。
スイッチ型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
Shape | 文字 | "SQUARE" | ランプの形。SQUARE - 正方形。RECTANGLE - 長方形。 CIRCLE - 円。
BorderColor | 色文字 | "#808080" | ランプの枠線の色。
OnColor | 色文字 | "#FFFFFF" | Onの時の色。
OffColor | 色文字 | "#FFFFFF" | Offの時の色。
Margin | 数値 | 0.3 | ランプの余白の割合（0から１）。
MarkColor | 色文字 | "#000000" | マークの色。
MarkStyle | 文字 | "TICK" | マークのタイプ。 NONE - 表示しない。TICK - チェック。CROSS - クロス。 DOT - ドット。
ボタン型
プロパティ名 | 型 | デフォルト | 説明
Enabled | ブール | TRUE | 無効時ボタンが押せなくなる。
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
TextColor | 色文字 | "#000000" | テキストの色。
ButtonFillColor | 色文字 | OSの背景色 | ボタンの色。
ButtonBorderStyle | 文字 | "3D_RAISE2" | 枠のスタイル（FLAT/3D_FRAME/3D_RAISE1/3D_RAISE2）。
XMargin | 数値 | 0.15 | X方向のボタンの余白の割合（0から１）。
YMargin | 数値 | 0.15 | Y方向のボタンの余白の割合（0から１）。
サイドボタン型
プロパティ名 | 型 | デフォルト | 説明
Enabled | ブール | TRUE | 無効時ボタンが押せなくなる。
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
TextColor | 色文字 | "#000000" | テキストの色。
TextAlignX | 文字 | "CENTER" | テキストの位置。"LEFT" - 左表示 "CENTER" - 左右中央表示 "RIGHT" - 右表示
TextAlignY | 文字 | "CENTER" | テキストの位置。"TOP" - 上表示 "CENTER" - 上下中央表示 "BOTTOM" - 下表示
ButtonFillColor | 色文字 | OSの背景色 | ボタンの色。
ButtonBorderStyle | 文字 | "3D_RAISE2" | 枠のスタイル（FLAT/3D_FRAME/3D_RAISE1/3D_RAISE2）。
ButtonText | 文字 | "..." | ボタンに表示するテキスト。
ButtonTextColor | 色文字 | "#000000" | ボタンに表示するテキストの色。
ButtonWidth | 数値 | 20 | ボタンの幅（ピクセル単位）。
イメージ型
プロパティ名 | 型 | デフォルト | 説明
FillColor | 色文字 | "#FFFFFF" | 背景色。
BlinkFillColor | 色文字 | "#FF0000" | 点滅したときの色。
BlinkFill | ブール | FALSE | TRUE - 点滅する。 FALSE - 点滅しない。
File | 文字 | "" | ファイル名のパス。
SetData
SetDataでセルに表示するデータをテキストで設定します。SetDataで設定したテキストは、下表のようにグリッド表示されます。
タイプ | 説明
ラベル型 | テキストがそのまま表示されます。
エディットボックス型 | テキストがそのまま表示されます。ユーザーはテキストを編集できます。
コンボボックス型 | テキストがそのまま表示されます。ユーザーはテキストを編集できます。
メータ型 | 数値に変換され、最大値（Max）、最小値（Min）からメータとして表示されます。ShowTextプロパティがTRUEの時、テキストがそのまま表示されます。
ランプ型 | ブールに変換され、ランプとして表示されます。T、TRUE、0以外の数値はすべてTRUE(ON)に変換されます。F、FALSE、0はFALSE(OFF)に変換されます。
スイッチ型 | ブールに変換され、スイッチとして表示されます。ユーザーはOn/Offを切り替えられます。T、TRUE、0以外の数値はすべてTRUE(ON)に変換されます。F、FALSE、0はFALSE(OFF)に変換されます。
ボタン型 | テキストがそのまま表示されます。
イメージ型 | なにも表示されません。
| ラベル型/ボタン型/メータ型のテキストは複数行表示に対応しています。改行する場合は改行文字を下記のように入れてください。 this.SetData(0, 0, "line1" + ::RET() + "line2");
キー操作
グリッドコントロール上で使用できるキー操作は以下のとおりです。尚、カットキー（Ctrl+X）、貼り付けキー（Ctrl+V）、DELキーはそれぞれEnableCutKey/EnablePasteKey/EnableDelKeyで無効にすることができます。
キー操作 | 効果
Ctrl+C | 選択している範囲をコピーする。
Ctrl+X | 選択している範囲をカットする。
Ctrl+P | 現在のカーソル位置に貼り付けする。
DEL | 選択している範囲のデータをクリアする。
Enter | エディットを開始する（セルタイプがエディットボックスの場合のみ）。エディットを終了するときは再びEnterキーを押します。
F2 | Enterキーと同様にエディットを開始する。（セルタイプがエディットボックスの場合のみ。）
Space | スイッチの値を切り替える（セルタイプがスイッチの場合のみ）。
↑ | カーソルを下に移動する。
↓ | 画像ファイルを表示するとき使用します。
← | カーソルを左に移動する。
→ | カーソルを右に移動する。
Shift + ↑ | 選択範囲を上に広げる。
Shift + ↓ | 選択範囲を下に広げる。
Shift + ← | 選択範囲を左に広げる。
Shift + → | 選択範囲を右に広げる。
マウスホイール操作
グリッドコントロールはマウスホイール（上下スクロール）に対応しています。
セルのインデックス
例えばSetDataメソッドでは、以下のように列（Col）と行（Row）の位置を指定します。この位置のことをインデックスと言います。 SetData (Col, Row, Data) セルのインデックスは0から始まります。ヘッダ部のインデックスは-1からマイナス方向に順番に割り振られています。下図はインデックスを（Col, Row）でグリッド内に表示した状態です。