SET LIST ITEM PARAMETER

4D v20.1


SET LIST ITEM PARAMETER ( {* ;} list ; itemRef \| * ; selector ; value )

引数	型	説明
*	演算子	指定時, listはオブジェクト名 (文字列) 省略時, listはリスト参照番号
list	ListRef, 文字	リスト参照番号 (* 省略時), またはリストオブジェクト名 (* 指定時)
itemRef \| *	演算子, 倍長整数	項目参照番号, または 0: リストに最後に追加された項目, または *: リスト中のカレント項目
selector	文字	パラメタ定数
value	文字, ブール, 実数	パラメタ値

説明

SET LIST ITEM PARAMETERコマンドは、リスト参照またはオブジェクト名をlistに指定したリスト中、itemRef引数で指定した項目のselector パラメタを設定するために使用します。

1番目の * 引数を渡した場合、list 引数はフォーム中のリストオブジェクトのオブジェクト名 (文字列) です。この引数を渡さない場合、list 引数はリスト参照番号 (ListRef) です。1つしかフォーム上でリストオブジェクトを使用しない、または2番目の * を省略してリスト構造を処理対象とする場合、いずれのシンタックスも使用できます。同じリストの複数のリストオブジェクトがフォーム上にあり、2番目の * を渡してカレントの項目を処理する場合、リストオブジェクトごとにカレント項目が異なるため、オブジェクト名に基づくシンタックスを使用しなければなりません。

itemRefには参照番号を渡すことができます。渡した項目参照番号を持つ項目が存在しない場合、コマンドは何も行いません。オプションとしてitemRefに0を渡し、APPEND TO LISTコマンドを用いてリストへ最後に追加される項目を指定することができます。
最後に、itemRefには * を渡すことができます。この場合、コマンドはリストのカレント項目に対して適用されます。手動で複数のリスト項目が選択されている場合、最後に選択された項目がカレントリスト項目になります。選択された項目が存在しない場合、コマンドは何も行いません。

selector には、以下のいづれかを渡すことができます:

(“Hierarchical Lists” テーマ内にある)以下の定数のいづれか一つ:

定数	型	値	コメント
Additional text	文字列	4D_additional_text	この定数はitemRef 参照で参照する項目の右側にテキストを追加するのに使用します。この追加のタイトルは常にリストの右側に表示され、たとえユーザーが水平スクロールカーソルを移動させた場合でも表示されます。この定数を使用する場合、表示されるテキストをvalue 引数に渡します。
Associated standard action	文字列	4D_standard_action_name	itemRef 参照に標準アクションを割り当てます。この場合、value 引数に標準アクション名と引数を渡す必要があります。例: "fontSize?value=10pt"。詳細な情報については、デザインリファレンスマニュアルの標準アクションの章を参照してください。

カスタムのセレクター: selector 引数にカスタムのテキストを渡し、テキスト、数値、ブール型の値と関連づけることができます。この値はリスト項目に格納され、GET LIST ITEM PARAMETER コマンドを使用して取り出すことができます。これにより階層リストに関連づけられたどのようなインタフェースもセットアップできます。例えば顧客名リストにおいて、年齢をリスト項目に関連付け、項目が選択されたときにのみそれを表示させることなどができます。

例題

階層ポップパップメニューに選択リストを割り当て、標準アクション機能を使用してそのリストでフォントサイズ値の一覧を管理したい場合を考えます:

 $myList:=New list

 APPEND TO LIST($myList;ak standard action title;1)

 APPEND TO LIST($myList;ak standard action title;2)

 APPEND TO LIST($myList;ak standard action title;3)

 SET LIST ITEM PARAMETER($myList;1;Associated standard action;"fontSize?value=10pt")

 SET LIST ITEM PARAMETER($myList;2;Associated standard action;"fontSize?value=12pt")

 SET LIST ITEM PARAMETER($myList;3;Associated standard action;"fontSize?value=14pt")

 OBJECT SET LIST BY REFERENCE(*;"popup";Choice list;$myList)

参照

APPEND TO LIST
Get action info
GET LIST ITEM PARAMETER
GET LIST ITEM PARAMETER ARRAYS
INSERT IN LIST