Power Apps での リスト ボックスコントロール

ユーザーが 1 つまたは複数の項目を選択できるリスト。

内容

リスト ボックス コントロールでは、使用可能なすべての選択肢が常に表示されており (ドロップダウン コントロールと異なる)、ユーザーは一度に複数の項目を選択できます (ラジオ コントロールと異なる)。

主要なプロパティ

Default – ユーザーが変更する前のコントロールの初期値です。

注意

既定で選択できる項目は 1 つのみです。 複数の選択した項目が必要な場合は、コンボ ボックス コントロールを使用してください。

Items – ギャラリー、リスト、グラフなどのコントロールに表示されるデータのソース。

ギャラリー、リスト、またはグラフを追加すると、既定ではプロパティの一覧にItemsが表示され、新しいコントロールに表示されるデータを簡単に指定できます。 たとえば、ギャラリーの Items プロパティは Salesforce の取引先企業テーブル、Excel で作成されクラウドにアップロードされた在庫という名前の表、または ConferenceSpeakers という名前のリストに設定する場合があります。

追加のプロパティ

AccessibleLabel – スクリーン リーダー用のラベル。

BorderColor – コントロールの境界線の色。

BorderStyle – コントロールの境界線が実線破線点線、またはなしかどうか。

BorderThickness – コントロールの境界線の太さ。

Color – コントロールのテキストの色。

DisplayMode – コントロールがユーザー入力を許可するか (編集)、データのみを表示するか (表示)、または無効にするか (無効) どうか。

DisabledBorderColor – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロールの境界線の色。

DisabledColor – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロール内のテキストの色。

DisabledFill – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロールの背景色。

Fill – コントロールの背景色。

FocusedBorderColor – コントロールがフォーカスされているときのコントロールの境界線の色。

FocusedBorderThickness – コントロールがフォーカスされているときのコントロールの境界線の太さ。

Font – テキストを表示するフォントのファミリーの名前。

FontWeight – コントロール内のテキストの太さ: 太字中太標準、または細字

Height – コントロールの上端と下端間の距離。

HoverBorderColor – ユーザーがコントロール上にマウス ポインターを重ねているときのコントロールの境界線の色。

HoverColor – ユーザーがコントロールにマウス ポインターを重ねているときのコントロール内のテキストの色。

HoverFill – ユーザーがコントロールにマウス ポインターを重ねているときのコントロールの背景色。

Italic – コントロール内のテキストを斜体にするかどうか。

ItemPaddingLeft – リストボックス内のテキストと左端の間の距離。

LineHeight – たとえば、テキストの行間またはリスト内の項目間などの距離です。

OnChange – ユーザーが (スライダーを調整するなどして) コントロールの値を変更したときに実行するアクション。

OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。

PaddingBottom – コントロール内のテキストとそのコントロールの下端間の距離。

PaddingLeft – コントロール内のテキストとそのコントロールの左端間の距離。

PaddingRight – コントロール内のテキストとそのコントロールの右端間の距離。

PaddingTop – コントロール内のテキストとそのコントロールの上端間の距離。

PressedBorderColor – ユーザーがコントロールをタップまたはクリックしたときのコントロールの境界線の色。

PressedColor – ユーザーがコントロールをタップまたはクリックしたときのコントロール内のテキストの色。

PressedFill – ユーザーがコントロールをタップまたはクリックしたときのコントロールの背景色。

Reset – コントロールを既定値に戻すかどうかを指定します。

Selected – 選択された項目を表すデータ レコード。

注意

既定で選択できる項目は 1 つのみです。 複数の選択した項目が必要な場合は、コンボ ボックス コントロールを使用してください。

SelectedItems - 読み取り専用。 複数選択リストボックスの選択された項目のデータテーブルを表します。

SelectedItemsText - 読み取り専用。 複数選択リストボックスの選択された項目テキストのデータテーブルを表します。

SelectedText (Deprecated) – 選択した項目を表す文字列値。

SelectionColor – リスト内で選択された項目のテキストの色、またはペン コントロールの選択ツールの色。

SelectionFill – 選択された項目、またはリストの項目、またはペン コントロールの選択領域の背景色。

SelectMultiple – ユーザーがリストボックスの複数の項目を選択できるかどうか。

Size – コントロールに表示されるテキストのフォント サイズ。

Strikethrough – コントロールに表示されるテキストに取り消し線を付けるかどうか。

TabIndex – 他のコントロールに関連するキーボード ナビゲーションの順序。

Tooltip – ユーザーがコントロールにカーソルを置くときに表示される説明テキスト。

Underline – コントロールに表示されるテキストの下に線を引くかどうか。

Visible – コントロールが表示されるか非表示になるか。

Width – コントロールの左端と右端間の距離。

X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。

Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。

Distinct( DataSource, ColumnName )

  1. リスト ボックス コントロールを追加し、CategoryList という名前を付け、Items プロパティを次の式に設定します:
    ["カーペット","硬木","タイル"]

    コントロールの追加、名前付け、構成 についてはこちらをご覧ください。

    リスト ボックス内の床材のカテゴリ。

  2. 3 つの ドロップダウン コントロールを追加し、CategoryList の下に移動して、CarpetListHardwoodListTileList という名前を付けます。

  3. ドロップダウン コントロールの Items プロパティに、次の値の 1 つを設定します:

    • CarpetList: ["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]

    • HardwoodList: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]

    • TileList: ["Honey Onyx Marble","Indian Autumn Slate", "Panaria Vitality Ceramic"]

      ドロップダウン リストの床材の名前。

  4. ドロップダウン コントロールの Visible プロパティに、次の値の 1 つを設定します:

    • CarpetList: If("Carpet" in CategoryList.SelectedItems.Value, true)

    • HardwoodList: If("Hardwood" in CategoryList.SelectedItems.Value, true)

    • TileList: If("Tile" in CategoryList.SelectedItems.Value, true)

      If 関数または その他の関数 の詳細については各関連記事を参照してください。

  5. F5 キーを押してから、CategoryList で 1 つまたは複数の項目を選択します。

    選択に基づいて、適切な ドロップダウン コントロールが表示されます。

    選択されたリスト。

  6. (オプション) Esc キーを押して既定のワークスペースに戻ります。

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

色のコントラスト

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

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

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

キーボードのサポート

  • TabIndex を 0 以上にして、キーボード ユーザーがそこに移動できるようにする必要があります。

  • フォーカス インジケーターは明確に表示する必要があります。 これを実現するには FocusedBorderColor および FocusedBorderThickness を使用します。

    注意

    Tab キーを押すと、リストボックス に移動またはリスト ボックスから移動します。 矢印キーを押すと、リストボックス の内容に移動します。

注意

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

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