4D v16.3

LISTBOX SELECT ROW

ホーム

 
4D v16.3
LISTBOX SELECT ROW

LISTBOX SELECT ROW 


 

LISTBOX SELECT ROW ( {* ;} object ; rowPosition {; action} )  
引数   説明
演算子 in 指定時, objectはオブジェクト名 (文字列) 省略時, objectは変数
object  フォームオブジェクト in オブジェクト名 (* 指定時) または 変数 (* 省略時)
rowPosition  倍長整数 in 選択する行番号
action  倍長整数 in 選択アクション

説明   

LISTBOX SELECT ROW コマンドは、 object引数および * で指定されたリストボックス内において、positionに渡した番号の行を選択します。

オプションの引数 * を渡すことにより、object引数がオブジェクト名(文字列)であることを示します。この引数を渡さない場合、object引数が変数であることを示します。この場合、文字列ではなく変数参照を指定します。オブジェクト名についての詳細はオブジェクトプロパティを参照してください。

オプション引数actionを指定すると、行の選択がリストボックス内に既に存在している場合に実行する選択アクションを指定できます。この引数には値または次の定数のいずれかを渡すことができます(List Boxテーマ):

定数 コメント
lk add to selection 倍長整数 1 選択された行は既存の選択行に追加されます。指定した行が既存の選択に属している場合、コマンドは何も行いません。
lk remove from selection 倍長整数 2 指定された行は既存の選択行から取り除かれます。指定した行が既存の選択に属さない場合、コマンドは何も行いません。
lk replace selection 倍長整数 0 選択された行が新しい選択行となり、既存のものと置き換えられます。このコマンドは、ユーザが行をクリックした場合と同じ結果になります。これは (action 引数が省略された時の) デフォルトの動作です。
position引数が既存の行番号と一致しない時、コマンドは以下のように動作します:

  • positionが0より小さい場合、actionの値に関係なく、何もしません。
  • positionが0かつ、actionの値がlk replace selectionまたは省略された場合、リストボックスのすべての行が選択されます。actionの値がlk remove from selectionの場合、リストボックスのすべての行の選択が解除されます。
  • positionがリストボックスに含まれるすべての行数より大きい場合 (配列タイプのリストボックスの場合のみ)、リストボックスと関連づけられているブール配列が自動的にリサイズされ、選択アクションが行われます。このメカニズムは、LISTBOX SELECT ROW を、リストボックスで即座の同期を起こさない"標準"の配列管理コマンド (APPEND TO ARRAYなど) とともに使用できることを意味します。

メソッドの実行後、配列は同期されます。リストボックスのソース配列が実際にリサイズされたならば、選択アクションは実行されます。そうでなければリストボックスと関連づけられたブールの配列はその初期のサイズに戻り、コマンドは何もしません。

Notes:

  • 選択した列をリストボックスに表示するために、自動でスクロールしたい場合、OBJECT SET SCROLL POSITIONコマンドを使います。
  • 列を編集モードに切り換えるには、EDIT ITEMコマンドを使います。
  • position に渡された数値が、リストボックス中で非表示の行に該当する場合、行は選択されますが表示されません。



参照 

EDIT ITEM
LISTBOX DELETE ROWS
LISTBOX INSERT ROWS
LISTBOX SELECT BREAK
OBJECT SET SCROLL POSITION

 
プロパティ 

プロダクト: 4D
テーマ: リストボックス
番号: 912

 
履歴 

変更: 4D v11 SQL Release 2
名称変更: 4D v12

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v16)
ランゲージリファレンス ( 4D v16.1)
ランゲージリファレンス ( 4D v16.2)
ランゲージリファレンス ( 4D v16.3)