ComboBox  - AS3 Flex

Свойство data позволяет передавать значение в компонент при его использовании в средстве визуализации или в редакторе элементов. Привязка данных, как правило, используется для привязки поля свойства data к свойству данного компонента.

Элемент управления ComboBox использует свойство listData и свойство data следующим образом. Если ComboBox находится в элементе управления DataGrid, то свойство столбца dataField должно сопоставляться со свойством данных. Значение selectedItem устанавливается равным данному свойству. Если ComboBox находится в элементе управления List, то свойство списка labelField должно сопоставляться со свойством данных. Значение selectedItem устанавливается равным данному свойству. В противном случае selectedItem приравнивается к данным.

Это свойство не устанавливается в MXML.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dataChange .

Связанные элементы API

Набор элементов, отображаемых компонентом. Это свойство имеет тип Object, так как полученные классы могут обрабатывать различные типы данных, например Arrays, XML, ICollectionViews и другие классы. Все они преобразованы в ICollectionView, и ICollectionView возвращается при получении значения этого свойства; устанавливаемое значение невозможно получить, если это не ICollectionView.

Установка этого свойства скорректирует свойство selectedIndex (и, следовательно, свойство selectedItem), если selectedIndex свойство не было установлено. При отсутствии свойства prompt свойство selectedIndex будет установлено в значение «0»; в противном случае останется на значении «-1» (индекс, используемый для строки запроса). Если свойство selectedIndex было установлено и находится вне диапазона нового поставщика данных, возможно неожиданное поведение.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие collectionChange .

Ссылка на элемент управления List, действующий как раскрывающийся список в ComboBox.

IFactory, создающий производный от ListBase экземпляр для использования в качестве раскрывающегося списка. По умолчанию для List используется значение IFactory

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dropdownFactoryChanged .

Набор стилей для передачи из ComboBox в dropDown. Стили в стиле dropDownStyleName отменяют данные стили.

Связанные элементы API

Ширина раскрывающегося списка в пикселях.

Значение по умолчанию – 100 или ширина самого длинного текста в dataProvider, если она больше 100.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dropdownWidthChanged .

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

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

Связанные элементы API

Имя поля в элементах массива dataProvider для отображения в качестве метки в TextInput и раскрывающемся списке. По умолчанию элемент управления использует свойство label для каждого объекта Array и отображает его.

Но если элементы dataProvider не содержат свойство label, можно настроить свойство labelField для использования другого свойства.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelFieldChanged .

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

Примером может служить набор данных, имеющих поля lastName и firstName, для которого необходимо отобразить полные имена. labelFunction используется для указания функции обратного вызова, обрабатывающей соответствующие поля и возвращающей отображаемую строку.

labelFunction принимает единственный аргумент, являющийся элементом dataProvider, и возвращает строку:

      myLabelFunction(item:Object):String
      

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelFunctionChanged .

При использовании компонента в качестве средства визуализации или редактора вставных элементов Flex инициализирует свойство компонента listData с соответствующими данными из элемента управления List. Компонент может затем использовать свойства listData и данные для отображения соответствующей информации как средства визуализации или редактора вставных элементов.

Это свойство не устанавливается в MXML или ActionScript; Flex устанавливает его, когда компонент используется как средство визуализации или редактор вставных элементов.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dataChange .

Связанные элементы API

Строка запроса элемента управления ComboBox. Строка запроса, отображаемая в TextInput элемента управления ComboBox при selectedIndex = -1. Как правило, эта строка начинается с выражения «Выберите один...». Если строка запроса отсутствует, элемент ComboBox присваивает selectedIndex значение 0 и отображает первый элемент dataProvider.

Максимальное число видимых строк в списке элемента управления ComboBox. Если в dataProvider содержится меньше элементов, то ComboBox отображает столько элементов, сколько имеется в dataProvider.

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

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие resize .