GraphicElement  - AS3 Flex

Уровень прозрачности графического элемента. Действительные значения - десятичные значения между 0 (полная прозрачность) и 1 (полная непрозрачность). Например, значение .25 означает 25% непрозрачности элемента.

Указывает, что этот GraphicElement необходимо связать и визуализировать с помощью собственного DisplayObject.

Значением по умолчанию является false.

Вертикальное смещение в пикселях от целевого объекта привязки к положению базовой линии элемента управления.

По умолчанию целевым объектом привязки является верхний край области содержимого контейнера. В макетах с расширенными ограничениями, целевой объект может быть строкой ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате: "anchorTargetName:value". Например, "row1:10".

Координата Y базовой линии первой строки текста компонента.

Значение класса BlendMode, задающее режим наложения.

Значением по умолчанию является auto.

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

Вертикальное смещение в пикселях от нижнего края компонента к нижнему краю целевого объекта привязки.

По умолчанию целевым объектом привязки является область содержимого контейнера. В макетах с расширенными ограничениями, целевой объект может быть строкой ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате: "anchorTargetName:value". Например, "row1:10".

Определяет порядок отображения элементов внутри контейнеров. Элементы в Groups упорядочиваются на основании свойства depth, при этом элементы с самой большой «глубиной» отображаются на заднем плане, а с меньшей – на переднем. Элементы с одинаковой «глубиной» отобразятся в порядке добавления к контейнеру.

Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом.

Если DesignLayer присвоен, в визуальном элементе необходимо учитывать значение видимости и значение альфа-канала вышестоящего слоя в конечном итоге при передаче собственного эффективного значения видимости или значения альфа-канала в резервный DisplayObject (если применимо).

Визуальный элемент должен предусматривать прослушивание уведомлений layerPropertyChange из связанного вышестоящего элемента слоя. При изменении effectiveAlpha или effectiveVisibility слоя элемент должен выполнять вычисление собственного эффективного значения видимости (альфа-канала) и соответственно его применять.

Это свойство не должно устанавливаться непосредственно в MXML.

Свойство designLayer не используется для элемента управления z-порядка, см. depth.

Совместно используемый DisplayObject, в котором отображается этот IGraphicElement.

DisplayObject создается средствами реализации не здесь, а в методеcreateDisplayObject().

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Указывает связь между этим 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

Фактический DisplayObject, имеющийся в GraphicElement. Как правило, он эквивалентен свойству displayObject. Подклассы должны выполнять команды рисования в этом свойстве вместо displayObject.

Положение отображения элемента по оси x.

Положение отображения элемента по оси y.

Число, указывающее явную высоту компонента в пикселях в виде координат компонента.

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

Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

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

Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

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

Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

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

Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях.

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

Число, указывающее явную ширину компонента в пикселях в виде координат компонента.

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

Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с данным графическим элементом. Пакет mx.filters содержит классы, определяющие конкретные фильтры, доступные для использования.

Получатель возвращает копию массива фильтров. Значение свойств фильтров может быть изменено только посредством установщика.

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

Возвращает значение true, если GraphicElement имеет какое-либо свойство transform, отличное от перемещения (x, y)

Содержит true, если элемент имеет трехмерную матрицу.

hasLayoutMatrix3D используется вместо вызова и исследования значения getLayoutMatrix3D() возвращаемых данных, так как этот метод возвращает действительную матрицу, даже если элемент используется в двухмерной графике.

Высота графического элемента.

Значением по умолчанию является 0.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Горизонтальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки.

Целевым объектом привязки по умолчанию является сам контейнер.

В макетах с расширенными ограничениями целевым объектом привязки может быть столбец ограничения. В этом случае областью содержимого является пространство между предыдущим столбцом (или стороной контейнера) и целевым столбцом.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "constraintColumnId:value". Например, "col1:10".

Идентификатор компонента.

Указывает, включен ли этот элемент в макет вышестоящего элемента.

Значением по умолчанию является true.

Содержит true, если элемент представлен в трехмерной графике. Данный элемент может использоваться в трехмерной графике, поскольку он имеет свойства трехмерного преобразования, последующие смещения при трехмерном преобразовании его макета или и то, и другое.

