FlowElement  - AS3

TextLayoutFormat: определяет базовую линию, по которой выравнивается основная базовая линия. Например, если значение dominantBaseline установлено на ASCENT, то установка alignmentBaseline на DESCENT выравнивает верхнюю границу текста по базовой линии DESCENT или под строкой. Как правило, базовые линии определяет наибольший элемент в строке.

Допустимые значения: TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, TextBaseline.USE_DOMINANT_BASELINE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TextBaseline.USE_DOMINANT_BASELINE.

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

TextLayoutFormat: альфа-значение (прозрачности) для фона (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). При значении 0 обеспечивается полная прозрачность, а при значении 1 — полная непрозрачность. Экранные объекты, для которых значение alpha равно 0, являются активными, несмотря на невидимость.

Допустимые значения: числа от 0 до 1 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если undefined, в процессе каскада свойство получает значение 1.

TextLayoutFormat: цвет фона (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). Может иметь либо постоянное значение BackgroundColor.TRANSPARENT, либо шестнадцатеричное значение, задающее три 8-разрядных значения RGB (красный, зеленый, синий); например 0xFF0000 для красного и 0x00FF00 для зеленого.

Допустимые строковые значения: BackgroundColor.TRANSPARENT, FormatValue.INHERIT и переменные uint от 0x0 до 0xffffffff.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение BackgroundColor.TRANSPARENT.

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

TextLayoutFormat: величина сдвига базовой линии от значения dominantBaseline. Единицей измерения являются пиксели или процент от fontSize (в этом случае вводится строковое значение, например, 140%). Положительные значения сдвигают строку вверх для горизонтального текста (вправо для вертикального), а отрицательные значения сдвигают ее вниз для горизонтального текста (влево для вертикального).

Допустимые значения: BaselineShift.SUPERSCRIPT, BaselineShift.SUBSCRIPT, FormatValue.INHERIT.

Допустимые числовые значения — от -1000 до 1000.

Допустимые процентные значения: от -1000 до 1000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.0.

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

TextLayoutFormat: определяет вертикальное или горизонтальное размещение строки. Строки располагаются либо сверху вниз BlockProgression.TB (используется для горизонтального текста), либо справа налево BlockProgression.RL (используется для вертикального текста).

Допустимые значения: BlockProgression.RL, BlockProgression.TB, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение BlockProgression.TB.

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

TextLayoutFormat: управляет местом разрыва строк при форматировании текста по размеру окна. Установите значение BreakOpportunity.AUTO для стандартного разрыва строк. Установите значение BreakOpportunity.NONE для предотвращения разрыва строк до тех пор, пока текст не превысит допустимых размеров, при этом в самом тексте будут отсутствовать заданные места разрыва. Установите значение BreakOpportunity.ANY для разрешения разрыва строки в любом месте, не только между словами. Установите значение BreakOpportunity.ALL, чтобы каждая группа символов находилась в отдельной строке (рекомендуется использовать для текста по контуру).

Допустимые значения: BreakOpportunity.ALL, BreakOpportunity.ANY, BreakOpportunity.AUTO, BreakOpportunity.NONE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение BreakOpportunity.AUTO.

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

TextLayoutFormat: тип используемого для текста хинтинга CFF. Тип подсказки CFF определяет, будет ли среда выполнения Flash в принудительном порядке привязывать жирные горизонтальные основы к субпиксельной сетке. Это свойство применяется только в том случае, если для свойства renderingMode установлено значение RenderingMode.CFF, и используется встроенный шрифт (для свойства fontLookup установлено значение FontLookup.EMBEDDED_CFF). На экранах небольшого размера хинтинг создает для читателей четкий и удобочитаемый текст.

Допустимые значения: CFFHinting.NONE, CFFHinting.HORIZONTAL_STEM, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение CFFHinting.HORIZONTAL_STEM.

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

TextLayoutFormat: определяет тип обтекания текста вокруг плавающего объекта. При выборе значения none промежуток между обтекающим текстом и плавающим объектом будет минимальным. При выборе значения left текст будет обтекать любую область контейнера с плавающим объектом слева; при выборе значения right текст будет обтекать любую область контейнера с плавающим объектом справа. При выборе значения both текст будет обтекать все плавающие объекты.

Допустимые значения: ClearFloats.START, ClearFloats.END, ClearFloats.LEFT, ClearFloats.RIGHT, ClearFloats.BOTH, ClearFloats.NONE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение ClearFloats.NONE.

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

TextLayoutFormat: цвет текста. Шестнадцатеричное число, содержащее три 8-разрядных значения RGB (красный, зеленый, синий); например, 0xFF0000 для красного и 0x00FF00 для зеленого.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

TextLayoutFormat: число текстовых колонок (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). Количество колонок отменяет другие параметры настройки колонки. Значение представляет собой целое число или FormatValue.AUTO, если не указано. Если columnCount не указан, то columnWidth используется для создания максимального количества колонок в контейнере.

Допустимые строковые значения: FormatValue.AUTO, FormatValue.INHERIT и переменные int от 1 до 50.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: указывает размер средника между колонками в пикселях (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). Значение представляет собой число

Допустимые значения: числа от 0 до 1000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если undefined, в процессе каскада свойство получает значение 20.

TextLayoutFormat: ширина колонки в пикселях (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). Если указана ширина колонок, но не указано их количество, то TextLayout создает максимально возможное количество колонок этой ширины при заданной ширине контейнера и настройке columnGap. Все оставшееся пространство будет располагаться за последней колонкой. Значение представляет собой число.

