| Пакет | flash.text.engine |
| Класс | public final class FontDescription |
| Наследование | FontDescription Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект 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 | ||
![]() | constructor : 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 | ||
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
[статические]
Возвращает true, если доступен применимый шрифт устройства с указанными значениями fontName, fontWeight и fontPosture. | FontDescription | ||
[статические]
Возвращает значение true, если доступен встроенный шрифт с указанными свойствами fontName, fontWeight и fontPosture, где Font.fontType — это flash.text.FontType.EMBEDDED_CFF. | FontDescription | ||
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | 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
В этом примере создается объект 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);
}
}
}
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства