INSERT LISTBOX COLUMN

4D - Documentation   French   English   German   Spanish   日本語   4D v11 SQLコマンドテーマリスト   4D v11 SQLインデックス   4D v11 SQL定数テーマリスト   戻る   前   次

version 11 (Modified)


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

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

説明

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

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

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

colNamecolVariableには、挿入する列のオブジェクト名および変数名を渡します。

・配列タイプのリストボックスの場合、列に表示する内容が格納された配列の名前を渡します。

・セレクションタイプのリストボックスの場合、colVariable引数にはフィールドまたは変数を渡します。結果列の内容は、リストボックスに関連付けられたセレクションのレコードごとに評価されるフィールドまたは変数の値となります。このタイプのコンテンツは、リストボックスの"データソース"プロパティでカレントセレクションまたは命名セレクションを指定した場合にのみ使用できます (リストボックスオブジェクトの管理 の節を参照)。文字列, 数値, 日付, 時間, ピクチャ, ブールタイプのフィールドや変数を使用できます。

セレクションをベースとするリストボックスのコンテキストでは、INSERT LISTBOX COLUMN はフィールドや変数などの単純な要素を挿入するために使用できます。フォーミュラやメソッドなどのより複雑な表現式を使用したい場合は、INSERT LISTBOX COLUMN FORMULA コマンドを使用します。

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

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

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

例題

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

   C_LONGINT(HeaderVarName;$Last;RecNum)
   ALL RECORDS([Table1])
   $RecNum:=Records in table([Table1])
   ARRAY PICTURE(Picture;$RecNum)

   $Last:=Get number of listbox columns(*;"ListBox1")+1
   INSERT LISTBOX COLUMN(*;"ListBox1";$Last;"ColumnPicture";Picture;"HeaderPicture";HeaderVarName)

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

   $last:=Get number of listbox columns(*;"ListBox1")+1
   INSERT LISTBOX COLUMN(*;"ListBox1";$last;"FieldCol";[Transport]Fees;"HeaderName";HeaderVar)

参照

DELETE LISTBOX COLUMN, INSERT LISTBOX COLUMN FORMULA.


4D - Documentation   French   English   German   Spanish   日本語   4D v11 SQLコマンドテーマリスト   4D v11 SQLインデックス   4D v11 SQL定数テーマリスト   戻る   前   次