Допустимые строковые значения: FormatValue.AUTO, FormatValue.INHERIT и числа от 0 до 8000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение FormatValue.AUTO.

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

Возвращает вычисленные атрибуты формата, являющиеся действующими для этого элемента. Принимает во внимание наследование атрибутов из родительских элементов.

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

Возвращает coreStyles в этот FlowElement. Обратите внимание, что получатель создает копию базового словаря стилей. Объект coreStyles инкапсулирует форматы, определенные в TextLayoutFormat и содержащиеся в TextLayoutFormat.description. Объект coreStyles состоит из массива пар имя стиля-значение.

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

TextLayoutFormat: тип регистра цифр, используемого для текста. Установка значения на DigitCase.OLD_STYLE позволяет изменить размер букв на примерно соответствующий размеру строчных букв в нижнем или верхнем регистрах. Цифры располагаются пропорционально. Этот стиль доступен только в некоторых шрифтах, обычно в дополнительном или экспертном шрифте. Параметр DigitCase.LINING определяет высоту верхнего регистра, обычно является моноширинным и служит для выравнивания текста в диаграммах.

Допустимые значения: DigitCase.DEFAULT, DigitCase.LINING, DigitCase.OLD_STYLE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение DigitCase.DEFAULT.

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

TextLayoutFormat: тип ширины цифр, используемых для текста. Может иметь значение DigitWidth.PROPORTIONAL, которое рекомендуется использовать для отдельных чисел, или DigitWidth.TABULAR, используемое для чисел в таблицах, диаграммах и вертикальных строках.

Допустимые значения: DigitWidth.DEFAULT, DigitWidth.PROPORTIONAL, DigitWidth.TABULAR, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение DigitWidth.DEFAULT.

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

TextLayoutFormat: задает уровень двунаправленной вложенности текста в блоке по умолчанию. Направление чтения слева направо, как в сценариях с латинским стилем, или справа налево, как в сценариях с арабским или еврейским. Это свойство также влияет на направление колонки, когда оно применяется на уровне контейнера. Колонки могут быть расположены либо слева направо, либо справа налево, так же, как и текст. Примеры:

Допустимые значения: Direction.LTR, Direction.RTL, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение Direction.LTR.

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

TextLayoutFormat: указывает, какая из базовых линий элемента привязывается к alignmentBaseline для определения позиции элемента в строке по вертикали. Значение TextBaseline.AUTO выделяет доминирующую базовую линию, основывающуюся на свойстве locale родительского абзаца. Для японского и китайского языков значением выделенной базовой линией является TextBaseline.IDEOGRAPHIC_CENTER; для всех других - TextBaseline.ROMAN. Этот выбор базовых линий определяется выбором типа и размера шрифта.

Допустимые значения: FormatValue.AUTO, TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: указывает позицию базовой линии первой строки в контейнере. Базовая линия, к которой относится это свойство, зависит от локали на уровне контейнера. Для японского и китайского языка это — TextBaseline.IDEOGRAPHIC_BOTTOM; для всех других языков — TextBaseline.ROMAN. Смещение от верхнего отступа (или правого отступа, если blockProgression имеет значение RL) контейнера до базовой линии первой строки может иметь значение BaselineOffset.ASCENT, что означает равное верхнему выносному элементу строки, либо BaselineOffset.LINE_HEIGHT, что означает равное высоте этой первой строки, либо любое фиксированное число для указания абсолютного расстояния. Значение BaselineOffset.AUTO выравнивает верхний выносной элемент строки по верхнему отступу контейнера.

Допустимые строковые значения: BaselineOffset.AUTO, BaselineOffset.ASCENT, BaselineOffset.LINE_HEIGHT, FormatValue.INHERIT и числа от 0 до 1000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение BaselineOffset.AUTO.

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

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

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение Arial.

TextLayoutFormat: поиск используемых шрифтов. При указании FontLookup.DEVICE используются шрифты, установленные в системе, в которой выполняется SWF-файл. Использование шрифтов устройства сокращает размер ролика, но в различных системах и платформах текст не всегда отображается одинаково. При указании FontLookup.EMBEDDED_CFF используются контуры шрифтов, встроенные в опубликованный SWF-файл. Встроенные шрифты увеличивают размер файла SWF (иногда значительно), но текст в выбранном шрифте отображается последовательно.

Допустимые значения: FontLookup.DEVICE, FontLookup.EMBEDDED_CFF, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение FontLookup.DEVICE.

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

TextLayoutFormat: размер текста в пикселях.

Допустимые значения: числа от 1 до 720 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 12.

TextLayoutFormat: стиль текста. Можно использовать значение FontPosture.NORMAL для обычного текста или FontPosture.ITALIC для курсивного. Это свойство применяется только к шрифтам устройства (свойство fontLookup устанавливается на flash.text.engine. FontLookup.DEVICE).

Допустимые значения: FontPosture.NORMAL, FontPosture.ITALIC, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение FontPosture.NORMAL.

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

TextLayoutFormat: толщина текста. Может использоваться значение FontWeight.NORMAL для обычного текста или FontWeight.BOLD - для полужирного. Применяется только к шрифтам устройства (свойство fontLookup устанавливается на flash.text.engine. FontLookup.DEVICE).

Допустимые значения: FontWeight.NORMAL, FontWeight.BOLD, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение FontWeight.NORMAL.

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

Свойства TextLayoutFormat, применяются непосредственно к этому элементу.

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

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