Определяет требуемое направление макета для элемента: один из LayoutDirection.LTR (слева направо), LayoutDirection.RTL (справа налево) или null (наследование). Это свойство обычно основано на стиле наследования. Если null, то для стиля layoutDirection устанавливается значение undefined. Классы, например GraphicElement, которые реализуют ILayoutDirectionElement, но не поддерживают стили, должны дополнительно поддерживать значение null для этого свойства, т. е. layoutDirection должен быть унаследован из своего вышестоящего элемента.

Содержит всю подробную информацию о реализации преобразования с помощью GraphicElement и о поддержке слоев. В большинстве случаев изменение этого свойства не требуется.

Горизонтальное смещение в пикселях от левого края компонента к левому краю целевого объекта привязки.

По умолчанию целевым объектом привязки является область содержимого контейнера. В макетах с расширенными ограничениями целевым объектом может быть столбец ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "anchorTargetName:value". Например, "col1:10".

Свойство, управляющее тем, будет ли маска свечения отсекать маскируемое содержимое. Это свойство может иметь эффект только в том случае, если к графическому элементу применена маска типа MaskType.LUMINOSITY.

Значением по умолчанию является false.

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

Свойство, управляющее вычислением значения цветов RGB графического элемента, использующего маску свечения. Если true, значение цвета RGB пиксела в исходном содержимом инвертируется и умножается на соответствующую область в маске. Если false, значение цвета RGB пикселя исходного содержимого используется непосредственно.

Значением по умолчанию является false.

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

Вызывающий экранный объект маскируется заданным объектом mask. Если экранный объект отсутствует в списке отображения, он будет добавлен в него в качестве нижестоящего элемента объекта displayObject. Сам объект mask не отображается. Чтобы удалить маску, нужно задать для mask значение null. Для использования в качестве маски другого элемента GraphicElement, встройте GraphicElement в группу или другой контейнер.

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

Определяет, как маска применяется к GraphicElement.

Возможными значениями являются MaskType.CLIP, MaskType.ALPHA и MaskType.LUMINOSITY.

Обрезка по маске

Если маскирование находится в режиме обрезки, обрезочные маски уменьшаются до однобитовых. Это означает, что маска не будет влиять на непрозрачность пикселей в исходном содержимом; она либо оставит значение без изменения (если соответствующий пиксель в маске имеет ненулевое значение альфа-канала), либо сделает его полностью прозрачным (если пиксель маски имеет нулевое значение альфа-канала).

При обрезке по маске для достижения эффекта в исходном содержимом используются только фактические векторы кривых и фигур, а также заливки, определенные маской. обводки и растровые фильтры, определенные в маске, игнорируются. Любая заполненная область в маске считается заполненной и визуализирует исходное содержимое. Тип и параметры заливки не являются релевантными; сплошная, градиентная или растровая заливки выполняют визуализацию основного исходного содержимого независимо от значений альфа-канала заливки маски.

При использовании в обрезочной маске BitmapGraphics обрабатываются как прямоугольники с растровой заливкой. В результате при включении исходного растрового изображения в маску его альфа-канал становится нерелевантным: растровое изображение становится для маски эквивалентным прямоугольнику со сплошной заливкой того же размера.

Альфа-маскирование

В режиме альфа-маскирования непрозрачность каждого пиксела в исходном содержимом умножается на непрозрачность соответствующей области маски. т. е. пиксель исходного содержимого с непрозрачностью 1, маскированный областью с непрозрачностью 0,5, получит в результате непрозрачность 0,5. Исходный пиксель с непрозрачностью 0,8, маскированный областью с непрозрачностью 0,5, получит в результате непрозрачность 0,4.

В общем и целом альфа-маскирование эквивалентно визуализации преобразованной маски и исходного содержимого в отдельное пространство RGBA и умножению альфа-канала содержимого маски на альфа-канал исходного содержимого. Все содержимое маски визуализируется на ее поверхности перед созданием поверхности исходного содержимого. В результате на окончательное комбинированное содержимое влияют все функции FXG, например обводки, растровые фильтры и непрозрачность заливки.

При работе в альфа-режиме альфа-канал любых растровых данных обычно комбинируется в альфа-канале маски, что влияет на конечное визуализированное содержимое. То же самое верно как для BitmapGraphics, так и для векторов и фигур с растровой заливкой.

Маскирование свечения

