Power Apps のデータ テーブル コントロール

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

Description

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

制限事項

データ テーブル コントロールには、次の制限があります。

• Items プロパティが Filter 関数を含む数式に設定されているデータ テーブル コントロールをコピーして貼り付けると、新しいデータ テーブル コントロールの Items プロパティの数式は、_1 サフィックスを含むフィールド名になります。 これにより、フィールド名が無効になり、データ テーブルにデータが表示されなくなります。 この問題を回避するには、コントロールをコピーする前に、 Filter 関数がデータ テーブル コントロールの 列と同じ名前を持つデータ ソース内のフィールドを参照していないことを確認します。 その場合は、 データ テーブル コントロールの列の名前を変更します。 または、テーブル内の名前と一致するように、無効なフィールド名から _1 サフィックスを削除します。

能力

Power Apps では、2017 年 5 月 5 日に データ テーブル コントロールが導入されました。 このセクションでは、サポートされている機能とサポートされていない機能について説明します。

利用可能になりました

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

現時点では利用不可

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

既知の問題

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

重要なプロパティ

• 項目 – データ テーブル コントロールに表示される データ のソース。
• [選択済み] – [データ テーブル ] コントロールで選択した行。

その他のプロパティ

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

関連する関数

• Filter(DataSource, Formula)(DataSource, Formula)
• Search(DataSource, SearchString, Column)(DataSource, SearchString, Column)

例示

基本的な使用方法

1. 空のタブレット アプリを作成します。

2. [ 挿入 ] タブで、[ データ テーブル] をクリックまたはタップします。

   

   データ テーブル コントロールが画面に追加されます。

3. データ テーブル コントロール SalesOrderTable の名前を変更し、画面全体をカバーするようにサイズを変更します。

4. 右側のウィンドウで、[ データ ソース] を選択し、[販売注文] を選択 します。 テーブルが一覧にない場合は、テーブルを検索して、Microsoft Dataverse に接続します。

   

   これで、Data テーブル コントロールが販売注文データ ソースにアタッチされました。 データ テーブル コントロールには、その機能をサポートするコネクタを使用しているため、いくつかの初期フィールドが表示されます。

   

5. 右側のウィンドウで、1 つ以上のチェック ボックスをオンにして、個々のフィールドを表示または非表示にします。

   たとえば、 CustomerPurchaseOrderReference の横にあるチェック ボックスをオンにして、このフィールドを非表示にします。

6. 右側のウィンドウで、フィールドを上下にドラッグして並べ替えます。

   

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

   

データ テーブル コントロールのヘッダーのスタイルを設定し直す

1. [データ テーブル] コントロールが選択されている間、右側のウィンドウで [詳細設定] タブをクリックまたはタップします。

2. HeadingFill プロパティのフィールドをクリックまたはタップし、値を RGBA(62,96,170,1) に変更します。

3. HeadingColor プロパティのフィールドをクリックまたはタップし、値を White に変更します。

4. HeadingSize プロパティのフィールドをクリックまたはタップし、値を 14 に変更します。

   

データ テーブル コントロールを別のコントロールに接続する

1. 編集フォーム コントロールを画面に追加します。

2. データ テーブル コントロールと編集フォーム コントロールのサイズを変更して、データ テーブル コントロールが画面の左側に表示され、編集フォーム コントロールが画面の右側に表示されるようにします。

   

3. Form1 が選択されている間、右側のウィンドウで列数を 1 に変更します。

4. Form1 を販売注文データ ソースに接続します。

   Form1 には、いくつかの初期フィールドが表示されます。

   

5. 右側のウィンドウで、[ 詳細設定 ] タブをクリックまたはタップします。

6. Form1 の Item プロパティを SalesOrderTable.Selected に設定します。

   Form1 には、 データ テーブル コントロールで選択されている行の情報が表示されます。

   

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

色のコントラスト

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

• 色 と 塗りつぶし
• HeadingColor と HeadingFill
• SelectedColor と SelectedFill
• HoverColor と HoverFill

これは、 標準のカラー コントラスト要件に加えて行われます。

スクリーン リーダー サポート

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