|
セルプロパティは、グリッドコントロールの各セル毎のプロパティです。セルプロパティは、以下の2通りの方法で設定できます。
これらの各メソッドの「Props」パラメータに、以下のプロパティ設定書式で指定します。
また、一度に複数のセルプロパティを設定する場合は、配列で指定します。
c("セルプロパティ名1:設定値1", "セルプロパティ名2:設定値2" [, ...])
|
|
以下が、メニューアイテムプロパティの設定例です。
設定例)SetCellPropertyの場合
プロパティ一つの設定
this.SetCellProperty(
"col",
"CellType:label",
0
);
|
複数プロパティの設定
this.SetCellProperty(
"col",
c("CellType:label", "FillColor:#FF0000", "TextColor:#FFFFFF"),
0
);
|
|
セルプロパティは、セルタイプ毎によりプロパティ値が異なります。セルタイプは以下のタイプがあります。
セルタイプは、共通セルプロパティ「CellType」を用いてセル毎にセルのタイプを設定できます。デフォルトでは型は「無指定」になります。
セルタイプ
|
タイプ指定文字
|
説明
|
ラベル型
|
label
|
文字を表示するとき使用します。
|
エディットボックス型
|
edit
|
ユーザーが入力を行うとき使用します。
|
コンボボックス型
|
combo
|
ユーザーが入力を行うとき使用します。リストからの選択が可能です。
|
メータ型
|
meter
|
バーメーターとして数値を表示します。
|
ランプ型
|
lamp
|
ON/OFFをランプで表示します。
|
スイッチ型
|
switch
|
ON/OFFをユーザーが設定するときに使用します。
|
ボタン型
|
button
|
セルをボタンにするときに使用します。
|
サイドボタン型
|
sidebutton
|
セルの右端にボタンを置くときに使用します。
|
イメージ型
|
image
|
画像ファイルを表示するとき使用します。
|
|
セルのプロパティ(背景色、文字の色、文字の位置、点滅など)を設定する場合、予めセルタイプを設定する必要があります。共通セルプロパティ「CellType」によりセルタイプを設定する場合、配列の先頭で指定する必要があります。
this.SetCellProperty(
"col",
c("CellType:button", "TextColor:@TextColor"),
1
);
|
|
ヘッダセルのプロパティ(背景色、文字の色、文字の位置、点滅など)を設定する場合、SetCellPropertyメソッドの第1パラメータで「cell」「row」「col」でセルタイプを設定する必要があります。「all」「range」ではヘッダのセルタイプは設定されません。
this.SetCellProperty(
"cell",
c("CellType:label", "FillColor:#FFFFFF", "TextAlignX:RIGHT"),
0,
-1
);
|
|
共通
|
|
|
|
Style
|
文字
|
""
|
セルのスタイル名を指定します。スタイル名は、「AddStyle」で指定するスタイル定義配列のインデックス0番目となります。
|
CellType
|
文字
|
""
|
セルタイプ。
セルタイプ
|
タイプ指定文字
|
説明
|
ラベル型
|
label
|
文字を表示するとき使用します。
|
エディットボックス型
|
edit
|
ユーザーが入力を行うとき使用します。
|
コンボボックス型
|
combo
|
ユーザーが入力を行うとき使用します。リストからの選択が可能です。
|
メータ型
|
meter
|
バーメーターとして数値を表示します。
|
ランプ型
|
lamp
|
ON/OFFをランプで表示します。
|
スイッチ型
|
switch
|
ON/OFFをユーザーが設定するときに使用します。
|
ボタン型
|
button
|
セルをボタンにするときに使用します。
|
サイドボタン型
|
sidebutton
|
セルの右端にボタンを置くときに使用します。
|
イメージ型
|
image
|
画像ファイルを表示するとき使用します。
|
|
Width
|
数値
|
-
|
セルの幅。
|
Height
|
数値
|
-
|
セルの高さ。
|
FillColor
|
色文字
|
"#FFFFFF"
|
セルの背景色。
|
BlinkFillColor
|
色文字
|
"#FF0000"
|
セルが点滅したときの背景色。
BlinkFillがTRUEの場合に有効。
|
BlinkFill
|
ブール
|
FALSE
|
セルの点滅。
TRUE - 点滅する FALSE - 点滅しない
|
|
ラベル型(セルタイプ:label)
|
|
|
|
TextColor
|
色文字
|
"#000000"
|
テキストの色。
|
TextAlignX
|
文字
|
"CENTER"
|
テキストの横位置。
LEFT
|
左寄せ表示
|
CENTER
|
中央寄せ表示
|
RIGHT
|
右寄せ表示
|
|
TextAlignY
|
文字
|
"CENTER"
|
テキストの縦位置。
TOP
|
上寄せ表示
|
CENTER
|
中央寄せ表示
|
BOTTOM
|
下寄せ表示
|
|
|
エディットボックス型(セルタイプ:edit)
|
|
|
|
TextColor
|
色文字
|
"#000000"
|
テキストの色。
|
TextAlignX
|
文字
|
"CENTER"
|
テキストの横位置。
LEFT
|
左寄せ表示
|
CENTER
|
中央寄せ表示
|
RIGHT
|
右寄せ表示
|
|
TextAlignY
|
文字
|
"CENTER"
|
テキストの縦位置。
TOP
|
上寄せ表示
|
CENTER
|
中央寄せ表示
|
BOTTOM
|
下寄せ表示
|
|
TextType
|
文字
|
"TEXT"
|
テキストタイプです。詳しくはエディットボックスコントロールを参照下さい。
|
TextFormat
|
文字
|
""
|
テキストフォーマットです。詳しくはエディットボックスコントロールを参照下さい。
|
|
コンボボックス型(セルタイプ:combo)
|
|
|
|
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を設定すると、空文字がセルに設定されます。
|
|
メーター型(セルタイプ:meter)
|
|
|
|
ShowText
|
ブール
|
FALSE
|
テキストの表示。
TRUE - 表示する。 FALSE - 表示しない。
|
TextColor
|
色文字
|
"#000000"
|
テキストの色。
|
BorderColor
|
色文字
|
"#808080
|
メータの枠線の色。
|
MeterForeColor
|
色文字
|
"#00FF00"
|
メータの値により変化する部分の色。
|
MeterBackColor
|
色文字
|
"#000000"
|
メータの背景色。
|
Max
|
数値
|
100
|
メータの最大値。
|
Min
|
数値
|
0
|
メータの最小値。
|
XMargin
|
数値
|
0.15
|
X方向のメータの余白の割合(0から1)。
|
YMargin
|
数値
|
0.15
|
Y方向のメータの余白の割合(0から1)。
|
|
ランプ型(セルタイプ:lamp)
|
|
|
|
Shape
|
文字
|
"SQUARE"
|
ランプの形。
SQUARE
|
正方形
|
RECTANGLE
|
長方形
|
CIRCLE
|
円
|
|
BorderColor
|
色文字
|
"#808080"
|
ランプの枠線の色。
|
OnColor
|
色文字
|
"#FF0000"
|
Onの時の色。
|
OffColor
|
色文字
|
"#FFFFFF"
|
Offの時の色。
|
Margin
|
数値
|
0.3
|
ランプの余白の割合(0から1)。
|
MarkColor
|
色文字
|
"#000000"
|
マークの色。
|
MarkStyle
|
文字
|
"NONE"
|
マークのタイプ。
NONE
|
表示しない
|
TICK
|
チェック
|
CROSS
|
クロス
|
DOT
|
ドット
|
|
|
スイッチ型(セルタイプ:switch)
|
|
|
|
Shape
|
文字
|
"SQUARE"
|
ランプの形。
SQUARE
|
正方形
|
RECTANGLE
|
長方形
|
CIRCLE
|
円
|
|
BorderColor
|
色文字
|
"#808080"
|
ランプの枠線の色。
|
OnColor
|
色文字
|
"#FFFFFF"
|
Onの時の色。
|
OffColor
|
色文字
|
"#FFFFFF"
|
Offの時の色。
|
Margin
|
数値
|
0.3
|
ランプの余白の割合(0から1)。
|
MarkColor
|
色文字
|
"#000000"
|
マークの色。
|
MarkStyle
|
文字
|
"TICK"
|
マークのタイプ。
NONE
|
表示しない
|
TICK
|
チェック
|
CROSS
|
クロス
|
DOT
|
ドット
|
|
|
ボタン型(セルタイプ:button)
|
|
|
|
Enabled
|
ブール
|
TRUE
|
有効、無効の切り替え。
FALSEの時が無効状態になります。無効時ボタンが押せなくなります。
|
TextColor
|
色文字
|
"#000000"
|
テキストの色。
|
ButtonFillColor
|
色文字
|
OSの背景色
|
ボタンの色。
|
ButtonBorderStyle
|
文字
|
"3D_RAISE2"
|
枠のスタイル。
FLAT
|
フラット
|
3D_FRAME
|
3D
|
3D_RAISE1
|
3D(凸)
|
3D_RAISE2
|
3D(凸高め)
|
@BorderStyleX
|
テーマに沿った設定
|
|
XMargin
|
数値
|
0.15
|
X方向のボタンの余白の割合(0から1)。
|
YMargin
|
数値
|
0.15
|
Y方向のボタンの余白の割合(0から1)。
|
|
サイドボタン型(セルタイプ:sidebutton)
|
|
|
|
Enabled
|
ブール
|
TRUE
|
無効時ボタンが押せなくなる。
|
TextColor
|
色文字
|
"#000000"
|
テキストの色。
|
TextAlignX
|
文字
|
"CENTER"
|
テキストの横位置。
LEFT
|
左寄せ表示
|
CENTER
|
中央寄せ表示
|
RIGHT
|
右寄せ表示
|
|
TextAlignY
|
文字
|
"CENTER"
|
テキストの縦位置。
TOP
|
上寄せ表示
|
CENTER
|
中央寄せ表示
|
BOTTOM
|
下寄せ表示
|
|
ButtonFillColor
|
色文字
|
OSの背景色
|
ボタンの色。
|
ButtonBorderStyle
|
文字
|
"3D_RAISE2"
|
枠のスタイル。
FLAT
|
フラット
|
3D_FRAME
|
3D
|
3D_RAISE1
|
3D(凸)
|
3D_RAISE2
|
3D(凸高め)
|
@BorderStyleX
|
テーマに沿った設定
|
|
ButtonText
|
文字
|
"..."
|
ボタンに表示するテキスト。
|
ButtonTextColor
|
色文字
|
"#000000"
|
ボタンに表示するテキストの色。
|
ButtonWidth
|
数値
|
20
|
ボタンの幅(ピクセル単位)。
|
|
イメージ型(セルタイプ:image)
|