4D Doc Center : LISTBOX INSERT COLUMN

4D v14.3

LISTBOX INSERT COLUMN


LISTBOX INSERT COLUMN ( {* ;} object ; colPosition ; colName ; colVariable ; headerName ; headerVar {; footerName ; footerVar} )

引数	型	説明
*	演算子	指定時, objectはオブジェクト名 (文字列) 省略時, objectは変数
object	フォームオブジェクト	オブジェクト名 (* 指定時) または変数 (* 省略時)
colPosition	倍長整数	列の挿入場所
colName	文字	列オブジェクト名
colVariable	配列, フィールド, 変数	列配列名またはフィールドまたは変数
headerName	文字	列ヘッダオブジェクト名
headerVar	整数変数	列ヘッダ変数
footerName	文字	列フッターオブジェクト名
footerVar	変数	列フッター変数

説明

LISTBOX INSERT COLUMNコマンドは、object引数および * で指定されたリストボックスに列を挿入します。

注: このコマンドは階層モードで表示されているリストボックスの先頭列に適用されてもなにも行いません。

オプションの引数 * を渡すことにより、object引数がオブジェクト名（文字列）であることを示します。この引数を渡さない場合、object引数が変数であることを示します。この場合、文字列ではなく変数参照を指定します。オブジェクト名についての詳細はオブジェクトプロパティを参照してください。

新しい列は、colPosition引数で指定された列の直前に挿入されます。colPosition引数の値が列の合計数よりも大きい場合、最後の列の後ろにカラムが追加されます。

colNameとcolVariableには、挿入する列のオブジェクト名および変数名を渡します。
・配列タイプのリストボックスの場合、列に表示する内容が格納された配列の名前を渡します。
・セレクションタイプのリストボックスの場合、colVariable引数にはフィールドまたは変数を渡します。結果列の内容は、リストボックスに関連付けられたセレクションのレコードごとに評価されるフィールドまたは変数の値となります。このタイプのコンテンツは、リストボックスの"データソース"プロパティでカレントセレクションまたは命名セレクションを指定した場合にのみ使用できます (リストボックスオブジェクトの管理を参照)。文字列, 数値, 日付, 時間, ピクチャ, ブールタイプのフィールドや変数を使用できます。
セレクションをベースとするリストボックスのコンテキストでは、LISTBOX INSERT COLUMNはフィールドや変数などの単純な要素を挿入するために使用できます。フォーミュラやメソッドなどのより複雑な表現式を使用したい場合はLISTBOX INSERT COLUMN FORMULAコマンドを使用します。

注: 同じリストボックス内で、配列をデータソースとする列と、フィールドや変数をデータソースとする列を混在させることはできません。

headerNameとheaderVarには、挿入される列のヘッダのオブジェクト名および変数を渡します。

footerNameとfooterVarにも、挿入される列のヘッダのオブジェクト名および変数を渡すことができます。

注: オブジェクト名は、フォーム内で重複してはいけません。colNameやheaderName、footerNameに渡される名前が既に使用されていないことを確認してください。重複した名前を指定すると、列は作成されず、エラーが生成されます。

例題 1

リストボックスの最後に列を追加します:

 C_LONGINT(HeaderVarName;$Last;RecNum)

 ALL RECORDS([Table1])

 $RecNum:=Records in table([Table1])

 ARRAY PICTURE(Picture;$RecNum)

 

 $Last:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$Last;"ColumnPicture";Picture;"HeaderPicture";HeaderVarName)

例題 2

リストボックスの右に列を追加し、[Transport]Fees フィールドの値を関連付けます:

 $last:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$last;"FieldCol";[Transport]Fees;"HeaderName";HeaderVar)