ComboBox  - AS3 Flex

プロンプト領域にユーザーが文字を入力するのに合わせて、アイテムリストを検索するために使用するコールバック関数を指定します。ユーザーが文字を入力すると、コントロールのドロップダウン領域が開きます。次にアイテムリストがスクロールして、最もよく一致するアイテムがハイライトされます。

このプロパティで参照される関数は、入力文字列を取り、入力に一致するデータプロバイダー内のアイテムのインデックスを返します。アイテムは、データプロバイダーのインデックスの Vector.<int> として返されます。

このコールバック関数には次のシグネチャが必要です。

        function myMatchingFunction(comboBox:ComboBox, inputText:String):Vector.<int>

このプロパティの値が null の場合、ComboBox はデフォルトのアルゴリズムを使用して一致を検索します。デフォルトでは、長さ n の入力文字列がアイテムの最初の n 文字（大文字と小文字は無視）と等しい場合は、そのアイテムに一致したと見なされます。例えば、「aRiz」は「Arizona」に一致しますが、「riz」は一致しません。

検索を無効にするには、空の Vector.<int> を返すコールバック関数を作成します。

デフォルト値： null。

プロンプト領域に入力された新しい値を、データプロバイダーのデータアイテムと同じデータ型に変換するコールバック関数を指定します。このプロパティで参照される関数は、プロンプト領域のテキストがコミットされて、データプロバイダーで見つからない場合に呼び出されます。

このコールバック関数には次のシグネチャが必要です。

        function myLabelToItem(value:String):Object

ここで、value はプロンプト領域に入力された String を表しています。この関数は、データプロバイダーのアイテムと同じ型である Object を返します。

デフォルトのコールバック関数は value を返します。

ユーザーが入力するときに、プロンプト領域に入る最大の文字数です。0 という値は、制限がないことを示しています。

デフォルト値： 0。

true の場合、ユーザーがプロンプト領域を編集すると、ドロップダウンリストが開きます。

デフォルト値： true。

入力テキストが null の場合に表示されるテキストです。

コントロールが最初に作成されるとプロンプトテキストが表示されます。コントロールがフォーカスを得た場合、入力テキストが null 以外の場合、またはリスト内のアイテムが選択された場合に、プロンプトテキストは非表示になります。コントロールがフォーカスを失ったが、テキストが入力されていない（テキストフィールドの値が null または空の文字列である）場合にのみ、プロンプトテキストが再表示されます。

プロンプトテキストのスタイルは CSS で変更できます。コントロールにプロンプトテキストがあり、無効になっていない場合は、normalWithPrompt 擬似セレクターによってスタイルが定義されます。コントロールが無効になっている場合は、disabledWithPrompt 擬似セレクターによって定義されたスタイルが使用されます。

次の CSS の例では、TextInput コントロール内のプロンプトテキストのカラーが変更されています。ComboBox コントロールは、TextInput コントロールをプロンプトテキストおよび入力のサブコンポーネントとして使用するため、この CSS を使用すると、その ComboBox コントロールのプロンプトテキストが変更されます。

      @namespace s "library://ns.adobe.com/flex/spark";
      s|TextInput:normalWithPrompt {
          color: #CCCCFF;
      }
      

デフォルト値： null。

ユーザーがプロンプト領域に入力できる文字のセットを指定します。デフォルトでは、空のストリングの値に対応する任意の文字を入力できます。

デフォルト値： ""。