Маска свечения, иногда называемая «мягкой маской», действует аналогично маске альфа-канала, за исключением того, что как непрозрачность, так и значение цвета RGB пикселя в исходном содержимом умножаются на непрозрачность и значение цвета RGB в соответствующей области в маске.

В общем и целом маскирование свечения эквивалентно визуализации преобразованной маски и исходного содержимого в отдельное пространство RGBA и умножению альфа-канала и значения цвета RGB содержимого маски на альфа-канал и значение цвета RGB исходного содержимого. Все содержимое маски визуализируется на ее поверхности перед созданием поверхности исходного содержимого. В результате на окончательное комбинированное содержимое влияют все функции FXG, например обводки, растровые фильтры и непрозрачность заливки.

Маскирование свечения не принадлежит Flash, но распространено в таких инструментах Adobe Creative Suite, как Adobe Illustrator и Adobe Photoshop. Чтобы выполнить визуальный эффект маски свечения в содержимом, визуализируемом в Flash, графический элемент, определяющий маску свечения, фактически создает экземпляр фильтра затенения, который имитирует визуальный вид маски свечения, как если бы он был выполнен посредством инструментов Adobe Creative Suite.

Объекты, к которым применяются маски свечения, могут установить свойства для управления значением цвета RGB и обрезкой маски. См. атрибуты luminosityInvert и luminosityClip.

Значением по умолчанию является MaskType.CLIP.

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

Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях. Для этого свойства разработчиком компонента установлено значение по умолчанию.

Разработчик компонента использует это свойство для установки верхней границы для высоты компонента.

Если разработчик приложения изменяет значение по умолчанию maxHeight, новое значение сохраняется в explicitMaxHeight. Значение maxHeight по умолчанию не изменяется. В итоге, если в ходе создания макета свойство maxHeight установлено разработчиком приложения явно, значение explicitMaxHeight используется как рекомендованное для компонента максимальное значение высоты. Если maxHeight не установлено пользователем явно, используется значение по умолчанию.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleY влияет на значение true maxHeight относительно его вышестоящего элемента. Некоторые компоненты не имеют теоретической границы по высоте. В таких случаях их значение maxHeight будет установлено на UIComponent.DEFAULT_MAX_HEIGHT.

Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях. Для этого свойства разработчиком компонента установлено значение по умолчанию.

Разработчик компонента использует это свойство для установки верхней границы для ширины компонента.

Если разработчик приложения изменяет значение по умолчанию maxWidth, новое значение сохранятся в explicitMaxWidth. Значение maxWidth по умолчанию не изменяется. В итоге, если в ходе создания макета свойство maxWidth установлено разработчиком приложения явно, значение explicitMaxWidth используется как рекомендованное для компонента максимальное значение ширины. Если maxWidth не установлено пользователем явно, используется значение по умолчанию.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleX влияет на значение true maxWidth относительно его вышестоящего элемента. Некоторые компоненты не имеют теоретической границы по ширине. В таких случаях их значение maxWidth будет установлено на UIComponent.DEFAULT_MAX_WIDTH.

Высота компонента в пикселях по умолчанию. Это значение устанавливается посредством метода measure().

Ширина компонента в пикселях по умолчанию. Это значение устанавливается посредством метода measure().

Размеры границ по умолчанию верхнего левого угла относительно начального положения объекта.

Размеры границ по умолчанию верхнего левого угла относительно начального положения объекта.

Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях. Значение по умолчанию зависит от реализации компонента.

Если разработчик приложения устанавливает значение minHeight, новое значение сохраняется в explicitMinHeight. Значение по умолчанию minHeight не изменяется. В итоге, если в ходе создания макета свойство minHeight явным образом установлено разработчиком приложения, значение explicitMinHeight используется как рекомендованное для компонента минимальное значение высоты. Если свойство minHeight не установлено разработчиком приложения явно, используется значение measuredMinHeight.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleY влияет на значение true minHeight относительно его вышестоящего элемента.

Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. Это значение представлено в координатах компонента в пикселях. Значение по умолчанию зависит от реализации компонента.

Если разработчик приложения устанавливает значение minWidth, новое значение сохраняется в explicitMinWidth. Значение по умолчанию minWidth не изменяется. В итоге, если в ходе создания макета свойство minWidth явным образом установлено разработчиком приложения, значение explicitMinWidth используется как рекомендованное для компонента минимальное значение ширины. Если в ходе создания макета свойство minWidth не установлено разработчиком приложения явно, используется значение measuredMinWidth.

