■ListView

リストビューを表すオブジェクトです。

●イベント

イベント名 

 発生タイミング

selectionchanged

選択行が変更されたとき。

reloaded

リストビューがデータをサーバーから再読み込みしたとき。

●メソッド

.getName()

リストビューの名前を取得します。

戻り値

String

.getDataTableName()

リストビューに連結されているテーブル名を取得します。

戻り値

String

.getRowCount()

リストビューに表示されているデータの行数を取得します。

戻り値

Number

.getSelectedRowIndex()

選択行の行番号を取得します。行番号は0から始まります。

戻り値

Number

.getSelectedRowIndexs()

複数選択を行っている場合の選択行の行番号を取得します。行番号は0から始まります。

戻り値

Array

.getValue( rowIndex, columnName )

リストビュー内の指定したセルの値を取得します。

パラメーター

rowIndex

Type: Number

取得したいセルの行番号。行番号は0から始まります。

columnName

Type: String

取得したいセルのリストビュー上の列名。

 

戻り値

Anything

.setValue( rowIndex, columnName, value )

リストビュー内の指定したセルに値を設定します。

パラメーター

rowIndex

Type: Number

値を設定したいセルの行番号。行番号は0から始まります。

columnName

Type: String

値を設定したいセルのリストビュー上の列名。

value

Type: Anything

 設定する値。

 

戻り値

なし

.selectRow( index )

指定したリストビューの行を選択状態にします。

パラメーター

index

Type: Number

選択状態にしたい行の行番号。行番号は0から始まります。

 

戻り値

なし

.clearAllSelectedRows()

リストビューの選択列のチェックボックスのチェックをすべて外れた状態にします。

戻り値

なし

.selectAllRows()

リストビューの選択列のチェックボックスをすべてチェックされた状態にします。

戻り値

なし

.addSelectedRow(rowIndex)

リストビューの選択列の指定した行のチェックボックスをチェックされた状態にします。

パラメーター

rowIndex

Type: Number

選択列をチェックされた状態にしたい行の行番号。行番号は0から始まります。

 

戻り値

なし

.clearSelectedRow(rowIndex)

リストビューの選択列の指定した行のチェックボックスのチェックを外れた状態にします。

パラメーター

rowIndex

Type: Number

選択列のチェックを外れた状態にしたい行の行番号。行番号は0から始まります。

 

戻り値

なし

.isSelectedRow(rowIndex)

リストビューの選択列の指定した行のチェックボックスの状態を取得します。

パラメーター

rowIndex

Type: Number

選択列のチェックボックスの状態を取得したい行の行番号。行番号は0から始まります。

 

戻り値

Boolean

.reload()

リストビューのデータをサーバーから再読み込みします。

戻り値

なし

.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()

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

戻り値

なし