| Пакет | 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):voidcanShareWithNext | () | метод |
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