4D Doc Center : INSERT IN LIST

4D v14.3

INSERT IN LIST


INSERT IN LIST ( {* ;} list ; beforeItemRef \| * ; itemText ; itemRef {; sublist ; expanded} )

引数	型	説明
*	演算子	指定時, listはオブジェクト名 (文字列) 省略時, listはリスト参照番号
list	ListRef, 文字	リスト参照番号 (* 省略時), またはリストオブジェクト名 (* 指定時)
beforeItemRef \| *	倍長整数, 演算子	項目参照番号または 0: リストに最後に追加された項目または *: 現在選択されている項目
itemText	文字	新しいリスト項目のテキスト
itemRef	倍長整数	新しいリスト項目のユニークな参照番号
sublist	ListRef	新しいリスト項目に添付するオプションのサブリスト
expanded	ブール	サブリストの展開/折りたたみ状態を指定

説明

INSERT IN LIST コマンドは、listに渡されたリスト参照番号またはオブジェクト名のリストに新規項目を挿入します。

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

beforeItemRef 引数は、新規リスト項目を挿入する位置を指定するために用います:

リストに最後追加された項目の前に新しい項目を挿入するには値0を渡します。そして新しく挿入された項目が選択されます。
現在選択されている項目の前に新しい項目を挿入するには * を指定します。そして新しく挿入された項目が選択されます。
特定の項目の前に挿入するには、その項目の参照番号を渡します。この場合新しく挿入された項目は自動的には選択されません。項目参照番号に対応する項目がない場合、コマンドは何もしません。

新規項目のテキストと項目参照番号をitemTextとitemRefに渡します。

項目にサブ項目を設定する場合は、sublist に有効なリスト参照を渡します。この場合サブリストを展開または縮小を指定するexpanded引数を渡さなければなりません。TrueまたはFalseの指定に従い、サブリストは展開または折りたたまれます。

例題

以下のコードは、リストhListの現在選択されている項目の直前に項目を挿入します（サブリストは添付されていません）:

 vlUniqueRef:=vlUniqueRef+1

 INSERT IN LIST(hList;*;"New Item";vlUniqueRef)