Пакетfl.controls
Классpublic class ComboBox
НаследованиеComboBox Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Реализует IFocusManagerComponent

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Компонент ComboBox содержит раскрывающийся список, в котором можно выбрать одно значение. Ее функциональные возможности аналогичны возможностям элемента формы SELECT в HTML. Компонент ComboBox можно редактировать. В этом случае пользователь может вводить записи, которые не включены в список, в раздел TextInput компонента ComboBox.

Посмотреть примеры

См. также

List
TextInput


Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
 InheritedbuttonMode : Boolean
Задает режим кнопки данного спрайта.
Sprite
 InheritedcacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.
DisplayObject
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcontextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом.
InteractiveObject
  dataProvider : DataProvider
Определяет или задает модель данных для списка просматриваемых элементов.
ComboBox
 InheriteddoubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick.
InteractiveObject
  dropdown : List
[только для чтения] Определяет ссылку на компонент List, который находится в компоненте ComboBox.
ComboBox
  dropdownWidth : Number
Определяет или задает максимальную ширину раскрывающегося списка (в пикселах).
ComboBox
 InheriteddropTarget : DisplayObject
[только для чтения] Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен.
Sprite
  editable : Boolean
Определяет или задает логическое значение, которое определяет возможность редактирования компонента ComboBox.
ComboBox
 Inheritedenabled : Boolean
Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем.
UIComponent
 Inheritedfilters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.
DisplayObject
 InheritedfocusEnabled : Boolean
Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedfocusManager : IFocusManager
Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии.
UIComponent
 InheritedfocusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.
InteractiveObject
 Inheritedgraphics : Graphics
[только для чтения] Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.
Sprite
 Inheritedheight : Number
Определяет или задает высоту компонента (в пикселах).
UIComponent
 InheritedhitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта.
Sprite
  labelField : String
Определяет или задает имя поля в объекте dataProvider, отображаемое в качестве метки поля TextInput и раскрывающегося списка.
ComboBox
  labelFunction : Function
Определяет или задает функцию, используемую для получения метки элемента.
ComboBox
  length : int
[только для чтения] Определяет количество элементов в списке.
ComboBox
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
 InheritedmouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedmouseX : Number
[только для чтения] Указывает координату x положения курсора мыши (в пикселах).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y положения курсора мыши (в пикселах).
DisplayObject
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
 InheritednumChildren : int
[только для чтения] Возвращает число потомков данного объекта.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
  prompt : String
Определяет или задает запрос для компонента ComboBox.
ComboBox
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  restrict : String
Определяет или задает символы, которые могут быть введены пользователем в текстовом поле.
ComboBox
 Inheritedroot : DisplayObject
[только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.
DisplayObject
 Inheritedrotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).
DisplayObject
 InheritedrotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
  rowCount : uint
Определяет или задает максимальное число строк, отображаемых в раскрывающемся списке без появления полосы прокрутки.
ComboBox
 Inheritedscale9Grid : Rectangle
Текущая активная сетка масштабирования.
DisplayObject
 InheritedscaleX : Number
Умножает текущую ширину компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleY : Number
Умножает текущую высоту компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
  selectedIndex : int
Определяет или задает индекс выбранного элемента в списке, допускающем выбор одного элемента.
ComboBox
  selectedItem : Object
Определяет или задает значение элемента, выбранного в раскрывающемся списке.
ComboBox
  selectedLabel : String
[только для чтения] Определяет строку, отображаемую в объекте TextInput компонента ComboBox.
ComboBox
 InheritedsoundTransform : SoundTransform
Управляет звуком в данном спрайте.
Sprite
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
  text : String
Определяет или задает текст, который содержится в текстовом поле компонента ComboBox с возможностью редактирования.
ComboBox
  textField : TextInput
[только для чтения] Определяет ссылку на компонент TextInput, который содержится в компоненте ComboBox.
ComboBox
 InheritedtextSnapshot : TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
 InheriteduseHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.
Sprite
  value : String