Это значение используется контейнером при вычислении размера и позиции компонента. Оно не используется самим компонентом при определении его размера по умолчанию. Таким образом, это свойство может не оказывать влияния, если оно является нижестоящим для контейнера или контейнеров, которые не применяют коэффициент в этом свойстве. Поскольку значение находится в координатах компонента, свойство scaleX влияет на значение true minWidth относительно его вышестоящего элемента.

True, если элементу требуется эксклюзивный DisplayObject. Обычно разработчики не вызывают этот метод напрямую, а переопределяют его в подклассах, чтобы указать на необходимость эксклюзивного DisplayObject. Обычно подклассу необходим DisplayObject, если требуется установить его свойства. Некоторыми примерами таких свойств DisplayObject являются filters, blendMode, mask, rotation, alpha.

Владелец этого объекта IVisualElement. По умолчанию он является вышестоящим элементом этого объекта IVisualElement. Однако если этот объект IVisualElement является нижестоящим компонентом, отображаемым вышестоящим элементом, например раскрывающимся списком элемента управления ComboBox, владельцем компонента является объект, отображающий этот объект IVisualElement.

Этими свойствами управляет не приложение Flex, а каждый отдельный компонент. Таким образом, при использовании метода PopUpManger.createPopUp() или PopUpManger.addPopUp() для отображения внутреннего компонента необходимо задать в качестве значения свойства owner внутреннего компонента компонент, который обеспечил отображение этого раскрывающегося элемента.

Значением по умолчанию является значение свойства parent.

Вышестоящий контейнер или компонент данного компонента. Только визуальные элементы могут иметь вышестоящее свойство parent. Для невизуальных элементов должно использоваться другое свойство для обращения к объекту, которому они принадлежат. В соответствии с соглашением для невизуальных объектов для ссылки на объект, которому они принадлежат, используется свойство owner.

Указывает высоту компонента в виде процента от размера вышестоящего элемента. Допустимые значения: 0 – 100 Определение свойства height или explicitHeight приводит к установке для этого свойства значения NaN.

Это свойство возвращает числовое значение только в том случае, если свойство было задано предварительно; однако оно не отражает точный размер компонента в процентах.

Указывает ширину компонента в виде процента от размера вышестоящего элемента. Допустимые значения: 0 – 100 По умолчанию используется значение NaN. Задание свойств width или explicitWidth приводит к сбросу значения этого свойства в значение NaN.

Это свойство возвращает числовое значение только в том случае, если свойство было задано предварительно; однако оно не отражает точный размер компонента в процентах.

Это свойство для элемента управления UITextField всегда устанавливается на NaN.

В макетах Spark это свойство используется для вычисления ширины границ компонента после масштабирования и вращения. Например, если компонент повернут на 90 градусов, то при указании percentWidth изменится высота компонента.

Определяет ряд настроек, применяемых для преобразования объекта способом, не отображающимся в макете вышестоящего элемента объекта.

Например, если требуется отрегулировать макет объекта, который будет повернут на 90 градусов, устанавливается свойство объекта rotation. Если необходимо, чтобы макет поворачиваемого объекта не регулировался, устанавливается свойство postLayoutTransformOffsets.rotationZ.

Горизонтальное смещение в пикселях от правого края компонента к правому краю целевого объекта привязки.

По умолчанию целевым объектом привязки является область содержимого контейнера. В макетах с расширенными ограничениями целевым объектом может быть столбец ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "anchorTargetName:value". Например, "col1:10".

Указывает поворот элемента относительно его исходной ориентации, в градусах.

Обозначает поворот в градусах по оси x экземпляра элемента относительно исходной ориентации по трехмерному вышестоящему контейнеру. Значения от 0 до 180 задают поворот по часовой стрелке. Значения от 0 до -180 задают поворот против часовой стрелки. Значения за пределами этого диапазона добавляются или вычитаются из 360 для получения допустимого значения. Это свойство игнорируется при вычислении любого из двумерных макетов Flex.

Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. Значения от 0 до 180 задают поворот по часовой стрелке. Значения от 0 до -180 задают поворот против часовой стрелки. Значения за пределами этого диапазона добавляются или вычитаются из 360 для получения допустимого значения. Это свойство игнорируется при вычислении любого из двумерных макетов Flex.

