4D v16.3Selected list items |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
Selected list items
Selected list items
Selected list items コマンドは、list引数に渡された参照番号またはオブジェクト名のリストにおいて、選択された項目の位置または参照番号を返します。 オプションの第一引数 * を渡すと、list 引数はフォーム上のリストオブジェクトに対応するオブジェクト名 (文字列) です。この引数を渡さない場合、list 引数は階層リスト参照 (ListRef) です。リストオブジェクトを一つしか使わない場合または2番目の * を渡して項目参照番号を扱う場合、両方のシンタックスを使用できます。他方フォーム上に同じ階層リストを参照する複数のオブジェクトがあり、2番目の * を省略して項目位置を扱う場合、それぞれのオブジェクトが個別に展開/折りたたみ状態をもつので、オブジェクト名に基づくシンタックスを使用しなければなりません。 Note: オブジェクト名に @ 文字を使用することで、名前に対応するオブジェクトが複数検索された場合、Selected list items コマンドは最初に見つけたオブジェクトを処理の対象とします。 複数の項目が選択される場合、コマンドはitemsArray 配列に選択された項目の参照または位置を返します。ユーザが選択した項目を知るために、フォーム上のリストに対しこのコマンドを適用できます。 2番目の * 引数は、項目位置を扱うか (省略時)、項目参照を扱うか (指定時) を指定します。 itemsArray引数には倍長整数タイプの配列を渡すことができます。必要に応じ、関数は配列の作成やサイズ調整を行います。コマンドの実行後、itemsArrayには次の要素が代入されます: 選択された項目が存在しない場合、空の配列が返されます。 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 $vlItemPos:=Selected list items(hList) ` この時点で$vlItemPos は8 $vlItemPos:=Selected list items(hList;$arrPos) ` この時点で$vlItemPos は3 $vlItemRef:=Selected list items(hList;$arrRefs;*) ` $vlItemRef は203 (例えば) ` $arrRefs{1} は101, $arrRefs{2} は203 (例えば)
参照
SELECT LIST ITEMS BY POSITION
|
プロパティ
プロダクト: 4D
履歴
変更: 4D v11 SQL ARTICLE USAGE
ランゲージリファレンス ( 4D v16) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||