[только для чтения] Определяет метку элемента в компоненте ComboBox, доступном для редактирования.
ComboBox
 Inheritedversion : String = "3.0.0.15"
Номер версии компонентов.
UIComponent
 Inheritedvisible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента.
UIComponent
 Inheritedwidth : Number
Определяет или задает ширину компонента (в пикселах).
UIComponent
 Inheritedx : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера.
UIComponent
 Inheritedy : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера.
UIComponent
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр компонента ComboBox.
ComboBox
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
Добавляет элемент в конец списка элементов.
ComboBox
  
addItemAt(item:Object, index:uint):void
Вставляет элемент в положении списка, заданном индексом.
ComboBox
 Inherited
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой.
DisplayObjectContainer
 Inherited
Удаляет свойство style для экземпляра компонента.
UIComponent
  
Закрывает раскрывающийся список.
ComboBox
 Inherited
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.
DisplayObjectContainer
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
Отображает или скрывает индикатор фокуса этого компонента.
UIComponent
 Inherited
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow).
UIComponent
 Inherited
DisplayObject
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для дочернего экземпляра DisplayObject.
DisplayObjectContainer
 Inherited
DisplayObject
 Inherited
Возвращает объект, который в настоящее время имеет фокус.
UIComponent
  
Возвращает элемент в положении, заданном индексом.
ComboBox
 Inherited
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
Возвращает свойство style, установленное в последовательности для поиска стилей компонента.
UIComponent
  
[статические] Возвращает карту стилей по умолчанию для текущего компонента.
ComboBox
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).
DisplayObject
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное.
UIComponent
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Возвращает строку, которая должна отображаться средством визуализации для указанного объекта данных на основе свойств labelField и labelFunction.
ComboBox
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
[статические] Объединяет стили из нескольких классов в одном объекте.
UIComponent
 Inherited
Перемещает компонент в указанное положение в пределах его родительского компонента.
UIComponent
 Inherited
DisplayObject
 Inherited
DisplayObject
  
Открывает раскрывающийся список.
ComboBox
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Удаляет все элементы из списка.
ComboBox
 Inherited
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Удаляет указанный элемент из списка.
ComboBox
  
Удаляет элемент в заданном положении индекса.
ComboBox
  
Заменяет элемент в положении, заданном индексом, другим элементом.
ComboBox
 Inherited
Изменяет положение существующего потомка в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает фокус на этот компонент.
UIComponent
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
setSize(width:Number, height:Number):void
Задает указанную высоту и ширину компонента.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Задает свойство style для экземпляра компонента.
UIComponent
  
sortItems(... sortArgs):*
Сортирует элементы, предоставляемые текущим поставщиком данных.
ComboBox
  
sortItemsOn(field:String, options:Object = null):*
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям.
ComboBox
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану).
Sprite
 Inherited
Завершает метод startDrag().
Sprite
 Inherited
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков.
DisplayObjectContainer
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости.
UIComponent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Возвращает указанный стиль для компонента, учитывая все стили, заданные на глобальном уровне, уровне компонентов и уровне экземпляров.
UIComponent
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
  Отправляется при изменении выделенной области в компоненте ComboBox. Если компонент ComboBox доступен для редактирования, то отправляется каждый раз при нажатии клавиши в текстовом поле.ComboBox
 InheritedОтправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
  Отправляется, когда раскрывающийся список по какой-либо причине закрывается.ComboBox
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 InheritedОтправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.InteractiveObject
  Отправляется, если свойство editable имеет значение true, а пользователь во время набора текста в редактируемом поле нажимает клавишу Enter.ComboBox
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 InheritedОтправляется, когда экранный объект перемещается в фокус.InteractiveObject
 InheritedОтправляется, когда экранный объект покидает фокус.InteractiveObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
 InheritedОтправляется, когда видимый компонент становится невидимым.UIComponent
   Задает значение свойства type для объекта события itemRollOut.ComboBox
   Задает значение свойства type для объекта события itemRollOver.ComboBox
 InheritedОтправляется, когда пользователь нажимает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью клавиатуры.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется при перемещении компонента.UIComponent
  Отправляется, когда пользователь нажимает кнопку для открытия раскрывающегося списка.ComboBox
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.InteractiveObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется при изменении размеров компонента.UIComponent
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
  Отправляется при прокрутке раскрывающегося списка компонента ComboBox.ComboBox
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда невидимый компонент становится видимым.UIComponent
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства 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
 InheritedТип: 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 визуализирует текстовое поле с использованием шрифтов устройства.

