4D Doc Center : Selected list items

4D v14.3

Selected list items


Selected list items ( {* ;} list {; itemsArray {; *}} ) -> 戻り値

引数	型	説明
*	演算子	指定時, listはオブジェクト名 (文字列) 省略時, listはリスト参照番号
list	ListRef, 文字	リスト参照番号 (* 省略時), またはリストオブジェクト名 (* 指定時)
itemsArray	倍長整数配列	2番目の * 省略時: 配列にはリスト中で選択された項目の位置配列が返される 2番目の * 指定時: 配列には選択された項目の参照が返される
*	演算子	省略時: 項目位置指定時: 項目参照
戻り値	倍長整数	2番目の * 省略時: 展開/折りたたまれたされたリスト中現在選択されている項目位置 2番目の * 指定時: 選択されている項目の参照

説明

Selected list items コマンドは、list引数に渡された参照番号またはオブジェクト名のリストにおいて、選択された項目の位置または参照番号を返します。

オプションの第一引数 * を渡すと、list 引数はフォーム上のリストオブジェクトに対応するオブジェクト名 (文字列) です。この引数を渡さない場合、list 引数は階層リスト参照 (ListRef) です。リストオブジェクトを一つしか使わない場合または2番目の * を渡して項目参照番号を扱う場合、両方のシンタックスを使用できます。他方フォーム上に同じ階層リストを参照する複数のオブジェクトがあり、2番目の * を省略して項目位置を扱う場合、それぞれのオブジェクトが個別に展開/折りたたみ状態をもつので、オブジェクト名に基づくシンタックスを使用しなければなりません。

Note: オブジェクト名に @ 文字を使用することで、名前に対応するオブジェクトが複数検索された場合、Selected list items コマンドは最初に見つけたオブジェクトを処理の対象とします。

複数の項目が選択される場合、コマンドはitemsArray 配列に選択された項目の参照または位置を返します。ユーザが選択した項目を知るために、フォーム上のリストに対しこのコマンドを適用できます。

2番目の * 引数は、項目位置を扱うか (省略時)、項目参照を扱うか (指定時) を指定します。

itemsArray引数には倍長整数タイプの配列を渡すことができます。必要に応じ、関数は配列の作成やサイズ調整を行います。コマンドの実行後、itemsArrayには次の要素が代入されます:

2番目の引数 * を省略した場合、リストの展開/折りたたみ状態に相対的な各選択項目の位置。
2番目の引数 * を渡した場合、各選択項目の固定参照。

選択された項目が存在しない場合、空の配列が返されます。

Note: 選択項目が複数存在する場合、コマンドはlistのカレント項目位置あるいは参照番号を戻り値として返します。カレント項目は、ユーザが最後にクリックした項目（手動による選択の場合）またはSELECT LIST ITEMS BY POSITIONやSELECT LIST ITEMS BY REFERENCEコマンドで最後に指定された項目（プログラムによる選択の場合）のいずれかになります。

リストにサブリストがある場合、このコマンドサブリストではなく、メインリスト（フォームで実際に定義されたリスト）に適用します。位置は、リストとそのサブリストの現在の展開または縮小状態を用いて、メインリストの最上位の項目と相対的に表わされます。

いずれの場合でも、選択された項目が存在しない場合、関数は0を返します。

例題

次は、アプリケーションモードで表示されたhListという名前のリストです:

$vlItemPos:=Selected list items(hList) ` この時点で$vlItemPos は 2

 $vlItemPos:=Selected list items(hList) ` この時点で$vlItemPos は4

 $vlItemRef:=Selected list items(hList;*) ` $vlItemRef は200 (例えば)

 $vlItemPos:=Selected list items(hList) ` この時点で$vlItemPos は8

 $vlItemRef:=Selected list items(hList;*) ` $vlItemRef は203 (例えば)

 $vlItemPos:=Selected list items(hList;$arrPos) ` この時点で$vlItemPos は3

  ` $arrPos{1} は3, $arrPos{2} は 4 そして $arrPos{3} は 5

 $vlItemRef:=Selected list items(hList;$arrRefs;*) ` $vlItemRef は203 (例えば) ` $arrRefs{1} は101, $arrRefs{2} は203 (例えば)