IGraphicElement - Adobe ActionScript® 3 (AS3 Flex)

Пакет	spark.core
Интерфейс	public interface IGraphicElement extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher
Средство реализации	GraphicElement

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

IGraphicElement реализуется объектами IVisualElements, что позволяет воспользоваться преимуществами управления DisplayObject вышестоящего IGraphicElementContainer.

Одним из типичных вариантов применения является совместное использование DisplayObject. Класс Group, реализующий IGraphicElementContainer, формирует последовательности, состоящие из соответствующих нижестоящих элементов IGraphicElement, которые совместно используют и отображают один и тот же DisplayObject. DisplayObject создается первым элементом в последовательности.

Другой вариант использования заключается в том, что элемент не является производным от DisplayObject, а вместо этого поддерживает, создает и/или удаляет собственный DisplayObject. IGraphicElementContainer вызывает элемент для создания DisplayObject, добавляет DisplayObject в качестве соответствующего нижестоящего элемента в правильной позиции индекса и управляет его удалением.

Обычно расширяется класс GraphicElement вместо непосредственной реализации интерфейса IGraphciElement. Класс GraphicElement уже предоставляет большую часть необходимых функциональных возможностей.

Связанные элементы API

spark.core.IGraphicElementContainer

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		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
		canShareWithNext(element:IGraphicElement):Boolean Возвращает значение true, если этот IGraphicElement совместим со следующим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.	IGraphicElement
		canShareWithPrevious(element:IGraphicElement):Boolean Возвращает значение true, если этот IGraphicElement совместим с предыдущим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.	IGraphicElement
		createDisplayObject():DisplayObject Создает новый DisplayObject, в котором отображается этот IGraphicElement.	IGraphicElement
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	IEventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Возвращает координату Х границ элемента для указанного размера элемента.	ILayoutElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Возвращает координату Y границ элемента при указанном размере элемента.	ILayoutElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает высоту макета элемента.	ILayoutElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает ширину макета элемента.	ILayoutElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Возвращает координату Х, используемую элементом для отображения на экране.	ILayoutElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Возвращает координату Y, используемую элементом для отображения на экране.	ILayoutElement
		getLayoutMatrix():Matrix Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня.	ILayoutElement
		getLayoutMatrix3D():Matrix3D Возвращает преобразование макета Matrix3D для этого элемента.	ILayoutElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает максимальную высоту элемента.	ILayoutElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает максимальную ширину элемента.	ILayoutElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает минимальную высоту элемента.	ILayoutElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает минимальную ширину элемента.	ILayoutElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает предпочтительную высоту элемента.	ILayoutElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает предпочтительную ширину элемента.	ILayoutElement
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	IEventDispatcher
		invalidateLayoutDirection():void Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection.	ILayoutDirectionElement
		parentChanged(parent:IGraphicElementContainer):void Вызывается с помощью IGraphicElementContainer при добавлении или удалении IGraphicElement из компонента хоста.	IGraphicElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	IEventDispatcher
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void Устанавливает координаты, используемые элементом для отображения на экране.	ILayoutElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Устанавливает размер макета элемента.	ILayoutElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня.	ILayoutElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня.	ILayoutElement
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean Определяет, может ли этот элемент отображаться в объекте 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
		validateDisplayList():void Вызывается IGraphicElementContainer для повторного отображения этого элемента в его свойстве displayObject.	IGraphicElement
		validateProperties():void Вызывается IGraphicElementContainer для проверки свойств этого элемента.	IGraphicElement
		validateSize():void Вызывается IGraphicElementContainer для проверки правильности размера этого элемента.	IGraphicElement
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом 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

createDisplayObject
validateDisplayList
displayObjectSharingMode

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
setSharedDisplayObject

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

canShareWithNext
setSharedDisplayObject

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

displayObject
spark.core.IGraphicElementContainer.invalidateGraphicElementSharing
spark.core.IGraphicElementContainer.discardDisplayObject

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

canShareWithPrevious
canShareWithNext
spark.core.IGraphicElementContainer.invalidateGraphicElementSharing

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

displayObject
validateProperties
validateSize

validateProperties

()

метод

public function validateProperties():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Вызывается IGraphicElementContainer для проверки свойств этого элемента.

Для вызова этого метода необходимо обратиться к IGraphicElementContainer путем вызова метода invalidateGraphicElementProperties().

Этот метод может вызываться даже в том случае, если данный элемент не обратился к IGraphicElementContainer.

Связанные элементы API

validateSize
validateDisplayList

validateSize

()

метод

public function validateSize():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Вызывается IGraphicElementContainer для проверки правильности размера этого элемента.

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

Для вызова этого метода необходимо обратиться к IGraphicElementContainer путем вызова метода invalidateGraphicElementSize().

Этот метод может вызываться даже в том случае, если данный элемент не обратился к IGraphicElementContainer.

Связанные элементы API

validateProperties
validateDisplayList

Юридическая информация | Политика конфиденциальности онлайн

IGraphicElement - AS3 Flex

Классы x

displayObject

displayObjectSharingMode

canShareWithNext

canShareWithPrevious

createDisplayObject

parentChanged

setSharedDisplayObject

validateDisplayList

validateProperties

validateSize