Указывает, по какой из базовых линий строки, содержащей элемент, выравнивается dominantBaseline, определяя вертикальную позицию элемента в строке. Используйте константы flash.text.engine.TextBaseline для этого свойства.

Базовые линии определяются самым большим элементом в строке, если не заданы TextBlock.baselineFontDescription и TextBlock.baselineFontSize для изменения этой логики.

Значение по умолчанию — flash.text.engine.TextBaseline.USE_DOMINANT_BASELINE.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Дает автору возможность автоматически задавать свойству alpha для всех атомов строки, основанных на формате элемента, указанное значение Number.

Указывает значение альфа-прозрачности заданного объекта. Допустимые значения находятся в диапазоне 0 (полностью прозрачный) — 1 (полностью непрозрачный). Значение по умолчанию 1. Экранные объекты, для которых значение alpha равно 0, являются активными, несмотря на невидимость.

Значение по умолчанию — 1,0.

См. также

Указывает смещение базовой линии для элемента, в пикселах.

Элемент смещается с dominantBaseline на это расстояние. Сдвиг добавляется к положение по оси у членов элемента, поэтому в невращаемом тексте положительное смещение базовой линии сдвигает элемент вниз, а отрицательное — вверх.

Значение по умолчанию 0,0, что указывает на отсутствие смещения.

Возможный разрыв строки в тексте. Это свойство определяет, какие символы могут использоваться для разрыва, когда обтекающий текст разбивается на несколько строк. Используйте константы flash.text.engine.BreakOpportunity для этого свойства.

Значение по умолчанию — flash.text.engine.BreakOpportunity.AUTO.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Указывает цвет текста. Целое число, содержащее три 8-разрядных компонента RGB; например, 0xFF0000 — это красный, 0x00FF00 — это зеленый.

Значение по умолчанию — 0x000000, то есть, проигрыватель Flash Player использует черный цвет.

Регистр цифр в тексте. Регистр цифр влияет на стиль и расположение групп числовых символов. Используйте константы flash.text.engine.DigitCase для этого свойства.

Значение по умолчанию — flash.text.engine.DigitCase.DEFAULT.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Ширина цифр в тексте. Используйте константы flash.text.engine.DigitWidth для этого свойства.

Значение по умолчанию — flash.text.engine.DigitWidth.DEFAULT.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Указывает, какая из базовых линий элемента выравнивается по alignmentBaseline для определения вертикальной позиции элемента в строке. Используйте константы flash.text.engine.TextBaseline для этого свойства.

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

Значение по умолчанию — flash.text.engine.TextBaseline.ROMAN.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Объект, включающий свойства, необходимые для описания шрифта.

Значением по умолчанию является объект FontDescription, созданный по умолчанию.

См. также

Размер точки текста.

Значение по умолчанию — 12,0.

Кернинг текста. Используйте константы flash.text.engine.Kerning для этого свойства. Кернинг регулирует количество пикселов между определенными парами символов с целью улучшения удобочитаемости текста. Кернинг поддерживается для всех шрифтов, имеющих таблицы кернинга.

Значение по умолчанию — flash.text.engine.Kerning.ON.

В качестве значений этого свойства используйте следующие строковые значения:

Лигатура в тексте. Лигатура возникает, когда две или более литеры объединяются в один глиф. Лигатуры обычно заменяют последовательные символы с общими компонентами, такие как пары букв "fi", "fl" или "ae". Они используются как с латинскими, так и с нелатинскими наборами символов. Используйте константы flash.text.engine.LigatureLevel для этого свойства.

Значение по умолчанию — flash.text.engine.LigatureLevel.COMMON.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Локаль текста. Управляет преобразованием регистра и формированием. Используются стандартные идентификаторы локали. Например "en", "en_US" и "en-US" относятся к английскому, а "ja" — к японскому.

Значение по умолчанию равно "en".

Задает вращение, применяемое к отдельным глифам символа. Используйте константы flash.text.engine.TextRotation для этого свойства.

Значение по умолчанию — flash.text.engine.TextRotation.AUTO.

Конечный поворот любого глифа является суммой ElementFormat.textRotation, ContentElement.textRotation и TextBlock.lineRotation.

ElementFormat.textRotation обычно применяется для восточно-азиатского текста, где символы должны поворачиваться для правильного отображения в вертикальной раскладке: значение flash.text.engine.TextRotation.AUTO используется в сочетании с TextBlock.lineRotation = flash.text.engine.ROTATE_90.

Определение этого свойства для шрифтов, не содержащих сведений о вертикальной раскладке, может дать нежелательные результаты. Шрифты, содержащие таблицу vmtx или VORG, такие как японский шрифт "MS Mincho", работают правильно, так как эти таблицы предоставляют данные, необходимые процессору раскладки. Такие шрифты, как Verdana, не содержащие необходимой информации, работают неправильно.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

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

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

Значение по умолчанию 0,0.

Пример:

       //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;
  

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

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

Значение по умолчанию 0,0.

Пример:

       //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;
  

Регистр текста. Используйте константы flash.text.engine.TypographicCase для этого свойства.

Значение по умолчанию — flash.text.engine.TypographicCase.DEFAULT.

В качестве значений этого свойства используйте следующие строковые значения:

См. также

Создает объект ElementFormat.

Возвращает объект FontMetrics со свойствами, описывающими emBox, положение зачеркивания, толщину зачеркивания, положение подчеркивания, толщину подчеркивания и шрифта, заданного fontDescription и fontSize.

См. также

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);
            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;
            
        }
    }    
}