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 时其提示文本会发生更改：

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

默认值为 null。

指定用户可以在提示区域中输入的字符集。默认情况下，用户可以输入任意字符，相当于空字符串的值。

默认值为 ""。

构造函数。