| Пакет | flash.text.engine |
| Класс | public final class ElementFormat |
| Наследование | ElementFormat  Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект ElementFormat, примененный к ContentElement в элементе TextBlock, не аннулирует действие TextBlock. После применения объекта ElementFormat к ContentElement для его свойства locked задается значение true. Изменение свойств заблокированного объекта ElementFormat невозможно. Вместо этого необходимо использовать метод clone() для создания разблокированной копии объекта, который можно изменить и присвоить объекту ContentElement.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| alignmentBaseline : String
Определяет тип базовой линии в содержащем элементе, по которой следует выравнивать доминантные базовые линии элементов с таким форматом. | ElementFormat | ||
| alpha : Number
Определяет прозрачность элементов строки, затрагиваемых этим объектом. | ElementFormat | ||
| baselineShift : Number
Указывает смещение базовой линии для элемента в пикселях. | ElementFormat | ||
| breakOpportunity : String
Возможный разрыв строки в тексте. | ElementFormat | ||
| color : uint
Указывает цвет текста. | ElementFormat | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| digitCase : String
Регистр цифр в тексте. | ElementFormat | ||
| digitWidth : String
Ширина цифр в тексте. | ElementFormat | ||
| dominantBaseline : String
Определяет тип базовой линии, который должен использоваться в качестве доминантной базовой линии. | ElementFormat | ||
| fontDescription : FontDescription
Объект, свойства которого описывают шрифт. | ElementFormat | ||
| fontSize : Number
Размер текста в пикселах. | ElementFormat | ||
| kerning : String
Кернинг регулирует количество пикселей между определенными парами символов с целью улучшения удобочитаемости текста. | ElementFormat | ||
| ligatureLevel : String
Лигатура в тексте. | ElementFormat | ||
| locale : String
Локаль текста. | ElementFormat | ||
| locked : Boolean
Обозначает, заблокирован ли объект ElementFormat. | ElementFormat | ||
| textRotation : String
Задает вращение, применяемое к отдельным глифам символа. | ElementFormat | ||
| trackingLeft : Number
Трекинг или ручной кернинг, применяемый слева от каждого глифа (в пикселях). | ElementFormat | ||
| trackingRight : Number
Трекинг или ручной кернинг, применяемый справа от каждого глифа (в пикселях). | ElementFormat | ||
| typographicCase : String
Регистр текста. | ElementFormat | ||
| Метод | Определено | ||
|---|---|---|---|
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Создает объект ElementFormat. | ElementFormat | ||
Создание разблокированной клонированной копии объекта ElementFormat. | ElementFormat | ||
Возвращает объект FontMetrics со свойствами, описывающими emBox, положение зачеркивания, толщину зачеркивания, положение подчеркивания, толщину подчеркивания и шрифта, заданного fontDescription и fontSize.
| ElementFormat | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
alignmentBaseline | свойство |
alignmentBaseline:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Определяет тип базовой линии в содержащем элементе, по которой следует выравнивать доминантные базовые линии элементов с таким форматом. Используйте константы TextBaseline для этого свойства.
Выравнивание базовых линий определяется самым большим вертикальным элементом в строке, если не заданы TextBlock.baselineFontDescription и TextBlock.baselineFontSize для изменения этой логики.
Значение по умолчанию — TextBaseline.USE_DOMINANT_BASELINE.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
TextBaseline.ROMAN | dominantBaseline выравнивается по латинской базовой линии строки. |
TextBaseline.ASCENT | dominantBaseline выравнивается по базовой линии верхнего выносного элемента строки. |
TextBaseline.DESCENT | dominantBaseline выравнивается по базовой линии нижнего выносного элемента строки. |
TextBaseline.IDEOGRAPHIC_TOP | dominantBaseline выравнивается по идеографической верхней базовой линии строки. |
TextBaseline.IDEOGRAPHIC_CENTER | dominantBaseline выравнивается по идеографической центральной базовой линии строки. |
TextBaseline.IDEOGRAPHIC_BOTTOM | dominantBaseline выравнивается по идеографической нижней базовой линии строки. |
TextBaseline.USE_DOMINANT_BASELINE | dominantBaseline выравнивается по той же базовой линии строки. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Задает базовую линию выравнивания строки, по которой выравнивается dominantBaseline графического элемента. |
GroupElement | Не оказывает влияния. |
TextElement | Задает базовую линию выравнивания строки, по которой выравнивается dominantBaseline текстового элемента. |
Реализация
public function get alignmentBaseline():String public function set alignmentBaseline(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся членом TextBaseline.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
alpha | свойство |
alpha:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Определяет прозрачность элементов строки, затрагиваемых этим объектом. Допустимые значения находятся в диапазоне 0 (полностью прозрачный) — 1 (полностью непрозрачный). Экранные объекты, для которых значение alpha равно 0, являются активными, несмотря на невидимость.
По умолчанию используется значение 1.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Применяет заданное значение альфа-канала к графическому элементу. Мультипликативно объединяется с любым значением альфа-канала, заданным в самом графическом объекте DisplayObject или в TextLine. |
GroupElement | Не оказывает влияния. |
TextElement | Применяет заданное значение альфа-канала к текстовому элементу. Мультипликативно объединяется с любым значением альфа-канала, заданным в TextLine. |
Реализация
public function get alpha():Number public function set alpha(value:Number):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
baselineShift | свойство |
baselineShift:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Указывает смещение базовой линии для элемента в пикселях.
Элемент смещается с dominantBaseline на это расстояние. Сдвиг добавляется к положение по оси у членов элемента, поэтому в не вращающемся тексте положительное смещение базовой линии сдвигает элемент вниз, а отрицательное — вверх.
Значение по умолчанию 0,0, что указывает на отсутствие смещения.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Смещает графический элемент с базовой линии. |
GroupElement | Не оказывает влияния. |
TextElement | Смещает текстовый элемент с базовой линии. |
Реализация
public function get baselineShift():Number public function set baselineShift(value:Number):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
breakOpportunity | свойство |
breakOpportunity:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Возможный разрыв строки в тексте. Это свойство определяет, какие символы могут использоваться для разрыва, когда обтекающий текст разбивается на несколько строк. Используйте константы BreakOpportunity для этого свойства.
По умолчанию используется значение BreakOpportunity.AUTO.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
BreakOpportunity.AUTO | Возможные разрывы строк определяются в соответствии со стандартными свойствами символов Юникод, например разрыв между словами и после дефиса. |
BreakOpportunity.ANY | Любой символ в объекте ContentElement рассматривается как возможность разрыва строки. Это значение обычно используется, когда латинский текст встраивается с восточно-азиатский текст и желательны разрывы строк в середине слов. |
BreakOpportunity.NONE | Ни один из символов диапазона не рассматривается как возможность разрыва строки. |
BreakOpportunity.ALL | Все символы в диапазоне рассматриваются как возможности для разрыва строки, то есть разрыв строки будет осуществляться после каждого символа. Полезно для создания таких эффектов, как текст по контуру. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Определяет возможность разрыва строки между смежными текстовыми элементами в группе. Если elementFormat группы имеет значение null, используется формат первого из смежных элементов. |
TextElement | Определяет возможность разрыва строки между символами в текстовом элементе. |
Реализация
public function get breakOpportunity():String public function set breakOpportunity(value:String):voidВыдает
ArgumentError — Если заданное значение не является членом класса BreakOpportunity.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
color | свойство |
color:uint| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Указывает цвет текста. Целое число, содержащее три 8-разрядных компонента RGB; например, 0xFF0000 — это красный, 0x00FF00 — это зеленый.
По умолчанию используется значение 0x000000, то есть черный.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Задает цвет текста. |
Реализация
public function get color():uint public function set color(value:uint):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
digitCase | свойство |
digitCase:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Регистр цифр в тексте. Регистр цифр влияет на стиль и расположение групп числовых символов. Используйте константы DigitCase для этого свойства.
По умолчанию используется значение DigitCase.DEFAULT.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
DigitCase.DEFAULT | Применяет к тексту регистр цифр по умолчанию. |
DigitCase.LINING | Применяет к тексту маюскульный регистр цифр. |
DigitCase.OLD_STYLE | Применяет к тексту минускульный регистр цифр. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет регистр цифр, используемый для текста в элементе. |
Реализация
public function get digitCase():String public function set digitCase(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся элементом класса DigitCase.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
digitWidth | свойство |
digitWidth:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Ширина цифр в тексте. Используйте константы DigitWidth для этого свойства.
По умолчанию используется значение DigitWidth.DEFAULT.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
DigitWidth.DEFAULT | Применяет к тексту ширину цифр по умолчанию. |
DigitWidth.PROPORTIONAL | Применяет к тексту пропорциональную ширину цифр. |
DigitWidth.TABULAR | Применяет к тексту табличную ширину цифр. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет ширину цифр, используемую для текста в элементе. |
Реализация
public function get digitWidth():String public function set digitWidth(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся элементом класса DigitWidth.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
dominantBaseline | свойство |
dominantBaseline:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Определяет тип базовой линии, который должен использоваться в качестве доминантной базовой линии. Доминантная базовая линия выравнивается по базовой линии выравнивания, чтобы определить позицию по вертикали для элемента в строке. Используйте константы TextBaseline для этого свойства.
Содержимое элемента определяет базовые линии. В случае с TextElement базовые линии определяются шрифтом и размером кегля. В случае с GraphicElement базовые линии определяются высотой элемента.
Значение по умолчанию — TextBaseline.ROMAN.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
TextBaseline.ROMAN | Латинская базовая линия элемента выравнивается по alignmentBaseline. |
TextBaseline.ASCENT | Базовая линия верхнего выносного элемента выравнивается по alignmentBaseline. |
TextBaseline.DESCENT | Базовая линия нижнего выносного элемента выравнивается по alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_TOP | Идеографическая верхняя базовая линия элемента выравнивается по alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_CENTER | Идеографическая центральная базовая линия элемента выравнивается по alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_BOTTOM | Идеографическая нижняя базовая линия элемента выравнивается по alignmentBaseline. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Определяет, какая из базовых линий графического элемента выравнивается по alignmentBaseline. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет, какая из базовых линий текстового элемента выравнивается по alignmentBaseline. |
Реализация
public function get dominantBaseline():String public function set dominantBaseline(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся членом TextBaseline.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
fontDescription | свойство |
fontDescription:FontDescription| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект, свойства которого описывают шрифт.
Значением по умолчанию является объект FontDescription, созданный по умолчанию.
Если задается свойство fontDescription, предоставленный объект FontDescription заблокирован: для его свойства locked задано значение true. Изменение заблокированного объекта FontDescription невозможно.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет шрифт, используемый для текста в элементе. |
Реализация
public function get fontDescription():FontDescription public function set fontDescription(value:FontDescription):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
fontSize | свойство |
fontSize:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Размер текста в пикселах.
По умолчанию используется значение 12.0.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет размер текста элемента в пикселах. |
Реализация
public function get fontSize():Number public function set fontSize(value:Number):voidВыдает
ArgumentError — Если задано значение меньше нуля.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
kerning | свойство |
kerning:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Кернинг регулирует количество пикселей между определенными парами символов с целью улучшения удобочитаемости текста. Кернинг поддерживается для всех шрифтов, имеющих таблицы кернинга.
По умолчанию используется значение Kerning.ON.
Чтобы установить значения для этого свойства, используйте следующие константы класса Kerning.
| Строковое значение | Описание |
|---|---|
Kerning.ON | Кернинг включен. |
Kerning.OFF | Кернинг выключен. |
Kerning.AUTO | В азиатской типографике кернинг всегда включен за исключением тех случаев, когда его использование неприемлемо. Кернинг применяется между двумя символами, если ни один из них не принадлежит к кандзи, хирагана или катакана. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Определяет, применяется ли кернинг между смежными текстовыми элементами в группе. Если elementFormat группы имеет значение null, используется формат первого из смежных элементов. |
TextElement | Определяет, применяется ли кернинг между символами в текстовом элементе. |
Реализация
public function get kerning():String public function set kerning(value:String):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
ligatureLevel | свойство |
ligatureLevel:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Лигатура в тексте. Лигатура возникает, когда две или более литеры объединяются в один глиф. Лигатуры обычно заменяют последовательные символы с общими компонентами, такие как пары букв «fi», «fl» или «ae». Они используются как с латинскими, так и с нелатинскими наборами символов. Используйте константы LigatureLevel для этого свойства.
По умолчанию используется значение LigatureLevel.COMMON.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
LigatureLevel.NONE | Лигатуры не создаются. |
LigatureLevel.MINIMUM | Создаются минимальные лигатуры. |
LigatureLevel.COMMON | Создаются обычные лигатуры. |
LigatureLevel.UNCOMMON | Создаются необычные лигатуры. |
LigatureLevel.EXOTIC | Создаются экзотические лигатуры. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Определяет уровень лигатуры между смежными текстовыми элементами в группе. Если elementFormat группы имеет значение null, используется формат первого из смежных элементов. |
TextElement | Определяет уровень лигатуры между символами в текстовом элементе. |
Реализация
public function get ligatureLevel():String public function set ligatureLevel(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся элементом класса LigatureLevel.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
locale | свойство |
locale:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Локаль текста. Управляет преобразованием регистра и формированием. Используются стандартные идентификаторы локали. Например en, en_US и en-US относятся к английскому, а ja — к японскому. Список кодов локалей см. в списке кодов iso639-2.
Значение по умолчанию равно en.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет преобразования и формирование для текста в элементе. |
Реализация
public function get locale():String public function set locale(value:String):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
locked | свойство |
locked:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Обозначает, заблокирован ли объект ElementFormat. Если задано значение true, изменение объекта ElementFormat невозможно. Вызовите метод ElementFormat.clone() для получения разблокированной копии объекта ElementFormat.
Реализация
public function get locked():Boolean public function set locked(value:Boolean):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
textRotation | свойство |
textRotation:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Задает вращение, применяемое к отдельным глифам символа. Используйте для этого свойства константы, определенные в классе TextRotation.
По умолчанию используется значение TextRotation.AUTO.
Конечный поворот любого глифа является суммой ElementFormat.textRotation, ContentElement.textRotation и TextBlock.lineRotation.
Это свойство обычно используется для азиатского текста, где символы необходимо поворачивать для правильного отображения при вертикальной раскладке. Для этого используйте TextRotation.AUTO в сочетании с TextBlock.lineRotation = TextRotation.ROTATE_90.
Определение этого свойства для шрифтов, не содержащих сведений о вертикальной раскладке, может дать нежелательные результаты. Шрифты, содержащие таблицу vmtx или VORG, такие как японский шрифт MS Mincho, работают правильно, так как эти таблицы предоставляют данные, необходимые процессору раскладки. Такие шрифты, как Verdana, не содержащие необходимой информации, работают неправильно.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
TextRotation.ROTATE_0 | Глифы не поворачиваются. |
TextRotation.ROTATE_90 | Глифы поворачиваются на 90 градусов по часовой стрелке. |
TextRotation.ROTATE_180 | Глифы поворачиваются на 180 градусов. |
TextRotation.ROTATE_270 | Глифы поворачиваются на 270 градусов по часовой стрелке. |
TextRotation.AUTO | Задает поворот на 90 градусов против часовой стрелки только для полноширинных и широких глифов, в соответствии со свойствами Юникод для глифа. Обычно это значение используется с восточно-азиатскими текстами, чтобы поворачивать только глифы, требующие поворота. Этот поворот применяется только к вертикальному тексту, чтобы возвращать полноширинным и широким символам вертикальную ориентацию, не затрагивая остальных символов. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет поворот глифов в текстовом элементе. |
Реализация
public function get textRotation():String public function set textRotation(value:String):voidВыдает
ArgumentError — Если задано значение, не являющееся членом TextRotation.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
trackingLeft | свойство |
trackingLeft:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Трекинг или ручной кернинг, применяемый слева от каждого глифа (в пикселях). Если kerning включен, значение trackingLeft добавляется к значениям в таблице кернинга для шрифта. Если kerning выключен, значение trackingLeft используется в качестве значения ручного кернинга. Поддерживает как положительные, так и отрицательные значения.
Обычно желаемое значение трекинга делится между trackingRight и trackingLeft. В противном случае в тексте со смешанной направленностью у одной двунаправленной границы будет двойной трекинг, а у другой — нулевой.
По умолчанию используется значение 0.0.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Определяет трекинг, применяемый к левой стороне графического элемента. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет трекинг, применяемый к левой стороне символов в текстовом элементе. |
Пример:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingLeft = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingLeft = -1.0;
Реализация
public function get trackingLeft():Number public function set trackingLeft(value:Number):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
trackingRight | свойство |
trackingRight:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Трекинг или ручной кернинг, применяемый справа от каждого глифа (в пикселях). Если kerning включен, значение trackingRight добавляется к значениям в таблице кернинга для шрифта. Если kerning выключен, значение trackingRight используется в качестве значения ручного кернинга. Поддерживает как положительные, так и отрицательные значения.
Обычно желаемое значение трекинга делится между trackingRight и trackingLeft. В противном случае в тексте со смешанной направленностью у одной двунаправленной границы будет двойной трекинг, а у другой — нулевой.
По умолчанию используется значение 0.0.
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Определяет трекинг, применяемый к правой стороне графического элемента. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет трекинг, применяемый к правой стороне символов в текстовом элементе. |
Пример:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingRight = -1.0;
Реализация
public function get trackingRight():Number public function set trackingRight(value:Number):voidВыдает
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
typographicCase | свойство |
typographicCase:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Регистр текста. Используйте для этого свойства константы, определенные в классе TypographicCase.
По умолчанию используется значение TypographicCase.DEFAULT.
В качестве значений этого свойства используйте следующие строковые значения:
| Строковое значение | Описание |
|---|---|
TypographicCase.DEFAULT | Указывает, что для всех символов используется обычный регистр. |
TypographicCase.TITLE | Указывает, что на выходе символы верхнего регистра используют заголовочные глифы. |
TypographicCase.CAPS | Указывает, что на выходе для символов верхнего регистра корректируются интервалы. |
TypographicCase.SMALL_CAPS | Указывает, что на выходе символы верхнего регистра используют капительные глифы. |
TypographicCase.UPPERCASE | Указывает, что на выходе все символы используют глифы верхнего регистра. |
TypographicCase.LOWERCASE | Указывает, что на выходе все символы используют глифы нижнего регистра. |
TypographicCase.CAPS_AND_SMALL_CAPS | Указывает, что на выходе все символы нижнего регистра используют капительные глифы. |
| Подкласс | Результат определения свойства |
|---|---|
GraphicElement | Не оказывает влияния. |
GroupElement | Не оказывает влияния. |
TextElement | Определяет регистр текста, используемый для текстового элемента. |
Реализация
public function get typographicCase():String public function set typographicCase(value:String):voidВыдает
ArgumentError — Если заданное значение не является членом класса TypographicCase.
| |
IllegalOperationError — Если задается после блокирования объекта ElementFormat (для свойства locked задано значение true).
|
Связанные элементы API
ElementFormat | () | Конструктор |
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Создает объект ElementFormat.
ПараметрыfontDescription:FontDescription (default = null)null. Если не выбрано описание шрифта, используется описание по умолчанию.
| |
fontSize:Number (default = 12.0) | |
color:uint (default = 0x000000) | |
alpha:Number (default = 1.0)alpha применяется ко всем атомам строки на основе формата элемента.
| |
textRotation:String (default = "auto") | |
dominantBaseline:String (default = "roman") | |
alignmentBaseline:String (default = "useDominantBaseline") | |
baselineShift:Number (default = 0.0) | |
kerning:String (default = "on") | |
trackingRight:Number (default = 0.0) | |
trackingLeft:Number (default = 0.0) | |
locale:String (default = "en") | |
breakOpportunity:String (default = "auto") | |
digitCase:String (default = "default") | |
digitWidth:String (default = "default") | |
ligatureLevel:String (default = "common") | |
typographicCase:String (default = "default") |
Выдает
ArgumentError — Заданный fontSize меньше 0.
| |
ArgumentError — Заданное значение textRotation не является членом класса TextRotation.
| |
ArgumentError — Заданное значение dominantBaseline не является членом класса TextBaseline.
| |
ArgumentError — Заданное значение alignmentBaseline не является членом класса TextBaseline.
| |
ArgumentError — Заданное значение kerning не является членом класса Kerning.
| |
ArgumentError — Заданное значение breakOpportunity не является членом класса BreakOpportunity.
| |
ArgumentError — Заданное значение digitCase не является членом класса DigitCase.
| |
ArgumentError — Заданное значение digitWidth не является членом класса DigitWidth.
| |
ArgumentError — Заданное значение ligatureLevel не является членом класса LigatureLevel.
| |
ArgumentError — Заданное значение typographicCase не является членом класса TypographicCase.
|
clone | () | метод |
public function clone():ElementFormat| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Создание разблокированной клонированной копии объекта ElementFormat.
ВозвращаетElementFormat — Разблокированная копия объекта ElementFormat.
|
Пример ( Использование этого примера )
В этом примере создается объект ElementFormat и задается свойство FontSize. Создается новый объект TextElement с использованием ElementFormat (и блокируется таким образом), затем этот объект TextElement используется в качестве содержимого для объекта TextBlock. Из объекта TextBlock создается текстовая строка.
Для изменения объекта ElementFormat сначала проверьте его свойство locked. Если оно имеет значение true, используйте метод clone() для создания разблокированной копии объекта ElementFormat, измените его свойства, затем повторно свяжите новый объект ElementFormat с объектом TextBlock. При повторной разбивке строк новые строки получат новые параметры шрифтов.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormat_cloneExample extends Sprite {
private var ef1:ElementFormat;
private var ef2:ElementFormat;
public function ElementFormat_cloneExample():void {
var fd:FontDescription = new FontDescription();
fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
fd.fontName = "Palatino";
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize=20;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
ef2 = (ef1.locked) ? ef1.clone() : ef1;
ef2.fontSize = 32;
tb.content.elementFormat=ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
}
}
}
getFontMetrics | () | метод |
public function getFontMetrics():FontMetrics| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Возвращает объект FontMetrics со свойствами, описывающими emBox, положение зачеркивания, толщину зачеркивания, положение подчеркивания, толщину подчеркивания и шрифта, заданного fontDescription и fontSize.
FontMetrics — Объект FontMetrics, описывающий свойства шрифта, заданного fontDescription.
|
Связанные элементы API
Пример ( Использование этого примера )
ElementFormat и назначать ему FontDescription, а также использовать метод getFontMetrics для отображения метрики выбранного шрифта размером 24 пункта.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class FontMetricsExample extends Sprite {
public function FontMetricsExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 24;
var fm1:FontMetrics = ef1.getFontMetrics();
trace(fm1.emBox);
trace(fm1.strikethroughOffset);
trace(fm1.strikethroughThickness);
trace(fm1.subscriptScale);
trace(fm1.subscriptOffset);
trace(fm1.superscriptScale);
trace(fm1.superscriptOffset);
trace(fm1.underlineOffset);
trace(fm1.underlineThickness);
}
}
}
В этом примере показано, как создавать два объекта ElementFormat и задавать для них некоторые свойства. Назначается новый ElementFormats объекту TextElement, который назначался в качестве содержимого TextBlock. Изменение ElementFormat объекта TextElement не влияет на текстовые строки, созданные родительским блоком.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormatExample extends Sprite {
public function ElementFormatExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 30;
ef1.color = 0xFF0000;
ef1.alpha = 100;
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 2;
ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
var ef2:ElementFormat = new ElementFormat(fd);
ef2.fontSize = 30;
ef2.color = 0xFF0000;
ef2.alpha = 0.3;
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
line1.x = 15;
line1.y = 30;
tb.content.elementFormat = ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
line2.x = 15;
line2.y = 60;
}
}
}
Tue Jun 12 2018, 11:34 AM Z