Если свойству embedFonts текстового поля присвоено значение true, необходимо указать для текста шрифт с помощью свойства font объекта TextFormat, примененного к текстовому полю. Если указанный шрифт не встроен в SWF-файл, текст не отображается.

Значение по умолчанию false.
ComboBox
 InheritedТип: Number Формат: Length
Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах.
UIComponent
 InheritedТип: Class
Обложка, используемая для показа индикаторов фокуса.
UIComponent
  
overSkin
Тип: Class
Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда на него указывает курсор. Значение по умолчанию ComboBox_overSkin.
ComboBox
  
repeatDelay
Тип: Number Формат: Time
Количество миллисекунд ожидания, которое проходит после того, как событие buttonDown впервые отправляется перед отправкой второго события buttonDown. Значение по умолчанию 500.
ComboBox
  
repeatInterval
Тип: Number Формат: Time
Интервал в миллисекундах между событиями buttonDown, которые отправляются после задержки, указанной с помощью стиля repeatDelay. Значение по умолчанию 35.
ComboBox
 InheritedТип: 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

См. также


Пример
В следующем примере демонстрируется метод выбора поставщика данных для компонента ComboBox. ComboBox обновляется при обновлении поставщика данных:

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

Пример
В следующем примере создается экземпляр компонента ComboBox, а свойство 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;
}
В следующем примере создается экземпляр компонента ComboBox, а свойство 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

Пример
В следующем примере создается новый редактируемый экземпляр ComboBox, который добавляет пользовательские элементы к поставщику данных при отправке события 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

См. также


Пример
В следующем примере создается компонент ComboBox, а свойство 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) + ")";
}
В следующем примере создается компонент ComboBox, а свойство 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

См. также


Пример
В следующем примере создается ComboBox, а свойство 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);
В следующем примере создается ComboBox, а свойство 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

Пример
В следующем примере создается экземпляр компонента ComboBox, задается свойство 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);
В следующем примере создается экземпляр компонента ComboBox, а свойство 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

См. также


Пример
В следующем примере создается компонент ComboBox, позволяющий вводить только шестнадцатеричные обозначения цветов с помощью свойства 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

См. также


Пример
В следующем примере используется компонент Slider, который устанавливает свойство 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

См. также


Пример
В следующем примере компонент Slider применяется при установке свойства 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;
}
В следующем примере создается компонент ComboBox, а значение свойства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

См. также


Пример
В следующем примере компонент Button применяется для копирования элементов из ComboBox в List:

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;
    }
}
В следующем примере используются два компонента Label, которые показывают выделенный в данный момент элемент в компоненте 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 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

См. также


Пример
В следующем примере компонент Label используется при показе свойства 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

Пример
В следующем примере создается редактируемый компонент ComboBox, в котором показан текст, введенный в экземпляр компонента TextArea:

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

Пример
В следующем примере создается редактируемый компонент ComboBox, позволяющий вводить только 8 символов:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.textField.maxChars = 8;
myComboBox.move(10, 10);
addChild(myComboBox);
В следующем примере создается компонент ComboBox и задается формат текста для внедренного текстового поля:

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);
В следующем примере создается компонент ComboBox и задается пользовательский формат текста для внедренного текстового поля и раскрывающегося меню:

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

Пример
В следующем примере компонент Label используется для показа свойства 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 уже закрыт, вызов этого метода не будет иметь последствий.

См. также


Пример

В следующем примере создается экземпляр компонента 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 — Объект с указанным положением индекса.

Пример

