ユーザ インタフェース コントロール > 共通プロパティ > レイアウト > タイプ > Listbox |
Listbox コントロールは、リスト ボックスをロールアウトに配置するのに使用します。
これはドロップダウン リストとは異なり、リスト全体が常にロールアウトに表示されます。
コンボボックスとは異なり、上部に編集テキスト フィールドはなく、スクロール可能な簡単なリストだけがあります。ユーザはリストをスクロールするか、あるいはクリックして項目を選択できます。
listbox <name> [<caption>] [items:<array_of_strings>] [selection:<number>] [height:<number>] [readOnly:<boolean>]
listbox 項目の位置合わせの既定値は、 #left です。
現在選択されているリスト内の項目番号。基数は 1 です。選択の既定値は 1 です。
項目行の数で示す listbox 全体の高さ。既定値は 10 行です。 listBox で正確に N 項目を表示するには、高さを N に設定します。
true に設定した場合、ユーザはリストから項目を選択できません。false に設定するか何も指定しなかった場合、ユーザはリストから項目を選択できます。
現在選択されている項目番号。基数は 1 です。項目のリストが空配列の場合、値は 0 (ゼロ)になります。
現在選択されている項目のテキストです。個々の項目を置換して items 配列全体をリセットするために使用します。項目リストが空の配列の場合、この値は undefined です。
true に設定した場合、ユーザはリストから項目を選択できません。 false に設定した場合、ユーザはリストから項目を選択できます。
リストボックスのリスト ウィンドウの幅をピクセル単位で取得/設定します。
リストボックスのリスト ウィンドウの高さをピクセル単位で取得/設定します。
ユーザがリスト内の項目を選択したときに呼び出されます。引数 <arg> には、新しい、現在の選択項目番号が入ります。
ユーザがリスト内の項目をダブルクリックしたときに呼び出されます。 on selected ハンドラは、クリック、およびダブルクリックの 1 回目のクリックで常に呼び出されるので注意してください。 <arg> 引数には、ダブルクリックされた項目の数が保持されます。
オプションの <arg> 引数を指定すると、右クリックした項目のインデックスが含まれます。