Указывает поворот элемента относительно его исходной ориентации, в градусах.

Горизонтальное масштабирование элемента от точки преобразования (в процентах).

Вертикальное масштабирование элемента от точки преобразования (в процентах).

Масштабирование элемента по оси z от точки преобразования (в процентах).

Вертикальное смещение в пикселях от верхнего края компонента к верхнему краю целевого объекта привязки.

По умолчанию целевым объектом привязки является область содержимого контейнера. В макетах с расширенными ограничениями, целевой объект может быть строкой ограничений.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "anchorTargetName:value". Например, "row1:10".

Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. Конкретные свойства (matrix, colorTransform и три свойства только для чтения (concatenatedMatrix, concatenatedColorTransform и pixelBounds)) описываются в разделе, посвященном классу Transform.

Каждое из свойств объекта transform представляет собой объект. Это очень важно, так как единственным способом задать новые значения для объектов matrix или colorTransform является создание нового объекта и его копирование в свойство transform.matrix или transform.colorTransform.

Например, чтобы увеличить значение tx матрицы экранного объекта, необходимо скопировать весь объект matrix, а затем копировать новый объект в свойство matrix объекта transform.

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

Свойство tx нельзя задавать напрямую. Следующий код не действует на myDisplayObject.

    myDisplayObject.transform.matrix.tx += 10;
    

Также можно копировать весь объект transform и назначить его свойству transform другого экранного объекта. Например, следующий код копирует весь объект transform из myOldDisplayObj в myNewDisplayObj.

Полученный экранный объект, myNewDisplayObj, теперь имеет те же значения для матрицы, преобразования цвета и пиксельных границ, что и старый экранный объект, myOldDisplayObj.

Обратите внимание, что на устройствах AIR for TV используется аппаратное ускорение, если оно доступно, для преобразований цветов.

Положение точки преобразования элемента по оси x.

Положение точки преобразования элемента по оси у.

Положение точки преобразования элемента по оси z.

Вертикальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки.

Целевым объектом привязки по умолчанию является сам контейнер.

В макетах с расширенными ограничениями целевым объектом привязки может являться строка ограничений. В этом случае область содержимого является пространством между предыдущей строкой (или стороной контейнера) и целевой строкой.

Установка для свойства числового значения или числовой строки (например, 10) определяет использование целевого объекта привязки по умолчанию.

Для указания целевого объекта привязки установите в качестве значения свойства строку в формате "constraintColumnId:value". Например, "row1:10".

Управляет видимостью данного визуального элемента. Если установлено значение true, то объект является видимым.

Если объект является невидимым, а свойство includeInLayout установлено на true, объект занимает место в контейнере, оставаясь при этом невидимым.

Если для visible установлено значение true, то объект необязательно будет видимым вследствие его размера и в зависимости от того, включено ли усечение контейнера.

Установка для visible значения false позволяет избежать фокусировки на компоненте.

Ширина графического элемента.

Значением по умолчанию является 0.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Положение графического элемента по оси x.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Положение графического элемента по оси y.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Положение графического элемента по оси z.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .

Возвращает значение true, если этот IGraphicElement совместим со следующим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.

Параметры

Возвращает значение true, если этот IGraphicElement совместим с предыдущим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.

В некоторых случаях этот элемент можно передать в IGraphicElementContainer в вызове метода setSharedDisplayObject(). В этих случаях данный метод не вызывается.

Параметры

Определяет, может ли быть пропущен вызов метода measure().

Обрабатывает свойства, установленные для элемента. Это усовершенствованный метод, который можно отменить при создании какого-либо подкласса.

Этот метод не вызывается напрямую. Метод commitProperties() вызывается программой Flex при использовании метода addElement() для добавления элемента к контейнеру IGraphicElementContainer, например Group, или при вызове метода invalidateProperties() элемента. Вызовы метода commitProperties() осуществляются перед вызовами метода measure(). Это позволяет устанавливать значения свойств, которые могли бы использоваться методом measure().

