UITextFormat

Пакет	mx.core
Класс	public class UITextFormat
Наследование	UITextFormat TextFormat Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс UITextFormat представляет данные форматирования символов класса UITextField. Класс UITextField определяет компонент, используемый многими составными компонентами Flex для отображения текста.

Класс UITextFormat расширяет класс flash.text.TextFormat для загрузки методов измерения текста measureText() и measureHTMLText(), а также для добавления свойств, контролирующих расширенное сглаживание шрифтов.

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

mx.core.UITextField

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		align : String Обозначает выравнивание абзаца.	TextFormat
		antiAliasType : String Определяет параметры сглаживания для класса UITextField.	UITextFormat
		blockIndent : Object Указывает отступ блока в пикселях.	TextFormat
		bold : Object Определяет, является ли текст полужирным.	TextFormat
		bullet : Object Показывает, что текст является частью маркированного списка.	TextFormat
		color : Object Указывает цвет текста.	TextFormat
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		direction : String Направленность текста.	UITextFormat
		font : String Имя шрифта для текста в данном текстовом формате (в виде строки).	TextFormat
		gridFitType : String Определяет параметр подгонки к сетке для класса UITextField.	UITextFormat
		indent : Object Указывает отступ от левого поля до первого символа в абзаце.	TextFormat
		italic : Object Показывает, выделен ли текст в данном текстовом формате курсивом.	TextFormat
		kerning : Object Логическое значение, указывающее использование кернинга (true — включено и false — отключено).	TextFormat
		leading : Object Целое число, представляющее величину промежутка между строками по вертикали (так называемый междустрочный интервал).	TextFormat
		leftMargin : Object Левое поле абзаца (в пикселях).	TextFormat
		letterSpacing : Object Число, представляющее величину пространства, равномерно распределяемого между всеми символами.	TextFormat
		locale : String Локаль текста.	UITextFormat
		moduleFactory : IFlexModuleFactory Объект moduleFactory, использованный для создания полей TextField для встроенных шрифтов.	UITextFormat
		rightMargin : Object Правое поле абзаца (в пикселях).	TextFormat
		sharpness : Number Определяет параметр резкости для класса UITextField.	UITextFormat
		size : Object Размер текста в пикселях в данном текстовом формате.	TextFormat
		tabStops : Array Задает пользовательские позиции табуляции в виде массива неотрицательных целых чисел.	TextFormat
		target : String Указывает целевое окно, где отображается гиперссылка.	TextFormat
		thickness : Number Определяет параметр толщины для класса UITextField.	UITextFormat
		underline : Object Показывает, является ли текст в этом текстовом формате подчеркнутым: да (true) или нет (false).	TextFormat
		url : String Указывает целевой URL-адрес для текста в данном текстовом формате.	TextFormat
		useFTE : Boolean = false Определяет способ измерения текста для методов measureText() и measureHTMLText().	UITextFormat

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		UITextFormat(systemManager:ISystemManager, font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null) Конструктор.	UITextFormat
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		measureHTMLText(htmlText:String, roundUp:Boolean = true):flash.text:TextLineMetrics Возвращает данные измерения для указанного текста HTML, который может содержать HTML-теги, например <font> и <b>. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяющего его формат.	UITextFormat
		measureText(text:String, roundUp:Boolean = true):flash.text:TextLineMetrics Возвращает данные измерения для указанного текста. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяющего его формат.	UITextFormat
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Сведения о свойстве

antiAliasType

свойство

public var antiAliasType:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет параметры сглаживания для класса UITextField. Возможными значениями являются normal (flash.text.AntiAliasType.NORMAL) и advanced (flash.text.AntiAliasType.ADVANCED).

Значение по умолчанию равно advanced и обеспечивает расширенное сглаживание для встроенного шрифта. Установите значение normal для отключения расширенного сглаживания.

Это свойство не влияет на системные шрифты.

Этот стиль применяется ко всему тексту в объекте UITextField, и его невозможно применить выборочно только к некоторым символам.

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

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

flash.text.AntiAliasType

direction

свойство

public var direction:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Направленность текста.

Допустимые значения – ltr для текста, записываемого слева направо, как в гарнитурах латинского стиля, и rtl для текста, записываемого справа налево, как в арабском и иврите.

FTE и TLF используют это значение в алгоритме двухстороннего макета текста, который сопоставляет последовательность символов «Юникод» с последовательностью глифов.

Примечание. Этот стиль применяется только в том случае, если этот формат UITextFormat используется с UIFTETextField, а не с UITextField.

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

gridFitType

свойство

public var gridFitType:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет параметр подгонки к сетке для класса UITextField. Допустимыми значениями являются none (flash.text.GridFitType.NONE), pixel (flash.text.GridFitType.PIXEL) и subpixel (flash.text.GridFitType.SUBPIXEL).

Это свойство применяется только при использовании вложенного шрифта и при установке свойства fontAntiAliasType на advanced.

Это свойство не влияет на системные шрифты.

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

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

flash.text.GridFitType

locale

свойство

public var locale:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Локаль текста.

