Power Appsのギャラリーコントロールの基本設定

この記事の位置づけ

この記事は、Power Appsの初学者向け技術メモです。設定方法はバージョンによって変わることがあります。

実際のアプリで動作を確認してください。

ざっくり言うと

Power Appsでデータを一覧表示するときに使うのがギャラリーコントロールです。

SharePointリストやExcelのデータをリスト形式で表示し、行をタップして詳細画面に遷移するような操作の起点になります。

ギャラリーの挿入と基本設定

1. 「挿入」→「ギャラリー」→レイアウトを選ぶ（縦・横・空白など）
2. Items プロパティにデータソースを設定する
3. ギャラリー内のラベル・画像などのコントロールのTextプロパティを設定する

よく使うプロパティ

Items（データソース）

ギャラリーに表示するデータを指定します。

Items: 申請リスト

Filter関数やSort関数と組み合わせることが多いです。

Items: Sort(Filter(申請リスト, ステータス = "申請中"), 作成日時, Descending)

ThisItem

ギャラリー内のコントロールで、その行のデータを参照するときに使います。

// タイトルを表示するラベルのText
ThisItem.Title

// 担当者を表示
ThisItem.担当者

// 日付を表示
Text(ThisItem.作成日時, "yyyy/mm/dd")

OnSelect

行をタップしたときの動作を設定します。

// 詳細画面に遷移する
Navigate(DetailScreen, ScreenTransition.Cover)

選択した行のデータは Gallery1.Selected として参照できます。

Selected

現在選択されている行のデータを参照できます。

// ギャラリーの外のラベルで選択行のデータを表示
Gallery1.Selected.Title

TemplateFill

各行の背景色を設定します。

// 偶数・奇数行で交互に色を変える
If(Mod(ThisItem.Value, 2) = 0, RGBA(240,240,240,1), White)

検索ボックスと組み合わせる

テキスト入力コントロール（SearchInput）を使って絞り込みができます。

Items: Filter(申請リスト, SearchInput.Text in 件名 || SearchInput.Text in 申請者)

選択状態をハイライトする

選択中の行を視覚的に示したい場合：

TemplateFill: If(ThisItem.IsSelected, LightBlue, White)

ThisItem.IsSelected は選択されている行で true になります。

ギャラリーのレイアウト種類の入口

レイアウト	特徴
縦ギャラリー	縦スクロールのリスト形式（最もよく使う）
横ギャラリー	横スクロールのカルーセル形式
高さが変わるギャラリー	内容によって行の高さが変わる
空のギャラリー	中身を自由に設計できる

注意点

ギャラリーのItemsにFilter関数を使い、Delegation（委任）に非対応の関数を使うとデータが先頭500件（または2000件）に制限される場合があります。

また、ギャラリーの中のコントロールを直接クリックして選択しようとしても、ギャラリーの行が先に反応することがあります。Altキーを押しながらクリックすると内部のコントロールを選択できます。

関連メモ・関連ツール

• Power AppsのFilter関数の使い方の入口
• Power AppsのSetとUpdateContextの違い（変数の使い分け）
• Power AppsのPatchとSubmitFormの違い