4D Doc Center : LISTBOX EXPAND

4D v14.3

LISTBOX EXPAND


LISTBOX EXPAND ( {* ;} object {; recursive {; selector {; line {; column}}}} )

引数	型	説明
*	演算子	指定時、objectはオブジェクト名 (文字列) 省略時、objectは変数
object	フォームオブジェクト	オブジェクト名 (* 指定時) または変数 (* 省略時)
recursive	ブール	True = サブレベルを展開 False = サブレベルを展開しない
selector	倍長整数	展開するリストボックスのパーツ
line	倍長整数	展開するブレーク行の番号、または展開するリストボックスレベルの番号
column	倍長整数	展開するブレーク列の番号

LISTBOX EXPAND コマンドはobjectと*で指定したリストボックスオブジェクトのブレーク行を展開するために使用します。

オプションの* 引数を渡した場合、object引数はオブジェクト名 (文字列) です。この引数を渡さない場合objectは変数です。この場合、文字列ではなく変数参照を渡します。

リストボックスが階層モードとして設定されていない場合、コマンドはなにも行いません。階層リストボックスに関する詳細は階層リストボックスの管理を参照してください。

オプションのrecursive引数を使用してリストボックスの階層サブレベルの展開を指定できます。Trueを渡すか省略すると、すべてのレベルおよびすべてのサブレベルが展開されます。Falseを渡すと指定された一番目のレベルのみが展開されます。

オプションのselector引数を使用して、コマンドのスコープを指定できます。この引数にはList Boxテーマの以下の定数のいずれかを渡すことができます:

定数	型	値	コメント
Listbox all	倍長整数	0	コマンドはすべてのサブレベルに作用します (引数省略時のデフォルト値)。
Listbox selection	倍長整数	1	コマンドは選択されたサブレベルに作用します。
Listbox break row	倍長整数	2	コマンドはrow と column引数で指定された"セル"に属するサブレベルに作用します。これらの引数は標準モードのリストボックスの行および列番号を表すことに留意してください。階層表現ではありません。row と column 引数が省略されると、コマンドは何も行いません。
Listbox level	倍長整数	3	コマンドはlevel列に対応するすべてのブレーク行に作用します。この引数は標準モードのリストボックスの列番号を指定し、階層表現を考慮しません。level引数が省略されると、コマンドはなにも行いません。

このコマンドはブレーク行を選択しません。

選択あるいはリストボックスがブレーク行を含んでいないか、すべてのブレーク行がすでに展開されている場合、コマンドはなにも行いません。

以下の例題では、コマンドのさまざまな利用方法を示します。以下の配列がリストボックスに表示されているものとします:

  //リストボックスのすべてのブレーク行とサブ行を展開する

 LISTBOX EXPAND(*;"MyListbox")

  //選択された第一レベルのブレーク行を展開する

 LISTBOX EXPAND(*;"MyListbox";False;Listbox selection)

  //"Belgium"行が選択されている場合

  //Brittanyブレーク行を展開し、サブレベルは展開しない

 LISTBOX EXPAND(*;"MyListbox";False;Listbox break row;1;2)

  //一番目の列 (国) のみを展開

 LISTBOX EXPAND(*;"MyListbox";False;Listbox level;1)