FTE и TLF используют этот языковой стандарт для сопоставления символов «Юникод» с глифами шрифтов и поиска резервных шрифтов.

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

moduleFactory

свойство

moduleFactory:IFlexModuleFactory

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект moduleFactory, использованный для создания полей TextField для встроенных шрифтов.

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

sharpness

свойство

public var sharpness:Number

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет параметр резкости для класса UITextField. Это свойство указывает резкость краев глифа. Возможными значениями являются числа от -400 до 400.

Это свойство не влияет на системные шрифты.

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

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

flash.text.TextField

thickness

свойство

public var thickness:Number

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет параметр толщины для класса UITextField. Это свойство указывает толщину границ глифов. Возможные значения – числа от -200 до 200.

Это свойство не влияет на системные шрифты.

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

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

flash.text.TextField

useFTE

свойство

public var useFTE:Boolean = false

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет способ измерения текста для методов measureText() и measureHTMLText().

Если значение равно true, то используется внеэкранный экземпляр класса FTETextField в Text Layout Framework. Если значение равно false, то используется внеэкранный экземпляр класса TextField в Flash Player.

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

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

()

Конструктор

public function UITextFormat(systemManager:ISystemManager, font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null)

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Конструктор.

Параметры

	`systemManager:ISystemManager` — Объект SystemManager. SystemManager отслеживает встроенные шрифты. Обычно этот объект SystemManager получается из свойства `systemManager` для UIComponent.

	`font:String` (default = `null`) — Строка, указывающая имя шрифта или значение `null`, указывающее на то, что значение UITextFormat не указывает данное свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`size:Object` (default = `null`) — Число, указывающее размер шрифта в пикселях или значение `null`, если UITextFormat не содержит это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`color:Object` (default = `null`) — Целое число без знака, указывающее цвет текста в формате RGB (например, 0xFF0000 для красного цвета) или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`bold:Object` (default = `null`) — Логический флаг, указывающий наличие текста, выделенного жирным шрифтом, или значение `null`, если UITextFormat не содержит это свойство Это дополнительный параметр, по умолчанию его значением является `null`.

	`italic:Object` (default = `null`) — Флаг с логическим значением, указывающий на курсив в тексте, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`underline:Object` (default = `null`) — Флаг с логическим значением, указывающий на подчеркивание в тексте, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`url:String` (default = `null`) — Строка, указывающая URL-адрес гиперссылки текста, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`target:String` (default = `null`) — Строка, указывающая целевое окно, в котором отображается URL-адрес гиперссылки. Если целевое окно представлено значением `null` или пустой строкой, то ссылочная страница отображается в то же окне браузера. Если параметр `urlString` имеет значение `null` или равен пустой строке, то свойство не действует. Это дополнительный параметр, по умолчанию его значением является `null`.

	`align:String` (default = `null`) — Строка, указывающая выравнивание абзаца со значением flash.text.TextFormatAlign, или `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`leftMargin:Object` (default = `null`) — Число, указывающее левое поле абзаца в пикселях, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`rightMargin:Object` (default = `null`) — Число, указывающее правое поле абзаца в пикселях, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`indent:Object` (default = `null`) — Число, указывающее отступ от левого поля до первого символа абзаца в пикселях, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

	`leading:Object` (default = `null`) — Число, указывающее размер дополнительного вертикального пространства между строками, или значение `null`, если UITextFormat не указывает это свойство. Это дополнительный параметр, по умолчанию его значением является `null`.

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

flash.text.TextFormatAlign

Сведения о методе

measureHTMLText

()

метод

public function measureHTMLText(htmlText:String, roundUp:Boolean = true):flash.text:TextLineMetrics

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает данные измерения для указанного текста HTML, который может содержать HTML-теги, например <font> и <b>. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяющего его формат.

Параметры

	`htmlText:String` — Строка, определяющая измеряемый HTML-текст.

	`roundUp:Boolean` (default = `true`) — Флаг с логическим значением, определяющий необходимость округления измеренной ширины и высоты до ближайшего целого числа. Округление допустимо в большинстве случаев.

Возвращает

flash.text:TextLineMetrics — Объект TextLineMetrics, содержащий измерения текста.

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

flash.text.TextLineMetrics

measureText

()

метод

public function measureText(text:String, roundUp:Boolean = true):flash.text:TextLineMetrics

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает данные измерения для указанного текста. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяющего его формат.

Параметры

	`text:String` — Строка, содержащая измеряемый текст.

	`roundUp:Boolean` (default = `true`) — Флаг с логическим значением, определяющий необходимость округления измеренной ширины и высоты до ближайшего целого числа. Округление допустимо в большинстве случаев.

Возвращает

flash.text:TextLineMetrics — Объект TextLineMetrics, содержащий измерения текста.

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

flash.text.TextLineMetrics

Юридическая информация | Политика конфиденциальности онлайн

UITextFormat - AS3 Flex

Пакетыx

Элементы языка

Приложения

Пакет mx.core

antiAliasType

direction

gridFitType

locale

moduleFactory

sharpness

thickness

useFTE

UITextFormat

measureHTMLText

measureText