У некоторых элементов имеются свойства, которые взаимодействуют друг с другом. Зачастую в момент запуска целесообразно обработать все эти свойства сразу и избежать дублирования работы.

Создает новый DisplayObject, в котором отображается этот IGraphicElement.

Последующие вызовы получателя свойства displayObject должны возвращать тот же самый экранный объект.

После создания DisplayObject вышестоящий элемент IGraphicElementContainer передает экранные объекты в остальные элементы последовательности.

IGraphicElementContainer обеспечивает вызов метода только при необходимости.

Если требуется участие элемента в совместном использовании DisplayObject, новый DisplayObject должен реализовать интерфейс IShareableDisplayObject. Этот интерфейс применяется IGraphicElementContainer для управления удалением и повторным отображением последовательности графических элементов и, как правило, не используется разработчиками непосредственно.

Для повторной оценки общедоступных последовательностей вызывается метод invalidateGraphicElementSharing() в IGraphicElementContainer.

Чтобы IGraphicElementContainer принудительно удалил текущий DisplayObject элемента из списка отображения и повторно рассчитал совместное использование экранного объекта, вызовите метод discardDisplayObject() в IGraphicElementContainer.

Возвращает координату Х границ элемента для указанного размера элемента.

Этот метод обычно используется макетами при вызове метода measure() для предварительного определения позиции элемента в случае изменения размеров элемента в соответствии с определенной размерностью.

Параметры

Возвращает координату Y границ элемента при указанном размере элемента. Этот метод обычно используется макетами при вызове measure() для предварительного определения позиции элемента в случае изменения размеров элемента в соответствии с определенной размерностью.

Параметры

Возвращает высоту макета элемента. Размер, используемый элементом для отображения на экране.

Параметры

Возвращает ширину макета элемента. Размер, используемый элементом для отображения на экране.

Параметры

Возвращает координату Х, используемую элементом для отображения на экране.

Параметры

Возвращает координату Y, используемую элементом для отображения на экране.

Параметры

Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня.

Эта матрица, как правило, определяется двумерными свойствами компонента, такими как x, y, rotation, scaleX, scaleY, transformX и transformY. Некоторые компоненты могут иметь дополнительные свойства преобразования, которые применяются в дополнение к матрице макета для определения ее окончательного вида при вычислении. Например, UIComponent определяет свойство offsets.

Возвращает преобразование макета Matrix3D для этого элемента.

Эта матрица, как правило, определяется свойствами преобразования компонента, такими как x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX и transformY. Некоторые компоненты могут иметь дополнительные свойства преобразования, которые применяются в дополнение к матрице макета для определения ее окончательного вида при вычислении. Например, UIComponent определяет свойство offsets.

Возвращает максимальную высоту элемента.

Параметры

Возвращает максимальную ширину элемента.

Параметры

Возвращает минимальную высоту элемента.

Параметры

Возвращает минимальную ширину элемента.

Параметры

Возвращает предпочтительную высоту элемента.

Параметры

Возвращает предпочтительную ширину элемента.

Параметры

Возвращает количество пикселов, занятых обводкой на каждой стороне границ элемента.

Параметры

Вызывается автоматически компилятором MXML при создании GraphicElement с помощью тега MXML. При создании GraphicElement с помощью ActionScript необходимо установить свойство id вручную.

Параметры

Вызов метода приводит к вызову метода validateDisplayList() элементов перед визуализацией списка отображения.

В updateDisplayList() подклассы должны переопределять и выполнять их действия.

Служебный метод, сообщающий хосту об изменениях элемента и необходимости в обновлении его слоя.

Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. Если они различаются, этот метод отвечает за зеркальное отображение содержимого элемента и за обновление преобразования элемента после создания макета, чтобы нижестоящие элементы могли наследовать отображенную зеркально систему координат. Объекты IVisualElements обычно реализуют зеркальное отображение с помощью свойства postLayoutTransformOffsets, которое масштабирует ось X на -1 и изменяет координату x начальной позиции по ширине элемента. Фактическим результатом такого зеркального преобразования является то, что направление, в котором повышается значение оси Х, меняется на обратное без изменения местоположения объекта относительно начальной позиции вышестоящего элемента.

Вспомогательный метод, делающий недействительными размер и список отображения вышестоящего элемента, если этот объект оказывает влияние на соответствующий макет (значение includeInLayout равно true).

