| Пакет | flash.text.engine |
| Класс | public class ContentElement |
| Наследование | ContentElement  Object |
| Подклассы | GraphicElement, GroupElement, TextElement |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ContentElement — это абстрактный базовый класс, поэтому экземпляры ContentElement нельзя создавать непосредственно. При вызове new ContentElement() выдается исключение ArgumentError.
Элемент ContentElement можно назначить только одному GroupElement или свойству content только одного текстового блока.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| elementFormat : ElementFormat
Объект ElementFormat, используемый для элемента. | ContentElement | ||
| eventMirror : EventDispatcher
Объект EventDispatcher, получающий копии каждого события, вызванного для действительных текстовых строк, созданных на основе данного элемента содержимого. | ContentElement | ||
| groupElement : GroupElement [только для чтения]
Объект GroupElement, содержащий этот элемент, или null, если это не группа. | ContentElement | ||
| rawText : String [только для чтения]
Копия текста в элементе, включая символы U+FDEF. | ContentElement | ||
| text : String [только для чтения]
Копия текста в элементе, за исключением символов U+FDEF, представляющих графические элементы в объекте String. | ContentElement | ||
| textBlock : flash.text.engine:TextBlock [только для чтения]
Объект TextBlock, которому принадлежит этот элемент. | ContentElement | ||
| textBlockBeginIndex : int [только для чтения]
Индекс в первого символа в этом элементе текстового блока. | ContentElement | ||
| textRotation : String
Поворот, который должен применяться к элементу, как к едином целому. | ContentElement | ||
| userData : *
Дает возможность приложению связать произвольные данные с элементом. | ContentElement | ||
| Метод | Определено | ||
|---|---|---|---|
ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
При вызове конструктора new СontentElement() выдается исключение ArgumentError. | ContentElement | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| GRAPHIC_ELEMENT : uint = 0xFDEF [статические]
Указывает на присутствие в тексте графического элемента. | ContentElement | ||
elementFormat | свойство |
elementFormat:ElementFormat| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект ElementFormat, используемый для элемента.
По умолчанию используется null.
Если задается свойство elementFormat, предоставленный объект ElementFormat заблокирован: для его свойства locked задано значение true. Изменение заблокированного объекта ElementFormat невозможно.
Реализация
public function get elementFormat():ElementFormat public function set elementFormat(value:ElementFormat):voidСвязанные элементы API
eventMirror | свойство |
eventMirror:EventDispatcher| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект EventDispatcher, получающий копии каждого события, вызванного для действительных текстовых строк, созданных на основе данного элемента содержимого. Заданный объект может использоваться для настройки прослушивателей для текстовой ссылки или другого интерактивного фрагмента текста, так как при исполнении может быть сложно определить, какие части строк получены от определенных элементов содержимого. Также прослушиватели можно использовать для применения отделки, например подчеркивания, показатели которой невозможно определить до раскладки текста. Значение по умолчанию — null, то есть, зеркальные события не отправляются.
Зеркала событий представлены в текстовых строках в качестве экземпляров класса TextLineMirrorRegion. В зависимости от двунаправленной обработки и разрывов строк, можно создавать одну или несколько зеркальных областей.
По умолчанию используется null.
Реализация
public function get eventMirror():EventDispatcher public function set eventMirror(value:EventDispatcher):voidСвязанные элементы API
groupElement | свойство |
groupElement:GroupElement [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект GroupElement, содержащий этот элемент, или null, если это не группа.
По умолчанию используется null.
Реализация
public function get groupElement():GroupElementСвязанные элементы API
rawText | свойство |
text | свойство |
text:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Копия текста в элементе, за исключением символов U+FDEF, представляющих графические элементы в объекте String.
Реализация
public function get text():StringСвязанные элементы API
textBlock | свойство |
textBlock:flash.text.engine:TextBlock [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект TextBlock, которому принадлежит этот элемент.
По умолчанию используется null.
Реализация
public function get textBlock():flash.text.engine:TextBlockСвязанные элементы API
textBlockBeginIndex | свойство |
textBlockBeginIndex:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Индекс в первого символа в этом элементе текстового блока. Это значение берется не из кэша, а вычисляется при каждом вызове метода.
Значением по умолчанию является -1.
Реализация
public function get textBlockBeginIndex():inttextRotation | свойство |
textRotation:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Поворот, который должен применяться к элементу, как к едином целому. Используйте константы TextRotation для этого свойства.
Значение по умолчанию равно TextRotation.ROTATE_0.
Конечный поворот любого глифа является суммой ElementFormat.textRotation, ContentElement.textRotation и TextBlock.lineRotation.
ContentElement.textRotation используется для создания короткого фрагмента текста, поворот которого отличается от поворота содержащей его строки. В качестве примера можно привести фрагменты TCY в японском тексте. TCY — это сокращение от Tate-Chu-Yoko, так называется размещение небольшого фрагмента текста по горизонтали (обычно это числа) среди вертикального японского текста. Чтобы создать абзац вертикального японского текста с фрагментом TCY, выполните следующие действия.
- Задайте
TextBlock.lineRotation=TextRotation.ROTATE_90 - Задайте для
TextBlock.contentобъект GroupElement, состоящий из трех объектов TextElement. Первый из этих элементов — это японский текст до фрагмента TCY, второй — латинский текст фрагмента TCY, а третий — японский текст после TCY. - Задайте свойству
textRotationобъекта TCY TextElement значениеTextRotation.ROTATE_270. Текстовый элемент TCY поворачивается как единое целое. Операция начинается с поворота на 90 градусов, унаследованного от строки. Добавление поворота на 270 градусов переводит фрагмент в горизонтальное положение.
Повернутые элементы содержимого не поддерживают вложенность. В любой иерархии элементов содержимого, независимо от уровня сложности, свойство textRotation можно задать только для одного элемента. Следующие методы и функции установки свойств выдают ошибку аргумента в случае обнаружения вложенного поворота:
ContentElement.textRotationGroupElement.setElementsGroupElement.replaceElements
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
TextRotation.ROTATE_0 | Элемент не поворачивается. |
TextRotation.ROTATE_90 | Элемент поворачивается на 90 градусов по часовой стрелке. |
TextRotation.ROTATE_180 | Элемент поворачивается на 180 градусов. |
TextRotation.ROTATE_270 | Элемент поворачивается на 270 градусов по часовой стрелке. |
TextRotation.AUTO | Не поддерживается. |
Реализация
public function get textRotation():String public function set textRotation(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся членом TextRotation.
| |
ArgumentError — Если задано значение TextRotation.AUTO.
| |
ArgumentError — Если операция должна привести к вложенным вращениям внутри элемента GroupElement.
|
Связанные элементы API
userData | свойство |
public var userData:*| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Дает возможность приложению связать произвольные данные с элементом.
По умолчанию используется null.
ContentElement | () | Конструктор |
public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
При вызове конструктора new СontentElement() выдается исключение ArgumentError. Однако можно вызывать конструкторы для следующих подклассов ContentElement:
new GraphicElement()new GroupElement()new TextElement()
elementFormat:ElementFormat (default = null)null.
| |
eventMirror:EventDispatcher (default = null)EventDispatcher, получающий копии каждого события, вызванного для действительных текстовых строк, созданных на основе данного элемента содержимого. По умолчанию используется null.
| |
textRotation:String (default = "rotate0")TextRotation для этого свойства. Значение по умолчанию равно TextRotation.ROTATE_0.
|
GRAPHIC_ELEMENT | Константа |
Tue Jun 12 2018, 11:34 AM Z