Power Apps での Data table コントロール

[アーティクル]
03/09/2022

一連のデータを表形式で表示します。

内容

Data table コントロールには、コントロールが表示する各フィールドの列ヘッダーを含む形式でデータセットが表示されます。アプリの制作者は、表示するフィールドとその順序を完全に制御できます。 Data table コントロールでは、Gallery コントロールのように、選択した行を指す Selected プロパティが保持されます。したがって、Data table コントロールは他のコントロールにリンクできます。

機能

Power Apps では、2017 年 5 月 5 日に Data table コントロールが導入されました。このセクションでは、サポートされている機能とサポートされていない機能に関する情報を提供します。

入手可能

Data table コントロールのデータは読み取り専用です。
Data table コントロールでは常に単一行が選択されます。
Data table コントロールを接続されたデータソースまたはローカルデータソースにリンクします。
アプリの実行中に Data table コントロールの列幅を調整しますが、変更は保存されません。
Microsoft Dataverse など、この機能を実装したコネクターにリンクすると、一連の既定フィールドが Data table コントロールに表示されます。その後、必要に応じてこれらのフィールドや他のフィールドを表示または非表示にできます。
列幅や見出しテキストをカスタマイズします。
Data table コントロールでのハイパーリンクを表示します。
Data table コントロールをコピーして貼り付けます。

現時点では利用不可

個々の列のスタイルをカスタマイズします。
Data table コントロールをフォームコントロールに追加します。
すべての行の高さを変更します。
Data table コントロールで画像を表示します。
関連テーブルのフィールドを表示します。
組み込み機能を使用して列見出しによるデータのフィルター処理および並べ替えをします。
Data table コントロールを Gallery コントロールに追加します。
Data table コントロールでデータを編集します。
複数行を選択します。

既知の問題

Items プロパティで FirstN 関数を使用すると、データが表示されません。

主要なプロパティ

Items – Data table コントロールに表示されるデータのソース。
Selected – Data table コントロールで選択された行。

その他のプロパティ

AutoWidth - 列の幅を自動にするか手動にするかを定義する、データテーブル内の列のプロパティです。
BorderColor – Data table コントロールの境界線の色。
BorderStyle – Data table コントロールの境界線のスタイル。オプションは、実線、破線、点線、およびなしです。
BorderThickness – Data table コントロールの境界線の太さ。
Color – すべてのデータ行の既定のテキスト色。
FieldDisplayName - 選択された列の表示名を定義するデータテーブル内の列のプロパティです。
Fill – すべてのデータ行の既定の背景色。
Font – すべてのデータ行の既定のフォント。
FontWeight – すべてのデータ行の既定のフォントの太さ。
HeadingColor – 列見出しのテキストの色。
HeadingFill – 列見出しの背景色。
HeadingFont – 列見出しのフォント。
HeadingFontWeight – 列見出しのフォントの太さ。
HeadingSize – 列見出しのフォントサイズ。
Height – Data table コントロールの上端と下端間の距離。
HoverColor – マウスポインターが指している行のテキストの色。
HoverFill – マウスポインターが指している行の背景色。
IsHyperlink - 選択された列をハイパーリンク形式にするかどうかを定義するデータテーブル内の列のプロパティです。
NoDataText – Data table コントロールに表示するレコードがないときに、ユーザーが受け取るメッセージ。
Order - 他の列に対応する列の順序を決定するデータテーブル内の列のプロパティです。順序は左から右に始まり、最初の列の順序値は1を1とします。
SelectedColor – 選択された行のテキストの色。
SelectedFill – 選択した行の背景色。
Size – すべてのデータ行の既定のフォントサイズ。
Text - 選択されたカラム内に表示するデータのテキスト値を定義する、データテーブル内のカラムのプロパティです。
Visible – Data table コントロールが表示または非表示になるかを決定する値。
Width – Data table コントロールの左端と右端間の距離。
X – Data table コントロールの左端とその親コンテナーの左端 (親コンテナーがない場合は画面の左端) との間の距離。
Y – Data table コントロールの上端とその親コンテナーの上端 (親コンテナーがない場合は画面の上端) との間の距離。

Filter(DataSource, 数式)(DataSource, 数式)
Search(DataSource、SearchString、列)(DataSource、SearchString、列)

例

基本的な使用方法

空白のタブレットアプリを作成します。
挿入タブで、Data table をクリックまたはタップします。

Data table コントロールが画面に追加されます。
Data table コントロールを SalesOrderTable に名前変更し、画面全体をカバーするようにサイズ変更します。
右側のペインで、データソース を選択し、受注を選択します。テーブルがリストされていない場合は、テーブルを検索して Microsoft Dataverse に接続します。

Data table コントロールが受注データソースに添付されるようになりました。その機能をサポートするコネクタを使用しているため、いくつかの初期フィールドが Data table コントロールに表示されます。
右側のウィンドウで、1 つ以上のチェックボックスを選択して、個々のフィールドを表示または非表示にします。

たとえば、CustomerPurchaseOrderReference の横にあるチェックボックスを選択して、このフィールドを非表示にします。
右側のウィンドウで、フィールドを上下にドラッグして、フィールドの順序を変更します。

SalesOrderTable コントロールでは、指定した順序でフィールドが表示されます。

Data table コントロールのヘッダーをスタイル変更する

Data table コントロールが選択されている間に、右側のウィンドウの詳細タブをクリックまたはタップします。
HeadingFill プロパティのフィールドをクリックまたはタップしてから、値を RGBA(62,96,170,1) に変更します。
HeadingColor プロパティのフィールドをクリックまたはタップしてから、値を白に変更します。
HeadingSize プロパティのフィールドをクリックまたはタップしてから、値を 14 に変更します。

Data table コントロールを別のコントロールに接続する

Edit form コントロールを画面に追加します。
Data table と Edit form コントロールのサイズを変更して、Data table コントロールが画面の左側、Edit form コントロールが画面の右側の部分に表示されるようにします。
Form1 が選択されている間に、右側のウィンドウで、列の数を 1 に変更します。
Form1 を受注データソースに接続します。

いくつかの初期フィールドが Form1 に表示されます。
右側のウィンドウで、詳細タブをクリックまたはタップします。
Form1 の Item プロパティを SalesOrderTable.Selected に設定します。

Form1 には、Data table コントロールで選択された行からの情報が表示されます。

アクセシビリティのガイドライン

色のコントラスト

次の間には適切な色のコントラストが必要です:

Color と Fill
HeadingColor と HeadingFill
SelectedColor と SelectedFill
HoverColor と HoverFill

これは、標準の色のコントラスト要件に追加されるものです。

NoDataText が存在する必要があります。

注意

ドキュメントの言語設定についてお聞かせください。簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。個人データは収集されません (プライバシーステートメント)。