4D Doc Center : LISTBOX INSERT ROWS

4D v14.3

LISTBOX INSERT ROWS


LISTBOX INSERT ROWS ( {* ;} object ; rowPosition {; numRows} )

引数	型	説明
*	演算子	指定時, objectはオブジェクト名 (文字列) 省略時, objectは変数
object	フォームオブジェクト	オブジェクト名 (* 指定時) または変数 (* 省略時)
rowPosition	倍長整数	行挿入位置
numRows	倍長整数	挿入する行数

LISTBOX INSERT ROWSコマンドは、object引数および * で指定されたリストボックスにひとつ以上の新しい行を挿入します。

注: このコマンドは配列タイプのリストボックスに対してのみ利用できます。セレクションタイプのリストボックスに対して使用した場合、コマンドは何も行わず、OKシステム変数に0が設定されます。

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

numRowsが省略されているとデフォルトで行が1つだけ挿入されます。指定された場合、コマンドはこの引数で指定された行数を挿入します。

行はposition 引数で指定された位置に挿入されます。新しい行は、配列タイプや表示状態に関わらず、リストボックスで使用されるすべての配列のこの位置に自動で挿入されます。

position の値がリストボックスの総行数より大きい場合、行は各配列の一番最後に追加されます。0の場合、行は各配列の先頭に追加されます。負数の場合、何も行いません。