Пакет | fl.controls |
Класс | public class ComboBox |
Наследование | ComboBox ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Реализует | IFocusManagerComponent |
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
См. также
Свойство | Определено | ||
---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
![]() | alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
![]() | blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
![]() | blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
![]() | buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
![]() | cacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() | contextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
dataProvider : DataProvider
Определяет или задает модель данных для списка просматриваемых элементов. | ComboBox | ||
![]() | doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | |
dropdown : List [только для чтения]
Определяет ссылку на компонент List, который находится в компоненте ComboBox. | ComboBox | ||
dropdownWidth : Number
Определяет или задает максимальную ширину раскрывающегося списка (в пикселах). | ComboBox | ||
![]() | dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен. | Sprite | |
editable : Boolean
Определяет или задает логическое значение, которое определяет возможность редактирования компонента ComboBox. | ComboBox | ||
![]() | enabled : Boolean
Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем. | UIComponent | |
![]() | filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
![]() | focusEnabled : Boolean
Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя. | UIComponent | |
![]() | focusManager : IFocusManager
Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. | UIComponent | |
![]() | focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
![]() | graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
![]() | height : Number
Определяет или задает высоту компонента (в пикселах). | UIComponent | |
![]() | hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
labelField : String
Определяет или задает имя поля в объекте dataProvider, отображаемое в качестве метки поля TextInput и раскрывающегося списка. | ComboBox | ||
labelFunction : Function
Определяет или задает функцию, используемую для получения метки элемента. | ComboBox | ||
length : int [только для чтения]
Определяет количество элементов в списке. | ComboBox | ||
![]() | loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
![]() | mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
![]() | mouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши. | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши. | InteractiveObject | |
![]() | mouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя. | UIComponent | |
![]() | mouseX : Number [только для чтения]
Указывает координату x положения курсора мыши (в пикселах). | DisplayObject | |
![]() | mouseY : Number [только для чтения]
Указывает координату y положения курсора мыши (в пикселах). | DisplayObject | |
![]() | name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
![]() | numChildren : int [только для чтения]
Возвращает число потомков данного объекта. | DisplayObjectContainer | |
![]() | opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
![]() | parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
prompt : String
Определяет или задает запрос для компонента ComboBox. | ComboBox | ||
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
restrict : String
Определяет или задает символы, которые могут быть введены пользователем в текстовом поле. | ComboBox | ||
![]() | root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
![]() | rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
![]() | rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]() | rotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]() | rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
rowCount : uint
Определяет или задает максимальное число строк, отображаемых в раскрывающемся списке без появления полосы прокрутки. | ComboBox | ||
![]() | scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
![]() | scaleX : Number
Умножает текущую ширину компонента на коэффициент масштабирования. | UIComponent | |
![]() | scaleY : Number
Умножает текущую высоту компонента на коэффициент масштабирования. | UIComponent | |
![]() | scaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
![]() | scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
selectedIndex : int
Определяет или задает индекс выбранного элемента в списке, допускающем выбор одного элемента. | ComboBox | ||
selectedItem : Object
Определяет или задает значение элемента, выбранного в раскрывающемся списке. | ComboBox | ||
selectedLabel : String [только для чтения]
Определяет строку, отображаемую в объекте TextInput компонента ComboBox. | ComboBox | ||
![]() | soundTransform : SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
![]() | stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
![]() | tabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab. | DisplayObjectContainer | |
![]() | tabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab. | InteractiveObject | |
![]() | tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
text : String
Определяет или задает текст, который содержится в текстовом поле компонента ComboBox с возможностью редактирования. | ComboBox | ||
textField : TextInput [только для чтения]
Определяет ссылку на компонент TextInput, который содержится в компоненте ComboBox. | ComboBox | ||
![]() | textSnapshot : TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() | transform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
![]() | useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
value : String [только для чтения]
Определяет метку элемента в компоненте ComboBox, доступном для редактирования. | ComboBox | ||
![]() | version : String = "3.0.0.15"
Номер версии компонентов. | UIComponent | |
![]() | visible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента. | UIComponent | |
![]() | width : Number
Определяет или задает ширину компонента (в пикселах). | UIComponent | |
![]() | x : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера. | UIComponent | |
![]() | y : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера. | UIComponent | |
![]() | z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject |
Метод | Определено | ||
---|---|---|---|
ComboBox()
Создает новый экземпляр компонента ComboBox. | ComboBox | ||
![]() |
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях. | EventDispatcher | |
Добавляет элемент в конец списка элементов. | ComboBox | ||
Вставляет элемент в положении списка, заданном индексом. | ComboBox | ||
![]() |
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой. | DisplayObjectContainer | |
![]() |
Удаляет свойство style для экземпляра компонента. | UIComponent | |
Закрывает раскрывающийся список. | ComboBox | ||
![]() |
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
![]() |
Передает событие в поток событий. | EventDispatcher | |
![]() |
Отображает или скрывает индикатор фокуса этого компонента. | UIComponent | |
![]() |
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow). | UIComponent | |
![]() | DisplayObject | ||
![]() |
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
![]() |
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | |
![]() |
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
![]() |
Возвращает позицию индекса для дочернего экземпляра DisplayObject. | DisplayObjectContainer | |
![]() | DisplayObject | ||
![]() |
Возвращает объект, который в настоящее время имеет фокус. | UIComponent | |
Возвращает элемент в положении, заданном индексом. | ComboBox | ||
![]() |
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур. | DisplayObject | |
![]() |
Возвращает свойство style, установленное в последовательности для поиска стилей компонента. | UIComponent | |
[статические]
Возвращает карту стилей по умолчанию для текущего компонента. | ComboBox | ||
![]() |
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные). | DisplayObject | |
![]() |
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним. | DisplayObject | |
![]() |
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
![]() |
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное. | UIComponent | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Возвращает строку, которая должна отображаться средством визуализации для указанного объекта данных на основе свойств labelField и labelFunction. | ComboBox | ||
![]() |
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
![]() | [статические]
Объединяет стили из нескольких классов в одном объекте. | UIComponent | |
![]() |
Перемещает компонент в указанное положение в пределах его родительского компонента. | UIComponent | |
![]() | DisplayObject | ||
![]() | DisplayObject | ||
Открывает раскрывающийся список. | ComboBox | ||
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Удаляет все элементы из списка. | ComboBox | ||
![]() |
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Удаляет указанный элемент из списка. | ComboBox | ||
Удаляет элемент в заданном положении индекса. | ComboBox | ||
Заменяет элемент в положении, заданном индексом, другим элементом. | ComboBox | ||
![]() |
Изменяет положение существующего потомка в DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Задает фокус на этот компонент. | UIComponent | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Задает указанную высоту и ширину компонента. | UIComponent | |
![]() |
Задает свойство style для экземпляра компонента. | UIComponent | |
Сортирует элементы, предоставляемые текущим поставщиком данных. | ComboBox | ||
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям. | ComboBox | ||
![]() |
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
![]() |
Завершает метод startDrag(). | Sprite | |
![]() |
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта. | DisplayObjectContainer | |
![]() |
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков. | DisplayObjectContainer | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости. | UIComponent | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
![]() | Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
![]() | Отправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
Отправляется при изменении выделенной области в компоненте ComboBox. Если компонент ComboBox доступен для редактирования, то отправляется каждый раз при нажатии клавиши в текстовом поле. | ComboBox | |||
![]() | Отправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста. | InteractiveObject | ||
![]() | Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
Отправляется, когда раскрывающийся список по какой-либо причине закрывается. | ComboBox | |||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню. | InteractiveObject | ||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню. | InteractiveObject | ||
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным. | EventDispatcher | ||
![]() | Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | ||
Отправляется, если свойство editable имеет значение true, а пользователь во время набора текста в редактируемом поле нажимает клавишу Enter. | ComboBox | |||
![]() | [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
![]() | [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
![]() | Отправляется, когда экранный объект перемещается в фокус. | InteractiveObject | ||
![]() | Отправляется, когда экранный объект покидает фокус. | InteractiveObject | ||
![]() | [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
![]() | Отправляется, когда видимый компонент становится невидимым. | UIComponent | ||
Задает значение свойства type для объекта события itemRollOut. | ComboBox | |||
Задает значение свойства type для объекта события itemRollOver. | ComboBox | |||
![]() | Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | ||
![]() | Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | ||
![]() | Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | ||
![]() | Отправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | ||
![]() | Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | ||
![]() | Отправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject. | InteractiveObject | ||
![]() | Отправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется при перемещении компонента. | UIComponent | ||
Отправляется, когда пользователь нажимает кнопку для открытия раскрывающегося списка. | ComboBox | |||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню. | InteractiveObject | ||
![]() | Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
![]() | Отправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
![]() | [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
![]() | Отправляется при изменении размеров компонента. | UIComponent | ||
![]() | Отправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject. | InteractiveObject | ||
![]() | Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
Отправляется при прокрутке раскрывающегося списка компонента ComboBox. | ComboBox | |||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню. | InteractiveObject | ||
![]() | Отправляется, когда невидимый компонент становится видимым. | UIComponent | ||
![]() | Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | ||
![]() | Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | ||
![]() | Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject |
Стиль | Описание | Определено | ||
---|---|---|---|---|
buttonWidth | Тип: Number Формат: Length Пространство, отделяющее правый край компонента от текста, представляющего выбранный элемент, в пикселах. Кнопка является частью фоновой обложки. Значение по умолчанию 24 . | ComboBox | ||
cellRenderer | Тип: Class Класс, который предоставляет средство визуализации для каждого элемента компонента. Значение по умолчанию fl.controls.listClasses.CellRenderer . | ComboBox | ||
contentPadding | Тип: Number Формат: Length Заполняющая информация между содержимым (компонент и полоса прокрутки) и внешним краем фона в пикселах. Значение по умолчанию 3 . | ComboBox | ||
disabledAlpha | Тип: Class Значение альфа-канала, которое присваивается списку, когда свойство enabled имеет значение false .
Значение по умолчанию 0.5 . | ComboBox | ||
disabledSkin | Тип: Class Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда его свойству enabled присвоено значение false .
Значение по умолчанию ComboBox_disabledSkin . | ComboBox | ||
![]() | Тип: flash.text.TextFormat Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена. | UIComponent | ||
downArrowDisabledSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда она отключена. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowDown_disabledSkin . | ComboBox | ||
downArrowDownSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда пользователь нажимает на кнопку. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowDown_downSkin . | ComboBox | ||
downArrowOverSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда курсор находится над кнопкой. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowDown_overSkin . | ComboBox | ||
downArrowUpSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowDown_upSkin . | ComboBox | ||
downSkin | Тип: Class Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда кнопка мыши нажата. Значение по умолчанию ComboBox_downSkin . | ComboBox | ||
embedFonts | Тип: Boolean Указывает, необходимо ли использовать для визуализации текстового поля контуры встроенных шрифтов. Если выбрано значение true , Flash Player визуализирует текстовое поле с помощью контуров встроенных шрифтов. Если выбрано значение false , Flash Player визуализирует текстовое поле с использованием шрифтов устройства.
Если свойству false . | ComboBox | ||
![]() | Тип: Number Формат: Length Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах. | UIComponent | ||
![]() | Тип: Class Обложка, используемая для показа индикаторов фокуса. | UIComponent | ||
overSkin | Тип: Class Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда на него указывает курсор. Значение по умолчанию ComboBox_overSkin . | ComboBox | ||
repeatDelay | Тип: Number Формат: Time Количество миллисекунд ожидания, которое проходит после того, как событие buttonDown впервые отправляется перед отправкой второго события buttonDown .
Значение по умолчанию 500 . | ComboBox | ||
repeatInterval | Тип: Number Формат: Time Интервал в миллисекундах между событиями buttonDown , которые отправляются после задержки, указанной с помощью стиля repeatDelay .
Значение по умолчанию 35 . | ComboBox | ||
![]() | Тип: flash.text.TextFormat Объект TextFormat, используемый для визуализации метки компонента. | UIComponent | ||
textPadding | Тип: Number Формат: Length Пространство, отделяющее границу от текста, отражающего выбранный элемент, в пикселах. Значение по умолчанию 3 . | ComboBox | ||
thumbArrowUpSkin | Тип: Class Имя класса, используемого в качестве обложки для бегунка полосы прокрутки. Значение по умолчанию ScrollThumb_upSkin . | ComboBox | ||
thumbDisabledSkin | Тип: Class Обложка, используемая для указания отключенного состояния бегунка. Значение по умолчанию ScrollThumb_upSkin . | ComboBox | ||
thumbDownSkin | Тип: Class Имя класса, используемого в качестве обложки для бегунка полосы прокрутки при нажатии на бегунок. Значение по умолчанию ScrollThumb_downSkin . | ComboBox | ||
thumbIcon | Тип: Class Имя класса, используемого в качестве значка для бегунка полосы прокрутки. Значение по умолчанию ScrollBar_thumbIcon . | ComboBox | ||
thumbOverSkin | Тип: Class Имя класса, используемого в качестве обложки для бегунка полосы прокрутки, когда курсор находится над бегунком. Значение по умолчанию ScrollThumb_overSkin . | ComboBox | ||
trackDisabledSkin | Тип: Class Обложка, используемая для указания отключенной дорожки. Значение по умолчанию ScrollTrack_Skin . | ComboBox | ||
trackDownSkin | Тип: Class Обложка, используемая для того, чтобы указать состояние нажатой кнопки мыши для отключенной обложки. Значение по умолчанию ScrollTrack_Skin . | ComboBox | ||
trackOverSkin | Тип: Class Обложка, используемая для того, чтобы указать состояние курсора, находящегося над дорожкой прокрутки. Значение по умолчанию ScrollTrack_Skin . | ComboBox | ||
trackUpSkin | Тип: Class Обложка, используемая для того, чтобы указать состояние ненажатой кнопки мыши для дорожки прокрутки. Значение по умолчанию ScrollTrack_Skin . | ComboBox | ||
upArrowDisabledSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда она отключена. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowUp_disabledSkin . | ComboBox | ||
upArrowDownSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда пользователь нажимает ее. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowUp_downSkin . | ComboBox | ||
upArrowOverSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда курсор находится над кнопкой со стрелкой. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowUp_overSkin . | ComboBox | ||
upArrowUpSkin | Тип: Class Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значение по умолчанию ScrollArrowUp_upSkin . | ComboBox | ||
upSkin | Тип: Class Имя класса, отвечающего за фон компонента ComboBox. Значение по умолчанию ComboBox_upSkin . | ComboBox |
dataProvider | свойство |
dataProvider:DataProvider
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает модель данных для списка просматриваемых элементов. Один и тот же поставщик данных может использоваться несколькими компонентами на основе списка. Изменения в поставщике данных немедленно становятся доступны всем компонентам, которые используют его в качестве источника данных.
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void
См. также
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); var cb:ComboBox = new ComboBox(); cb.dataProvider = dp; addChild(cb); var counter = 0; var t:Timer = new Timer(500); t.addEventListener(TimerEvent.TIMER,addAnotherItem); t.start(); function addAnotherItem(e:TimerEvent = null):void { dp.addItem( { label: "Item " + counter++ } ); }
dropdown | свойство |
dropdown:List
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет ссылку на компонент List, который находится в компоненте ComboBox. Экземпляр подкомпонента List не создается в ComboBox до тех пор, пока не приходит время его показать. Однако этот список создается во время доступа к свойству dropdown
.
public function get dropdown():List
dropdownWidth | свойство |
dropdownWidth:Number
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает максимальную ширину раскрывающегося списка (в пикселах). Значение по умолчанию этого свойства — это ширина компонента ComboBox (сумма ширины экземпляра TextInput и ширины экземпляра BaseButton).
Значение по умолчанию 100
public function get dropdownWidth():Number
public function set dropdownWidth(value:Number):void
dropdownWidth
задается, исходя из значения компонента Slider:
import fl.controls.ComboBox; import fl.controls.Slider; import fl.events.SliderEvent; var mySlider:Slider = new Slider(); mySlider.minimum = 50; mySlider.maximum = 150; mySlider.liveDragging = true; mySlider.snapInterval = 5; mySlider.tickInterval = 10; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); mySlider.move(10, 10); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.move(10, 30); addChild(myComboBox); mySlider.value = myComboBox.dropdownWidth; function changeHandler(event:SliderEvent):void { myComboBox.dropdownWidth = event.value; }
dropdownWidth
основано на длине текста в раскрывающемся списке:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"The quick brown fox"}); myComboBox.addItem({label:"Lorem ipsum"}); myComboBox.addItem({label:"Little Miss Muffet"}); myComboBox.addItem({label:"Goldilocks and the three bears"}); myComboBox.addItem({label:"Jack and Jill"}); myComboBox.move(10, 30); addChild(myComboBox); var maxLength:Number = 0; var i:uint; for (i = 0; i < myComboBox.length; i++) { myComboBox.selectedIndex = i; myComboBox.drawNow(); var currText:String = myComboBox.text; var currWidth:Number = myComboBox.textField.textWidth; maxLength = Math.max(currWidth, maxLength); trace(currText, currWidth, maxLength); } myComboBox.selectedIndex = -1; myComboBox.dropdownWidth = maxLength + 20; myComboBox.open();
editable | свойство |
editable:Boolean
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает логическое значение, которое определяет возможность редактирования компонента ComboBox. Значение true
указывает, что компонент ComboBox допускает редактирование; значение false
говорит о том, что его нельзя редактировать.
В редактируемом компоненте ComboBox пользователь может вводить значения в текстовое поле, которое не появляется в раскрывающемся списке. В текстовом поле приводится текст элемента в списке. Если компонент ComboBox не поддерживает редактирование, текст не удастся ввести в текстовое поле.
Значение по умолчанию false
public function get editable():Boolean
public function set editable(value:Boolean):void
enter
:
import fl.controls.ComboBox; import fl.data.DataProvider; import fl.events.ComponentEvent; var dp:DataProvider = new DataProvider(); var myComboBox:ComboBox = new ComboBox; myComboBox.dataProvider = dp; myComboBox.editable = true; myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.move(10, 10); addChild(myComboBox); function enterHandler(event:ComponentEvent):void { var myCB:ComboBox = event.currentTarget as ComboBox; dp.addItem({label:myCB.text}); myCB.text = ""; myCB.sortItemsOn("label", Array.CASEINSENSITIVE); }
labelField | свойство |
labelField:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает имя поля в объекте dataProvider
, отображаемое в качестве метки поля TextInput и раскрывающегося списка.
Этот компонент по умолчанию показывает свойство label
для каждого элемента dataProvider
. Если элементы dataProvider
не содержат свойство label
, свойство labelField
можно задать, чтобы воспользоваться другим свойством.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Значение по умолчанию "label"
public function get labelField():String
public function set labelField(value:String):void
См. также
labelField
задает поле пользовательской метки:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({firstName:"Jane", lastName:"Doe"}); dp.addItem({firstName:"Bill", lastName:"Smith"}); dp.addItem({firstName:"Tim", lastName:"Jones"}); dp.sortOn(["firstName","lastName"]); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.labelField = "firstName"; myComboBox.move(10, 10); addChild(myComboBox);
labelFunction | свойство |
labelFunction:Function
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает функцию, используемую для получения метки элемента.
Этот компонент по умолчанию показывает свойство label
для элемента dataProvider
. Но некоторые наборы данных могут не иметь поля label
или иметь поле, значение которого можно использовать в качестве метки без изменений. Так, например, в определенном наборе данных могут храниться полные имена, но их поддержка выполняется с помощью полей lastName
и firstName
. В подобном случае данное свойство можно использовать для установки функции обратного вызова, которая объединяет значения полей lastName
и firstName
в показываемой строке полного имени.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
public function get labelFunction():Function
public function set labelFunction(value:Function):void
См. также
labelFunction
списка присваивается функция, которая форматирует строку, показываемую в каждой ячейке:
import fl.data.DataProvider; import fl.controls.List; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({name:"User A", price:0.43}); myDataProvider.addItem({name:"User B", price:0.34}); var users:List = new List(); users.dataProvider = myDataProvider; users.labelFunction = myLabelFunction; addChild(users); function myLabelFunction(item:Object):String { return item.name + " ($" + item.price.toFixed(2) + ")"; }
labelField
задает поле пользовательской метки:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({firstName:"Jane", lastName:"Doe"}); dp.addItem({firstName:"Bill", lastName:"Smith"}); dp.addItem({firstName:"Tim", lastName:"Jones"}); dp.sortOn(["lastName", "firstName"]); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.labelFunction = nameLabelFunction; myComboBox.move(10, 10); addChild(myComboBox); function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
length | свойство |
length:int
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет количество элементов в списке. Это свойство принадлежит компоненту List, но его можно также открыть из экземпляра ComboBox.
Значение по умолчанию 0
public function get length():int
См. также
rowCount
задается на основании того, сколько элементов находится в этом компоненте:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.addItem({label:"Item D"}); myComboBox.addItem({label:"Item E"}); myComboBox.addItem({label:"Item F"}); myComboBox.rowCount = myComboBox.length / 2; addChild(myComboBox);
rowCount
задается на основании того, сколько элементов находится в этом компоненте:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({label:"Item A"}); dp.addItem({label:"Item B"}); dp.addItem({label:"Item C"}); dp.addItem({label:"Item D"}); dp.addItem({label:"Item E"}); dp.addItem({label:"Item F"}); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.rowCount = myComboBox.length / 2; addChild(myComboBox);
prompt | свойство |
prompt:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает запрос для компонента ComboBox. Этот запрос является строкой, которая отображается в области TextInput компонента ComboBox, когда selectedIndex
равен -1. Обычно эта строка начинается с выражения "Выберите один...". Если запрос не задан, компонент ComboBox присваивает свойству selectedIndex
значение 0 и показывает первый элемент свойства dataProvider
.
Значение по умолчанию ""
public function get prompt():String
public function set prompt(value:String):void
prompt
, а размер комбинированного окна изменяется в соответствии с шириной текста запроса:
import fl.controls.ComboBox; var cbStyles:Object = ComboBox.getStyleDefinition(); var bW:Number = cbStyles.buttonWidth as Number var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Please select an option..."; myComboBox.addItem({label:"Option 1"}); myComboBox.addItem({label:"Option 2"}); myComboBox.drawNow(); myComboBox.width = myComboBox.textField.textWidth + 35; myComboBox.dropdownWidth = myComboBox.width - bW; myComboBox.move(10, 10); addChild(myComboBox);
prompt
задается, исходя из количества элементов в его поставщике данных:
import fl.controls.ComboBox; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({label:"Getting Started"}); dp.addItem({label:"New Features"}); dp.addItem({label:"ActionScript"}); dp.addItem({label:"Components"}); dp.sortOn("label", Array.CASEINSENSITIVE); var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Topics (" + dp.length + ")"; myComboBox.dataProvider = dp; myComboBox.width = 150; myComboBox.move(10, 10); addChild(myComboBox);
restrict | свойство |
restrict:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает символы, которые могут быть введены пользователем в текстовом поле. Если значение restrict
— это строка, состоящая из символов, в текстовое поле можно вводить только символы из этой строки. Строка читается слева направо. Если свойству restrict
присвоено значение null
, можно ввести любой символ. Если в качестве значения свойства restrict
выступает пустая строка (""), ввод символов не поддерживается. Можно задать диапазон с помощью символа (-). При этом ограничивается только взаимодействие с пользователем; сценарий может помещать в текстовое поле любой символ.
Значение по умолчанию null
public function get restrict():String
public function set restrict(value:String):void
См. также
restrict
:
import fl.controls.ComboBox; import fl.data.DataProvider; import fl.events.ComponentEvent; var dp:DataProvider = new DataProvider(); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.editable = true; myComboBox.restrict = "0-9A-F"; myComboBox.textField.maxChars = 6; myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.move(10, 10); addChild(myComboBox); function enterHandler(event:ComponentEvent):void { var colorStr:String = ComboBox(event.currentTarget).text; var colorNum:uint = uint("0x" + colorStr); dp.addItem({label:colorStr, value:colorNum}); dp.sortOn("value", Array.NUMERIC); event.currentTarget.text = ""; }
rowCount | свойство |
rowCount:uint
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает максимальное число строк, отображаемых в раскрывающемся списке без появления полосы прокрутки. Если количество элементов в раскрывающемся списке превышает это значение, размер списка изменяется и при необходимости появляется полоса прокрутки. Если количество элементов в раскрывающемся списке меньше этого значения, размер раскрывающегося списка изменяется в соответствии с количеством содержащихся в нем элементов.
Это поведение отличается от поведения компонента List, в котором всегда указывается количество строк, определяемое свойством rowCount
даже в том случае, когда среди них есть пробелы.
Значение по умолчанию 5
public function get rowCount():uint
public function set rowCount(value:uint):void
См. также
rowCount
для компонента ComboBox:
import fl.controls.ComboBox; import fl.controls.Slider; import fl.events.SliderEvent; var numItems:uint = 8; var mySlider:Slider = new Slider(); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 1; mySlider.maximum = numItems; mySlider.liveDragging = true; mySlider.move(10, 10); mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.move(10, 30); addChild(myComboBox); var i:uint; for (i = 0; i < numItems; i++) { myComboBox.addItem({label:"Item " + i}); } function changeHandler(event:SliderEvent):void { myComboBox.rowCount = event.value; }
selectedIndex | свойство |
selectedIndex:int
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает индекс выбранного элемента в списке, допускающем выбор одного элемента. В списке, допускающем выбор одного элемента, за один раз можно выбрать только один элемент.
Значение "-1" указывает, что не выделен ни один элемент; если выделено несколько элементов, это значение равно индексу элемента, который был выбран последним в группе выделенных элементов.
Когда это свойство задается с помощью ActionScript, элемент с указанным индексом заменяет текущую выделенную область. Когда выделение изменяется программным методом, объект события change
не отправляется.
Значение по умолчанию 0
public function get selectedIndex():int
public function set selectedIndex(value:int):void
См. также
selectedIndex
для экземпляра компонента ComboBox:
import fl.controls.ComboBox; import fl.controls.Slider; import fl.data.DataProvider; import fl.events.SliderEvent; var items:XML = <items> <item label="Item 1" /> <item label="Item 2" /> <item label="Item 3" /> <item label="Item 4" /> </items>; var dp:DataProvider = new DataProvider(items); var mySlider:Slider = new Slider(); mySlider.liveDragging = true; mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 0; mySlider.maximum = dp.length - 1; mySlider.width = 100; mySlider.move(10, 10); mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.move(10, 30); addChild(myComboBox); function changeHandler(event:SliderEvent):void { myComboBox.selectedIndex = event.value; }
selectedIndex
указывается в метке в рабочей области:
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Please select an item..."; myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.addItem({label:"Item 4"}); myComboBox.width = 150; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = "selectedIndex:" + myComboBox.selectedIndex; myLabel.move(myComboBox.x + myComboBox.width + 10, myComboBox.y); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = "selectedIndex:" + myComboBox.selectedIndex; }
selectedItem | свойство |
selectedItem:Object
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает значение элемента, выбранного в раскрывающемся списке. Если пользователь вводит текст в текстовое поле редактируемого компонента ComboBox, свойству selectedItem
присваивается значение undefined
. Это свойство имеет значение только тогда, когда пользователь выбирает элемент или когда ActionScript используется для выбора элемента из раскрывающегося списка. Если компонент ComboBox не допускает редактирование, значение свойства selectedItem
всегда действительно. Если в раскрывающемся списке редактируемого компонента ComboBox отсутствуют элементы, этому свойству присваивается значение null
.
Значение по умолчанию null
public function get selectedItem():Object
public function set selectedItem(value:Object):void
См. также
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.List; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select an item"; myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.move(10, 10); addChild(myComboBox); var myButton:Button = new Button(); myButton.label = "Copy"; myButton.move(myComboBox.x + myComboBox.width + 10, myComboBox.y); myButton.addEventListener(MouseEvent.CLICK, clickHandler); addChild(myButton); var myList:List = new List(); myList.rowCount = myList.length; myList.selectable = false; myList.move(myComboBox.x, myComboBox.y + myComboBox.height + 10); addChild(myList); function clickHandler(event:MouseEvent):void { if (myComboBox.selectedIndex > -1) { myList.addItem(myComboBox.selectedItem); myList.rowCount = myList.length; } }
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var firstNameLabel:Label = new Label(); firstNameLabel.text = ""; firstNameLabel.autoSize = TextFieldAutoSize.LEFT; firstNameLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(firstNameLabel); var lastNameLabel:Label = new Label(); lastNameLabel.text = ""; lastNameLabel.autoSize = TextFieldAutoSize.LEFT; lastNameLabel.move(firstNameLabel.x, firstNameLabel.y + firstNameLabel.height); addChild(lastNameLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; var item:Object = cb.selectedItem; if (cb.selectedIndex > -1) { firstNameLabel.text = item.firstName; lastNameLabel.text = item.lastName; } } function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
selectedLabel | свойство |
selectedLabel:String
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет строку, отображаемую в объекте TextInput компонента ComboBox. Это значение рассчитывается на основе данных с помощью свойства labelField
или labelFunction
.
public function get selectedLabel():String
См. также
selectedLabel
для ComboBox:
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myLabel:Label = new Label(); myLabel.text = ""; myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(myLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; myLabel.text = "selectedLabel: " + cb.selectedLabel; } function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
text | свойство |
text:String
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет или задает текст, который содержится в текстовом поле компонента ComboBox с возможностью редактирования. Если компоненты ComboBox не поддерживают редактирование, это значение предназначено только для чтения.
Значение по умолчанию ""
public function get text():String
public function set text(value:String):void
import fl.controls.ComboBox; import fl.controls.TextArea; import fl.events.ComponentEvent; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler); myComboBox.width = 300; myComboBox.move(10, 10); addChild(myComboBox); var myTextArea:TextArea = new TextArea(); myTextArea.wordWrap = false; myTextArea.setSize(300, 200); myTextArea.move(myComboBox.x, myComboBox.y + myComboBox.height + 10); addChild(myTextArea) function textInputHandler(event:TextEvent):void { myTextArea.appendText(event.type + ":\n"); myTextArea.appendText("\t" + event.currentTarget.text + "\n"); myTextArea.appendText("\t" + event.text + "\n"); myTextArea.appendText("\n"); autoScroll(myTextArea); } function enterHandler(event:ComponentEvent):void { myTextArea.appendText(event.type + ":\n"); myTextArea.appendText("\t" + event.currentTarget.text + "\n"); myTextArea.appendText("\n"); autoScroll(myTextArea); } function autoScroll(ta:TextArea):void { ta.verticalScrollPosition = ta.maxVerticalScrollPosition; }
textField | свойство |
textField:TextInput
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет ссылку на компонент TextInput, который содержится в компоненте ComboBox. Воспользуйтесь этим свойством для доступа и манипулирования основным компонентом TextInput. Например, этим свойством можно воспользоваться, чтобы изменить выделение текстового поля или ограничить набор символов, которые можно в него ввести.
public function get textField():TextInput
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.editable = true; myComboBox.textField.maxChars = 8; myComboBox.move(10, 10); addChild(myComboBox);
import fl.controls.ComboBox; var comicSansTF:TextFormat = new TextFormat(); comicSansTF.font = "Comic Sans MS"; var myComboBox:ComboBox = new ComboBox(); myComboBox.textField.setStyle("textFormat", comicSansTF); myComboBox.addItem({label:"Item A"}); myComboBox.addItem({label:"Item B"}); myComboBox.addItem({label:"Item C"}); myComboBox.addItem({label:"Item D"}); myComboBox.move(10, 10); addChild(myComboBox);
import fl.controls.ComboBox; import fl.data.DataProvider; var myTextFormat:TextFormat = new TextFormat(); myTextFormat.font = "Comic Sans MS"; myTextFormat.color = 0xFF0000; var fontArray:Array = Font.enumerateFonts(true); fontArray.sortOn("fontName", Array.CASEINSENSITIVE); var dp:DataProvider = new DataProvider(fontArray); var myComboBox:ComboBox = new ComboBox(); myComboBox.dataProvider = dp; myComboBox.dropdown.iconField = null; myComboBox.labelField = "fontName"; myComboBox.textField.setStyle("textFormat", myTextFormat); myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat); myComboBox.width = 200; myComboBox.move(10, 10); addChild(myComboBox);
value | свойство |
value:String
[только для чтения] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Определяет метку элемента в компоненте ComboBox, доступном для редактирования. Если компонент ComboBox не поддерживает редактирование, это свойство определяет данные, которые содержатся в данном элементе.
public function get value():String
value
для редактируемого компонента ComboBox:
import fl.controls.ComboBox; import fl.controls.Label; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user:"; myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.labelFunction = nameLabelFunction; myComboBox.width = 120; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); myComboBox.editable = true; addChild(myComboBox); var myLabel:Label = new Label(); myLabel.text = ""; myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height); addChild(myLabel); function changeHandler(event:Event):void { var cb:ComboBox = event.currentTarget as ComboBox; myLabel.text = "value: " + cb.value; } function nameLabelFunction(item:Object):String { var str:String; if (item == null) { str = myComboBox.value; } else { str = item.lastName + ", " + item.firstName; } return str; }
ComboBox | () | Конструктор |
public function ComboBox()
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Создает новый экземпляр компонента ComboBox.
addItem | () | метод |
public function addItem(item:Object):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Добавляет элемент в конец списка элементов.
Элемент должен содержать свойства label
и data
; однако в этот список можно также добавить элементы с другими свойствами. По умолчанию свойство label
элемента используется для показа метки строки; данные строки сохраняются в свойстве data
.
Параметры
item:Object — Элемент, добавляемый в поставщик данных.
|
См. также
addItemAt | () | метод |
public function addItemAt(item:Object, index:uint):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Вставляет элемент в положении списка, заданном индексом. Индексы элементов в указанном положении индекса или после него увеличиваются на 1.
Параметры
item:Object — Элемент, добавляемый в список.
| |
index:uint — Индекс для места добавления элемента.
|
См. также
close | () | метод |
public function close():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Закрывает раскрывающийся список.
Примечание. Вызов этого метода приводит к отправке события close
. Если компонент ComboBox уже закрыт, вызов этого метода не будет иметь последствий.
См. также
open()
и close()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); addChild(myComboBox); var isOpen:Boolean = false; var timer:Timer = new Timer(1000); timer.addEventListener(TimerEvent.TIMER, timerHandler); timer.start(); function openHandler(event:Event):void { isOpen = true; } function closeHandler(event:Event):void { isOpen = false; } function timerHandler(event:TimerEvent):void { if (isOpen) { myComboBox.close(); } else { myComboBox.open(); } }
getItemAt | () | метод |
public function getItemAt(index:uint):Object
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Возвращает элемент в положении, заданном индексом.
Параметры
index:uint — Получаемый индекс элемента.
|
Object — Объект с указанным положением индекса.
|
getItemAt()
:
import fl.controls.ComboBox; import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1", price:0.34}); myComboBox.addItem({label:"Item 2", price:13.19}); myComboBox.addItem({label:"item 3", price:2.96}); myComboBox.addItem({label:"Item 4", price:3.49}); myComboBox.addItem({label:"Item 5", price:1.27}); myComboBox.move(10, 10); addChild(myComboBox); var indexCol:DataGridColumn = new DataGridColumn("index"); indexCol.headerText = ""; indexCol.sortOptions = Array.NUMERIC; var labelCol:DataGridColumn = new DataGridColumn("label"); labelCol.sortOptions = Array.CASEINSENSITIVE; var priceCol:DataGridColumn = new DataGridColumn("price"); priceCol.sortOptions = Array.NUMERIC; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(indexCol); myDataGrid.addColumn(labelCol); myDataGrid.addColumn(priceCol); myDataGrid.move(10, 40); myDataGrid.rowCount = myComboBox.length; myDataGrid.width = 180; addChild(myDataGrid); var i:uint; var item:Object; for (i = 0; i < myComboBox.length; i++) { item = myComboBox.getItemAt(i); myDataGrid.addItem({index:i, label:item.label, price:item.price}); }
getStyleDefinition | () | метод |
public static function getStyleDefinition():Object
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat
содержит значение null
или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle()
по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat
, выбранный по умолчанию для указанного компонента:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Объект стилей по умолчанию.
|
См. также
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToLabel | () | метод |
public function itemToLabel(item:Object):String
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Извлекает строку, показываемую средством визуализации для указанного объекта данных, исходя из значений свойств labelField
и labelFunction
.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Параметры
item:Object — Объект, создаваемый путем визуализации.
|
String — Отображаемая строка на основе данных.
|
См. также
open | () | метод |
public function open():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Открывает раскрывающийся список.
Примечание. Вызов этого метода вызывает отправку события open
. Если компонент ComboBox уже открыт, вызов этого метода не будет иметь последствий.
См. также
removeAll | () | метод |
public function removeAll():void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Удаляет все элементы из списка.
См. также
removeAll()
:
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.TextInput; var greenTF:TextFormat; var redTF:TextFormat; var myTextInput:TextInput; var addButton:Button; var myComboBox:ComboBox; var removeButton:Button; greenTF = new TextFormat(); greenTF.color = 0x006600; redTF = new TextFormat(); redTF.color = 0xFF0000; myTextInput = new TextInput(); myTextInput.maxChars = 20; myTextInput.restrict = "a-zA-Z"; myTextInput.move(10, 10); addChild(myTextInput); addButton = new Button(); addButton.label = "(+) Add"; addButton.setStyle("textFormat", greenTF); addButton.move(120, 10); addButton.addEventListener(MouseEvent.CLICK, addClickHandler); addChild(addButton); myComboBox = new ComboBox(); myComboBox.move(10, 40); addChild(myComboBox); removeButton = new Button(); removeButton.label = "(-) Remove All"; removeButton.setStyle("textFormat", redTF); removeButton.move(120, 40); removeButton.addEventListener(MouseEvent.CLICK, removeClickHandler); addChild(removeButton); function addClickHandler(event:MouseEvent):void { if (myTextInput.length > 0) { trace("adding item..."); myComboBox.addItem({label:myTextInput.text}); myComboBox.sortItemsOn("label", Array.CASEINSENSITIVE); myTextInput.text = ""; } } function removeClickHandler(event:MouseEvent):void { trace("removing all items..."); myComboBox.removeAll(); }
removeItem | () | метод |
public function removeItem(item:Object):Object
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Удаляет указанный элемент из списка.
Параметры
item:Object — Удаляемый элемент.
|
Object — Удаленный элемент.
|
См. также
import fl.controls.List; import fl.events.ListEvent; var myList:List = new List(); myList.addItem( { label: "Carrot" } ); myList.addItem( { label: "Turnip" } ); myList.addItem( { label: "Tomato" } ); myList.addItem( { label: "Blueberry" } ); myList.addEventListener(ListEvent.ITEM_CLICK,removeSelectedItem); addChild(myList); function removeSelectedItem(e:ListEvent):void { myList.removeItem(e.item); }
removeItemAt | () | метод |
public function removeItemAt(index:uint):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Удаляет элемент в заданном положении индекса. Местоположения индексов элементов, индексы которых превышают указанный индекс, смещаются в массиве на 1.
Это метод компонента List, который доступен из экземпляра компонента ComboBox.
Параметры
index:uint — Индекс удаляемого элемента.
|
RangeError — Указанный индекс меньше 0, либо больше или равен длине поставщика данных.
|
См. также
replaceItemAt | () | метод |
public function replaceItemAt(item:Object, index:uint):Object
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Заменяет элемент в положении, заданном индексом, другим элементом. Этот метод изменяет поставщик данных компонента List. Если поставщик данных используется сразу несколькими компонентами, обновление распространяется также на данные, предоставляемые этим компонентам.
Параметры
item:Object — Элемент, заменяющий элемент с указанным положением индекса.
| |
index:uint — Положение индекса заменяемого элемента.
|
Object — Замененный элемент.
|
replaceItemAt()
:
import fl.controls.Button; import fl.controls.ComboBox; import fl.controls.TextArea; import fl.controls.TextInput; var myComboBox:ComboBox = new ComboBox(); myComboBox.prompt = "Select a user..."; myComboBox.addItem({label:"Person 1"}); myComboBox.addItem({label:"Person 2"}); myComboBox.addItem({label:"Person 3"}); myComboBox.addItem({label:"Person 4"}); myComboBox.width = 150; myComboBox.move(10, 10); myComboBox.addEventListener(Event.CHANGE, changeHandler); addChild(myComboBox); var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "a-zA-Z0-9"; myTextInput.maxChars = 12; myTextInput.move(10, 40); addChild(myTextInput) var myButton:Button = new Button(); myButton.label = "Replace item"; myButton.addEventListener(MouseEvent.CLICK, clickHandler); myButton.move(120, 40); addChild(myButton); var myTextArea:TextArea = new TextArea(); myTextArea.editable = false; myTextArea.setSize(320, 240); myTextArea.move(10, 70); addChild(myTextArea); function changeHandler(event:Event):void { myTextInput.text = myComboBox.selectedLabel; } function clickHandler(event:MouseEvent):void { var cIndex:int = myComboBox.selectedIndex; if (cIndex > -1) { var newItem:Object = {label:myTextInput.text}; var oldItem:Object = myComboBox.replaceItemAt(newItem, cIndex); myComboBox.selectedIndex = cIndex; myTextArea.appendText("[index:" + cIndex + "] old:'" + oldItem.label +"', new:'" + newItem.label + "'\n"); myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition; } }
sortItems | () | метод |
public function sortItems(... sortArgs):*
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Сортирует элементы, предоставляемые текущим поставщиком данных. Этот метод выполняет сортировку на основе значений Юникод элементов. ASCII — это подмножество Юникода.
Параметры
... sortArgs — Аргументы, по которым выполняется сортировка.
|
* — Возвращаемое значение зависит от того, переданы ли какие-либо параметры этому методу. Дополнительную информацию см. в описании метода Array.sort() . Учтите, что этот метод возвращает 0, когда параметру sortArgs присваивается значение Array.UNIQUESORT .
|
См. также
upperCaseSort()
, которая сравнивает свойства label
двух элементов и возвращает логическое значение в зависимости от требуемого порядка расположения элемента:
import fl.controls.ComboBox; var cb:ComboBox = new ComboBox(); cb.addItem( { label: "Mercury" } ); cb.addItem( { label: "Venus" } ); cb.addItem( { label: "Earth" } ); cb.addItem( { label: "planet" } ); cb.sortItems(upperCaseSort); addChild(cb); function upperCaseSort(a:Object, b:Object):Boolean { return a.label.toUpperCase() > b.label.toUpperCase(); }
sortItemsOn | () | метод |
public function sortItemsOn(field:String, options:Object = null):*
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям.
Параметры
field:String — Поле, которое служит критерием сортировки.
| |
options:Object (default = null ) — Аргументы сортировки, которые используются для переопределения поведения сортировки по умолчанию. Два и более аргумента разделяются побитовым оператором ИЛИ (|).
|
* — Возвращаемое значение зависит от того, переданы ли какие-либо параметры этому методу. Дополнительную информацию см. в описании метода Array.sortOn() . Учтите, что этот метод возвращает 0, когда параметру sortOption присваивается значение Array.UNIQUESORT .
|
См. также
cb
, который содержит 4 элемента, а именно: "Apples"
, "Bananas"
, "cherries"
и "Grapes"
:
import fl.controls.ComboBox; var cb:ComboBox = new ComboBox(); addChild(cb); // First, populate the ComboBox with the elements. cb.addItem( { label: "Bananas" } ); cb.addItem( { label: "Apples" } ); cb.addItem( { label: "cherries" } ); cb.addItem( { label: "Grapes" } ); // The following statement sorts using the order parameter set to "ASC", // and results in a sort that places "cherries" at the bottom of the list // because the sort is case-sensitive. cb.sortItemsOn("label", "ASC"); // resulting order: Apples, Bananas, Grapes, cherries // The following statement sorts using the order parameter set to "DESC", // and results in a sort that places "cherries" at the top of the list // because the sort is case-sensitive. cb.sortItemsOn("label", "DESC"); // resulting order: cherries, Grapes, Bananas, Apples // The following statement sorts using the optionsFlag parameter set to // Array.CASEINSENSITIVE. Note that an ascending sort is the default setting. cb.sortItemsOn("label", Array.CASEINSENSITIVE); // resulting order: Apples, Bananas, cherries, Grapes // The following statement sorts using the optionsFlag parameter set to // Array.CASEINSENSITIVE | Array.DESCENDING. cb.sortItemsOn("label", Array.CASEINSENSITIVE | Array.DESCENDING); // resulting order: Grapes, cherries, Bananas, Apples
sortItemsOn()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); myComboBox.addItem({firstName:"Bill", lastName:"Smith"}); myComboBox.addItem({firstName:"Tim", lastName:"Jones"}); myComboBox.sortItemsOn("lastName", Array.CASEINSENSITIVE); myComboBox.labelFunction = nameLabelFunction; myComboBox.move(10, 10); addChild(myComboBox); function nameLabelFunction(item:Object):String { return item.lastName + ", " + item.firstName; }
change | Событие |
flash.events.Event
flash.events.Event.CHANGE
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется при изменении выделенной области в компоненте ComboBox. Если компонент ComboBox доступен для редактирования, то отправляется каждый раз при нажатии клавиши в текстовом поле.
КонстантаEvent.CHANGE
определяет значение свойства type
объекта события change
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget , чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент. |
close | Событие |
flash.events.Event
flash.events.Event.CLOSE
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется, когда раскрывающийся список по какой-либо причине закрывается.
КонстантаEvent.CLOSE
определяет значение свойства type
объекта события close
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, для которого разорвано подключение. |
open()
и close()
:
import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); addChild(myComboBox); var isOpen:Boolean = false; var timer:Timer = new Timer(1000); timer.addEventListener(TimerEvent.TIMER, timerHandler); timer.start(); function openHandler(event:Event):void { isOpen = true; } function closeHandler(event:Event):void { isOpen = false; } function timerHandler(event:TimerEvent):void { if (isOpen) { myComboBox.close(); } else { myComboBox.open(); } }
См. также
enter | Событие |
fl.events.ComponentEvent
fl.events.ComponentEvent.ENTER
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется, если свойство editable
имеет значение true
, а пользователь во время набора текста в редактируемом поле нажимает клавишу Enter.
type
для объекта события enter
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
itemRollOut | Событие |
fl.events.ListEvent
fl.events.ListEvent.ITEM_ROLL_OUT
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется, когда пользователь убирает указатель мыши с одного из элементов данного компонента.
Задает значение свойстваtype
для объекта события itemRollOut
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
columnIndex | Отсчитываемое от нуля значение индекса столбца, содержащего средство визуализации. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
index | Отсчитываемое от нуля значение индекса в объекте DataProvider, содержащем средство визуализации. |
item | Ссылка на данные, принадлежащие средству визуализации. |
rowIndex | Отсчитываемое от нуля значение индекса строки, содержащего средство визуализации. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
См. также
itemRollOver | Событие |
fl.events.ListEvent
fl.events.ListEvent.ITEM_ROLL_OVER
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется, когда пользователь наводит указатель мыши на один из элементов данного компонента.
Задает значение свойстваtype
для объекта события itemRollOver
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
columnIndex | Отсчитываемое от нуля значение индекса столбца, содержащего средство визуализации. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
index | Отсчитываемое от нуля значение индекса в объекте DataProvider, содержащем средство визуализации. |
item | Ссылка на данные, принадлежащие средству визуализации. |
rowIndex | Отсчитываемое от нуля значение индекса строки, содержащего средство визуализации. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
import fl.controls.ComboBox; import fl.controls.TextArea; import fl.events.ListEvent; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(Event.OPEN, openHandler); myComboBox.addEventListener(Event.CLOSE, closeHandler); myComboBox.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler); myComboBox.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOutHandler); myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, dropdownRollOverHandler) myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, dropdownRollOutHandler); addChild(myComboBox); var myTextArea:TextArea = new TextArea(); myTextArea.editable = false; myTextArea.setSize(320, 240); myTextArea.move(120, 10); addChild(myTextArea); function openHandler(event:Event):void { logEvent("ComboBox open"); } function closeHandler(event:Event):void { logEvent("ComboBox close"); } function itemRollOverHandler(event:ListEvent):void { var rowIdx:uint = event.rowIndex as uint; logEvent("ComboBox itemRollOver: " + "`" + myComboBox.getItemAt(rowIdx).label + "`"); } function itemRollOutHandler(event:ListEvent):void { var rowIdx:uint = event.rowIndex as uint; logEvent("ComboBox itemRollOut: " + "`" + myComboBox.getItemAt(rowIdx).label + "`"); } function rollOverHandler(event:MouseEvent):void { logEvent("ComboBox rollOver"); myComboBox.open(); } function rollOutHandler(event:MouseEvent):void { logEvent("ComboBox rollOut"); myComboBox.close(); } function dropdownRollOverHandler(event:MouseEvent):void { logEvent("ComboBox.dropdown rollOver"); // reopen ComboBox after it gets closed by the ComboBox rollOut event myComboBox.open(); } function dropdownRollOutHandler(event:MouseEvent):void { logEvent("ComboBox.dropdown rollOut"); myComboBox.close(); } function logEvent(text:String):void { myTextArea.appendText(text + "\n"); myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition; }
См. также
open | Событие |
flash.events.Event
flash.events.Event.OPEN
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется, когда пользователь нажимает кнопку для открытия раскрывающегося списка. Также отправляется, когда пользователь нажимает на текстовое поле, если компонент ComboBox недоступен для редактирования.
КонстантаEvent.OPEN
определяет значение свойства type
объекта события open
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, установивший подключение. |
open()
. Раскрывающееся меню закрывается через 1 секунду, если пользователь не наводит курсор на ComboBox или его раскрывающееся меню.
import fl.controls.Button; import fl.controls.ComboBox; var myComboBox:ComboBox = new ComboBox(); myComboBox.addItem({label:"Item 1"}); myComboBox.addItem({label:"Item 2"}); myComboBox.addItem({label:"Item 3"}); myComboBox.move(10, 10); myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler); myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler); addChild(myComboBox); var myButton:Button = new Button(); myButton.emphasized = true; myButton.label = "open ComboBox"; myButton.move(120, 10); myButton.addEventListener(MouseEvent.CLICK, clickHandler); addChild(myButton); var closeTimer:Timer = new Timer(1000, 1); closeTimer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler); function clickHandler(event:MouseEvent):void { myComboBox.open(); closeTimer.reset(); closeTimer.start(); } function timerCompleteHandler(event:TimerEvent):void { myComboBox.close(); } function rollOverHandler(event:MouseEvent):void { closeTimer.stop(); } function rollOutHandler(event:MouseEvent):void { myComboBox.close(); }
См. также
scroll | Событие |
fl.events.ScrollEvent
fl.events.ScrollEvent.SCROLL
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0 |
Отправляется при прокрутке раскрывающегося списка компонента ComboBox.
Задает значение свойстваtype
для объекта события scroll
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
delta | 1 ; значение, указывающее величину прокрутки.
|
direction | vertical ; направление объекта ScrollBar. |
position | 0 ; положение бегунка Scrollbar после того, как он был перемещен. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
cb
.package { import flash.display.Sprite import flash.text.TextField; import flash.events.Event; import fl.controls.ComboBox; public class ComboBoxExample extends Sprite { private var tf:TextField; public function ComboBoxExample() { setupComboBox(); setupTextField(); } private function setupTextField():void { tf = new TextField(); tf.x = 180; tf.y = 15; tf.autoSize = "left"; addChild(tf); } private function setupComboBox():void { cb.setSize(150,22); cb.addItem( { label: "MasterCard", data:1 } ); cb.addItem( { label: "Visa", data:2 } ); cb.addItem( { label: "American Express", data:3 } ); cb.addEventListener(Event.CHANGE, cardSelected); } private function cardSelected(e:Event):void { tf.text = "You have selected: " tf.appendText(cb.selectedItem.label); } } }