Присваивает элементу идентификатор, позволяя задавать стиль для элемента путем ссылки на его id. Например, следующая строка задает цвет для объекта SpanElement, который имеет идентификатор span1:

         textFlow.getElementByID("span1").setStyle("color", 0xFF0000);
         

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

TextLayoutFormat: правило, используемое для выравнивания текста в абзаце. Значением по умолчанию является FormatValue.AUTO, которое выравнивает текст согласно свойству абзаца locale. Для всех языков, кроме японского и китайского, FormatValue.AUTO получает значение JustificationRule.SPACE, которое добавляет к символу пробела дополнительное пространство. Для японского и китайского языков FormatValue.AUTO имеет значение JustficationRule.EAST_ASIAN. Выравнивание частично изменяет интервал между знаками пунктуации. Запятая и японская точка занимают в латинице целый символ, в то время как восточно-азиатском тексте — только половину символа. Кроме того, согласно традиции, в восточно-азиатском тексте интервал между знаками пунктуации должен быть уже, чем между остальными символами. В нижеприведенном примере обратите внимание также на интерлиньяж, который применяется ко второй строке абзаца. В восточноазиатской версии последние две строки смещаются вправо. В латинской версии вторая и последующие строки смещаются влево.

Допустимые значения: JustificationRule.EAST_ASIAN, JustificationRule.SPACE, FormatValue.AUTO, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: стиль используемый для выравнивания абзаца. Используется только вместе с параметром justificationRule для JustificationRule.EAST_ASIAN. Значение по умолчанию FormatValue.AUTO относится к JustificationStyle.PUSH_IN_KINSOKU для всех локалей. Константы, определяемые классом JustificationStyle, указывают параметры обработки символов кинсоку — японских символов, которые не должны появляться в начале и конце строк. Если необходимо получить более разреженный текст, укажите JustificationStyle.PUSH-OUT-ONLY. Если необходимо использовать поведение, подобное тому, что получается при использовании justificationRule JustificationRule.SPACE, укажите JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT.

Допустимые значения: JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT, JustificationStyle.PUSH_IN_KINSOKU, JustificationStyle.PUSH_OUT_ONLY, FormatValue.AUTO, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: кернинг регулирует количество пикселов между определенными парами символов с целью улучшения удобочитаемости текста. Кернинг поддерживается для всех шрифтов, имеющих таблицы кернинга.

Допустимые значения: Kerning.ON, Kerning.OFF, Kerning.AUTO, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение Kerning.AUTO.

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

TextLayoutFormat: указывает модель интерлиньяжа, которая является комбинацией основы и направления интерлиньяжа. Основа межстрочного интервала — это базовая линия, на которую ссылается свойство lineHeight. Направление межстрочного интервала определяет, относится ли свойство lineHeight к расстоянию от базовой линии строки до базовой линии строки, находящейся перед ней или за ней. Значение по умолчанию FormatValue.AUTO определяется на основе свойства абзаца locale. Для японского и китайского языков значение равно LeadingModel.IDEOGRAPHIC_TOP_DOWN, для всех других языков — LeadingModel.ROMAN_UP.

Основа межстрочного интервала:

Направление межстрочного интервала:

Допустимые значения: LeadingModel.ROMAN_UP, LeadingModel.IDEOGRAPHIC_TOP_UP, LeadingModel.IDEOGRAPHIC_CENTER_UP, LeadingModel.IDEOGRAPHIC_TOP_DOWN, LeadingModel.IDEOGRAPHIC_CENTER_DOWN, LeadingModel.APPROXIMATE_TEXT_FIELD, LeadingModel.ASCENT_DESCENT_UP, LeadingModel.BOX, LeadingModel.AUTO, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение LeadingModel.AUTO.

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

TextLayoutFormat: управляет тем, какая лигатура, определенная в шрифте, может использоваться в тексте. Лигатуры для каждого из этих параметров зависят от шрифта. Лигатура возникает, когда две или более литеры объединяются в один глиф. Лигатуры обычно заменяют последовательные символы с общими компонентами, такие как пары букв «fi», «fl» или «ae». Они используются как с латинскими, так и с нелатинскими наборами символов. Лигатуры, активируемые значениями MINIMUM, COMMON, UNCOMMON и EXOTIC являются аддитивными. Каждое значение активирует новый набор лигатур, при этом включая в себя все предыдущие типы.

Примечание. При работе со шрифтами арабского или сирийского языка для ligatureLevel устанавливается значение MINIMUM или выше.

Допустимые значения: LigatureLevel.MINIMUM, LigatureLevel.COMMON, LigatureLevel.UNCOMMON, LigatureLevel.EXOTIC, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение LigatureLevel.COMMON.

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

TextLayoutFormat: управляет переносом слов в контейнере (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). Текст в контейнере можно настроить по ширине контейнера (LineBreak.TO_FIT), либо установить разрыв только при наличии символов возврата каретки или символов перевода строки (LineBreak.EXPLICIT).

Допустимые значения: LineBreak.EXPLICIT, LineBreak.TO_FIT, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение LineBreak.TO_FIT.

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

TextLayoutFormat: управление интерлиньяжем текста. Расстояние от базовой линии предыдущей или следующей строки (в зависимости от LeadingModel) до базовой линии текущей строки равно максимальному межстрочному интервалу, применяемому в отношении любого символа в строке. Значение выражается либо числом, либо процентом. При указании процента вводится строковое значение, например, 140%.

Допустимые числовые значения — от -720 до 720.

