| Пакет | flashx.textLayout.factory |
| Класс | public class StringTextLineFactory |
| Наследование | StringTextLineFactory TextLineFactoryBase Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Текстовые строки являются статическими и создаются с применением единого формата и единого абзаца. Создаваемые строки умещаются в указанном ограничивающем прямоугольнике.
Класс StringTextLineFactory обеспечивает эффективный способ создания элементов TextLine, поскольку во многих повторяющихся вызовах в нем многократно используются объекты TextFlow, ParagraphElement, SpanElement и ContainerController. Существует возможность создания отдельной фабрики и ее многократного применения. Также можно многократно использовать все элементы, которые являются одинаковыми при каждом их вызове; например, таким образом могут применяться различные форматы и границы.
Примечание. Для создания статических строк, использующих множество форматов или абзацев, или включающих вложенные графические элементы, применяются объект TextFlow и TextFlowTextLineFactory.
Примечание. При усечении текста StringTextLineFactory игнорирует свойство truncationIndicatorFormat, заданное в truncationOptions.
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
![]() | compositionBounds : Rectangle
Прямоугольник, внутри которого создаются текстовые строки. | TextLineFactoryBase | |
| configuration : IConfiguration [только для чтения]
Конфигурация, используемая внутренним объектом TextFlow. | StringTextLineFactory | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| defaultConfiguration : IConfiguration [статические] [только для чтения]
Конфигурация по умолчанию, используемая данной фабрикой, если не задана иная конфигурация. | StringTextLineFactory | ||
![]() | horizontalScrollPolicy : String
Указывает способ создания строк в случае, если границы компоновки недостаточно велики. | TextLineFactoryBase | |
![]() | isTruncated : Boolean [только для чтения]
Указывает, был ли текст усечен при последней операции создания строк. | TextLineFactoryBase | |
| paragraphFormat : flashx.textLayout.formats:ITextLayoutFormat
Формат абзаца. | StringTextLineFactory | ||
| spanFormat : flashx.textLayout.formats:ITextLayoutFormat
Формат символа. | StringTextLineFactory | ||
![]() | swfContext : ISWFContext
Экземпляр ISWFContext, используемый для создания, при необходимости, вызовов FTE. | TextLineFactoryBase | |
| text : String
Текст, преобразуемый в объекты TextLine. | StringTextLineFactory | ||
| textFlowFormat : flashx.textLayout.formats:ITextLayoutFormat
Формат текстового потока. | StringTextLineFactory | ||
![]() | truncationOptions : flashx.textLayout.factory:TruncationOptions
Указывает параметры усечения текста, если он не умещается в границах компоновки. | TextLineFactoryBase | |
![]() | verticalScrollPolicy : String
Указывает способ создания строк в случае, если границы компоновки недостаточно велики. | TextLineFactoryBase | |
| Метод | Определено | ||
|---|---|---|---|
StringTextLineFactory(configuration:IConfiguration = null)
Создает объект StringTextLineFactory. | StringTextLineFactory | ||
Создает объекты TextLine с использованием текста, назначенного этому объекту фабрики в текущий момент. | StringTextLineFactory | ||
![]() |
Наименьший прямоугольник, в котором может уместиться размещаемое содержимое. | TextLineFactoryBase | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
configuration | свойство |
configuration:IConfiguration [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конфигурация, используемая внутренним объектом TextFlow.
Реализация
public function get configuration():IConfigurationdefaultConfiguration | свойство |
defaultConfiguration:IConfiguration [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конфигурация по умолчанию, используемая данной фабрикой, если не задана иная конфигурация.
Реализация
public static function get defaultConfiguration():IConfigurationparagraphFormat | свойство |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Формат абзаца.
Реализация
public function get paragraphFormat():flashx.textLayout.formats:ITextLayoutFormat public function set paragraphFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidspanFormat | свойство |
spanFormat:flashx.textLayout.formats:ITextLayoutFormat| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Формат символа.
Реализация
public function get spanFormat():flashx.textLayout.formats:ITextLayoutFormat public function set spanFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidtext | свойство |
text:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Текст, преобразуемый в объекты TextLine.
Для создания объектов TextLine вызовите createTextLines() после установки данного свойства text и требуемых форматов.
Реализация
public function get text():String public function set text(value:String):voidtextFlowFormat | свойство |
textFlowFormat:flashx.textLayout.formats:ITextLayoutFormat| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Формат текстового потока.
Реализация
public function get textFlowFormat():flashx.textLayout.formats:ITextLayoutFormat public function set textFlowFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidStringTextLineFactory | () | Конструктор |
public function StringTextLineFactory(configuration:IConfiguration = null)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Создает объект StringTextLineFactory.
Параметрыconfiguration:IConfiguration (default = null) — Объект конфигурации, используемый для установки свойств внутреннего объекта TextFlow, применяемого для компоновки строк, создаваемых данной фабрикой.
|
createTextLines | () | метод |
public function createTextLines(callback:Function):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Создает объекты TextLine с использованием текста, назначенного этому объекту фабрики в текущий момент.
Текстовые строки создаются с использованием текста и форматов, назначенных в текущий момент, и компонуются для размещения в границах, назначенных в свойстве compositionBounds. По мере создания каждой строки фабрика обеспечивает вызов функции, заданной в параметре callback. Эта функция получает объект TextLine и применяется для отображения строки.
Для создания отличающегося набора строк измените любое свойство в соответствии с имеющимися требованиями и вновь вызовите метод createTextLines().
Обратите внимание на то, что политика прокрутки factory определяет, сколько строк генерируется.
Параметры
callback:Function — Функция обратного вызова, вызываемая для каждого созданного объекта TextLine.
|
createTextLines() вызывается дважды с использованием одной и той же фразы. Между вызовами выполняется корректировка свойств фабрики для создания эффекта «отбрасывания тени».
package flashx.textLayout.factory.examples {
import flash.display.DisplayObject;
import flash.display.Sprite;
import flash.geom.Rectangle;
import flashx.textLayout.factory.StringTextLineFactory;
import flashx.textLayout.formats.TextLayoutFormat;
public class StringTextLineFactory_example extends Sprite
{
public function StringTextLineFactory_example()
{
var factory:StringTextLineFactory = new StringTextLineFactory();
factory.compositionBounds = new Rectangle( 100, 100, 200, 130 );
var format:TextLayoutFormat = new TextLayoutFormat();
format.fontFamily = "LilyUPC, Verdana, _sans";
format.fontSize = 32;
format.color = 0x000000;
format.textAlpha = .5;
factory.spanFormat = format;
factory.text = "The quick brown fox jumped over the lazy dog.";
factory.createTextLines( useTextLines );
factory.compositionBounds = new Rectangle( 99, 99, 200, 130 );
format.color = 0x990000;
format.textAlpha = 1;
factory.spanFormat = format;
factory.createTextLines( useTextLines );
graphics.beginFill(0x555555,.5);
graphics.drawRect( 99, 99, 201, 131 );
graphics.endFill();
}
private function useTextLines( line:DisplayObject ):void
{
var displayObject:DisplayObject = this.addChild( line );
}
}
}
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства