Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.text.engine 

FontDescription  - AS3

Пакетflash.text.engine
Классpublic final class FontDescription
НаследованиеFontDescription Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Класс FontDescription представляет информацию, необходимую для описания шрифта.

Объект FontDescription применен к объекту ElementFormat, который в свою очередь применяется к ContentElement в TextBlock. После применения объекта FontDescription к объекту ElementFormat для его свойства locked задается значение true. Изменение свойств заблокированного объекта FontDescription невозможно. Вместо этого необходимо использовать метод clone() для создания разблокированной копии объекта, который можно изменить и присвоить объекту ElementFormat.

Примечание. Механизм визуализации текста FTE (Flash Text Engine) не поддерживает шрифты Type 1 или растровые шрифты, такие как Type 3, ATC, sfnt-wrapped CID или Naked CID.

Посмотреть примеры

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



Общедоступные свойства
 СвойствоОпределено
  cffHinting : String
Тип используемого для текста хинтинга CFF.
FontDescription
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  fontLookup : String
Задает способ поиска шрифта.
FontDescription
  fontName : String
Имя используемого шрифта или разделенный запятой список имен шрифтов.
FontDescription
  fontPosture : String
Задает начертание шрифта.
FontDescription
  fontWeight : String
Задает толщину шрифта.
FontDescription
  locked : Boolean
Определяет, является ли объект FontDescription заблокированным.
FontDescription
  renderingMode : String
Режим визуализации, используемый для данного текста.
FontDescription
Общедоступные методы
 МетодОпределено
  
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Создает объект FontDescription.
FontDescription
  
Создание разблокированной клонированной копии объекта FontDescription.
FontDescription
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
[статические] Возвращает true, если доступен применимый шрифт устройства с указанными значениями fontName, fontWeight и fontPosture.
FontDescription
  
isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
[статические] Возвращает значение true, если доступен встроенный шрифт с указанными свойствами fontName, fontWeight и fontPosture, где Font.fontType — это flash.text.FontType.EMBEDDED_CFF.
FontDescription
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

cffHinting

свойство
cffHinting:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Тип используемого для текста хинтинга CFF. Используйте константы CFFHinting для этого свойства. Это свойство применяется, только если свойство RenderingMode текста имеет значение RenderingMode.CFF.

Используемый тип хинтинга CFF (компактного формата шрифтов) определяет, должна ли среда выполнения Flash принудительно вписывать горизонтальные основы в подпискельную сетку ли время выполнения Flash сильные горизонтальные основы поместиться к подпиксельной сетке или нет.

Применяется только к встроенным шрифтам.

По умолчанию используется значение CFFHinting.HORIZONTAL_STEM.

Для свойства CFFHinting можно использовать следующие константы класса CFFHinting.

Строковое значениеОписание
CFFHinting.NONEЗадает отсутствие хинтинга CFF. Горизонтальные основы глифов не привязываются к подпиксельной сетке. Этот параметр подходит для анимации или для шрифтов большого размера.
CFFHinting.HORIZONTAL_STEMЗадает хинтинг CFF. Сильные горизонтальные основы вписываются в подпиксельную сетку на экране. Чтобы использовать этот параметр, свойство RenderingMode должно иметь значение RenderingMode.CFF.



Реализация
    public function get cffHinting():String
    public function set cffHinting(value:String):void

Выдает
ArgumentError — Если задано значение, не являющееся элементом класса CFFHinting.
 
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

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

fontLookup

свойство 
fontLookup:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Задает способ поиска шрифта.

По умолчанию используется значение FontLookup.DEVICE.

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

Строковое значениеОписание
FontLookup.DEVICEДля визуализации текста среда выполнения ищет шрифт устройства с заданным свойством name в локальной системе.
FontLookup.EMBEDDED_CFFДля визуализации текста среда выполнения ищет встроенный шрифт CFF с заданными свойством name. Рассматриваются только шрифты типа flash.text.Font.fontType.EMBEDDED_CFF. Если заданный шрифт CFF не встроен в приложение, среда выполнения пытается использовать резервный шрифт устройства для каждого глифа. Этот метод менее эффективен, чем изначальный выбор шрифта устройства.



Реализация
    public function get fontLookup():String
    public function set fontLookup(value:String):void

Выдает
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

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

fontName

свойство 
fontName:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Имя используемого шрифта или разделенный запятой список имен шрифтов. Среда выполнения визуализирует элемент с помощью первого доступного шрифта в списке. Например, если задать «Arial, Helvetica, _sans», то проигрыватель сначала выполняет поиск Arial, затем Helvetica, если Arial не обнаружен, а потом _sans, если не обнаружен ни тот, ни другой.