Допустимые процентные значения: от -1000% до 1000%.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 120%.

TextLayoutFormat: если значение равно true, применяет перечеркивание, размещая линию посередине строки.

Допустимыми значениями являются true, false и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение false.

TextLayoutFormat: определяет атрибуты форматирования для ссылок в нормальном состоянии. Это значение передается вниз по иерархии и применяется ко всем нижестоящим ссылкам. Принимает inherit, ITextLayoutFormat или преобразует массив объектов с ключом и значением в объекты TextLayoutFormat.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение null.

TextLayoutFormat: определяет атрибуты форматирования, используемые для ссылок в состоянии наведения, когда указатель мыши находится в пределах ссылки. Это значение передается вниз по иерархии и применяется ко всем нижестоящим ссылкам. Принимает inherit, ITextLayoutFormat или преобразует массив объектов с ключом и значением в объекты TextLayoutFormat.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение null.

TextLayoutFormat: определяет атрибуты форматирования для ссылок в нормальном состоянии. Это значение передается вниз по иерархии и применяется ко всем нижестоящим ссылкам. Принимает inherit, ITextLayoutFormat или преобразует массив объектов с ключом и значением в объекты TextLayoutFormat.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение null.

TextLayoutFormat: определяет автоотступ начального края списков, если значением заполнения этой стороны списка является auto.

Допустимые значения: числа от -1000 до 1000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 40.

TextLayoutFormat: определяет маркеры для списка атрибутов форматирования. Это значение передается вниз по иерархии и применяется ко всем нижестоящим ссылкам. Принимает inherit, IListMarkerFormat или преобразует массив объектов с ключом и значением в объекты ListMarkerFormat.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение null.

TextLayoutFormat:

Допустимые значения: ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение ListStylePosition.OUTSIDE.

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

TextLayoutFormat:

Допустимые значения: ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение ListStyleType.DISC.

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

TextLayoutFormat: локаль текста. Управляет преобразованием регистра и формированием. Используются стандартные идентификаторы локали, описанные в техническом стандарте Unicode #35. Например, en, en_US и en-US относятся к английскому, а ja — к японскому.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение en.

TextLayoutFormat: нижний отступ в пикселах. По умолчанию для auto используется нулевое значение, кроме списков, открывающее расстояние которых равно 45. (принимает значение по умолчанию, если не определено во время каскада) Пробел между нижним краем контейнера и текстом. Значение: Number или auto.

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

Допустимые строковые значения: FormatValue.AUTO, FormatValue.INHERIT и числа от -8000 до 8000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: левый отступ в пикселях. По умолчанию для auto используется нулевое значение, кроме списков, открывающее расстояние которых равно 45. (принимает значение по умолчанию, если не определено во время каскада) Пробел между левым краем контейнера и текстом. Значение: Number или auto.

При вертикальном тексте в прокручиваемых контейнерах с несколькими колонками в первой и последующих колонках отобразится заполнение в виде пробела в конечной части контейнера, но для просмотра заполнения последней колонки при превышении текстом ширины контейнера, придется выполнить прокрутку.

Допустимые строковые значения: FormatValue.AUTO, FormatValue.INHERIT и числа от -8000 до 8000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: правый отступ в пикселях. По умолчанию для auto используется нулевое значение, кроме списков, открывающее расстояние которых равно 45. (принимает значение по умолчанию, если не определено во время каскада) Пробел между правым краем контейнера и текстом. Значение: Number или auto.

Допустимые строковые значения: FormatValue.AUTO, FormatValue.INHERIT и числа от -8000 до 8000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: верхний отступ в пикселях. По умолчанию для auto используется нулевое значение, кроме списков, открывающее расстояние которых равно 45. (принимает значение по умолчанию, если не определено во время каскада) Пробел между верхним краем контейнера и текстом. Значение: Number или auto.

Допустимые строковые значения: FormatValue.AUTO, FormatValue.INHERIT и числа от -8000 до 8000.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение FormatValue.AUTO.

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

TextLayoutFormat: число, указывающее величину отступа для правого края абзаца, в пикселях. Относится к правому краю в текстах, написанных слева направо, и к левому краю в текстах, написанных справа налево.

Допустимые значения: числа от 0 до 8000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

TextLayoutFormat: число, определяющее величину интервала в пикселях, оставляемого после абзаца. Сворачивается вместе с paragraphSpaceBefore.

Допустимые значения: числа от 0 до 8000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

TextLayoutFormat: число, определяющее величину интервала в пикселях, оставляемого перед абзацем. Сворачивается вместе с paragraphSpaceAfter.

Допустимые значения: числа от 0 до 8000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

TextLayoutFormat: число, указывающее величину отступа для левого края абзаца, в пикселях. Относится к левому краю в текстах, написанных слева направо, и к правому краю в текстах, написанных справа налево.

Допустимые значения: числа от 0 до 8000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

Возвращает родительский элемент этого объекта FlowElement. Каждый FlowElement имеет не более одного родительского элемента.

Возвращает относительный конец этого объекта FlowElement в родительском элементе. Если родительский элемент null, то это значение всегда равно textLength. Если родительский элемент не null, то это значение является суммой длин текста этого и всех предыдущих элементов одного уровня, что соответствует первому символу в следующем объекте FlowElement.

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

Возвращает относительное начало этого объекта FlowElement в родительском элементе. Если родительский элемент null, то это значение всегда нулевое. Если родительский элемент не null, то значение является суммой длин текста всех предыдущих элементов одного уровня.

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

