VP Get table dirty rows
履歴
| リリース | 内容 |
|---|---|
| 19 R8 | 追加 |
VP Get table dirty rows ( vpAreaName : Text ; tableName : Text { ; reset : Boolean {; sheet : Integer }} ) : Collection
| 引数 | 型 | 説明 | |
|---|---|---|---|
| vpAreaName | Text | -> | 4D View Pro フォームオブジェクト名 |
| tableName | Text | -> | Table name |
| reset | Boolean | -> | 現在の表から "ダーティ" ステータスをクリアするには true、そのままにするには false を指定します。 デフォルト = true デフォルト = true |
| sheet | Integer | -> | シートのインデックス (省略した場合はカレントシート) |
| 戻り値 | Collection | <- | 前回のリセット以降に変更された全項目を格納するオブジェクトのコレクション |
説明
VP Get table dirty rows コマンドは、tableName が指定する表組みの前回のリセット以降に変更された項目を含む dirty row ("ダーティ" な行) のオブジェクトのコレクションを返します。
vpAreaName には、4D View Pro エリアの名前を渡します。
tableName には、変更された行を取得したい表組みの名称を渡します。なお、データコンテキスト にバインドされている列の変更のみが考慮されます。
デフォルトでは、このコマンドを呼び出すと、現在のテーブルから ダーティ のステータスをクリアします。この状態をリセットせずに維持するには、reset に false を渡します。
sheet には、ターゲットシートのインデックスを渡します。 index が省略された場合、または -1 が渡された場合、コマンドはカレントシートに対して適用されます。
インデックスは 0 起点です。
返されるコレクション内の各 dirty row ("ダーティ" な行) オブジェクトは、以下のプロパティを含みます:
| プロパティ | 型 | 説明 |
|---|---|---|
| item | object | 変更された行の変更オブジェクト |
| originalItem | object | 変更前のオブジェクト |
| row | integer | 変更された行のインデックス |
tableName が見つからない場合、または変更された列が含まれていない場合、コマンドは空のコレクションを返します。
例題
変更された行の数を取得します:
var $dirty : Collection
$dirty:=VP Get table dirty rows("ViewProArea"; "ContextTable"; False)
VP SET NUM VALUE(VP Cell("ViewProArea"; 0; 0); $dirty.length)
参照
VP CREATE TABLE
VP Find table
VP SET TABLE COLUMN ATTRIBUTES
VP RESIZE TABLE