編集グリッド

[編集グリッド] コントロールでは、表形式レコードのリスト表示、編集、ページネーション、検索が可能です。

デモ: 編集グリッド

Apps_Tables_Cheatsheet.zip デモ アプリをダウンロードして UiPath Studio Web にインポートします。編集グリッド コントロールを使用して、データを表示および更新するための表のチートシートを作成する方法の例をご覧ください。

全般

• 新しい列を追加 - プラス記号「+」アイコンをクリックして、データに新しい列を追加します。

• 非表示 - true の場合、実行時にコントロールが非表示になります。

• 編集可能 - false の場合、コントロールを読み取り専用としてマークします。

• 行を追加 - true の場合、アプリ ユーザーが実行時に新しい行を追加できます。false の場合、ユーザーは新しい行を追加できません。

• 行を削除 - true の場合、アプリ ユーザーに行の削除を許可します。false の場合、ユーザーは行を削除できません。

• 検索 - オンの場合、組み込みの検索機能が表示されます。

注:

[編集グリッド] 内の [日付の選択] では、時刻値を含む列の種類の編集はサポートされていません。Data Service エンティティで[時刻を除外] オプションを使用して列の設定を変更し、データのエラーを回避してください。

時刻列を含める必要がある場合は、列の [編集モード ビュー] オプションを Textbox 型に設定します。

イベント

• 選択した行 - 行を選択したときの動作を設定します。

• 行を追加 - 行が追加された際の挙動を設定します。

• 行を修正 - 行が修正された際の挙動を設定します。

• 行を削除 時 - 行が削除された際の挙動を設定します。

スタイル

• コントロールの配置 - 既定では、親の配置を継承します。親とは異なる配置を設定することもできます。既定の親の配置に戻すには、現在優先されているオプションの選択を解除します。

  注: 配置は、親に対して選択したレイアウト ([縦方向]/[横方向]) によって異なります。

• 背景色 - [グリッド ヘッダー] と [グリッド本体] の背景色です。

• 枠線 - コントロールの枠線です。枠線の太さ、色、半径を設定できます。

• フォント - 列のヘッダーと列の本文のテキスト両方のフォント属性 (フォント ファミリ、サイズ、色、スタイル (太字、斜体、下線) など) です。既定では、このコントロールの直接の親コンテナーのフォント ファミリが継承されます。その場合、フォントに「Inherited」と表示されます。

• マージン - コントロールのマージンです。既定では 4px のマージンが設定されています。[上/下] および [左/右] のプロパティがそれぞれ組み合わされています。これらのプロパティの組み合わせは、[マージン] セクションの右側にある [リンク] ボタンをクリックして解除できます。

• サイズ - コントロールの幅と高さです。既定では、サイズは [auto] に設定されています。最小値または最大値を設定するには、3 点リーダー メニューのアイコン (...) をクリックします。コントロールのサイズがオプションよりも小さい場合は、スクロール バーが表示されます。

VB のプロパティ

VB のプロパティ	データ型	説明
SelectedItem	Apps.Controls.TabularInitClass	コントロールで現在選択されている項目を参照します。
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	[表] コントロール内の値のデータ ソースを参照します。
NewItem	Apps.Controls.TabularInitClass	[行を追加] オプションによって作成される項目を参照します。[行の追加時] イベントは、このプロパティを参照します。
Editable	Boolean	[編集グリッド] を対話可能にするかどうかを指定します。
AddRows	Boolean	[編集グリッド] に行を追加できるかどうかを指定します。
DeleteRows	Boolean	[編集グリッド] から行を削除できるかどうかを指定します。
RowIndex	Integer	更新操作や削除操作の対象となる行のインデックスを参照します。データセット全体がメモリ内にあるプロセスの連携に使用する必要があります。
Search	Boolean	検索機能を有効化/無効化します。true の場合、検索が有効化されます。
Value	Apps.Controls.TabularInitClass	コントロールで現在選択されている値です。
Hidden	Boolean	true の場合、実行時にコントロールが非表示になります。
Disabled	Boolean	true の場合、実行時にコントロールを無効化します。

複雑なデータを AppsDataSource に変換する

データ テーブルまたは複雑なデータ型を AppsDataSource に変換するには、データ テーブルを変数に保存してから、.ToListSource メソッドを使用してデータをデータ テーブルから AppsDataSource に変換します。

1. データを DataTable 型の変数に保存します。たとえば、変数に「dt」という名前を付けます。
2. [表] コントロールの [データ ソース] フィールドで、以下の式を使用します。

   dt.ToListSource()

一般的に、複雑なオブジェクトは以下の構文を使用して AppsDataSource に変換できます。

Processes.ALLDATATYPES.out_datatable.ToListSource()

[表] コントロールと [編集グリッド] コントロールを持つエンティティを使用する

[表] コントロールと [編集グリッド] コントロールでエンティティを使用する方法の詳細については、「 アプリ プロジェクトで表形式コントロールを Data Service エンティティと共に使用する 」をご覧ください。

注:

• 表コントロールと編集グリッド コントロールを使用した日付の書式設定はサポートされていません。日付列を使用する場合、 DateTime 型は追加の書式設定なしで表示されます (生の値として表示されます)。これに対し、 DateOnly 型の列は、ユーザーのブラウザーのロケールと言語の設定に基づいて自動的に書式設定されます。
• エンティティを操作する場合は、[ ワークフローを作成 ] オプションを使用してページネーションを有効化することをお勧めします。エンティティ アプリの変数を データ ソース として使用することはお勧めしません。データのローカル コピーが作成され、Data Fabric からのページネーションがサポートされないためです。