TextLayoutFormat: режим визуализации, используемый для данного текста. Применяется только к встроенным шрифтам (для свойства fontLookup устанавливается значение FontLookup.EMBEDDED_CFF).

Допустимые значения: RenderingMode.NORMAL, RenderingMode.CFF, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение RenderingMode.CFF.

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

TextLayoutFormat: присваивает элементу класс-идентификатор, позволяя задавать стиль для элемента путем ссылки на его styleName.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если undefined, в процессе каскада свойство получает значение null.

Возвращает стили в FlowElement. Обратите внимание, что получатель создает копию словаря стилей. Возвращаемый объект инкапсулирует все стили, установленные в свойстве формата, в том числе базовые и пользовательские стили. Возвращенный объект состоит из массива пар имя стиля-значение.

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

TextLayoutFormat: указывает позиции табуляции, связанные с абзацем. Функции присвоения могут принимать массив TabStopFormat, сжатое строковое представление, undefined или FormatValue.INHERIT. Сжатое строковое представление всегда преобразуется в массив TabStopFormat.

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

Позиция табуляции принимает следующую форму: <тип выравнивания><позиция выравнивания>|<метка выравнивания>.

Тип выравнивания представляет собой одиночный символ и может иметь значение S, E, C или D (или эквиваленты нижнего регистра). S или s означает start, E или e — end, C или c — center, D или d — decimal. Тип выравнивания является необязательным параметром, и если он не определен, то по умолчанию принимается значение S.

Позиция выравнивания представляет собой число, и определяется в соответствии со спецификацией FXG для чисел (десятичное число или экспоненциальное представление). Позиция выравнивания является обязательным параметром.

Вертикальная черта используется для отделения позиции выравнивания от метки выравнивания, и используется только в случае, если имеется метка выравнивания.

Метка выравнивания не является обязательной при типе выравнивания D, и не должна присутствовать при типе выравнивания, отличном от D. Метка выравнивания может представлять собой любую последовательностью символов, прерываемых пробелом, оканчивающим позицию табуляции (для последней позиции табуляции завершающий пробел не является обязательным; здесь подразумевается конец метки выравнивания). Пробел может быть частью метки выравнивания, если он маскируется обратной косой чертой (\). Обратная косая черта может быть частью метки выравнивания, она маскируется другой обратной косой чертой (\\). Если используется тип выравнивания D, а метка выравнивания не указана, то она примет значение по умолчанию null.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение null.

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

TextLayoutFormat: выравнивание строк в абзаце относительно контейнера. TextAlign.LEFT выравнивает строки по левому краю контейнера. TextAlign.RIGHT выравнивает строки по правому краю. TextAlign.CENTER помещает строку на равном расстоянии от левого и правого краев. TextAlign.JUSTIFY выравнивает строки по ширине контейнера. TextAlign.START эквивалентен установке left в тексте слева направо, или right в тексте справа налево. TextAlign.END эквивалентен установке right в тексте слева направо, или left в тексте справа налево.

Допустимые значения: TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TextAlign.START.

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

TextLayoutFormat: выравнивание последней (или единственной) строки в абзаце относительно контейнера в выровненном тексте. Если для textAlign установлено значение TextAlign.JUSTIFY, то textAlignLast определяет способ выравнивания последней строки (или единственной строки, если блок состоит из одной строки). Значения подобны значениям textAlign.

Допустимые значения: TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TextAlign.START.

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

TextLayoutFormat: альфа-значение (прозрачности) для текста. При значении 0 обеспечивается полная прозрачность, а при значении 1 — полная непрозрачность. Экранные объекты, для которых значение textAlpha равно 0, являются активными, несмотря на их невидимость.

Допустимые значения: числа от 0 до 1 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 1.

TextLayoutFormat: оформление в тексте. Используется для подчеркивания текста; значение по умолчанию — none.

Допустимые значения: TextDecoration.NONE, TextDecoration.UNDERLINE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TextDecoration.NONE.

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

TextLayoutFormat: число, определяющее величину отступа первой строки абзаца в пикселях. Отрицательный отступ перенесет строку на поля или даже за границы контейнера.

Допустимые значения: числа от -8000 до 8000 и FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

TextLayoutFormat: указывает параметры выравнивания текста. Значением по умолчанию является TextJustify.INTER_WORD, что означает добавление дополнительного пробела к знакам пробела. TextJustify.DISTRIBUTE добавляет дополнительный пробел к знакам пробела и между отдельными буквами. Используется только вместе с justificationRule параметра JustificationRule.SPACE.

Допустимые значения: TextJustify.INTER_WORD, TextJustify.DISTRIBUTE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TextJustify.INTER_WORD.

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

Возвращает общую длину текста, принадлежащего этому объекту FlowElement и его дочерним элементам. Если элемент не имеет текста, то обычно textLength имеет нулевое значение.

Последний фрагмент объектов ParagraphElement имеет символ разрыва абзаца для последнего объекта SpanElement. Разрыв абзаца включается в значение textLength для этого объекта SpanElement и всех его родительских элементов. Он не включается в свойство text объекта SpanElement.

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

TextLayoutFormat: указывает число градусов для поворота данного текста.

Допустимые значения: TextRotation.ROTATE_0, TextRotation.ROTATE_180, TextRotation.ROTATE_270, TextRotation.ROTATE_90, TextRotation.AUTO, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TextRotation.AUTO.

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

Устанавливает трекинг и является синонимом свойства trackingRight. Указывается как число пикселей или процент от fontSize.

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