Выполнение вызова этого метода приводит к вызову метода validateProperties() элементов перед визуализацией списка отображения.

В commitProperties() подклассы должны переопределять и выполнять их действия.

Вызов этого метода приводит к вызову метода validateSize() элементов перед визуализацией списка отображения.

В measure() подклассы должны отменять их действия и выполнять свои измерения. По умолчанию, если не будут установлены explicitWidth и explicitHeight, measure() вызван не будет. Для отмены такого поведения по умолчанию подклассы должны отменить skipMeasure().

Преобразует объект point из координат объекта (локальных) в координаты рабочей области (глобальные).

Этот метод позволяет преобразовать заданные координаты x и y из значений относительно исходной точки (0,0) конкретного объекта (локальных координат) в значения относительно исходной точки рабочей области (глобальные координаты).

Чтобы воспользоваться этим методом, сначала нужно создать экземпляр класса Point. Присвоенные значения x и y представляют локальные координаты, так как они указаны относительно исходной точки данного объекта.

Затем созданный экземпляр Point передается в качестве параметра методу localToGlobal(). Этот метод возвращает новый объект Point со значениями x и y, указанными относительно исходной точки рабочей области, а не данного объекта.

Параметры

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

Вычисляет размер элемента по умолчанию. Это усовершенствованный метод, который можно отменить при создании подкласса GraphicElement.

Этот метод не вызывается напрямую. Метод measure() вызывается программой Flex при добавлении элемента к контейнеру IGraphicElementContainer, например Group, с использованием метода addElement() и при вызове метода invalidateSize() элемента.

По умолчанию задается явная высота и явная ширина элемента, вызов метода measure() в программе Flex не осуществляется даже в случае явного вызова метода invalidateSize(). Для отмены такого поведения требуется отменить метод skipMeasure().

Для переопределения этого метода необходимо настроить свойства measuredWidth и measuredHeight для определения размера по умолчанию. Можно дополнительно задать свойства measuredX и measuredY для определения по размеров границ по умолчанию верхнего левого угла относительно исходного положения элемента.

Концептуальное отличие метода measure() для элемента заключается в предоставлении его собственных естественных или свойственных ему размеров в качестве значений по умолчанию. Поэтому свойства measuredWidth и measuredHeight должны определяться на основе таких факторов, как перечисленные ниже.

• Объем текста, который должен быть отображен в компоненте.
• Размер изображения JPEG, отображаемого в компоненте.

В некоторых случаях встроенный метод для определения значений по умолчанию отсутствует. Например, для простого элемента GreenCircle можно просто установить значение свойств measuredWidth = 100 и measuredHeight = 100 в методе measure() для предоставления приемлемого размера по умолчанию. В других случаях, например для элемента TextArea, соответствующее вычисление (например, поиск требуемого значения ширины и высоты, при которых будет отображен весь текст, а элемент будет иметь соотношение размеров, присущее золотому сечению) может занять слишком много времени и поэтому не является целесообразным.

В реализации метода measure() по умолчанию для свойств measuredWidth, measuredHeight, measuredX и measuredY устанавливается значение, равное 0.

Вызывается с помощью IGraphicElementContainer при добавлении или удалении IGraphicElement из компонента хоста.

Этот метод обычно не вызывается.

Параметры

Возвращает явную измеренную высоту перед преобразованием при использовании для реализации интерфейса ILayoutElement.

Возвращает явную измеренную ширину перед преобразованием при использовании для реализации интерфейса ILayoutElement.

Устанавливает координаты, используемые элементом для отображения на экране.

Следует учитывать, что вызовы метода setLayoutBoundSize() могут изменить положение макета, поэтому вызывайте setLayoutBoundPosition() после вызова setLayoutBoundSize().

Параметры

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

Если параметры width и/или height остаются неопределенными (NaN), Flex устанавливает размер макета элемента в соответствии с предпочтительной шириной и/или высотой.

Следует учитывать, что вызовы метода setLayoutBoundSize() могут изменить положение макета, поэтому вызывайте setLayoutBoundPosition() после вызова setLayoutBoundSize().

Параметры

Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня.