В следующем примере создается экземпляр компонента ComboBox. Чтобы скопировать элементы из ComboBox в компонент DataGrid используется цикл for и метод 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

Удаляет все элементы из списка.

См. также


Пример

В следующем примере создается экземпляр компонента Button, удаляющий элементы из ComboBox с помощью метода 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 — Замененный элемент.

Пример

В следующем примере выбранный в ComboBox в данный момент элемент заменяется значением из компонента TextInput с помощью метода 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.

См. также


Пример

В следующем примере выполняется сортировка элементов в экземпляре ComboBox согласно тексту метки для каждого элемента. Подлежащие сортировке элементы передаются пользовательской функции сортировки 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.

См. также


Пример

Следующие примеры основаны на экземпляре ComboBox с именем 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

В следующем примере создается ComboBox и выполняется сортировка элементов методом 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
свойство Event.type = flash.events.Event.CHANGE

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Отправляется при изменении выделенной области в компоненте ComboBox. Если компонент ComboBox доступен для редактирования, то отправляется каждый раз при нажатии клавиши в текстовом поле.

Константа Event.CHANGE определяет значение свойства type объекта события change.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
close Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CLOSE

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

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

Константа Event.CLOSE определяет значение свойства type объекта события close.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого разорвано подключение.

Пример

В следующем примере создается экземпляр компонента 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();
    }
}

См. также

enter Событие  
Тип объекта события: fl.events.ComponentEvent
свойство ComponentEvent.type = fl.events.ComponentEvent.ENTER

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Отправляется, если свойство editable имеет значение true, а пользователь во время набора текста в редактируемом поле нажимает клавишу Enter.

Задает значение свойства type для объекта события enter.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.
itemRollOut Событие  
Тип объекта события: fl.events.ListEvent
свойство ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OUT

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Отправляется, когда пользователь убирает указатель мыши с одного из элементов данного компонента.

Задает значение свойства type для объекта события itemRollOut.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexОтсчитываемое от нуля значение индекса столбца, содержащего средство визуализации.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
indexОтсчитываемое от нуля значение индекса в объекте DataProvider, содержащем средство визуализации.
itemСсылка на данные, принадлежащие средству визуализации.
rowIndexОтсчитываемое от нуля значение индекса строки, содержащего средство визуализации.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

itemRollOver Событие  
Тип объекта события: fl.events.ListEvent
свойство ListEvent.type = fl.events.ListEvent.ITEM_ROLL_OVER

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Отправляется, когда пользователь наводит указатель мыши на один из элементов данного компонента.

Задает значение свойства type для объекта события itemRollOver.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexОтсчитываемое от нуля значение индекса столбца, содержащего средство визуализации.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
indexОтсчитываемое от нуля значение индекса в объекте DataProvider, содержащем средство визуализации.
itemСсылка на данные, принадлежащие средству визуализации.
rowIndexОтсчитываемое от нуля значение индекса строки, содержащего средство визуализации.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

Пример

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

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
свойство Event.type = flash.events.Event.OPEN

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

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

Константа Event.OPEN определяет значение свойства type объекта события open.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, установивший подключение.

Пример

В следующем примере создается компонент Button, открывающий раскрывающийся список компонента ComboBox с помощью метода 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
свойство ScrollEvent.type = fl.events.ScrollEvent.SCROLL

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Отправляется при прокрутке раскрывающегося списка компонента ComboBox.

Задает значение свойства type для объекта события scroll.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
delta1; значение, указывающее величину прокрутки.
directionvertical; направление объекта ScrollBar.
position0; положение бегунка Scrollbar после того, как он был перемещен.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.
Примеры Как пользоваться примерами
ComboBoxExample.as

В этом примере показано, как отслеживать события ComboBox.
  1. Перетащите ComboBox в рабочую область и назовите его cb.
  2. Сохраните этот код под именем ComboBoxExample.as в том же каталоге, где и FLA-файл.
  3. Присвойте параметру DocumentClass в FLA-файле значение ComboBoxExample.
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);
        }
    }
}