TextLayoutFormat: число в пикселях (или процент от fontSize, например, 120%), определяющее размер трекинга (ручного кернинга), применяемого слева от каждого символа. Если kerning включен, значение trackingLeft добавляется к значениям в таблице кернинга для шрифта. Если kerning выключен, значение trackingLeft используется в качестве значения ручного кернинга. Поддерживает как положительные, так и отрицательные значения.

Допустимые числовые значения — от -1000 до 1000.

Допустимые процентные значения: от -1000% до 1000%.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

TextLayoutFormat: число в пикселях (или процент от fontSize, например, 120%), определяющее размер трекинга (ручного кернинга), применяемого справа от каждого символа Если kerning включен, значение trackingRight добавляется к значениям в таблице кернинга для шрифта. Если kerning выключен, значение trackingRight используется в качестве значения ручного кернинга. Поддерживает как положительные, так и отрицательные значения.

Допустимые числовые значения — от -1000 до 1000.

Допустимые процентные значения: от -1000% до 1000%.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 0.

У каждого FlowElement есть typeName. Значением по умолчанию для typeName является строка, которую использует textLayoutFormat TextConverter. Этот API можно использовать для установки другого typeName в FlowElement. Как правило, это выполняется для поддержки селекторов type в CSS.

Для получения информации об использовании см. документацию по TEXT_FIELD_HTML_FORMAT.

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

TextLayoutFormat: тип регистра, используемого для данного текста. Примеры:

Допустимые значения: TLFTypographicCase.DEFAULT, TLFTypographicCase.CAPS_TO_SMALL_CAPS, TLFTypographicCase.UPPERCASE, TLFTypographicCase.LOWERCASE, TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение TLFTypographicCase.DEFAULT.

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

Позволяет считывать и записывать стили пользователя в объект FlowElement. Учтите, что при чтении этого свойства для копии userStyles устанавливается формат этого элемента.

TextLayoutFormat: выравнивание по вертикали (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). Определяет способ выравнивания элементов TextFlow в контейнере.

Допустимые значения: VerticalAlign.TOP, VerticalAlign.MIDDLE, VerticalAlign.BOTTOM, VerticalAlign.JUSTIFY, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если это свойство не определено при каскадной операции, то оно получает значение VerticalAlign.TOP.

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

TextLayoutFormat: сворачивает или сохраняет пустое пространство при импорте текста в TextFlow. WhiteSpaceCollapse.PRESERVE сохраняет все символы пробела. WhiteSpaceCollapse.COLLAPSE удаляет символы новой строки, табуляции, а также начальные и концевые пробелы в блоке импортированного текста. Теги разрыва строк () и символы разделителя строк Unicode сохраняются.

Допустимые значения: WhiteSpaceCollapse.PRESERVE, WhiteSpaceCollapse.COLLAPSE, FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов этого свойства нет, то оно получает значение WhiteSpaceCollapse.COLLAPSE.

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

TextLayoutFormat: указывает оптимальный, минимальный и максимальный интервал (как множитель к ширине обычного интервала) между словами для использования при выравнивании. Оптимальное пространство для обозначения требуемого размера пространства в виде части значения, определенного в настройках шрифта. Минимальные и максимальные значения, которые используются, когда textJustify определяет ширину пробелов между словами перед использованием трекинга для выравнивания строки.

Допустимые процентные значения: от -1000% до 1000%.

Допустимые значения включают FormatValue.INHERIT.

По умолчанию значение равно undefined, что указывает на то, что оно не установлено.

Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. Если ни в одном из вышестоящих элементов данное свойство не установлено, оно получает значение 100 %, 50 %, 150 %.

Базовый класс — при вызове new FlowElement() выдается исключение ошибки.

Отменяет указанный параметром styleProp стиль в этом объекте FlowElement. Устанавливает значение undefined.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_clearStyleExample extends Sprite{    
        public function FlowElement_clearStyleExample()
        {
            // create a container and a TextFlow object
            var container:Sprite = new Sprite();
            this.addChild(container);
            var textFlow:TextFlow = new TextFlow();
            
            // create a paragraph and set lineThrough style to true 
            var paragraph:ParagraphElement = new ParagraphElement();
            paragraph.setStyle("color", 204);
            // create two spans of text
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            var span3:SpanElement = new SpanElement();            
            span1.text = "After calling clearStyle(), the value of color for span1 is: ";     
            span2.text = " but the value of span1.getStyle() for color is ";
            span3.text = " because getStyle() returns the inherited value that's applied to the style.";
            span1.clearStyle("color");        // undefined
            span1.text += span1.color;
            paragraph.addChild(span1);
            paragraph.addChild(span2);
            span2.text += span1.getStyle("color");    //204 
            paragraph.addChild(span3);
            
            textFlow.addChild(paragraph);
            // add controller, then update controller to display text
            var firstController:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(firstController);
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Выполняет полное копирование объекта FlowElement, включая любые дочерние элементы (при этом копируется содержимое между двумя позициями символов), и возвращает эту копию как объект FlowElement.

Без аргументов deepCopy() по умолчанию копирует весь элемент.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_deepCopyExample extends Sprite{    
        public function FlowElement_deepCopyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            // add text to the spans and spans to the paragraph
            span1.text = "Hello, ";
            span2.text = "World!";
            p.fontSize = 48;
            p.addChild(span1);
            p.addChild(span2);
            // make a deep copy of paragraph p, starting at relative offset 3; copy to end
            var p2:ParagraphElement = p.deepCopy(3, -1) as ParagraphElement; 
            // add copied paragraph (p2) to textflow; add composer and controller 
            // and update controller to display text
            textFlow.addChild(p2);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();    // 'lo, World!'
        }
    }
}

