Пакет | spark.core |
Интерфейс | public interface IGraphicElement extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
Средство реализации | GraphicElement |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
IGraphicElementContainer
.
Одним из типичных вариантов применения является совместное использование DisplayObject. Класс Group, реализующий IGraphicElementContainer
, формирует последовательности, состоящие из соответствующих нижестоящих элементов IGraphicElement, которые совместно используют и отображают один и тот же DisplayObject. DisplayObject создается первым элементом в последовательности.
Другой вариант использования заключается в том, что элемент не является производным от DisplayObject, а вместо этого поддерживает, создает и/или удаляет собственный DisplayObject. IGraphicElementContainer
вызывает элемент для создания DisplayObject, добавляет DisplayObject в качестве соответствующего нижестоящего элемента в правильной позиции индекса и управляет его удалением.
Обычно расширяется класс GraphicElement вместо непосредственной реализации интерфейса IGraphciElement. Класс GraphicElement уже предоставляет большую часть необходимых функциональных возможностей.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | IVisualElement | ||
baseline : Object
Вертикальное смещение в пикселях от целевого объекта привязки к положению базовой линии элемента управления. | ILayoutElement | ||
baselinePosition : Number [только для чтения]
Координата Y базовой линии первой строки текста компонента. | ILayoutElement | ||
bottom : Object
Вертикальное смещение в пикселях от нижнего края компонента к нижнему краю целевого объекта привязки. | ILayoutElement | ||
depth : Number
Определяет порядок отображения элементов внутри контейнеров. | IVisualElement | ||
designLayer : DesignLayer
Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом. | IVisualElement | ||
displayObject : DisplayObject [только для чтения]
Совместно используемый DisplayObject, в котором отображается этот IGraphicElement. | IGraphicElement | ||
displayObjectSharingMode : String
Указывает связь между этим IGraphicElement и его экранными объектами. | IGraphicElement | ||
hasLayoutMatrix3D : Boolean [только для чтения]
Содержит true, если элемент имеет трехмерную матрицу. | ILayoutElement | ||
height : Number
Указывает высоту экранного объекта в пикселях. | IVisualElement | ||
horizontalCenter : Object
Горизонтальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки. | ILayoutElement | ||
includeInLayout : Boolean
Указывает, включается ли этот компонент в макет вышестоящего контейнера. | ILayoutElement | ||
is3D : Boolean [только для чтения]
Содержит true, если элемент представлен в трехмерной графике. | IVisualElement | ||
layoutDirection : String
Определяет требуемое направление макета для элемента: один из LayoutDirection.LTR (слева направо), LayoutDirection.RTL (справа налево) или null (наследование). | ILayoutDirectionElement | ||
left : Object
Горизонтальное смещение в пикселях от левого края компонента к левому краю целевого объекта привязки. | ILayoutElement | ||
owner : DisplayObjectContainer
Владелец этого объекта IVisualElement. | IVisualElement | ||
parent : DisplayObjectContainer [только для чтения]
Вышестоящий контейнер или компонент данного компонента. | IVisualElement | ||
percentHeight : Number
Указывает высоту компонента в виде процента от размера вышестоящего элемента. | ILayoutElement | ||
percentWidth : Number
Указывает ширину компонента в виде процента от размера вышестоящего элемента. | ILayoutElement | ||
postLayoutTransformOffsets : mx.geom:TransformOffsets
Определяет ряд настроек, применяемых для преобразования объекта способом, не отображающимся в макете вышестоящего элемента объекта. | IVisualElement | ||
right : Object
Горизонтальное смещение в пикселях от правого края компонента к правому краю целевого объекта привязки. | ILayoutElement | ||
top : Object
Вертикальное смещение в пикселях от верхнего края компонента к верхнему краю целевого объекта привязки. | ILayoutElement | ||
verticalCenter : Object
Вертикальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки. | ILayoutElement | ||
visible : Boolean
Управляет видимостью данного визуального элемента. | IVisualElement | ||
width : Number
Указывает ширину экранного объекта в пикселях. | IVisualElement | ||
x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IVisualElement | ||
y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IVisualElement |
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | ||
Возвращает значение true, если этот IGraphicElement совместим со следующим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом. | IGraphicElement | ||
Возвращает значение true, если этот IGraphicElement совместим с предыдущим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом. | IGraphicElement | ||
Создает новый DisplayObject, в котором отображается этот IGraphicElement. | IGraphicElement | ||
Посылает событие в поток событий. | IEventDispatcher | ||
Возвращает координату Х границ элемента для указанного размера элемента. | ILayoutElement | ||
Возвращает координату Y границ элемента при указанном размере элемента. | ILayoutElement | ||
Возвращает высоту макета элемента. | ILayoutElement | ||
Возвращает ширину макета элемента. | ILayoutElement | ||
Возвращает координату Х, используемую элементом для отображения на экране. | ILayoutElement | ||
Возвращает координату Y, используемую элементом для отображения на экране. | ILayoutElement | ||
Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня. | ILayoutElement | ||
Возвращает преобразование макета Matrix3D для этого элемента. | ILayoutElement | ||
Возвращает максимальную высоту элемента. | ILayoutElement | ||
Возвращает максимальную ширину элемента. | ILayoutElement | ||
Возвращает минимальную высоту элемента. | ILayoutElement | ||
Возвращает минимальную ширину элемента. | ILayoutElement | ||
Возвращает предпочтительную высоту элемента. | ILayoutElement | ||
Возвращает предпочтительную ширину элемента. | ILayoutElement | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | ||
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. | ILayoutDirectionElement | ||
Вызывается с помощью IGraphicElementContainer при добавлении или удалении IGraphicElement из компонента хоста. | IGraphicElement | ||
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | ||
Устанавливает координаты, используемые элементом для отображения на экране. | ILayoutElement | ||
Устанавливает размер макета элемента. | ILayoutElement | ||
Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | ILayoutElement | ||
Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | ILayoutElement | ||
Определяет, может ли этот элемент отображаться в объекте sharedDisplayObject последовательности. | IGraphicElement | ||
transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента. | ILayoutElement | ||
Вызывается IGraphicElementContainer для повторного отображения этого элемента в его свойстве displayObject. | IGraphicElement | ||
Вызывается IGraphicElementContainer для проверки свойств этого элемента. | IGraphicElement | ||
Вызывается IGraphicElementContainer для проверки правильности размера этого элемента. | IGraphicElement | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher |
displayObject | свойство |
displayObject:DisplayObject
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Совместно используемый DisplayObject, в котором отображается этот IGraphicElement.
DisplayObject создается средствами реализации не здесь, а в методеcreateDisplayObject()
.
Реализация
public function get displayObject():DisplayObject
Связанные элементы API
displayObjectSharingMode | свойство |
displayObjectSharingMode:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Указывает связь между этим IGraphicElement и его экранными объектами. IGraphicElementContainer
управляет этим свойством, а значения являются одним из классов enum DisplayObjectSharingMode.
- Значение
DisplayObjectSharingMode.OWNS_UNSHARED_OBJECT
указывает, что IGraphicElement принадлежит исключительно DisplayObject, соответствующий его свойствуdisplayObject
. - Значение
DisplayObjectSharingMode.OWNS_SHARED_OBJECT
указывает, что IGraphicElement принадлежит DisplayObject, соответствующий его свойствуdisplayObject
, но другой IGraphicElements также использует/рисует на этом экранном объекте. В зависимости от конкретной реализации IGraphicElement может выполнять определенное управление экранным объектом. Например, базовый класс GraphicElement очищает преобразование экранного объекта, сбрасывает его свойства видимости, альфа-канала и т. д. к их значениям по умолчанию, а также очищают графику при каждом вызовеvalidateDisplayList()
. - Значение
DisplayObjectSharingMode.USES_SHARED_OBJECT
указывает, что IGraphicElement рисует в DisplayObject, соответствующем его свойствуdisplayObject
. Существует один или более IGraphicElements, рисующий в один и тот же displayObject, и для первого рисующего элемента устанавливается режимDisplayObjectMode.OWNS_SHARED_OBJECT
Реализация
public function get displayObjectSharingMode():String
public function set displayObjectSharingMode(value:String):void
canShareWithNext | () | метод |
public function canShareWithNext(element:IGraphicElement):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает значение true
, если этот IGraphicElement совместим со следующим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.
Параметры
element:IGraphicElement — Элемент, который следует за этим элементом в последовательности.
|
Boolean — Возвращает true , если этот элемент совместим с предыдущим элементом в последовательности.
|
Связанные элементы API
canShareWithPrevious | () | метод |
public function canShareWithPrevious(element:IGraphicElement):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает значение true
, если этот IGraphicElement совместим с предыдущим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.
В некоторых случаях этот элемент можно передать в IGraphicElementContainer
в вызове метода setSharedDisplayObject()
. В этих случаях данный метод не вызывается.
Параметры
element:IGraphicElement — Элемент, который предшествует этому элементу в последовательности.
|
Boolean — Возвращает true , если этот элемент совместим с предыдущим элементом в последовательности.
|
Связанные элементы API
createDisplayObject | () | метод |
public function createDisplayObject():DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Создает новый DisplayObject, в котором отображается этот IGraphicElement.
Последующие вызовы получателя свойства displayObject
должны возвращать тот же самый экранный объект.
После создания DisplayObject вышестоящий элемент IGraphicElementContainer
передает экранные объекты в остальные элементы последовательности.
IGraphicElementContainer
обеспечивает вызов метода только при необходимости.
Если требуется участие элемента в совместном использовании DisplayObject, новый DisplayObject должен реализовать интерфейс IShareableDisplayObject. Этот интерфейс применяется IGraphicElementContainer
для управления удалением и повторным отображением последовательности графических элементов и, как правило, не используется разработчиками непосредственно.
Для повторной оценки общедоступных последовательностей вызывается метод invalidateGraphicElementSharing()
в IGraphicElementContainer
.
Чтобы IGraphicElementContainer
принудительно удалил текущий DisplayObject элемента из списка отображения и повторно рассчитал совместное использование экранного объекта, вызовите метод discardDisplayObject()
в IGraphicElementContainer
.
DisplayObject — Созданный экранный объект..
|
Связанные элементы API
parentChanged | () | метод |
public function parentChanged(parent:IGraphicElementContainer):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается с помощью IGraphicElementContainer
при добавлении или удалении IGraphicElement из компонента хоста.
Этот метод обычно не вызывается.
Параметры
parent:IGraphicElementContainer — IGraphicElementContainer этого IGraphicElement .
|
setSharedDisplayObject | () | метод |
public function setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, может ли этот элемент отображаться в объекте sharedDisplayObject
последовательности.
Как правило, средства реализации возвращают значение true
, если этот IGraphicElement может выполнять кумулятивное отображение в свойстве graphics
совместно используемого объекта DisplayObject. Во всех случаях, когда этот IGraphicElement должен устанавливать свойства для DisplayObject, не применимого к остальным элементам в последовательности, этот метод возвращает значение false
. Примерами таких свойств могут служить свойства rotation, scale, transform, mask, alpha, filters, color transform, 3D и layer.
Если этот метод возвращает значение true
, последующие вызовы получателя свойства displayObject
должны возвращать аналогичный экранный объект.
В некоторых случаях свойство sharedDisplayObject
может являться непосредственно IGraphicElementContainer
. В других случаях DisplayObject создается первым элементом в последовательности.
Если этот IGraphicElement должен восстановить свою последовательность, он обращается к IGraphicElementContainer
путем вызова соответствующего метода invalidateGraphicElementSharing()
.
Параметры
sharedDisplayObject:DisplayObject — Общедоступный DisplayObject.
|
Boolean — Возвращает значение true , если этот IGraphicElement может отображаться в совместно используемом DisplayObject последовательности.
|
Связанные элементы API
validateDisplayList | () | метод |
public function validateDisplayList():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается IGraphicElementContainer
для повторного отображения этого элемента в его свойстве displayObject
.
Если элемент является первым элементом в последовательности (для displayObjectSharingMode
установлено значение DisplayObjectSharingMode.OWNS_SHARED_OBJECT
), графический элемент displayObject
очищается, а затем выполняется его настройка, требуемая для отображения остальных элементов.
Элемент всегда должен перерисовываться, даже если он не изменился со времени последнего вызова метода validateDisplayList()
. Вышестоящий объект IGraphicElementContainer
изменит всю последовательность, если любой из ее элементов требуется изменить.
Для вызова этого метода необходимо обратиться к IGraphicElementContainer
путем вызова метода invalidateGraphicElementSize()
.
Этот метод может вызываться даже в том случае, если данный элемент не обратился к IGraphicElementContainer
.
Связанные элементы API
validateProperties | () | метод |
public function validateProperties():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается IGraphicElementContainer
для проверки свойств этого элемента.
Для вызова этого метода необходимо обратиться к IGraphicElementContainer
путем вызова метода invalidateGraphicElementProperties()
.
Этот метод может вызываться даже в том случае, если данный элемент не обратился к IGraphicElementContainer
.
Связанные элементы API
validateSize | () | метод |
public function validateSize():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается IGraphicElementContainer
для проверки правильности размера этого элемента.
Если размер элемента изменяется и может повлиять на макет IGraphicElementContainer
, средство реализации должно аннулировать размер вышестоящего узла и список отображения.
Для вызова этого метода необходимо обратиться к IGraphicElementContainer
путем вызова метода invalidateGraphicElementSize()
.
Этот метод может вызываться даже в том случае, если данный элемент не обратился к IGraphicElementContainer
.
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z