ユーザーが 1 つまたは複数の項目を選択できるリストです。
説明
リスト ボックス コントロールは、使用可能なすべての選択肢が常に表示されており (ドロップ ダウン コントロールと異なる点)、ユーザーは一度に複数の項目を選択できます (ラジオ コントロールと異なる点)。
主要なプロパティ
Default – ユーザーが変更する前のコントロールの初期値です。
Items – ギャラリー、リスト、グラフなどのコントロールに表示されるデータのソースです。
Items ギャラリー、リスト、グラフなどのコントロールに表示されるデータのソースです。
ギャラリー、リスト、またはグラフを追加すると、既定ではプロパティの一覧に項目が表示されます。新しいコントロールに表示されるデータを簡単に指定できます。 たとえば、ギャラリーの Items プロパティは、Salesforce の Account テーブルや、Excel で作成してクラウドにアップロードした 在庫管理 という名前の表や、カンファレンスの講師と名前をつけた SharePoint リストなどに設定できます。
その他のプロパティ
BorderColor – コントロールの境界線の色です。
BorderStyle – コントロールの境界線を Solid (実線)、Dashed (破線)、Dotted (点線)、None (なし) のいずれに指定します。
BorderThickness – コントロールの境界線の太さです。
FocusedBorderThickness – キーボードでフォーカスした場合のコントロールの境界線の太さです。
Color – コントロールのテキストの色です。
DisplayMode – コントロールで、ユーザー入力を許可するか (Edit)、データの表示のみを許可するか (View)、許可しないか (Disabled) を設定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色です。
DisabledColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色です。
DisabledFill – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色です。
Fill – コントロールの背景色です。
Font – テキストを表記するフォントのファミリー名です。
FontWeight – コントロール内のテキストの太さです。Bold (太字)、Semibold (中太)、Normal (標準)、Lighter (細字) から指定します。
Height – コントロールの上端と下端の距離です。
HoverBorderColor – コントロール上にユーザーがマウス ポインターを重ねているときのコントロールの境界線の色です。
HoverColor – コントロールにユーザーがマウス ポインターを重ねているときのコントロール内のテキストの色です。
HoverFill – コントロールにユーザーがマウス ポインターを重ねているときのコントロールの背景色です。
Italic – コントロール内のテキストを斜体にするかどうかを指定します。
ItemPaddingLeft – リスト ボックス内のテキストと左端の間の距離です。
LineHeight – テキストの行間やリスト内の項目間などの距離です。
OnChange – ユーザーが (スライダーを調整するなどして) コントロールの値を変更した場合のアプリの反応を指定します。
OnSelect – ユーザーがコントロールをタップまたはクリックした場合のアプリの反応を指定します。
PaddingBottom – コントロール内のテキストとそのコントロールの下端間の距離です。
PaddingLeft – コントロール内のテキストとそのコントロールの左端間の距離です。
PaddingRight – コントロール内のテキストとそのコントロールの右端間の距離です。
PaddingTop – コントロール内のテキストとそのコントロールの上端間の距離です。
PressedBorderColor – コントロールをユーザーがタップまたはクリックしたときのコントロールの境界線の色です。
PressedColor – コントロールをユーザーがタップまたはクリックしたときのコントロール内のテキストの色です。
PressedFill – コントロールをユーザーがタップまたはクリックしたときのコントロールの背景色です。
Reset – コントロールを既定値に戻すかどうかを指定します。
SelectionColor – リスト内で選択された項目のテキストの色、またはペン コントロールの選択ツールの色です。
SelectionFill – リストで選択された項目またはペン コントロールの選択領域の背景色です。
SelectMultiple – ユーザーがリスト ボックスの複数の項目を選択できるかどうかを指定します。
Size – コントロールに表示されるテキストのフォント サイズです。
Strikethrough – コントロールに表示されるテキストに取り消し線を付けるかどうかを指定します。
TabIndex – ゼロ以外の値に設定すると、実行時のコントロールのタブの順序をカスタマイズできます。
Tooltip – ポインターをコントロールに合わせたときに表示される説明テキストです。
Underline – コントロールに表示されるテキストの下に線を引くかどうかを指定します。
Visible – コントロールを表示するか非表示にするかを指定します。
Width – コントロールの左端と右端の間の距離です。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離です。
Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離です。
関連する関数
Distinct( DataSource, ColumnName )
例
リスト ボックス コントロールを追加して CategoryList という名前を付け、Items プロパティを次の式に設定します。
["Carpet","Hardwood","Tile"]コントロールの追加、命名、構成についてはこちらをご覧ください。
3 つのドロップ ダウン コントロールを追加し、CategoryList の下に移動して、CarpetList、HardwoodList、TileList という名前を付けます。
各ドロップ ダウン コントロールの 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"]
各ドロップ ダウン コントロールの 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)
F5 キーを押し、CategoryList で 1 つまたは複数の項目を選択します。
選択に基づいて、適切なドロップ ダウン コントロールが表示されます。
(省略可能) Esc キーを押して既定のワークスペースに戻ります。