CellStyleはデータセル毎に設定できるスタイルと編集プロパティー達の集合である。 注意すべきことは、カラムスタイルや動的スタイルと違ってCellStyleは適用の基準がデータ行とフィールド達である。 だとしても、設定されるCellStyle達がDataSetにセーブされるのではない。 一つのデータセットに二つのグリッドが繋がった時、一つのグリッドの適用されたCellStyleが他のグリッドに適用されたりはしない。 他のスタイルと同じくCellStyleもView layerで管理される。
お互いに長所と短所があるゆえに状況にあるスタイリングの方式を探すべきである。
CellStyleをデータセルに適用するためにはまずグリッドに登録しなければならない。 各々のCellStyleはstyle idで接近できる。
grdMain.registerCellStyle('style01', {
"background": "#880000",
"foreground": "#ffffff"
});
データセル単位でセルスタイルを適用するためにはGridBase.setCellStyleメソッドを使用する。 dataRowIndexパラメーターが0より小さい値であれば行の追加の時に追加される行に適用される。
fieldにはフィールドインデックスや名前を指定することができるが、 -1で指定したらdataRowIndex行のすべてのセルに適用される。
赤い背景に白い文字 青い背景に白い文字
GridBase.setCellStylesで複数の行について設定することもできる。
黄色い背、景赤い文字
複数の行と複数のフィールドに設定することもできる。
緑の背景、白い文字
GridBase.setCellStyleRowsを利用して DataSetの複数の行の福栖のフィールドについて各々違うスタイルを指定することもできる。 下のサンプルのように一つ以上のスタイルid値を持つアレイのアレイや、 Json客体のアレイをfield mapと一緒に指定すればいい。
フィールドマップにスタイルアレイのどの位置の値をデータセットのどのフィールドに適用するかを設定する。 詳しい説明はsetCellStyleRowsヘルプトピックを参考する。
アレイのアレイで指定する。
Jsonアレイで指定する。