チェックボックス型セル

チェックボックス型セルを使用すると、セル内にチェックボックスを表示できます。チェックボックス型セルは、3つの状態（チェック、未チェック、中間状態）のいずれかを表すことのできる小さなチェックボックスを表示します。テキストを設定して、チェックボックスをカスタマイズできます。

2状態（チェック、未チェック）ではなく3状態のチェックボックスを表示するには、isThreeStateメソッドをtrueに設定します。textAlignメソッドを使用すると、チェックボックスおよびテキストの配置を指定することもできます。

次の表のように、valueメソッドを使用して、コードでチェックボックスの状態を変更することができます。

値	状態
null	Indeterminate
0	Unchecked
1	Checked

チェックボックスのサイズを変更するには、 boxSize() メソッドを使用できます。boxSize() メソッドの値を、任意の数値または「auto」に設定できます。本メソッドで不正な値が指定された場合、チェックボックスのサイズは変更されません。チェックボックスの標準サイズは12*12ピクセルです。

コードの使用

次のサンプルコードは、3状態のチェックボックス型セルを作成します。

// activeSheetを取得します。
var activeSheet = spread.getSheet(0);
var cellType = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType.caption("caption");
cellType.textTrue("True");
cellType.textFalse("False");
cellType.textIndeterminate("Indeterminate");
cellType.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType.isThreeState(true);
cellType.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType);
//activeSheet.getCell(1, 1).value(1);

チェックボックス型セルでのテキストの折り返し

チェックボックス型セルのキャプションをセルに収めるには、スタイルの wordWrap プロパティを true に設定します。これにより、キャプションがセル内で折り返して表示されます。

wordwrap

チェックボックス型セルでテキストを折り返し、垂直揃えを設定すると、チェックボックスは以下のように表示されます。

垂直揃え	出力
セルの vAlign が top の場合、チェックボックスはテキストと上揃えになります。
セルの vAlign が middle の場合、チェックボックスはテキストと中央揃えになります。
セルの vAlign が bottom の場合、チェックボックスはテキストと下揃えになります。

セルの hAlign を使用して、折り返したテキストの水平揃えを変更することができます。例えば、セルの hAlign が right の場合、テキストのみはセルの左揃えになります。同様に、セルの hAlign が left または center の場合、テキストはセルの左揃えまたは中央揃えになります。

コードの使用

次のサンプルコードは、チェックボックス型セルに wordWrap を実装する方法を示します。

// 長いキャプションを設定します。
cellType.caption("これは非常に長いサンプルテキストです。"); 
activeSheet.getCell(1, 1).cellType(cellType); 
activeSheet.setRowHeight(1, 120); 
activeSheet.setColumnWidth(1, 110); 
// チェックボックス型セルに wordwrap メソッドを実装します。
activeSheet.getCell(1, 1).wordWrap(true);