[]
↳ CheckBox
• new CheckBox()
チェックボックス型のセルを表します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
• typeName: string
シリアル化のサポートに使用される型名の文字列を表します。
▸ activateEditor(editorContext
, cellStyle
, cellRect
, context?
): void
エディタをアクティブにし、エディタのプロパティまたは属性の設定やイベントの連結などを行います。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
cellStyle |
Style |
セルの実際のスタイル。 |
cellRect |
Rect |
セルのレイアウト情報。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ boxSize(value?
): any
チェックボックスのサイズを示す値を取得または設定します。
名前 | 型 | 説明 |
---|---|---|
value? |
string | number |
チェックボックスのサイズ。 数値と「自動」をサポートします。 |
any
値が設定されていない場合は、チェックボックスのサイズを返します。
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox(); cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
▸ caption(value?
): any
セル型のキャプションを取得または設定します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
名前 | 型 | 説明 |
---|---|---|
value? |
string |
セル型のキャプション。 |
any
値が設定されていない場合は、キャプションを返します。値が設定されている場合は、チェックボックスセル型を返します。
▸ createEditorElement(context?
): HTMLElement
DOM要素を作成して返します。
名前 | 型 | 説明 |
---|---|---|
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
HTMLElement
DOM要素を返します。
▸ deactivateEditor(editorContext
, context?
): void
エディタを非アクティブにします。エディタのイベントの連結解除などが行われます。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ focus(editorContext
, context?
): void
エディタDOM要素にフォーカスを設定します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ format(value
, format
, formattedData?
, context?
): string
指定した書式を使用して値を文字列に書式設定します。
名前 | 型 | 説明 |
---|---|---|
value |
any |
書式設定するオブジェクト値。 |
format |
string | GeneralFormatter |
書式。 |
formattedData? |
FormattedData |
書式付きデータ。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
string
書式設定された文字列を返します。
▸ fromJSON(settings
): void
指定したJSON文字列からオブジェクト状態をロードします。
名前 | 型 | 説明 |
---|---|---|
settings |
any |
逆シリアル化されたセル型のデータ。 |
void
▸ getAutoFitHeight(value
, text
, cellStyle
, zoomFactor
, context?
): number
行の自動サイズ調整の処理に使用できるセルの高さを取得します。
名前 | 型 | 説明 |
---|---|---|
value |
any |
セルの値。 |
text |
string |
セルのテキスト。 |
cellStyle |
Style |
セルの実際の値。 |
zoomFactor |
number |
現在のシートのズーム率。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
number
行の自動サイズ調整の処理に使用できるセルの高さを返します。
▸ getAutoFitWidth(value
, text
, cellStyle
, zoomFactor
, context?
): number
列の自動サイズ調整の処理に使用できるセルの幅を取得します。
名前 | 型 | 説明 |
---|---|---|
value |
any |
セルの値。 |
text |
string |
セルのテキスト。 |
cellStyle |
Style |
セルの実際の値。 |
zoomFactor |
number |
現在のシートのズーム率。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
number
列の自動サイズ調整の処理に使用できるセルの幅を返します。
▸ getEditorValue(editorContext
, context?
): any
エディタの値を取得します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
any
エディタの値を返します。
▸ getHitInfo(x
, y
, cellStyle
, cellRect
, context?
): IHitTestCellTypeHitInfo
セル型のヒット情報を取得します。
名前 | 型 | 説明 |
---|---|---|
x |
number |
キャンバスを基準とする現在のポインタ位置の<i>x</i>座標。 |
y |
number |
キャンバスを基準とする現在のポインタ位置の<i>y</i>座標。 |
cellStyle |
Style |
現在のセルの実際のスタイル。 |
cellRect |
Rect |
現在のセルのレイアウト情報。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
x、y、row、col、cellRect、sheetAreaの各パラメーターと、isReservedLocationを示す値を含むオブジェクトを返します。isReservedLocationは、ヒットテストが、セル型が処理しなければならない特別な領域に位置する場合は
▸ isEditingValueChanged(oldValue
, newValue
, context?
): boolean
編集値が変更されたかどうか。
名前 | 型 | 説明 |
---|---|---|
oldValue |
any |
古い編集値。 |
newValue |
any |
新しい編集値。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
boolean
oldValueがnewValueと等しい場合は<c>true</c>、それ以外の場合は<c>false</c>。
▸ isImeAware(context?
): boolean
このセル型がIMEを認識するかどうか。
名前 | 型 | 説明 |
---|---|---|
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
boolean
セル型がIMEを認識する場合は<c>true</c>、それ以外の場合は<c>false</c>。
▸ isReservedKey(e
, context?
): boolean
セル型がキーボードイベントを自分で処理するかどうかを返します。
名前 | 型 | 説明 |
---|---|---|
e |
KeyboardEvent |
KeyboardEvent。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
boolean
セル型がキーボードイベントを自分で処理する場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ isThreeState(value?
): any
チェックボックスが3つの状態をサポートするかどうかを示す値を取得または設定します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
名前 | 型 | 説明 |
---|---|---|
value? |
boolean |
チェックボックスが3つの状態をサポートするかどうか。 |
any
値が設定されていない場合は、チェックボックスが3つの状態をサポートするかどうかを返します。値が設定されている場合は、チェックボックスセル型を返します。
▸ paint(ctx
, value
, x
, y
, w
, h
, style
, context?
): void
キャンバスにセルを描画します。
名前 | 型 | 説明 |
---|---|---|
ctx |
CanvasRenderingContext2D |
キャンバスの2次元コンテキスト。 |
value |
any |
セルの値。 |
x |
number |
キャンバスを基準とする<i>x</i>座標。 |
y |
number |
キャンバスを基準とする<i>y</i>座標。 |
w |
number |
セルの幅。 |
h |
number |
セルの高さ。 |
style |
Style |
セルの実際のスタイル。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ paintContent(ctx
, value
, x
, y
, w
, h
, style
, context?
): void
キャンバスにセル内容領域を描画します。
名前 | 型 | 説明 |
---|---|---|
ctx |
CanvasRenderingContext2D |
キャンバスの2次元コンテキスト。 |
value |
any |
セルの値。 |
x |
number |
キャンバスを基準とする<i>x</i>座標。 |
y |
number |
キャンバスを基準とする<i>y</i>座標。 |
w |
number |
セル内容領域の幅。 |
h |
number |
セル内容領域の高さ。 |
style |
Style |
セルの実際のスタイル。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ parse(text
, formatStr
, context?
): any
指定した書式文字列を使用してテキストをオブジェクトに解析します。
名前 | 型 | 説明 |
---|---|---|
text |
string |
解析するテキスト文字列。 |
formatStr |
string |
解析書式文字列。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
any
解析されたオブジェクト。
▸ processKeyDown(event
, context?
): boolean
表示モードでキーダウンを処理します。
名前 | 型 | 説明 |
---|---|---|
event |
KeyboardEvent |
KeyboardEvent。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ processKeyUp(event
, context?
): boolean
表示モードでキーアップを処理します。
名前 | 型 | 説明 |
---|---|---|
event |
KeyboardEvent |
KeyboardEvent。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ processMouseDown(hitInfo
): boolean
表示モードでマウスダウンを処理します。
名前 | 型 | 説明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfoメソッドによって返されたヒットテスト情報。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ processMouseEnter(hitInfo
): boolean
表示モードでマウスエンターを処理します。
名前 | 型 | 説明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfoメソッドによって返されたヒットテスト情報。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ processMouseLeave(hitInfo
): boolean
表示モードでマウスリーブを処理します。
名前 | 型 | 説明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfoメソッドによって返されたヒットテスト情報。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ processMouseMove(hitInfo
): boolean
表示モードでマウスムーブを処理します。
名前 | 型 | 説明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfoメソッドによって返されたヒットテスト情報。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ processMouseUp(hitInfo
): boolean
表示モードでマウスアップを処理します。
名前 | 型 | 説明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfoメソッドによって返されたヒットテスト情報。詳細については、「解説」を参照してください。 |
boolean
処理が成功した場合は<c>true</c>、それ以外の場合は<c>false</c>を返します。
▸ selectAll(editorContext
, context?
): void
エディタDOM要素内のすべてのテキストを選択します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ setEditorValue(editorContext
, value
, context?
): void
エディタの値を設定します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
value |
any |
アクティブセルから返された値。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void
▸ textAlign(value?
): any
チェックボックスに対するテキストの配置を取得または設定します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
名前 | 型 | 説明 |
---|---|---|
value? |
CheckBoxTextAlign |
チェックボックスに対するテキストの配置。 |
any
値が設定されていない場合は、チェックボックスに対するテキストの配置を返します。値が設定されている場合は、チェックボックスセル型を返します。
▸ textFalse(value?
): any
セルの値が<c>false</c>のときのセルのテキストを取得または設定します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
名前 | 型 | 説明 |
---|---|---|
value? |
string |
セルの値が<c>false</c>のときのセルのテキスト。 |
any
値が設定されていない場合は、セルの値が<c>false</c>のときのセルのテキストを返します。値が設定されている場合は、チェックボックスセル型を返します。
▸ textIndeterminate(value?
): any
セルの値が不定のとき(<c>true</c>でも<c>false</c>でもないとき)のセルのテキストを取得または設定します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
名前 | 型 | 説明 |
---|---|---|
value? |
string |
セルの値が不定のときのセルのテキスト。 |
any
値が設定されていない場合は、セルの値が不定のときのセルのテキストを返します。値が設定されている場合は、チェックボックスセル型を返します。
▸ textTrue(value?
): any
セルの値が<c>true</c>のときのセルのテキストを取得または設定します。
実例
// 次のサンプルコードは、チェックボックス型セルを作成します。
var cellType1 = new GC.Spread.Sheets.CellTypes.CheckBox();
cellType1.caption("caption");
cellType1.textTrue("true");
cellType1.textFalse("false");
cellType1.textIndeterminate("indeterminate");
cellType1.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom);
cellType1.isThreeState(true);
cellType1.boxSize(20);
activeSheet.getCell(1, 1).cellType(cellType1);
名前 | 型 | 説明 |
---|---|---|
value? |
string |
セルの値が<c>true</c>のときのテキスト。 |
any
値が設定されていない場合は、セルの値が<c>true</c>のときのテキストを返します。値が設定されている場合は、チェックボックスセル型を返します。
▸ toJSON(): any
オブジェクト状態をJSON文字列に保存します。
any
セル型データ。
▸ updateEditor(editorContext
, cellStyle
, cellRect
, context?
): Rect
エディタのサイズを更新します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
cellStyle |
Style |
セルの実際のスタイル。 |
cellRect |
Rect |
セルのレイアウト情報。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
セルラッパー要素の新しいサイズを返します。これには'width'と'height'の2つのプロパティが含まれます。
▸ updateEditorContainer(editorContext
, editorBounds
, cellStyle
): void
セルラッパー要素のサイズを更新します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
editorBounds |
Rect |
セルラッパー要素の新しいサイズ。 |
cellStyle |
Style |
セルの実際のスタイル。 |
void
▸ updateImeMode(editorContext
, imeMode
, context?
): void
エディタのIMEモードを更新します。
名前 | 型 | 説明 |
---|---|---|
editorContext |
HTMLElement |
createEditorElementメソッドによって作成されたDOM要素。 |
imeMode |
ImeMode |
セルの実際のスタイルからのIMEモード。 |
context? |
any |
セル型に関連付けられたコンテキスト。詳細については、「解説」を参照してください。 |
void