バージョン: 20

コンボボックス

コンボボックスはドロップダウンリストと似ていますが、キーボードから入力されたテキストを受けいれる点と、二つの追加オプションがついている点が異なります。

基本的にコンボボックスは入力エリアと同じように取り扱い、オブジェクト、配列、または選択リストを一連のデフォルト値として使用します。

コンボボックスの操作

入力エリアへの入力内容は、その他の入力フォームオブジェクトと同様に On Data Change イベントを使用して管理します。

コンボボックスの初期化方法は、ドロップダウンリストとまったく同じで、オブジェクト、配列、または選択リストを使用できます。

この機能は 4Dプロジェクトでのみ利用可能です。

コンボボックスのデータソースとして、コレクションを内包したオブジェクトを使用できます。このオブジェクトには、次のプロパティが格納されていなくてはなりません:

プロパティ	型	説明
`values`	コレクション	必須 - スカラー値のコレクション。すべての同じ型の値でなくてはなりません。サポートされている型: 文字列数値日付時間空、または未定義の場合、コンボボックスは空になります
`currentValue`	Collection要素と同じ	ユーザーによる入力値

オブジェクトにその他のプロパティが含まれている場合、それらは無視されます。

ユーザーによってコンボボックスに入力されたテキストは、オブジェクトの currentValue プロパティが受け取ります。

配列を初期化する方法については、ドロップダウンリストページの 配列の使用 を参照ください。

ユーザーによってコンボボックスに入力されたテキストは、配列の 0番目の要素が受け取ります。

入力エリア (列挙型のフィールドまたは変数) の管理のためにコンボボックスを使用したい場合、フィールドまたは変数をフォームオブジェクトのデータソースとして直接参照することができます。これにより列挙型のフィールド/変数を容易に管理できるようになります。

階層リストの場合、第一階層の値のみが表示・選択できます。

コンボボックスにフィールドや変数を関連付けるには、フォームオブジェクトの変数あるいは式欄にフィールドまたは変数の名前を直接入力します。

フォームを実行すると、4D が自動的に入力中または表示中のコンボボックスの状態を管理します。ユーザーが値を選択すると、その値はフィールドに保存され、このフィールドの値はフォームが表示されたときにコンボボックスに表示されます:

詳細については、ドロップダウンリストページの 選択リストの使用 を参照ください。

コンボボックスタイプのオブジェクトには、2つの専用オプションがあります:

自動挿入: このオプションがチェックされていると、オブジェクトに関連付けられたリストにない値をユーザーが入力した場合に、その値が自動的にデータソースに追加されます。
除外リスト (除外される値のリスト): 除外される値のリストを関連付けることができます。ユーザーがこのリストに含まれる値を入力したとき、その入力は自動的に却下され、エラーメッセージが表示されます。

指定リストは、コンボボックスに割り当てることができません。ユーザーインターフェースにおいて、オブジェクト内にいくつかの指定された値を表示したいときには、ドロップダウンリストのオブジェクトを使用して下さい。