Среда выполнения Flash поддерживает три общих имени шрифтов устройства: _sans (для шрифтов sans serif), _serif (для шрифтов serif) и _typewriter (для моноширинных шрифтов). Они соотносятся с определенными шрифтами устройств в зависимости от платформы.

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

Среда выполнения Flash обеспечивает резервные шрифты для глифов, которых нет в выбранном шрифте. Независимо от того, встроен используемый шрифт или нет, если глиф не найден в данном шрифте, среда выполнения пытается визуализировать его с использованием другого шрифта устройства, который может содержать нужный глиф.



Реализация
    public function get fontName():String
    public function set fontName(value:String):void

Выдает
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

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

fontPosture

свойство 
fontPosture:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Задает начертание шрифта.

По умолчанию используется значение FontPosture.NORMAL.

Чтобы установить значения для этого свойства, используйте следующие константы класса FontPosture.

ЗначениеОписание
FontPosture.NORMALОбычное начертание шрифта.
FontPosture.ITALICКурсивное начертание шрифта.



Реализация
    public function get fontPosture():String
    public function set fontPosture(value:String):void

Выдает
ArgumentError — Если задано значение, не являющееся элементом класса FontPosture.
 
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

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

fontWeight

свойство 
fontWeight:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Задает толщину шрифта.

По умолчанию используется значение FontWeight.NORMAL.

Чтобы установить значения для этого свойства, используйте следующие константы класса FontWeight.

Строковое значениеОписание
FontWeight.NORMALОбычная толщина шрифта.
FontWeight.BOLDПолужирная толщина шрифта.



Реализация
    public function get fontWeight():String
    public function set fontWeight(value:String):void

Выдает
ArgumentError — Если задано значение, не являющееся элементом класса FontWeight.
 
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

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

locked

свойство 
locked:Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5., Flash Lite 4

Определяет, является ли объект FontDescription заблокированным. Если задано значение true, изменение объекта FontDescription невозможно. Вызовите метод FontDescription.clone() для получения разблокированной копии объекта FontDescription.



Реализация
    public function get locked():Boolean
    public function set locked(value:Boolean):void

Выдает
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

renderingMode

свойство 
renderingMode:String

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Режим визуализации, используемый для данного текста. Используйте константы RenderingMode для этого свойства.

Применяется только к встроенным шрифтам.

По умолчанию используется значение RenderingMode.CFF.

Чтобы установить значения для этого свойства, используйте следующие константы класса RenderingMode.

Строковое значениеОписание
RenderingMode.NORMALПрименяет обычную визуализацию текста, которая соответствует типу визуализации, используемому в Flash Player 7 и более ранних версиях.
RenderingMode.CFFПрименяет визуализацию CFF (компактного формата шрифтов), которая делает текст более четким. (Эта функция стала доступной в проигрывателе Flash Player 10.) Визуализация CFF обеспечивает высококачественную визуализацию шрифтов мелкого размера.



Реализация
    public function get renderingMode():String
    public function set renderingMode(value:String):void

Выдает
ArgumentError — Если задано значение, не являющееся элементом класса RenderingMode.
 
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true).

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

Сведения о конструкторе

FontDescription

()Конструктор
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

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

Параметры
fontName:String (default = "_serif") — Имя используемого шрифта или разделенный запятой список имен шрифтов.
 
fontWeight:String (default = "normal") — Задает толщину шрифта.
 
fontPosture:String (default = "normal") — Задает начертание шрифта.
 
fontLookup:String (default = "device") — Задает метод поиска шрифта.
 
renderingMode:String (default = "cff") — Режим визуализации, используемый для данного текста. Используйте константы RenderingMode для этого свойства.
 
cffHinting:String (default = "horizontalStem") — Тип хинтинга CFF (компактного формата шрифтов), используемый для этого текста. Используйте константы CFFHinting для этого свойства.

Выдает
ArgumentError — Заданное значение fontWeight не является членом класса FontWeight.
 
ArgumentError — Заданное значение fontPosture не является членом класса FontPosture.
 
ArgumentError — Заданное значение fontLookup не является членом класса FontLookup.
 
ArgumentError — Заданное значение renderingMode не является членом класса RenderingMode.
 
ArgumentError — Заданное значение cffHinting не является членом класса CFFHinting.
Сведения о методе

clone

()метод
public function clone():FontDescription

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Создание разблокированной клонированной копии объекта FontDescription.

