ユーザーが 1 つまたは複数の項目を選択できるリスト。
Description
リスト ボックス コントロールには、常に (ドロップダウン コントロールとは異なり) 使用可能なすべての選択肢が表示され、ユーザーは一度に複数の項目を選択できます (ラジオ コントロールとは異なります)。
重要なプロパティ
既定値 – ユーザーによって変更される前のコントロールの初期値。
注
選択できる既定の項目は 1 つだけです。 複数の項目を選択する必要がある場合は、 コンボ ボックス コントロールを使用してください。
アイテム – ギャラリー、リスト、グラフなどのコントロールに表示されるデータのソース。
ギャラリー、リスト、またはグラフを追加すると、プロパティ リストに既定で Items が表示されるため、新しいコントロールに表示するデータを簡単に指定できます。 たとえば、ギャラリーの Items プロパティを Salesforce の Account テーブル、Excel で作成してクラウドにアップロードした Inventory という名前のテーブル、 ConferenceSpeakers という名前のリストに設定できます。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
色 – コントロール内のテキストの色。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
DisabledColor – DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色。
DisabledFill – DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
フォント – テキストが表示されるフォントファミリの名前。
FontWeight – コントロール内のテキストの重み: 太字、 半ボルト、 標準、 または太さ。
Height – コントロールの上端と下端の間の距離。
HoverBorderColor – ユーザーがそのコントロールにマウス ポインターを置いたままにしたときのコントロールの境界線の色。
HoverColor – ユーザーがマウス ポインターを置いたままにしたときのコントロール内のテキストの色。
HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。
斜体 – コントロール内のテキストが斜体かどうかを指定します。
ItemPaddingLeft – リスト ボックス内のテキストとその左端との間の距離。
LineHeight – リスト内のテキストまたは項目の行間の距離です。
OnChange – ユーザーがコントロールの値を変更したときに実行するアクション (スライダーを調整するなど)。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
PaddingBottom – コントロール内のテキストとそのコントロールの下端との間の距離。
PaddingLeft – コントロール内のテキストとそのコントロールの左端との間の距離。
PaddingRight – コントロール内のテキストとそのコントロールの右端との間の距離。
PaddingTop – コントロール内のテキストとそのコントロールの上端との間の距離。
PressedBorderColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの境界線の色。
PressedColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロール内のテキストの色。
PressedFill – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの背景色。
リセット – コントロールが既定値に戻るかどうか。
選択済み – 選択した項目を表すデータ レコード。
注
選択できる既定の項目は 1 つだけです。 複数の項目を選択する必要がある場合は、 コンボ ボックス コントロールを使用してください。
SelectedItems - 読み取り専用。 複数選択リスト ボックスの選択された項目のデータテーブルを表します。
SelectedItemsText - 読み取り専用。 複数選択リスト ボックスの選択した項目テキストのデータテーブルを表します。
SelectedText (非推奨) – 選択した項目を表す文字列値。
SelectionColor – 選択した項目またはリスト内の項目のテキストの色、またはペン コントロールの選択ツールの色。
SelectionFill – 選択したアイテムまたはリスト内の項目、またはペン コントロールの選択した領域の背景色。
SelectMultiple – ユーザーがリスト ボックスで複数の項目を選択できるかどうかを指定します。
サイズ – コントロールに表示されるテキストのフォント サイズ。
取り消し線 – コントロールに表示されるテキストを線で表示するかどうかを指定します。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
下線 – コントロールに表示されるテキストの下に行を表示するかどうかを指定します。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。
Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。
関連する関数
Distinct( DataSource, ColumnName )
Example
リスト ボックス コントロールを追加し、CategoryList という名前を付け、その Items プロパティを次の数式に設定します。
["Carpet","ハードウッド","タイル"]
3 つの ドロップダウン コントロールを追加し、 CategoryList の下に移動し、 CarpetList、 HardwoodList、TileList という名前を 付けます。
各ドロップダウン コントロールの Items プロパティを次のいずれかの値に設定します。
CarpetList: ["Caserta Stone ベージュ","Ageless Beauty Clay", "Lush II Tundra"]
ハードウッドリスト: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]
TileList: [Honey Onyx Marble","Indian Autumn Slate", "Panaria Vitality Ceramic"]
F5 キーを押し、 CategoryList で 1 つ以上の項目を選択します。
適切な ドロップダウン コントロールまたはコントロールは、選択内容または選択内容に基づいて表示されます。
(省略可能)Esc キーを押して既定のワークスペースに戻ります。
アクセシビリティ ガイドライン
色のコントラスト
次の間に適切な色のコントラストが必要です。
- SelectionColor と SelectionFill
- SelectionFill と Fill
- HoverFill と Fill
- PressedFill と Fill
これは、 標準のカラー コントラスト要件に加えて行われます。
スクリーン リーダーのサポート
- AccessibleLabel が存在する必要があります。
キーボードのサポート
キーボード ユーザーが移動できるようにするには、TabIndex を 0 以上にする必要があります。
フォーカス インジケーターは明確に表示する必要があります。 これを実現するには、FocusedBorderColor と FocusedBorderThickness を使用します。
注
タブ キーは 、リスト ボックスに移動するか、リスト ボックスから移動します。 方向キーを押すと、[ リスト] ボックスの内容が移動します。