ComboBox  - AS3 Flex

Определяет функцию обратного вызова, используемую при выполнении поиска в списке элементов при вводе пользователем символов в область запроса. Когда пользователь вводит символы, отображается раскрывающаяся область элемента управления. Он прокручивает список элементов до наиболее точного соответствия и выделяет его цветом.

Функция, на которую ссылается это свойство, получает строку ввода и возвращает в поставщик данных индекс элементов, которые соответствуют вводу. Элементы возвращаются как вектор.<int> индексов в поставщике данных.

Функция обратного вызова должна иметь следующую подпись:

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

Если значением этого свойства является null, то ComboBox находит соответствия с использованием заданного по умолчанию алгоритма. По умолчанию принято, что если входная строка длины n эквивалентна первым символам n элемента (без учета регистра), то она соответствует этому элементу. Например, aRiz совпадает с Arizona, в то время как riz – нет.

Для отмены поиска следует создать функцию обратного вызова, которая возвращает пустой вектор.<int>.

Значением по умолчанию является null.

Определяет функцию обратного вызова для преобразования нового значения, введенного в область подсказки, в тот же тип данных, что и элементы данных в поставщике данных. Функция, на которую ссылается это свойство, вызывается, когда текст в области запроса передан и не найден в поставщике данных.

Функция обратного вызова должна иметь следующую подпись:

        function myLabelToItem(value:String):Object

Где value является строкой, введенной в область запроса. Функция возвращает объект того же типа, что и элементы в поставщике данных.

Заданная по умолчанию функция обратного вызова возвращает value.

Введенное пользователем максимальное число символов, которое может содержать область запроса. Нулевое значение соответствует отсутствию ограничений.

Значением по умолчанию является 0.

Если true, раскрывающийся список открывается, когда пользователь редактирует область запроса.

Значением по умолчанию является true.

Текст, который будет отображаться при отсутствии вводимого текста.

При первом создании элемента управления на экране отображается запрос. Запрос не отображается, когда элемент управления получает фокус, для вводимого текста указано ненулевое значение, а также при выборе элемента списка. Запрос выводится повторно, когда элемент управления теряет фокус и значением текстового поля является null или пустая строка (т. е. текст не был введен).

Для изменения стиля запроса можно использовать CSS. Если элемент управления не выключен и содержит запрос, стиль определяется псевдоселектором normalWithPrompt. Если элемент управления выключен, то используются стили, определенные псевдоселектором disabledWithPrompt.

В следующем примере CSS изменяет цвет текста запроса в элементах управления TextInput. Элемент управления ComboBox использует элемент управления TextInput как подчиненный компонент для запросов и ввода, поэтому его текст запросов изменяется при использовании следующего CSS:

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

Значением по умолчанию является null.

Определяет набор символов, которые могут быть введены пользователем в область запроса. По умолчанию пользователь может вводить любые символы, соответствующие значению пустой строки.

Значением по умолчанию является "".

Конструктор.