Сравните userStyles этого с userStyles других элементов.

Параметры

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

Возвращает начальное местоположение элемента в текстовом потоке в виде абсолютного индекса. Позиция первого символа в потоке – 0.

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getAbsoluteStartExample extends Sprite
    {    
        public function FlowElement_getAbsoluteStartExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            // add text to the spans, spans to the paragraph, and paragraph to the text flow
            span1.text = "The start of span2 ";
            span2.text = "in this paragraph is at index: ";
            p.fontSize = 20;
            p.addChild(span1);
            p.addChild(span2);
            textFlow.addChild(p);
            // find the starting position of span2 and update controller to display text
            span2.text += span2.getAbsoluteStart();  // 19
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Возвращает символ в указанной позиции, относительно этого объекта FlowElement. Первый символ располагается в относительной позиции 0.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getCharAtPositionExample extends Sprite
    {        
        public function FlowElement_getCharAtPositionExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
                        
            //create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to the two spans, calling getCharAtPosition() to return the
            // character at relative position 27 in the first span
            span1.text = "The character at offset 27 in this paragraph is: ";
            span2.text =  span1.getCharAtPosition(27) + ".";    // i
            
            // add spans to paragraph p   
            p.addChild(span1);
            p.addChild(span2);
            
            // add paragraph p to text flow and update controller to display it
            textFlow.addChild(p);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Возвращает код символа в указанной позиции, относительно этого FlowElement. Первый символ располагается в относительной позиции 0.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getCharCodeAtPositionExample extends Sprite
    {        
        public function FlowElement_getCharCodeAtPositionExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
            
            //create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to spans; use getCharCodeAtPosition() to add char code from pos. 16
            // of span1
            
            span1.text = "The character code at offset 16 in this paragraph is: ";
            span2.text =  String(span1.getCharCodeAtPosition(16)) + ".";    // 100 (d)
            
            // add spans to paragraph p   
            p.addChild(span1);
            p.addChild(span2);
            
            // add paragraph p to text flow and update controller to display it
            textFlow.addChild(p);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Возвращает начало этого элемента относительно предшествующего элемента. Предполагается, что предшествующий элемент находится в цепочке родительских элементов. Если предшествующим элементом является родительский элемент, то это совпадает с this.parentRelativeStart. Если предшествующим элементом является элемент, вышестоящий по отношению к вышестоящему элементу, то это совпадает с parentRelativeStart плюс parent.parentRelativeStart и т. д.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getElementRelativeStartExample extends Sprite
    {        
        public function FlowElement_getElementRelativeStartExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
            
            //create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            var span2:SpanElement = new SpanElement();
            var span3:SpanElement = new SpanElement();
            
            // add text to first two spans
            span1.text = "The relative start of the link SpanElement (";
            span2.text =  ") in this paragraph is at position ";
            
            // create link span, add text and corresponding URL and add to link
            var linkSpan:SpanElement = new SpanElement();
            linkSpan.text = "Adobe's website";
            link.href = "http://www.adobe.com";
            link.addChild(linkSpan);
            
            // add first span, link, and second span to paragraph p   
            p.addChild(span1);
            p.addChild(link);
            p.addChild(span2);
            
            // call getElementRelativeStart() to get start of linkSpan and add to span 3
            span3.text = String(linkSpan.getElementRelativeStart(p)) + ".";  // 44.
            p.addChild(span3);
            
            // add paragraph p to text flow and update controller to display it
            textFlow.addChild(p);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Возвращает следующий элемент одного с FlowElement уровня в иерархии текстового потока.

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getNextSiblingExample extends Sprite
    {        
        public function FlowElement_getNextSiblingExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            var nextSpanElement:SpanElement = new SpanElement();
            // add text, set font size, add spans to paragraph, add paragraph to text flow
            span1.text = "Hello, ";
            span2.text = "World!";
            p.fontSize = 48;
            p.addChild(span1);
            p.addChild(span2);
            textFlow.addChild(p);
            // get next SpanElement for span1 and set its color to red; display text
            nextSpanElement = SpanElement(span1.getNextSibling());
            nextSpanElement.color = 0xCC0000;
            textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth,stage.stageHeight));
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Возвращает объект ParagraphElement, связанный с этим элементом. Он просматривает иерархию текстового потока и возвращает первый объект ParagraphElement.

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getParagraphExample extends Sprite
    {        
        public function FlowElement_getParagraphExample()
        {
            // create a container and a controller for it and add to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
                        
            //create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to first span
            span1.text = "Text that includes a link to ";
            
            // create link span, add text and corresponding URL and add to link
            var linkSpan:SpanElement = new SpanElement();
            linkSpan.text = "Adobe's website";
            link.href = "http://www.adobe.com";
            link.addChild(linkSpan);
            
            // add text to second span and add spans and link to paragraph p
            span2.text = ". Notice that paragraph p2 is identical to paragraph p."; 
            p.addChild(span1);
            p.addChild(link);
            p.addChild(span2);
            
            // call getParagraph() to retrieve paragaph for LinkElement 
            var p2:ParagraphElement = link.getParagraph();
            
            // add paragraph p2 to the text flow and display it
            textFlow.addChild(p2);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Возвращает предыдущий элемент одного с FlowElement уровня в иерархии текстового потока.

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getPreviousSiblingExample extends Sprite
    {        
        public function FlowElement_getPreviousSiblingExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            var prevSpanElement:SpanElement = new SpanElement();
            // add text, set font size, add spans to paragraph, add paragraph to text flow
            span1.text = "Hello, ";
            span2.text = "World!";
            p.fontSize = 48;
            p.addChild(span1);
            p.addChild(span2);
            textFlow.addChild(p);
            // get previous SpanElement for span2 and set its color to red; display text
            prevSpanElement = SpanElement(span2.getPreviousSibling());
            prevSpanElement.color = 0xCC0000;
            textFlow.flowComposer.addController(new ContainerController(this,400,200));
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Возвращает значение стиля, заданного параметром styleProp, указывающим имя стиля, и имеющего возможность включать в себя любое имя стиля пользователя. Получает доступ к существующему фрагменту, абзацу, текстовому потоку или стилю контейнера. Выполняет поиск по вышестоящему дереву, если стиль для конкретного элемента имеет значение undefined.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getStyleExample extends Sprite
    {        
        public function FlowElement_getStyleExample()
        {
            // create a container and a TextFlow object
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            var textFlow:TextFlow = new TextFlow();
            
            // create a paragraph and set lineThrough style to true 
            var paragraph:ParagraphElement = new ParagraphElement();
            paragraph.setStyle("lineThrough", true);
            // create two spans of text
            var p1Span1:SpanElement = new SpanElement();
            var p1Span2:SpanElement = new SpanElement();            
            p1Span1.text = "It was a dark and stormy night. ";
            p1Span2.text = "The quick red fox jumped over the lazy brown dog.";
            paragraph.addChild(p1Span1);
            paragraph.addChild(p1Span2);
            
            // call getStyle() for 1st span to see if lineThrough is on
            if(p1Span1.getStyle("lineThrough") == true)
                p1Span1.setStyle("lineThrough", false)    // if so, turn it off for this span
            textFlow.addChild(paragraph);
            
            // add composer and controller, then update controller to display text
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Получает указанный диапазон текста из FlowElement.

Параметры

Поднимается вверх по иерархии текстового потока для возвращения корневого объекта TextFlow для элемента.

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getTextFlowExample extends Sprite
    {        
        public function FlowElement_getTextFlowExample()
        {
            // create a container and a controller for it and add to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController(container, 400, 200);
            this.stage.addChild( container );
                        
            //create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to first span
            span1.text = "Text that includes a link to ";
            
            // create link span, add text and corresponding URL and add to link
            var linkSpan:SpanElement = new SpanElement();
            linkSpan.text = "Adobe's website";
            link.href = "http://www.adobe.com";
            link.addChild(linkSpan);
            
            // add text to second span, add spans and link to paragraph p, and
            // add paragraph p to textFlow
            span2.text = ". Notice that textFlow2 is identical to textFlow."; 
            p.addChild(span1);
            p.addChild(link);
            p.addChild(span2);
            textFlow.addChild(p);
            
            // use getTextFlow() with LinkElement to return its TextFlow; update controller
            // and display it
            var textFlow2:TextFlow = link.getTextFlow();     
            textFlow2.flowComposer.addController( controller );                               
            textFlow2.flowComposer.updateAllControllers();
        }
    }
}

Вызывается для объектов MXML после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML.

Параметры

Устанавливает стиль, указанный параметром styleProp, для значения, указанного параметром newValue. Можно установить стиль для фрагмента, абзаца, текстового потока или контейнера, включая любую пользовательскую пару имя-значение.

Примечание. При назначении пользовательского стиля Text Layout Framework может импортировать и экспортировать его, но скомпилированный MXML не может его поддерживать.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flash.text.engine.FontPosture;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_setStyleExample extends Sprite
    {        
        public function FlowElement_setStyleExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
            
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to the spans
            span1.text = "Hello, ";
            span2.text = "World!";
            
            // set the color style for span2 and add spans to paragraph p
            span2.setStyle("color", 0xCC0000);
            p.addChild(span1);
            p.addChild(span2);
            
            // add paragraph to text flow, set fontStyle for the text flow to italic,
            // and update controller to display the paragraph
            textFlow.addChild(p);
            textFlow.setStyle("fontStyle", FontPosture.ITALIC);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Создает копию этого объекта FlowElement, при этом копируется содержимое между двумя указанными позициями символов. Возвращает копию в виде нового объекта FlowElement. В отличие от deepCopy(), shallowCopy() не копирует дочерние элементы данного объекта FlowElement.

Без аргументов shallowCopy() по умолчанию копирует все содержимое.

Параметры

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

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_shallowCopyExample extends Sprite
    {        
        public function FlowElement_shallowCopyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            var span3:SpanElement = new SpanElement();
            // add text to the spans, spans to the paragraph
            span1.text = "paragraph2 has  ";
            span3.text = " children, so it would display nothing."
            p.fontSize = 20;
            p.addChild(span1);
            p.addChild(span2);
            p.addChild(span3);
            // create paragraph p2 as a shallow copy of paragraph p
            var p2:ParagraphElement = p.shallowCopy(3, -1) as ParagraphElement; 
            // add the number of children that p2 has to span2 for paragraph p
            span2.text += p2.numChildren;    // 0
            // add paragraph p to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Разделяет этот объект FlowElement в указанной параметром relativePosition позиции, которая является относительной текстовой позицией в этом элементе. Этот способ применяется только для разделения объектов SpanElements и FlowGroupElements.

Параметры