メニューのプルダウンによってユーザーが参照する選択可能なリストを実装します。
説明
DropdownList は、従来の ComboBox に似ていますが、選択した値のテキストをユーザーが編集することはできません。したがって任意の型の値を表示できます。また、イメージのようにテキスト表現を持たないものも表示できます。DropdownList は、ユーザーが比較的小さなリストから 1 つの値を選択する場合に適しています。
ユーザーが値のリストを表示するには、マウス ポインタでコントロールのどこかをクリックします。次に、ユーザーがリストのいずれかの値をクリックすると、その値がコントロールの先頭に表示されてリストが閉じます。
例
次の例は、通常のテキストのみの DropdownList を示しています。
| 例 | |
 | |
{DropdownList
"Antelope", "Llama", "Horse",
value="Antelope"
}
|
プログラミング注意事項
DropdownList の値は、リストで異なるように表示することができます。たとえば、値と Visual のペアを明示的に保持する ListItem で DropdownList を作成できます。ペアの Visual コンポーネントは、Curl 社で定義された Visual サブクラスのインスタンスであることが必要です。独自のサブクラスを作成する場合、clone-appearance メソッドを実装する必要があります。
別の方法として、値を与えるとListItem を生成する 1 つのプロシージャを指定することができます。
別の方法として、値を与えると
例
次の例は、DropdownList のカスタムリストアイテムの作成方法を示します。各アイテムは、文字列値 (色の名前) を持ち、色付きの四角形で表示されます。
次の例は上の例と似ていますが、それぞれの値の表示を指定して繰り返し取得せずに次のプロシージャを使用します。
| 例 | |
 | |
{DropdownList
{ListValueItem value="red",
{RectangleGraphic fill-color="red",
width=50pt, height=10pt
}
},
{ListValueItem value="blue",
{RectangleGraphic fill-color="blue",
width=50pt, height=10pt
}
},
{ListValueItem value="green",
{RectangleGraphic fill-color="green",
width=50pt, height=10pt
}
},
value="red"
}
|
次の例は上の例と似ていますが、それぞれの値の表示を指定して繰り返し取得せずに次のプロシージャを使用します。
| 例 | |
 | |
{DropdownList
"red", "blue", "green",
list-item-creation-proc =
{proc {val:any}:ListItem
{return {ListValueItem
value=val,
{RectangleGraphic fill-color=val,
width=50pt, height=10pt
}
}
}
},
value="red"
}
|
予期されたイベント
ビジュアル テスト
このクラスは、CurlDropdown ビジュアル テスト タイプを実装します。
すべての Visual によってサポートされる既定のビジュアル テスト アクションの他に、このクラスのオブジェクトは次のアクションをサポートします。
| アクション | 引数 | 説明 |
|---|---|---|
| item アイテムを選択します。 |
すべての Visual によってサポートされる既定のビジュアル テスト プロパティの他に、このクラスのオブジェクトは次のビジュアル テスト プロパティをサポートします。
注意事項
このオブジェクトは、"DropdownList"、"DropdownList/drop-button"、"DropdownList/item-frame"のスタイル ルールを記述することによってスタイル化することが出来ます。詳細は スキンが適用されたリストコントロール をご覧下さい