Возвращает
FontDescription — Разблокированная копия объекта FontDescription.

Пример  ( Использование этого примера )

В этом примере создается объект FontDescription, ему назначается шрифт устройства, задаются разные свойства шрифта и назначается новый объект (и таким образом блокируется) объекту ElementFormat. Создается новый объект TextElement с использованием ElementFormat, затем этотTextElement используется в качестве содержимого для объекта TextBlock. Из объекта TextBlock создается текстовая строка.

Для изменения объекта FontDescription сначала проверьте его свойство locked. Если значение true, используйте метод clone() для создания разблокированной копии объекта FontDescription, измените его свойства и назначьте его новому объекту ElementFormat. Затем повторно создайте связь нового объекта ElementFormat и объекта TextBlock. При повторной разбивке строк новые строки получат новые параметры шрифтов.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontDescription_cloneExample extends Sprite {
        private var fd:FontDescription;
        private var fd2:FontDescription;
        
        public function FontDescription_cloneExample():void {
            fd = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;
            fd.fontPosture = flash.text.engine.FontPosture.ITALIC;

            var ef1:ElementFormat = new ElementFormat(fd);
            
            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);
            
            fd2 = (fd.locked) ? fd.clone() : fd;    
            fd2.fontWeight = flash.text.engine.FontWeight.NORMAL;
            var ef2:ElementFormat = new ElementFormat(fd2);

            tb.content.elementFormat=ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            
        }
    }    
}

isDeviceFontCompatible

()метод 
public static function isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2

Возвращает true, если доступен применимый шрифт устройства с указанными значениями fontName, fontWeight и fontPosture.

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

Параметры

fontName:String — Имя проверяемого шрифта устройства.
 
fontWeight:String — Задает толщину шрифта. Используйте FontWeight.
 
fontPosture:String — Задает начертание шрифта. Используйте FontPosture.

Возвращает
Boolean — Значение true, если доступен совместимый шрифт устройства, в противном случае, значение — false.

Выдает
ArgumentError — Заданное значение fontWeight не является членом класса FontWeight.
 
ArgumentError — Заданное значение fontPosture не является членом класса FontPosture.

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

isFontCompatible

()метод 
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Возвращает значение true, если доступен встроенный шрифт с указанными свойствами fontName, fontWeight и fontPosture, где Font.fontType — это flash.text.FontType.EMBEDDED_CFF. Начиная с Flash Player 10, в содержимом приложения могут отображаться два вида встроенных шрифтов. Обычные встроенные шрифты используются только объектами TextField. Встроенные шрифты CFF используются только классами flash.text.engine. Два типа различаются свойством fontType класса Font, возвращенным функцией enumerateFonts().

Классы flash.text.engine не могут использовать шрифты типа EMBEDDED. Если fontLookup имеет значение FontLookup.EMBEDDED_CFF в среде выполнения единственным доступным шрифтом с заданным именем и стилем является шрифт типа EMBEDDED, среда выполнения использует шрифты устройства и визуализирует текст глиф за глифом, как будто в файле нет встроенного шрифта с заданным именем и стилем.

Если имеются шрифты EMBEDDED и EMBEDDED_CFF с одинаковым именем и стилем, выбирается шрифт типа EMBEDDED_CFF, и для визуализации текста используется шрифт EMBEDDED_CFF.

Параметры

fontName:String — Имя проверяемого встроенного шрифта.
 
fontWeight:String — Задает толщину шрифта. Используйте FontWeight.
 
fontPosture:String — Задает начертание шрифта. Используйте FontPosture.

Возвращает
Boolean — Значение true, если доступен совместимый встроенный шрифт, в противном случае, значение — false.

Выдает
ArgumentError — Заданное значение fontWeight не является членом класса FontWeight.
 
ArgumentError — Заданное значение fontPosture не является членом класса FontPosture.

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

FontDescriptionExample.as

В этом примере создается объект FontDescription, ему назначается шрифт устройства, задаются разные свойства шрифта и назначается новый объект объекту ElementFormat. Дополнительное форматирование шрифта выполняется с помощью ElementFormat. Создается новый объект TextElement с использованием ElementFormat, затем этотTextElement используется в качестве содержимого для объекта TextBlock. Из объекта TextBlock создается текстовая строка.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontDescriptionExample extends Sprite {
        
        public function FontDescriptionExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;
            fd.fontPosture = flash.text.engine.FontPosture.ITALIC;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 30;
            ef1.color = 0xFF0000;
            
            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);
            
        }
    }    
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.