セルを表すオブジェクトです。
イベント名 |
使用可能なセル型 |
発生タイミング |
---|---|---|
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()
要素からすべてのイベントハンドラを削除します。
戻り値
なし