4D v14.3

INSERT IN LIST

ホーム

 
4D v14.3
INSERT IN LIST

INSERT IN LIST 


 

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

説明   

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

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

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

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

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

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

例題  

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

 vlUniqueRef:=vlUniqueRef+1
 INSERT IN LIST(hList;*;"New Item";vlUniqueRef)

 
プロパティ 

プロダクト: 4D
テーマ: 階層リスト
番号: 625

 
履歴 

変更: 4D v11 SQL

 
参照 

APPEND TO LIST

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v12.4)
ランゲージリファレンス ( 4D v11 SQL Release 6)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)