Эта матрица, как правило, определяется двухмерными свойствами компонента, такими как x, y, rotation, scaleX, scaleY, transformX и transformY. Некоторые компоненты могут иметь дополнительные свойства преобразования, которые применяются в дополнение к матрице макета для определения ее окончательного вида при вычислении. Например, UIComponent определяет свойство offsets.

Следует отметить, что матрица макета факторизуется методами getPreferredSize(), getMinSize(), getMaxSize(), getLayoutSize() при вычислении в координатах вышестоящего элемента, а также методом getLayoutPosition() в координатах как вышестоящего, так и нижестоящего элемента. Макеты, для которых матрица преобразования вычисляется явным образом, как правило, вызывают этот метод и используют размеры в координатах нижестоящего элемента. Макеты, вызывающие этот метод, передают значение false в метод invalidateLayout таким образом, чтобы избежать инициирования последующей передачи макета.

Параметры

Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня.

Эта матрица, как правило, определяется свойствами преобразования компонента, такими как x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX и transformY. Некоторые компоненты могут иметь дополнительные свойства преобразования, которые применяются в дополнение к матрице макета для определения ее окончательного вида при вычислении. Например, UIComponent определяет свойство offsets.

Следует отметить, что трехмерная матрица факторизуется методами getPreferredSize(), getMinSize(), getMaxSize(), getLayoutSize() при вычислении в координатах вышестоящего элемента, а также методом getLayoutPosition() в координатах как вышестоящего, так и нижестоящего элемента. Макеты, для которых матрица преобразования вычисляется явным образом, как правило, вызывают этот метод и используют размеры в координатах нижестоящего элемента. Макеты, вызывающие этот метод, передают значение false в метод invalidateLayout таким образом, чтобы избежать инициирования последующей передачи макета.

Параметры

Определяет, может ли этот элемент отображаться в объекте 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().

Параметры

Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента. Эта функция присваивает предоставленные значения для вращения, масштабирования и перемещения, и затем по мере необходимости обновляет свойства x/y/z для сохранения фиксированного центра преобразования.

Параметры

Преобразуйте размер элемента.

Этот метод вычисляет ограничительную рамку элемента графики, как будто свойства элемента width/height устанавливались как проходивший в значениях. Метод возвращает высоту ограничительной рамки.

Вообще, этот метод не для, используют разработчиками. Вместо этого вы должны внедрить или изменить методы, определенные интерфейсом ILayoutElement.

Параметры

Служебный метод для преобразования точки, указанной в локальных координатах этого объекта, к ее местоположению в координатах вышестоящего узла объекта. Результат до и после создания макета будет установлен в параметрах position и postLayoutPosition, если они не равны null.

Параметры

Преобразуйте размер элемента.

Этот метод вычисляет ограничительную рамку элемента графики, как будто свойства элемента width/height устанавливались как проходивший в значениях. Метод возвращает ширину ограничительной рамки.

Вообще, этот метод не для, используют разработчиками. Вместо этого вы должны внедрить или изменить методы, определенные интерфейсом ILayoutElement.

Параметры

Обеспечивает отображение элемента и/или определение размеров и положения его содержимого. Это усовершенствованный метод, который можно отменить при создании подкласса GraphicElement.

Этот метод не вызывается напрямую. Метод updateDisplayList() вызывается программой Flex при добавлении компонента к контейнеру IGraphicElementContainer, например Group, с использованием метода addElement() и при вызове метода invalidateDisplayList() элемента.

Именно в этом методе необходимо осуществить программируемое отображение с использованием методов элемента displayObject, например graphics.drawRect().

Параметры

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

Если элемент является первым элементом в последовательности (для displayObjectSharingMode установлено значение DisplayObjectSharingMode.OWNS_SHARED_OBJECT), графический элемент displayObject очищается, а затем выполняется его настройка, требуемая для отображения остальных элементов.

Элемент всегда должен перерисовываться, даже если он не изменился со времени последнего вызова метода validateDisplayList(). Вышестоящий объект IGraphicElementContainer изменит всю последовательность, если любой из ее элементов требуется изменить.

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

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

Проверяет и обновляет свойства и макет этого объекта посредством немедленного вызова методов validateProperties(), validateSize() и validateDisplayList(), если необходимо.

Используется в логике макета для проверки свойств компонента посредством вызова метода commitProperties(). Как правило, подклассы должны отменять метод commitProperties(), но не данный метод.

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

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

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

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