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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Этот метод не вызывается напрямую. Метод 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.

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

Как правило, средства реализации возвращают значение 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().

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

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

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

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

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

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

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

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

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

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

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

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

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