メインコンテンツまでスキップ
バージョン: 20 R6 BETA

VP INSERT TABLE ROWS

履歴
リリース内容
19 R7追加

VP INSERT TABLE ROWS ( vpAreaName : Text ; tableName : Text ; row : Integer {; count : Integer {; insertAfter : Integer {; sheet : Integer }}} )

引数説明
vpAreaNameText->4D View Pro フォームオブジェクト名
tableNameText->Table name
rowInteger->行の挿入場所を指定する表組み内のインデックス
countText->挿入する行の数 (>0)
insertAfterInteger->vk table insert before または vk table insert after
sheetInteger->シートのインデックス (省略した場合はカレントシート)

説明

VP INSERT TABLE ROWS コマンドは、tableName で指定した表組みの row で指定した行インデックスに、1つまたは count で指定した数の空の行を挿入します。

insertAfter パラメーターに以下の定数のいずれかを渡すことで、row に指定した行インデックスの前または後に行を挿入するかを指定できます。

定数説明
vk table insert before0row の前に行を挿入します (省略時のデフォルト)
vk table insert after1row の後に行を挿入します

このコマンドは、シート内ではなく、tableName の表組みに行を挿入します。 したがって、シートの総行数は、このコマンドの影響を受けません。 表組みより下側にデータがある場合は、挿入された行の数に応じて自動的に下に移動します。

tableName の表組みが データコンテキスト にバインドされている場合、このコマンドはコレクションに新しい空の要素を挿入します。

tableName の表組みが存在しない場合、あるいはシートに十分なスペースがない場合は、何も起こりません。

例題

データコンテキストを使用した表組みを作成します:

var $context : Object
$context:=New object()

$context.col:=New collection
$context.col.push(New object("name"; "Smith"; "salary"; 10000))
$context.col.push(New object("name"; "Wesson"; "salary"; 50000))
$context.col.push(New object("name"; "Gross"; "salary"; 10500))

VP SET DATA CONTEXT("ViewProArea"; $context)

VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; 3; 3); "PeopleTable"; "col")

表組みに 2行と 2列を挿入したい場合、次のように書きます:

VP INSERT TABLE ROWS("ViewProArea"; "PeopleTable"; 1; 2)
VP INSERT TABLE COLUMNS("ViewProArea"; "PeopleTable"; 1; 2)

参照

VP INSERT TABLE COLUMNS
VP REMOVE TABLE ROWS