| Пакет | mx.core |
| Интерфейс | public interface IContainer extends IUIComponent , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
| Средство реализации | Container, Legend |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | IFlexDisplayObject | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | IFlexDisplayObject | |
| baselinePosition : Number [только для чтения]
Координата Y базовой линии первой строки текста компонента. | IUIComponent | |
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | IFlexDisplayObject | |
| buttonMode : Boolean
Задает режим кнопки данного спрайта. | IContainer | ||
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | IFlexDisplayObject | |
| creatingContentPane : Boolean
Контейнеры используют внутреннюю область содержимого для управления прокруткой. | IContainer | ||
| defaultButton : IFlexDisplayObject
Элемент управления Button, определенный в качестве кнопки по умолчанию для контейнера. | IContainer | ||
| document : Object
Ссылка на объект документа, связанный с этим компонентом. | IUIComponent | |
| doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | IContainer | ||
| dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен. | IContainer | ||
| enabled : Boolean
Возможность использования компонента пользователем. | IUIComponent | |
| explicitHeight : Number
Явно указанная высота для компонента в пикселях в виде координат компонента. | IUIComponent | |
| explicitMaxHeight : Number [только для чтения]
Число, указывающее максимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | |
| explicitMaxWidth : Number [только для чтения]
Число, указывающее максимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | |
| explicitMinHeight : Number [только для чтения]
Число, указывающее минимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | |
| explicitMinWidth : Number [только для чтения]
Число, указывающее минимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | |
| explicitWidth : Number
Явно указанная ширина для компонента в пикселях в виде координат компонента. | IUIComponent | |
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | IFlexDisplayObject | |
| focusManager : IFocusManager [только для чтения]
Получает FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. | IContainer | ||
| focusPane : Sprite
Один объект Sprite, распределенный между компонентами и используемый в качестве перекрытия для отображения индикатора фокуса. | IUIComponent | |
| focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | IContainer | ||
| graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | IContainer | ||
| height : Number
Указывает высоту экранного объекта в пикселях. | IFlexDisplayObject | |
| hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | IContainer | ||
| horizontalScrollPosition : Number
Текущая позиция горизонтальной полосы прокрутки. | IContainer | ||
| includeInLayout : Boolean
Указывает, включается ли этот компонент в макет вышестоящего контейнера. | IUIComponent | |
| isPopUp : Boolean
Установите значение true в PopUpManager для указания того, что компонент имеет всплывающую подсказку. | IUIComponent | |
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | IFlexDisplayObject | |
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | IFlexDisplayObject | |
| maxHeight : Number [только для чтения]
Число, указывающее максимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | |
| maxWidth : Number [только для чтения]
Число, указывающее максимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | |
| measuredHeight : Number [только для чтения]
Рассчитанная высота этого объекта. | IFlexDisplayObject | |
| measuredMinHeight : Number
Минимальная высота компонента по умолчанию в пикселях. | IUIComponent | |
| measuredMinWidth : Number
Минимальная ширина компонента по умолчанию в пикселях. | IUIComponent | |
| measuredWidth : Number [только для чтения]
Измеренная ширина этого объекта. | IFlexDisplayObject | |
| minHeight : Number [только для чтения]
Число, указывающее минимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | |
| minWidth : Number [только для чтения]
Число, указывающее минимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | |
| mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | IContainer | ||
| mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | IContainer | ||
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | IFlexDisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | IFlexDisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | IFlexDisplayObject | |
| numChildren : int [только для чтения]
Возвращает число дочерних элементов данного объекта. | IContainer | ||
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | IFlexDisplayObject | |
| owner : DisplayObjectContainer
Владелец этого объекта IVisualElement. | IUIComponent | |
| parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | IFlexDisplayObject | |
| percentHeight : Number
Число, указывающее высоту компонента в виде процента от размера вышестоящего элемента. | IUIComponent | |
| percentWidth : Number
Число, указывающее ширину компонента в процентах от размера его вышестоящего элемента. | IUIComponent | |
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | IFlexDisplayObject | |
| rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | IFlexDisplayObject | |
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | IFlexDisplayObject | |
| scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | IFlexDisplayObject | |
| scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | IFlexDisplayObject | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | IFlexDisplayObject | |
| soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | IContainer | ||
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | IFlexDisplayObject | |
| systemManager : ISystemManager
Ссылка на объект SystemManager для этого компонента. | IUIComponent | |
| tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | IContainer | ||
| tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | IContainer | ||
| tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | IContainer | ||
| textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | IContainer | ||
| transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | IFlexDisplayObject | |
| tweeningProperties : Array
Используется EffectManager. | IUIComponent | |
| useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | IContainer | ||
| verticalScrollPosition : Number
Текущая позиция вертикальной полосы прокрутки. | IContainer | ||
| viewMetrics : EdgeMetrics [только для чтения]
Возвращает объект, имеющий четыре свойства: left, top, right и bottom. | IContainer | ||
| visible : Boolean
Определяет видимость экранного объекта. | IFlexDisplayObject | |
| width : Number
Указывает ширину экранного объекта в пикселях. | IFlexDisplayObject | |
| x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IFlexDisplayObject | |
| y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IFlexDisplayObject | |
| Метод | Определено | ||
|---|---|---|---|
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | IContainer | ||
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | IContainer | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | |
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | IContainer | ||
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | IContainer | ||
|
Посылает событие в поток событий. | IEventDispatcher | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | IFlexDisplayObject | |
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | IContainer | ||
Возвращает экземпляр дочернего экранного объекта с заданным именем. | IContainer | ||
Возвращает позицию индекса для экземпляра DisplayObject child. | IContainer | ||
|
Стандартный метод, позволяющий определить, использовать ли явную или измеренную высоту
| IUIComponent | |
|
Стандартный метод, позволяющий определить, использовать ли явную или измеренную ширину
| IUIComponent | |
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | IContainer | ||
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | IFlexDisplayObject | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | IFlexDisplayObject | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | IFlexDisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | IFlexDisplayObject | |
|
Инициализация объекта. | IUIComponent | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | IFlexDisplayObject | |
|
Перемещает этот объект по указанным координатам осей x и y. | IFlexDisplayObject | |
|
Возвращает значение true, если цепочка свойств owner направлена от child к этому UIComponent. | IUIComponent | |
|
Вызывается Flex при добавлении или удалении объекта UIComponent из вышестоящего элемента. | IUIComponent | |
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | IContainer | ||
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | IContainer | ||
|
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | |
|
Устанавливает фактический размер для этого объекта. | IFlexDisplayObject | |
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | IContainer | ||
|
Вызывается при изменении свойства visible. | IUIComponent | |
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | IContainer | ||
Завершает метод startDrag(). | IContainer | ||
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | IContainer | ||
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | IContainer | ||
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher | |
buttonMode | свойство |
buttonMode:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает режим кнопки данного спрайта. При значении true этот спрайт ведет себя как кнопка, то есть запускает отображение курсора в виде руки, когда над ним проходит указатель, и может получать событие click при нажатии клавиш Enter и «Пробел», когда спрайт находится в фокусе. Можно отменить отображение курсора в виде руки, задав свойству useHandCursor значение false, в этом случае будет отображаться указатель.
В целом, для создания кнопок лучше использовать класс SimpleButton, однако свойство buttonMode можно использовать для придания спрайту некоторых функций кнопок. Чтобы включить спрайт в последовательность перехода посредством клавиши Tab, задайте свойству tabEnabled (унаследованному от класса InteractiveObject и имеющему по умолчанию значение false) значение true. Кроме того, подумайте, должны ли дочерние элементы спрайта реагировать на пользовательский ввод. Большинство кнопок блокируют воздействие пользовательского ввода на дочерние объекты, так как это препятствует нормальному потоку событий. Чтобы отключить воздействие пользовательского ввода на дочерние объекты, необходимо задать свойству mouseChildren (унаследованному от класса DisplayObjectContainer) значение false.
Если свойство buttonMode используется с классом MovieClip (подклассом класса Sprite), кнопка может получить дополнительные функции. Если включить кадры с подписями _up, _over и _down, проигрыватель Flash Player передает автоматические изменения состояния (функция, подобная возможностям фрагментов роликов, используемых в качестве кнопок, в предыдущих версиях ActionScript). Эти автоматические изменения состояния недоступны для спрайтов, так как у них нет временной шкалы и, следовательно, кадров для добавления подписей.
Реализация
public function get buttonMode():Boolean public function set buttonMode(value:Boolean):voidcreatingContentPane | свойство |
creatingContentPane:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Контейнеры используют внутреннюю область содержимого для управления прокруткой. Для creatingContentPane установлено значение true, если контейнер создает область содержимого, так что некоторые события могут игнорироваться или блокироваться.
Реализация
public function get creatingContentPane():Boolean public function set creatingContentPane(value:Boolean):voiddefaultButton | свойство |
defaultButton:IFlexDisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Элемент управления Button, определенный в качестве кнопки по умолчанию для контейнера. При фокусе, установленном на элементах управления в контейнере, нажатие клавиши Enter эквивалентно нажатию элемента управления Button
Реализация
public function get defaultButton():IFlexDisplayObject public function set defaultButton(value:IFlexDisplayObject):voiddoubleClickEnabled | свойство |
doubleClickEnabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, получает ли объект события doubleClick. Значение по умолчанию — false: по умолчанию экземпляр InteractiveObject не получает событий doubleClick. Если свойству doubleClickEnabled задано значение true, экземпляр получает события doubleClick в своих границах. Свойство mouseEnabled экземпляра InteractiveObject должно иметь значение true, чтобы объект мог получать события doubleClick.
При настройке данного свойства события не отправляются. Чтобы добавить прослушиватель события doubleClick, необходимо использовать метод addEventListener().
Реализация
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voiddropTarget | свойство |
dropTarget:DisplayObject [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен.
Реализация
public function get dropTarget():DisplayObjectfocusManager | свойство |
focusManager:IFocusManager [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. Каждый всплывающий элемент имеет собственный цикл фокуса и, соответственно, собственный экземпляр FocusManager. С помощью этого метода можно удостовериться, что выполняется обращение к верному экземпляру.
Реализация
public function get focusManager():IFocusManagerfocusRect | свойство |
focusRect:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. Может принимать одно из трех значений true, false или null. Значения true и false дают ожидаемые результаты, определяя, будет ли появляться прямоугольник в фокусе. Значение null указывает, что данный объект подчиняется свойству stageFocusRect рабочей области.
Реализация
public function get focusRect():Object public function set focusRect(value:Object):voidgraphics | свойство |
graphics:Graphics [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.
Реализация
public function get graphics():GraphicshitArea | свойство |
hitArea:Sprite| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет другой спрайт в качестве области щелчка для спрайта. Если свойство hitArea не существует или ему задано значение null или undefined, то в качестве области щелчка используется сам спрайт. Значение свойства hitArea может быть ссылкой на объект Sprite.
Свойство hitArea можно изменить в любой момент; модифицированный спрайт немедленно начинает использовать новое поведение области щелчка. Спрайт, настроенный в качестве области щелчка не обязательно должен быть видимым; его графическая форма, оставаясь невидимой, все равно обнаруживается в качестве области щелчка.
Примечание. Необходимо задать значение false свойству mouseEnabled спрайта, настроенного в качестве области щелчка. В противном случае кнопка спрайта может не работать, так как спрайт, настроенный в качестве области щелчка, получает события пользовательского ввода вместо кнопки спрайта.
Реализация
public function get hitArea():Sprite public function set hitArea(value:Sprite):voidhorizontalScrollPosition | свойство |
horizontalScrollPosition:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Текущая позиция горизонтальной полосы прокрутки. Она совпадает по размеру с расстоянием в пикселях между левой границей прокручиваемой области и крайней левой частью видимой в настоящий момент области.
Реализация
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidmouseChildren | свойство |
mouseChildren:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. Если объект поддерживает эти события, пользователь может взаимодействовать с ним с помощью мыши или другого устройства ввода. Значение по умолчанию — true.
Это свойство удобно использовать, когда кнопка создается с помощью экземпляра класса Sprite (а не класса SimpleButton). Когда для создания кнопки используется экземпляр Sprite, при желании можно украсить кнопку с помощью метода addChild(), добавив дополнительные экземпляры Sprite. Этот процесс может вызывать непредвиденное поведение событий мыши, так как целевым объектом события мыши вместо родительского экземпляра могут стать экземпляры Sprite, добавленные в качестве дочерних. Чтобы родительский экземпляр гарантированно был целевым объектом событий мыши, можно задать его свойству mouseChildren значение false.
При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener().
Реализация
public function get mouseChildren():Boolean public function set mouseChildren(value:Boolean):voidmouseEnabled | свойство |
mouseEnabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. Значение по умолчанию — true, которое указывает, что по умолчанию любой экземпляр InteractiveObject в списке отображения получает события мыши или других устройств пользовательского ввода. Если свойство mouseEnabled имеет значение false, экземпляр не получает событий мыши (или события другого пользовательского ввода, например клавиатуры). Эта настройка не затрагивает дочерние элементы данного экземпляра в списке отображения. Чтобы изменить поведение mouseEnabled для всех дочерних элементов объекта в списке отображения, используйте flash.display.DisplayObjectContainer.mouseChildren.
При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener().
Реализация
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidnumChildren | свойство |
soundTransform | свойство |
soundTransform:flash.media:SoundTransform| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Управляет звуком в данном спрайте.
Примечание. Это свойство не затрагивает содержимое HTML объекта HTMLControl (в Adobe AIR).
Реализация
public function get soundTransform():flash.media:SoundTransform public function set soundTransform(value:flash.media:SoundTransform):voidtabChildren | свойство |
tabChildren:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab.
Примечание. Это свойство не следует использовать с Flex. Вместо этого следует использовать свойство UIComponent.hasFocusableChildren.
Реализация
public function get tabChildren():Boolean public function set tabChildren(value:Boolean):voidСвязанные элементы API
tabEnabled | свойство |
tabEnabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. Если объект включен в последовательность перехода с помощью клавиши Tab, значение — true; в противном случае — false. По умолчанию используется значение false, за исключением следующих случаев.
- Для объекта SimpleButton используется значение
true. - Для объекта TextField с
type = "input"используется значениеtrue. - Для объекта Sprite или MovieClip с
buttonMode = trueиспользуется значениеtrue.
Реализация
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | свойство |
tabIndex:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает последовательность перехода между объектами в SWF-файле. Свойство tabIndex по умолчанию имеет значение -1, то есть для объекта не задан индекс при переходе с помощью клавиши Tab.
Если какой-либо отображаемый в данный момент объект в SWF-файле имеет свойство tabIndex, автоматическая последовательность перехода с помощью клавиши Tab отключается, и последовательность перехода вычисляется по свойствам tabIndex объектов SWF-файла. Пользовательская последовательность перехода с помощью клавиши Tab включает только объекты, имеющие свойство tabIndex.
Свойство tabIndex может быть выражено неотрицательным числом. Последовательность перехода определяется в соответствии со свойствами tabIndex объектов в восходящем порядке. Объект со значением 1 свойства tabIndex предшествует объекту со значением 2 свойства tabIndex. Нельзя использовать одинаковое значение tabIndex для нескольких объектов.
Пользовательская последовательность перехода с помощью клавиши Tab, определяемая свойством tabIndex, является линейной. Это значит, что иерархические отношения объектов в SWF-файле не учитываются. Все объекты в SWF-файле со свойствами tabIndex помещаются в последовательность перехода с помощью клавиши Tab, которая определяется последовательностью значений tabIndex.
Примечание. Чтобы установить порядок табуляции для экземпляров TLFTextField, передайте дочерний объект экранного объекта TLFTextField как InteractiveObject, затем задайте свойство tabIndex. Например:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Чтобы изменить порядок табуляции по умолчанию на обратный для трех экземпляров объекта TLFTextField (
tlfInstance1, tlfInstance2 и tlfInstance3), используйте:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Реализация
public function get tabIndex():int public function set tabIndex(value:int):voidtextSnapshot | свойство |
textSnapshot:flash.text:TextSnapshot [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
Реализация
public function get textSnapshot():flash.text:TextSnapshotuseHandCursor | свойство |
useHandCursor:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. Свойство useHandCursor по умолчанию имеет значение true. Когда useHandCursor имеет значение true, курсор в виде руки, используемый для кнопок, появляется при наведении указателя на спрайт-кнопку. Если же useHandCursor имеет значение false, используется указатель «стрелка».
Свойство useHandCursor можно изменить в любое время; модифицированный спрайт немедленно принимает новый вид курсора.
Примечание. Если во Flex или Flash Builder спрайт имеет дочерние спрайты, может потребоваться задание для свойства mouseChildren значения false. Например, если необходимо, чтобы курсор в виде руки отображался над элементом управления Flex <mx:Label>, задайте для свойств useHandCursor и buttonMode значение true, а для свойства mouseChildren значение false.
Реализация
public function get useHandCursor():Boolean public function set useHandCursor(value:Boolean):voidverticalScrollPosition | свойство |
verticalScrollPosition:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Текущая позиция вертикальной полосы прокрутки. Она совпадает по размеру с расстоянием в пикселях между верхней границей прокручиваемой области и крайней верхней частью видимой в настоящий момент области.
Реализация
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidviewMetrics | свойство |
viewMetrics:EdgeMetrics [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает объект, имеющий четыре свойства: left, top, right и bottom. Значение каждого свойства равно толщине хрома (визуальные элементы) вокруг границы контейнера.
Хром включает толщину границ. Если свойство horizontalScrollPolicy или verticalScrollPolicy имеют значение ScrollPolicy.ON, хром также включает толщину соответствующей полосы прокрутки. Если стратегия прокрутки имеет значение ScrollPolicy.AUTO, измерение хрома не включает толщину полосы прокрутки даже в случае ее отображения.
Подклассы контейнера должны переопределять этот метод так, чтобы они могли учитывать другой хром при расположении нижестоящих элементов контейнера. Например, свойствоviewMetrics для класса Panel должно возвращать объект, свойство top которого включает толщину строки заголовка контейнера Panel.
Реализация
public function get viewMetrics():EdgeMetricsaddChild | () | метод |
public function addChild(child:DisplayObject):DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. Дочерний элемент добавляется перед (сверху) всеми остальными дочерними элементами в данном экземпляре DisplayObjectContainer. (Чтобы добавить дочерний элемент в конкретную позицию в индексе, используйте метод addChildAt().)
При добавлении дочернего объекта, уже имеющего отличный от других контейнер объекта отображения в качестве родительского элемента, объект удаляется из списка дочерних элементов другого контейнера объекта отображения.
Примечание. Команда stage.addChild() может вызвать проблемы с опубликованным SWF-файлом, включая проблемы безопасности и конфликты с другими загруженными SWF-файлами. В экземпляре среды выполнения Flash есть только одна рабочая область независимо от числа загружаемых SWF-файлов. Так, как правило, объекты совсем не следует добавлять в рабочую область напрямую. Рабочая область должна содержать только корневой объект. Создайте объект DisplayObjectContainer, который будет содержать все элементы списка отображения. Затем, при необходимости, добавьте этот экземпляр DisplayObjectContainer в рабочую область.
Параметры
child:DisplayObject — Экземпляр DisplayObject для добавления в качестве нижестоящего элемента экземпляра DisplayObjectContainer.
|
DisplayObject — Экземпляр DisplayObject, передаваемый в параметр child.
|
addChildAt | () | метод |
public function addChildAt(child:DisplayObject, index:int):DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. Дочерний элемент добавляется к указанной позиции индекса. Индекс 0 представляет собой заднюю (нижнюю) часть списка отображения для объекта DisplayObjectContainer.
Так, в следующем примере представлено три объекта отображения с метками а, b и c в позициях индекса 0, 1 и 2 соответственно.
При добавлении дочернего объекта, уже имеющего отличный от других контейнер объекта отображения в качестве родительского элемента, объект удаляется из списка дочерних элементов другого контейнера объекта отображения.
Параметры
child:DisplayObject — Экземпляр DisplayObject для добавления в качестве нижестоящего элемента экземпляра DisplayObjectContainer.
| |
index:int — Позиция индекса для добавления нижестоящего элемента. При указании занятой в настоящее время позиции индекса существующий в данной позиции дочерний объект и все вышестоящие позиции перемещаются по списку на одну позицию вверх.
|
DisplayObject — Экземпляр DisplayObject, передаваемый в параметр child.
|
areInaccessibleObjectsUnderPoint | () | метод |
public function areInaccessibleObjectsUnderPoint(point:Point):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. По умолчанию содержимое из одного домена не имеет доступ к объектам из другого домена, если это не разрешено посредством вызова метода Security.allowDomain(). Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность.
Параметр point находится в координатной плоскости рабочей области, которая может отличаться от координатной плоскости контейнера объектов отображения (если это не рабочая область). Можно использовать методы globalToLocal() и localToGlobal() для преобразования точек между этими координатными плоскостями.
Параметры
point:Point — Точка, под которой следует выполнить поиск.
|
Boolean — Значение true, если точка содержит дочерние экранные объекты с ограничениями по безопасности.
|
contains | () | метод |
public function contains(child:DisplayObject):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. Область поиска охватывает весь список отображения, включая данный экземпляр DisplayObjectContainer. Нижестоящие элементы второго, третьего и последующих уровней возвращают значение true.
Параметры
child:DisplayObject — Тестируемый нижестоящий объект.
|
Boolean — Значение true, если объект child является дочерним элементом объекта DisplayObjectContainer или самого контейнера, в противном случае значение false.
|
getChildAt | () | метод |
public function getChildAt(index:int):DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
Параметры
index:int — Позиция индекса дочернего объекта.
|
DisplayObject — Дочерний экранный объект в заданной позиции индекса.
|
getChildByName | () | метод |
public function getChildByName(name:String):DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает экземпляр дочернего экранного объекта с заданным именем. Если заданное имя соответствует нескольким дочерним экранным объектам, метод возвращает первый из списка.
Метод getChildAt() работает быстрее метода getChildByName(). Метод getChildAt() обращается к дочернему элементу из кэшированного массива, а методу getChildByName() приходится искать дочерний элемент через связанный список.
Параметры
name:String — Имя возвращаемого нижестоящего элемента.
|
DisplayObject — Дочерний экранный объект с заданным именем.
|
getChildIndex | () | метод |
public function getChildIndex(child:DisplayObject):int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает позицию индекса для экземпляра DisplayObject child.
Параметры
child:DisplayObject — Искомый экземпляр DisplayObject.
|
int — Позиция индекса для искомого дочернего экранного объекта.
|
getObjectsUnderPoint | () | метод |
public function getObjectsUnderPoint(point:Point):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. Дочерние объекты, недоступные по соображениям безопасности, опускаются из возвращенного массива. Чтобы определить, затрагивается ли возвращенный массив ограничением с целью обеспечения безопасности, вызовите метод areInaccessibleObjectsUnderPoint().
Параметр point находится в координатной плоскости рабочей области, которая может отличаться от координатной плоскости контейнера объектов отображения (если это не рабочая область). Можно использовать методы globalToLocal() и localToGlobal() для преобразования точек между этими координатными плоскостями.
Параметры
point:Point — Точка, под которой следует выполнить поиск.
|
Array — Массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
|
removeChild | () | метод |
public function removeChild(child:DisplayObject):DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. Свойство parent удаленного дочернего элемента получает значение null, а сам объект утилизуется в ходе «сборки мусора», если отсутствуют другие ссылки на дочерний элемент. Позиции индекса экранных объектов, расположенных над дочерним элементом в DisplayObjectContainer уменьшаются на 1.
Сборщик мусора перераспределяет неиспользуемый объем памяти. Когда на переменную или объект больше нет ссылок или он хранится в другом месте, сборщик мусора очищает и утилизирует память, которую он занимал, при условии отсутствия ссылок
Параметры
child:DisplayObject — Удаляемый экземпляр DisplayObject.
|
DisplayObject — Экземпляр DisplayObject, передаваемый в параметр child.
|
removeChildAt | () | метод |
public function removeChildAt(index:int):DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет дочерний DisplayObject из заданной позиции index в списке дочерних объектов DisplayObjectContainer. Свойство parent удаленного дочернего элемента получает значение null, а сам объект очищается, если нет других ссылок на дочерние элементы. Позиции индекса экранных объектов, расположенных над дочерним элементом в DisplayObjectContainer уменьшаются на 1.
Сборщик мусора перераспределяет неиспользуемый объем памяти. Когда на переменную или объект больше нет ссылок или он хранится в другом месте, сборщик мусора очищает и утилизирует память, которую он занимал, при условии отсутствия ссылок
Параметры
index:int — Удаляемый индекс нижестоящего элемента DisplayObject.
|
DisplayObject — Удаленный экземпляр DisplayObject.
|
setChildIndex | () | метод |
public function setChildIndex(child:DisplayObject, index:int):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. Это отражается на иерархическом представлении дочерних объектов. Так, в следующем примере показано три разных объекта с именами a, b и c в позициях индекса 0, 1 и 2 соответственно.
Когда используется метод setChildIndex() и указывается уже занятая позиция индекса, меняются только позиции между прежней и новой позицией экранного объекта. Все остальные остаются без изменения. Если дочерний объект перемещается на более НИЗКУЮ позицию, позиции всех дочерних объектов между этими позициями станут на 1 ВЫШЕ. Если дочерний объект перемещается на более ВЫСОКУЮ позицию, позиции всех дочерних объектов между этими позициями станут на 1 НИЖЕ. Например, если контейнер экранных объектов из предыдущего примера имеет имя container, можно поменять позициями экранные объекты с именами a и b, вызвав следующий код:
container.setChildIndex(container.getChildAt(1), 0);
В результате этого объекты выстраиваются следующим образом:
Параметры
child:DisplayObject — Дочерний экземпляр DisplayObject, для которого нужно изменить номер индекса.
| |
index:int — Полученный в результате номер индекса для дочернего экранного объекта child.
|
startDrag | () | метод |
public function startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). Спрайт можно перетаскивать до явной остановки через вызов метода Sprite.stopDrag() или до того, как можно будет перетаскивать другой спрайт. Одновременно можно перетаскивать только один спрайт.
Трехмерные объекты отображения управляются указателем, а метод Sprite.startDrag() позволяет перемещать объект в трехмерной плоскости, определенной экранным объектом. Или, если экранный объект является двумерным объектом и дочерним элементом трехмерного объекта, двумерный объект перемещается в трехмерной плоскости, определенной трехмерным родительским объектом.
Параметры
lockCenter:Boolean (default = false)true) или в точке спрайта, на которой впервые щелкнул мышью пользователь (false).
| |
bounds:Rectangle (default = null) |
stopDrag | () | метод |
public function stopDrag():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Завершает метод startDrag(). Спрайт, созданный перетаскиваемым с помощью метода startDrag(), остается таковым до добавления метода stopDrag() или до того, как другой спрайт станет перетаскиваемым. Одновременно можно перетаскивать только один спрайт.
swapChildren | () | метод |
public function swapChildren(child1:DisplayObject, child2:DisplayObject):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. Все остальные дочерние объекты в контейнере экранных объектов остаются на прежних позициях.
Параметры
child1:DisplayObject — Первый дочерний объект.
| |
child2:DisplayObject — Второй дочерний объект.
|
swapChildrenAt | () | метод |
public function swapChildrenAt(index1:int, index2:int):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних объектов. Все остальные дочерние объекты в контейнере экранных объектов остаются на прежних позициях.
Параметры
index1:int — Позиция индекса первого дочернего объекта.
| |
index2:int — Позиция индекса второго дочернего объекта.
|
Tue Jun 12 2018, 11:34 AM Z