Пакет | fl.controls |
Класс | public class ComboBox |
Наследование | ComboBox UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Реализует | IFocusManagerComponent |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | ||
alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | ||
blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | ||
blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | ||
buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | ||
cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | 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 | ||
metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя. | UIComponent | ||
mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | ||
mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | ||
name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | ||
numChildren : int [только для чтения]
Возвращает число дочерних элементов данного объекта. | DisplayObjectContainer | ||
opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | ||
parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | ||
prompt : String
Определяет или задает запрос для компонента ComboBox. | ComboBox | ||
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 | ||
softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | Sprite | ||
stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | ||
tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | DisplayObjectContainer | ||
tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | ||
tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | ||
text : String
Определяет или задает текст, который содержится в текстовом поле компонента ComboBox с возможностью редактирования. | ComboBox | ||
textField : fl.controls:TextInput [только для чтения]
Определяет ссылку на компонент TextInput, который содержится в компоненте ComboBox. | ComboBox | ||
textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | ||
useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | ||
value : String [только для чтения]
Определяет метку элемента в компоненте ComboBox, доступном для редактирования. | ComboBox | ||
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() с заданной точкой point. | DisplayObjectContainer | ||
Удаляет свойство style для экземпляра компонента. | UIComponent | ||
Закрывает раскрывающийся список. | ComboBox | ||
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | ||
Посылает событие в поток событий. | EventDispatcher | ||
Отображает или скрывает индикатор фокуса этого компонента. | UIComponent | ||
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow). | UIComponent | ||
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | ||
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | ||
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | ||
Возвращает позицию индекса для экземпляра DisplayObject child. | DisplayObjectContainer | ||
Возвращает объект, который в настоящее время имеет фокус. | UIComponent | ||
Возвращает элемент в положении, заданном индексом. | ComboBox | ||
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | ||
Возвращает свойство style, установленное в последовательности для поиска стилей компонента. | UIComponent | ||
[статические]
Возвращает карту стилей по умолчанию для текущего компонента. | ComboBox | ||
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | ||
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | ||
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | ||
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное. | UIComponent | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Возвращает строку, которая должна отображаться средством визуализации для указанного объекта данных на основе свойств labelField и labelFunction. | ComboBox | ||
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | ||
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | ||
[статические]
Объединяет стили из нескольких классов в одном объекте. | UIComponent | ||
Перемещает компонент в указанное положение в пределах его родительского компонента. | UIComponent | ||
Открывает раскрывающийся список. | ComboBox | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет все элементы из списка. | ComboBox | ||
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Удаляет указанный элемент из списка. | ComboBox | ||
Удаляет элемент в заданном положении индекса. | ComboBox | ||
Заменяет элемент в положении, заданном индексом, другим элементом. | ComboBox | ||
Вызывает виртуальную клавиатуру. | InteractiveObject | ||
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | DisplayObjectContainer | ||
Задает фокус на этот компонент. | UIComponent | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Задает указанную высоту и ширину компонента. | UIComponent | ||
Задает свойство style для экземпляра компонента. | UIComponent | ||
Сортирует элементы, предоставляемые текущим поставщиком данных. | ComboBox | ||
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям. | ComboBox | ||
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | ||
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | ||
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | ||
Завершает метод startDrag(). | Sprite | ||
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | ||
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | DisplayObjectContainer | ||
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | DisplayObjectContainer | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости. | UIComponent | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | |||
Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | |||
Отправляется при изменении выделенной области в компоненте ComboBox. Если компонент ComboBox доступен для редактирования, то отправляется каждый раз при нажатии клавиши в текстовом поле. | ComboBox | |||
Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. | InteractiveObject | |||
Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда раскрывающийся список по какой-либо причине закрывается. | ComboBox | |||
Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR. | InteractiveObject | |||
Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. | InteractiveObject | |||
Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. | InteractiveObject | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | |||
Передается, если для свойства editable установлено значение true, и пользователь нажимает клавишу Enter после набора текста в доступном для редактирования текстовом поле. | ComboBox | |||
[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | |||
[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | |||
Отправляется после того, как экранный объект перемещается в фокус. | InteractiveObject | |||
Отправляется после того, как экранный объект теряет фокус. | InteractiveObject | |||
[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | |||
Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания. | InteractiveObject | |||
Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда видимый компонент становится невидимым. | UIComponent | |||
Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME. | InteractiveObject | |||
Задает значение свойства type для объекта события itemRollOut. | ComboBox | |||
Задает значение свойства type для объекта события itemRollOver. | ComboBox | |||
Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | |||
Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | |||
Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | |||
Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | |||
Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется при перемещении компонента. | UIComponent | |||
Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания. | InteractiveObject | |||
Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop(). | InteractiveObject | |||
Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы. | InteractiveObject | |||
Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта. | InteractiveObject | |||
Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ. | InteractiveObject | |||
Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | |||
Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | |||
Передается при нажатии пользователем кнопки раскрытия списка для отображения раскрывающегося списка. | ComboBox | |||
Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. | InteractiveObject | |||
Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости). | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. | InteractiveObject | |||
Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | |||
Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | |||
[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | |||
Отправляется при изменении размеров компонента. | UIComponent | |||
Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | |||
Отправляется при прокрутке раскрывающегося списка компонента ComboBox. | ComboBox | |||
Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. | InteractiveObject | |||
Отправляется, когда невидимый компонент становится видимым. | UIComponent | |||
Отправляется сразу после того, как программная клавиатура вызывается. | InteractiveObject | |||
Передается немедленно перед тем, как программная клавиатура появляется на экране. | InteractiveObject | |||
Передается немедленно после того, как программная клавиатура убирается с экрана. | InteractiveObject | |||
Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | |||
Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | |||
Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | |||
Передается, если пользователь вводит один или несколько символов текста. | InteractiveObject | |||
Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | |||
Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | |||
Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Стиль | Описание | Определено | ||
---|---|---|---|---|
buttonWidth | Тип: Number Формат: Length Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Пространство, отделяющее правый край компонента от текста, представляющего выбранный элемент, в пикселах. Кнопка является частью фоновой обложки. Значением по умолчанию является 24 . | ComboBox | ||
cellRenderer | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Класс, который предоставляет средство визуализации для каждого элемента компонента. Значением по умолчанию является fl.controls.listClasses.CellRenderer . | ComboBox | ||
contentPadding | Тип: Number Формат: Length Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Заполняющая информация между содержимым (компонент и полоса прокрутки) и внешним краем фона в пикселах. Значением по умолчанию является 3 . | ComboBox | ||
disabledAlpha | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Значение альфа-канала, которое присваивается списку, когда свойство enabled имеет значение false .
Значением по умолчанию является 0.5 . | ComboBox | ||
disabledSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда его свойству enabled присвоено значение false .
Значением по умолчанию является ComboBox_disabledSkin . | ComboBox | ||
Тип: flash.text.TextFormat Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена. | UIComponent | |||
downArrowDisabledSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования в качестве темы оформления для кнопки со стрелкой вниз полосы прокрутки при ее деактивации. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowDown_disabledSkin . | ComboBox | ||
downArrowDownSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования темы оформления для кнопки со стрелкой вниз полосы прокрутки при щелчке кнопкой мыши на кнопке со стрелкой. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowDown_downSkin . | ComboBox | ||
downArrowOverSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования темы оформления для кнопки со стрелкой вниз полосы прокрутки при наведении курсора мыши на кнопку со стрелкой. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowDown_overSkin . | ComboBox | ||
downArrowUpSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования в качестве темы оформления для кнопки со стрелкой вниз полосы прокрутки. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowDown_upSkin . | ComboBox | ||
downSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда кнопка мыши нажата. Значением по умолчанию является ComboBox_downSkin . | ComboBox | ||
embedFonts | Тип: Boolean Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Указывает, необходимо ли использовать для визуализации текстового поля контуры встроенных шрифтов. Если выбрано значение true , Flash Player визуализирует текстовое поле с помощью контуров встроенных шрифтов. Если выбрано значение false , Flash Player визуализирует текстовое поле с использованием шрифтов устройства.
Если свойству false . | ComboBox | ||
Тип: Number Формат: Length Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах. | UIComponent | |||
Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Обложка, используемая для показа индикаторов фокуса. | UIComponent | |||
overSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса, отвечающего за фон, который появляется в компоненте ComboBox, когда на него указывает курсор. Значением по умолчанию является ComboBox_overSkin . | ComboBox | ||
repeatDelay | Тип: Number Формат: Time Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Количество миллисекунд ожидания, которое проходит после того, как событие buttonDown впервые отправляется перед отправкой второго события buttonDown .
Значением по умолчанию является 500 . | ComboBox | ||
repeatInterval | Тип: Number Формат: Time Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Интервал в миллисекундах между событиями buttonDown , которые отправляются после задержки, указанной с помощью стиля repeatDelay .
Значением по умолчанию является 35 . | ComboBox | ||
Тип: flash.text.TextFormat Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Объект TextFormat, используемый для визуализации метки компонента. | UIComponent | |||
textPadding | Тип: Number Формат: Length Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Пространство, отделяющее границу от текста, отражающего выбранный элемент, в пикселах. Значением по умолчанию является 3 . | ComboBox | ||
thumbArrowUpSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса, используемого в качестве обложки для бегунка полосы прокрутки. Значением по умолчанию является ScrollThumb_upSkin . | ComboBox | ||
thumbDisabledSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Обложка, используемая для указания отключенного состояния бегунка. Значением по умолчанию является ScrollThumb_upSkin . | ComboBox | ||
thumbDownSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования в качестве темы оформления для ползунка полосы прокрутки при щелчке кнопкой мыши на ползунке. Значением по умолчанию является ScrollThumb_downSkin . | ComboBox | ||
thumbIcon | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования значка ползунка для полосы прокрутки. Значением по умолчанию является ScrollBar_thumbIcon . | ComboBox | ||
thumbOverSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования в качестве темы оформления для ползунка полосы прокрутки при наведении курсора мыши на ползунок. Значением по умолчанию является ScrollThumb_overSkin . | ComboBox | ||
trackDisabledSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Обложка, используемая для указания отключенной дорожки. Значением по умолчанию является ScrollTrack_Skin . | ComboBox | ||
trackDownSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Обложка, используемая для того, чтобы указать состояние нажатой кнопки мыши для отключенной обложки. Значением по умолчанию является ScrollTrack_Skin . | ComboBox | ||
trackOverSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Обложка, используемая для того, чтобы указать состояние курсора, находящегося над дорожкой прокрутки. Значением по умолчанию является ScrollTrack_Skin . | ComboBox | ||
trackUpSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Обложка, используемая для того, чтобы указать состояние ненажатой кнопки мыши для дорожки прокрутки. Значением по умолчанию является ScrollTrack_Skin . | ComboBox | ||
upArrowDisabledSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования в качестве темы оформления для кнопки со стрелкой вверх полосы прокрутки при ее деактивации. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowUp_disabledSkin . | ComboBox | ||
upArrowDownSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования темы оформления для кнопки со стрелкой вверх полосы прокрутки при щелчке кнопкой мыши на кнопке со стрелкой. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowUp_downSkin . | ComboBox | ||
upArrowOverSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования темы оформления для кнопки со стрелкой вверх полосы прокрутки при наведении курсора мыши на кнопку со стрелкой. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowUp_overSkin . | ComboBox | ||
upArrowUpSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса для использования в качестве темы оформления для кнопки со стрелкой вверх на полосе прокрутки. Если обложку изменить графическим или программным образом, необходимо сделать так, чтобы новая обложка имела ту же высоту (в случае горизонтальных полос прокрутки) или ширину (в случае вертикальных полос прокрутки), что и дорожка. Значением по умолчанию является ScrollArrowUp_upSkin . | ComboBox | ||
upSkin | Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flash CS3 Версии среды выполнения: Flash9.0.28.0, AIR 1.0 Имя класса, отвечающего за фон компонента ComboBox. Значением по умолчанию является ComboBox_upSkin . | ComboBox |
dataProvider | свойство |
dataProvider:DataProvider
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает модель данных для списка просматриваемых элементов. Один и тот же поставщик данных может использоваться несколькими компонентами на основе списка. Изменения в поставщике данных немедленно становятся доступны всем компонентам, которые используют его в качестве источника данных.
Реализация
public function get dataProvider():DataProvider
public function set dataProvider(value:DataProvider):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет ссылку на компонент List, который находится в компоненте ComboBox. Экземпляр подкомпонента List не создается в ComboBox до тех пор, пока не приходит время его показать. Однако этот список создается во время доступа к свойству dropdown
.
Реализация
public function get dropdown():List
dropdownWidth | свойство |
dropdownWidth:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает имя поля в объекте dataProvider
, отображаемое в качестве метки поля TextInput и раскрывающегося списка.
Этот компонент по умолчанию показывает свойство label
для каждого элемента dataProvider
. Если элементы dataProvider
не содержат свойство label
, свойство labelField
можно задать, чтобы воспользоваться другим свойством.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Значением по умолчанию является "label".
Реализация
public function get labelField():String
public function set labelField(value:String):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает функцию, используемую для получения метки элемента.
Этот компонент по умолчанию показывает свойство label
для элемента dataProvider
. Но некоторые наборы данных могут не иметь поля label
или иметь поле, значение которого можно использовать в качестве метки без изменений. Так, например, в определенном наборе данных могут храниться полные имена, но их поддержка выполняется с помощью полей lastName
и firstName
. В подобном случае данное свойство можно использовать для установки функции обратного вызова, которая объединяет значения полей lastName
и firstName
в показываемой строке полного имени.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Реализация
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет количество элементов в списке. Это свойство принадлежит компоненту List, но его можно также открыть из экземпляра ComboBox.
Значением по умолчанию является 0.
Реализация
public function get length():int
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает символы, которые могут быть введены пользователем в текстовом поле. Если значение restrict
— это строка, состоящая из символов, в текстовое поле можно вводить только символы из этой строки. Строка читается слева направо. Если свойству restrict
присвоено значение null
, можно ввести любой символ. Если в качестве значения свойства restrict
выступает пустая строка (""), ввод символов не поддерживается. Диапазон определяется с помощью символа (-). При этом ограничивается только взаимодействие с пользователем; сценарий может помещать в текстовое поле любой символ.
Значением по умолчанию является null.
Реализация
public function get restrict():String
public function set restrict(value:String):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает максимальное число строк, отображаемых в раскрывающемся списке без появления полосы прокрутки. Если количество элементов в раскрывающемся списке превышает это значение, размер списка изменяется и при необходимости появляется полоса прокрутки. Если количество элементов в раскрывающемся списке меньше этого значения, размер раскрывающегося списка изменяется в соответствии с количеством содержащихся в нем элементов.
Это поведение отличается от поведения компонента List, в котором всегда указывается количество строк, определяемое свойством rowCount
даже в том случае, когда среди них есть пробелы.
Значением по умолчанию является 5.
Реализация
public function get rowCount():uint
public function set rowCount(value:uint):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет или задает индекс выбранного элемента в списке, допускающем выбор одного элемента. В списке, допускающем выбор одного элемента, за один раз можно выбрать только один элемент.
Значение «-1» указывает, что не выделен ни один элемент; если выделено несколько элементов, это значение равно индексу элемента, который был выбран последним в группе выделенных элементов.
Когда это свойство задается с помощью ActionScript, элемент с указанным индексом заменяет текущую выделенную область. Когда выделение изменяется программным методом, объект события change
не отправляется.
Значением по умолчанию является 0.
Реализация
public function get selectedIndex():int
public function set selectedIndex(value:int):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Возвращает или устанавливает значение элемента, выбранного в раскрывающемся списке. Если пользователь вводит текст в текстовое поле редактируемого компонента ComboBox, свойству selectedItem
присваивается значение undefined
. Это свойство имеет значение только тогда, когда пользователь выбирает элемент или когда ActionScript используется для выбора элемента из раскрывающегося списка. Если компонент ComboBox не допускает редактирование, значение свойства selectedItem
всегда действительно. Если в раскрывающемся списке редактируемого компонента ComboBox отсутствуют элементы, этому свойству присваивается значение null
.
Значением по умолчанию является null.
Реализация
public function get selectedItem():Object
public function set selectedItem(value:Object):void
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет строку, отображаемую в объекте TextInput компонента ComboBox. Это значение рассчитывается на основе данных с помощью свойства labelField
или labelFunction
.
Реализация
public function get selectedLabel():String
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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:fl.controls:TextInput
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет ссылку на компонент TextInput, который содержится в компоненте ComboBox. Воспользуйтесь этим свойством для доступа и манипулирования основным компонентом TextInput. Например, этим свойством можно воспользоваться, чтобы изменить выделение текстового поля или ограничить набор символов, которые можно в него ввести.
Реализация
public function get textField():fl.controls: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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Создает новый экземпляр компонента ComboBox.
addItem | () | метод |
public function addItem(item:Object):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Добавляет элемент в конец списка элементов.
Элемент должен содержать свойства label
и data
; однако в этот список можно также добавить элементы с другими свойствами. По умолчанию свойство label
элемента используется для показа метки строки; данные строки сохраняются в свойстве data
.
Параметры
item:Object — Элемент, добавляемый в поставщик данных.
|
Связанные элементы API
addItemAt | () | метод |
public function addItemAt(item:Object, index:uint):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Вставляет элемент в положении списка, заданном индексом. Индексы элементов в указанном положении индекса или после него увеличиваются на 1.
Параметры
item:Object — Элемент, добавляемый в список.
| |
index:uint — Индекс для места добавления элемента.
|
Связанные элементы API
close | () | метод |
public function close():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Закрывает раскрывающийся список.
Примечание. Вызов этого метода приводит к отправке события close
. Если компонент ComboBox уже закрыт, вызов этого метода не будет иметь последствий.
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat
содержит значение null
или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle()
по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat
, выбранный по умолчанию для указанного компонента:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Объект стилей по умолчанию.
|
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Извлекает строку, показываемую средством визуализации для указанного объекта данных, исходя из значений свойств labelField
и labelFunction
.
Примечание. Свойство labelField
не используется, если свойству labelFunction
присвоена функция обратного вызова.
Параметры
item:Object — Объект, создаваемый путем визуализации.
|
String — Строка, отображаемая в зависимости от данных.
|
Связанные элементы API
open | () | метод |
public function open():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Открывает раскрывающийся список.
Примечание. Вызов этого метода вызывает отправку события open
. Если компонент ComboBox уже открыт, вызов этого метода не будет иметь последствий.
Связанные элементы API
removeAll | () | метод |
public function removeAll():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Удаляет все элементы из списка.
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Удаляет указанный элемент из списка.
Параметры
item:Object — Удаляемый элемент.
|
Object — Удаленный элемент.
|
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Удаляет элемент в заданном положении индекса. Местоположения индексов элементов, индексы которых превышают указанный индекс, смещаются в массиве на 1.
Это метод компонента List, который доступен из экземпляра компонента ComboBox.
Параметры
index:uint — Индекс удаляемого элемента.
|
Выдает
RangeError — Указанный индекс меньше 0, либо больше или равен длине поставщика данных.
|
Связанные элементы API
replaceItemAt | () | метод |
public function replaceItemAt(item:Object, index:uint):Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Сортирует элементы, предоставляемые текущим поставщиком данных. Этот метод выполняет сортировку на основе значений Юникод элементов. ASCII — это подмножество Юникода.
Параметры
... sortArgs — Аргументы, по которым выполняется сортировка.
|
* — Возвращаемое значение зависит от того, переданы ли какие-либо параметры этому методу. Дополнительную информацию см. в описании метода Array.sort() . Учтите, что этот метод возвращает 0, когда параметру sortArgs присваивается значение Array.UNIQUESORT .
|
Связанные элементы API
Пример ( Использование этого примера )
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 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям.
Параметры
field:String — Поле, которое служит критерием сортировки.
| |
options:Object (default = null ) — Аргументы сортировки, которые используются для переопределения поведения сортировки по умолчанию. Два и более аргумента разделяются побитовым оператором ИЛИ (|).
|
* — Возвращаемое значение зависит от того, переданы ли какие-либо параметры этому методу. Дополнительную информацию см. в описании метода Array.sortOn() . Учтите, что этот метод возвращает 0, когда параметру sortOption присваивается значение Array.UNIQUESORT .
|
Связанные элементы API
Пример ( Использование этого примера )
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
свойство Event.type =
flash.events.Event.CHANGE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется при изменении выделенной области в компоненте ComboBox. Если компонент ComboBox доступен для редактирования, то отправляется каждый раз при нажатии клавиши в текстовом поле.
Примечание. Несмотря на то что в таблице ниже отражаются пузырьки событий change
, пузырьки для элемента управления fl.controls.ComboBox отсутствуют.
Event.CHANGE
определяет значение свойства type
объекта события change
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
close | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.CLOSE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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(); } }
Связанные элементы API
enter | Событие |
fl.events.ComponentEvent
свойство ComponentEvent.type =
fl.events.ComponentEvent.ENTER
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Передается, если для свойства editable
установлено значение true
, и пользователь нажимает клавишу Enter после набора текста в доступном для редактирования текстовом поле.
type
для объекта события enter
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
itemRollOut | Событие |
fl.events.ListEvent
свойство ListEvent.type =
fl.events.ListEvent.ITEM_ROLL_OUT
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется, когда пользователь убирает указатель мыши с одного из элементов данного компонента.
Задает значение свойства
type
для объекта события itemRollOut
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
columnIndex | Отсчитываемый от нуля индекс столбца, содержащего средство визуализации. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
index | Отсчитываемое от нуля значение индекса в объекте DataProvider, содержащем средство визуализации. |
item | Ссылка на данные, принадлежащие средству визуализации. |
rowIndex | Отсчитываемое от нуля значение индекса строки, содержащего средство визуализации. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
Связанные элементы API
itemRollOver | Событие |
fl.events.ListEvent
свойство ListEvent.type =
fl.events.ListEvent.ITEM_ROLL_OVER
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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; }
Связанные элементы API
open | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.OPEN
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.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(); }
Связанные элементы API
scroll | Событие |
fl.events.ScrollEvent
свойство ScrollEvent.type =
fl.events.ScrollEvent.SCROLL
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS3 |
Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Отправляется при прокрутке раскрывающегося списка компонента ComboBox.
Задает значение свойстваtype
для объекта события scroll
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
delta | 1 ; значение, указывающее величину прокрутки.
|
direction | vertical ; направление объекта ScrollBar. |
position | 0 ; положение бегунка Scrollbar после того, как он был перемещен. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
- Перетащите ComboBox на монтажный стол и назовите его
cb
. - Сохраните этот код под именем ComboBoxExample.as в том же каталоге, где и FLA-файл.
- Присвойте параметру 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); } } }
Tue Jun 12 2018, 11:34 AM Z