■Cell

セルを表すオブジェクトです。

●イベント

イベント名 

 使用可能なセル型

 発生タイミング

valuechanged

すべてのセル型

セルの値が変更されたとき。

click

標準、ボタン、ハイパーリンク、画像

セルがクリックされたとき。

mouseenter

標準、ボタン、ハイパーリンク、画像

マウスなどのポインティングデバイスがセルの領域内に入ったとき。

mouseleave

標準、ボタン、ハイパーリンク、画像

マウスなどのポインティングデバイスがセルの領域内から外に出たとき。

selectionchanged

コンボボックス、ユーザー選択コンボボックス

選択項目が変更されたとき。

 

●メソッド

.getValue()

セルの値を取得します。

戻り値

Anything

.setValue( value )

セルに値を設定します。

パラメーター

value

Type: Anything

設定するセルの値。

 

戻り値

なし

.disable()

セルのユーザーとの対話を無効化します。

戻り値

なし

.enable()

セルのユーザーとの対話を有効化します。

戻り値

なし

.hide()

セルを非表示にします。

戻り値

なし

.show()

非表示となっているセルを表示します。

戻り値

なし

.setBackColor( color )

セルの背景色を設定します。

パラメーター

color

Type: Anything

設定する背景色の色。"red"や"#FF0000"などの値を指定。

 

.setForeColor( color )

セルの文字色を設定します。

パラメーター

color

Type: Anything

設定する文字色の色。"red"や"#FF0000"などの値を指定。

 

.bind( evenType [, eventData ], handler )

セルが持つイベントに対してイベントハンドラを紐づけます。

標準アクションの停止

紐づけたイベントの元々の動作をキャンセルするには、戻り値にfalseを返します。これにより、イベントバブリングも停止されるため、親要素が持つイベントの発生もキャンセルされます。

イベントへのデータの受け渡し

イベントハンドラにデータを受け渡すには、第2パラメーターに指定します。その場合、イベントハンドラは第3パラメーターに指定します。 受け渡されたデータは、イベントハンドラに渡されるjQueryイベントオブジェクトのdataプロパティから参照できます。

パラメーター

eventType

Type: String

紐づけするイベントを表す文字列。

eventData(オプション)

Type: Anything

イベントハンドラに渡すデータ。関数ではパラメーターであるjQueryイベントオブジェクトのdataプロパティから参照します。

handler

Type: Function( Event eventObject )

イベント発生時に実行される関数。

 

戻り値

なし 

.unbind( eventType [, handler ] ) 

指定したイベントハンドラの紐づけを削除します。第2パラメーターを省略した場合、指定イベントに紐づけされたすべてのイベントハンドラが削除されます。

パラメーター

eventType

Type: String

紐づけを削除するイベントを表す文字列。

handler(オプション)

Type: Function( Event eventObject )

紐づけを削除するイベントハンドラの関数。

 

戻り値

なし 

.unbindAll()

要素からすべてのイベントハンドラを削除します。

戻り値

なし