| Пакет | flashx.textLayout.elements |
| Класс | public class FlowGroupElement |
| Наследование | FlowGroupElement  FlowElement Object |
| Подклассы | ParagraphFormattedElement, SubParagraphGroupElementBase |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Объект FlowGroupElement невозможно создать напрямую. При вызове new FlowGroupElement() выдается исключение error.
Свойство MXML по умолчаниюmxmlChildren
Связанные элементы API
Общедоступные свойства
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | alignmentBaseline : *
TextLayoutFormat: определяет базовую линию, по которой выравнивается основная базовая линия. | FlowElement | |
| backgroundAlpha : *
TextLayoutFormat: альфа-значение (прозрачности) для фона (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). | FlowElement | |
| backgroundColor : *
TextLayoutFormat: цвет фона (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). | FlowElement | |
| baselineShift : *
TextLayoutFormat: величина сдвига базовой линии от значения dominantBaseline. | FlowElement | |
| blockProgression : *
TextLayoutFormat: указывает размещение срок по вертикали или горизонтали. | FlowElement | |
| breakOpportunity : *
TextLayoutFormat: определяет допустимые места разбиения строк, когда обтекающий текст разбивается на несколько строк. | FlowElement | |
| cffHinting : *
TextLayoutFormat: тип используемого для текста хинтинга CFF. | FlowElement | |
| clearFloats : *
TextLayoutFormat: определяет тип обтекания текста вокруг плавающего объекта. | FlowElement | |
| color : *
TextLayoutFormat: цвет текста. | FlowElement | |
| columnCount : *
TextLayoutFormat: число колонок текста (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). | FlowElement | |
| columnGap : *
TextLayoutFormat: определяет величину промежутка между колонками в пикселях (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). | FlowElement | |
| columnWidth : *
TextLayoutFormat: ширина колонки в пикселях (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). | FlowElement | |
| computedFormat : flashx.textLayout.formats:ITextLayoutFormat [только для чтения]
Возвращает вычисленные атрибуты формата, являющиеся действующими для этого элемента. | FlowElement | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| coreStyles : Object [только для чтения] Возвращает coreStyles в этот FlowElement. | FlowElement | |
| digitCase : *
TextLayoutFormat: тип регистра цифр, используемого для текста. | FlowElement | |
| digitWidth : *
TextLayoutFormat: тип ширины цифр, используемый для этого текста. | FlowElement | |
| direction : *
TextLayoutFormat: задает уровень двунаправленной вложенности текста в блоке по умолчанию. | FlowElement | |
| dominantBaseline : *
TextLayoutFormat: указывает, какая из базовых линий элемента привязывается к alignmentBaseline для определения позиции элемента в строке по вертикали. | FlowElement | |
| firstBaselineOffset : *
TextLayoutFormat: определяет положение базовой линии первой строки в контейнере. | FlowElement | |
| fontFamily : *
TextLayoutFormat: имя используемого шрифта или разделенный запятой список имен шрифтов. | FlowElement | |
| fontLookup : *
TextLayoutFormat: поиск используемых шрифтов. | FlowElement | |
| fontSize : *
TextLayoutFormat: размер текста в пикселях. | FlowElement | |
| fontStyle : *
TextLayoutFormat: стиль текста. | FlowElement | |
| fontWeight : *
TextLayoutFormat: толщина текста. | FlowElement | |
| format : flashx.textLayout.formats:ITextLayoutFormat Свойства TextLayoutFormat, применяются непосредственно к этому элементу. | FlowElement | |
| id : String
Присваивает элементу идентификатор, позволяя задавать стиль для элемента путем ссылки на его id. | FlowElement | |
| justificationRule : *
TextLayoutFormat: правило, используемое для выравнивания текста в абзаце. | FlowElement | |
| justificationStyle : *
TextLayoutFormat: стиль, используемый для выравнивания абзаца. | FlowElement | |
| kerning : *
TextLayoutFormat: кернинг регулирует количество пикселов между определенными парами символов с целью улучшения удобочитаемости текста. | FlowElement | |
| leadingModel : *
TextLayoutFormat: указывает модель межстрочного интервала, которая представляет собой комбинацию основы межстрочного интервала и направления межстрочного интервала. | FlowElement | |
| ligatureLevel : *
TextLayoutFormat: указывает, какая из лигатур, определенных в шрифте, может использоваться в тексте. | FlowElement | |
| lineBreak : *
TextLayoutFormat: определяет перенос слов в контейнере (принимает значение по умолчанию, если имеет значение undefined в процессе каскада). | FlowElement | |
| lineHeight : *
TextLayoutFormat: определяет межстрочные интервалы в тексте. | FlowElement | |
| lineThrough : *
TextLayoutFormat: если значение равно true, применяет перечеркивание, размещая линию посередине строки. | FlowElement | |
| linkActiveFormat : *
TextLayoutFormat: определяет атрибуты форматирования для ссылок в нормальном состоянии. | FlowElement | |
| linkHoverFormat : *
TextLayoutFormat: определяет атрибуты форматирования, используемые для ссылок в состоянии наведения, когда указатель мыши находится в пределах ссылки. | FlowElement | |
| linkNormalFormat : *
TextLayoutFormat: определяет атрибуты форматирования для ссылок в нормальном состоянии. | FlowElement | |
| listAutoPadding : *
TextLayoutFormat: определяет автоотступ начального края списков, если значением заполнения этой стороны списка является auto. | FlowElement | |
| listMarkerFormat : *
TextLayoutFormat: определяет маркеры для списка атрибутов форматирования. | FlowElement | |
| listStylePosition : *
TextLayoutFormat: допустимы значения ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. По умолчанию значение равно undefined, что указывает на то, что оно не установлено. Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. | FlowElement | |
| listStyleType : *
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, в процессе каскада это свойство наследует свое значение от вышестоящего элемента. | FlowElement | |
| locale : *
TextLayoutFormat: локаль текста. | FlowElement | |
| mxmlChildren : Array
Добавляет массив дочерних элементов к данному объекту. | FlowGroupElement | ||
| numChildren : int [только для чтения]
Возвращает число дочерних элементов FlowElement у этого объекта FlowGroupElement. | FlowGroupElement | ||
| paddingBottom : *
TextLayoutFormat: нижний отступ в пикселах. | FlowElement | |
| paddingLeft : *
TextLayoutFormat: левый отступ в пикселях. | FlowElement | |
| paddingRight : *
TextLayoutFormat: правый отступ в пикселях. | FlowElement | |
| paddingTop : *
TextLayoutFormat: верхний отступ в пикселях. | FlowElement | |
| paragraphEndIndent : *
TextLayoutFormat: число, определяющее величину отступа для конца абзаца, в пикселях. | FlowElement | |
| paragraphSpaceAfter : *
TextLayoutFormat: число, определяющее величину интервала в пикселях, оставляемого после абзаца. | FlowElement | |
| paragraphSpaceBefore : *
TextLayoutFormat: число, определяющее величину интервала в пикселях, оставляемого перед абзацем. | FlowElement | |
| paragraphStartIndent : *
TextLayoutFormat: число, определяющее величину отступа для начала абзаца, в пикселях. | FlowElement | |
| parent : FlowGroupElement [только для чтения] Возвращает родительский элемент этого объекта FlowElement. | FlowElement | |
| parentRelativeEnd : int [только для чтения] Возвращает относительный конец этого объекта FlowElement в родительском элементе. | FlowElement | |
| parentRelativeStart : int [только для чтения] Возвращает относительное начало этого объекта FlowElement в родительском элементе. | FlowElement | |
| renderingMode : *
TextLayoutFormat: режим визуализации, используемый для данного текста. | FlowElement | |
| styleName : *
TextLayoutFormat: присваивает элементу класс-идентификатор, позволяя задавать стиль для элемента путем ссылки на его styleName. | FlowElement | |
| styles : Object [только для чтения] Возвращает стили в FlowElement. | FlowElement | |
| tabStops : *
TextLayoutFormat: указывает позиции табуляции, связанные с абзацем. | FlowElement | |
| textAlign : *
TextLayoutFormat: выравнивание строк в абзаце относительно контейнера. | FlowElement | |
| textAlignLast : *
TextLayoutFormat: выравнивание последней (или единственной) строки в абзаце относительно контейнера в выровненном тексте. | FlowElement | |
| textAlpha : *
TextLayoutFormat: альфа-значение (прозрачности) для текста. | FlowElement | |
| textDecoration : *
TextLayoutFormat: оформление текста. | FlowElement | |
| textIndent : *
TextLayoutFormat: число, определяющее величину отступа первой строки абзаца в пикселях. | FlowElement | |
| textJustify : *
TextLayoutFormat: указывает параметры выравнивания текста. | FlowElement | |
| textLength : int [только для чтения]
Возвращает общую длину текста, принадлежащего этому объекту FlowElement и его дочерним элементам. | FlowElement | |
| textRotation : *
TextLayoutFormat: указывает число градусов для поворота данного текста. | FlowElement | |
| tracking : Object [только для записи]
Устанавливает трекинг и является синонимом свойства trackingRight. | FlowElement | |
| trackingLeft : *
TextLayoutFormat: число в пикселях (или процент от fontSize, например, 120%), определяющее размер трекинга (ручного кернинга), применяемого слева от каждого символа. | FlowElement | |
| trackingRight : *
TextLayoutFormat: число в пикселях (или процент от fontSize, например, 120%), определяющее размер трекинга (ручного кернинга), применяемого справа от каждого символа. | FlowElement | |
| typeName : String
У каждого FlowElement есть typeName. | FlowElement | |
| typographicCase : *
TextLayoutFormat: тип регистра текста, используемый для этого текста. | FlowElement | |
| userStyles : Object Позволяет считывать и записывать стили пользователя в объект FlowElement. | FlowElement | |
| verticalAlign : *
TextLayoutFormat: выравнивание по вертикали (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined). | FlowElement | |
| whiteSpaceCollapse : *
TextLayoutFormat: сворачивает или сохраняет пустое пространство при импорте текста в TextFlow. | FlowElement | |
| wordSpacing : *
TextLayoutFormat: указывает оптимальный, минимальный и максимальный интервал (как множитель к ширине обычного интервала) между словами для использования при выравнивании. | FlowElement | |
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Базовый класс — вызов new FlowGroupElement() создает исключения ошибки. | FlowGroupElement | ||
Добавляет нижестоящий объект FlowElement. | FlowGroupElement | ||
Добавляет нижестоящий объект FlowElement в заданной позиции индекса. | FlowGroupElement | ||
| Отменяет указанный параметром styleProp стиль в этом объекте FlowElement. | FlowElement | |
|
Выполняет полное копирование объекта FlowElement, включая любые дочерние элементы (при этом копируется содержимое между двумя позициями символов), и возвращает эту копию как объект FlowElement. | FlowElement | |
| Сравните userStyles этого с userStyles других элементов. | FlowElement | |
В случае относительного расположения текста, найдите индекс первого нижестоящего FlowElement, содержащего относительную позицию. | FlowGroupElement | ||
В случае относительного расположения текста, найдите элемент листа, содержащий позицию. | FlowGroupElement | ||
|
Возвращает начальное местоположение элемента в текстовом потоке в виде абсолютного индекса. | FlowElement | |
|
Возвращает символ в указанной позиции, относительно этого объекта FlowElement. | FlowElement | |
| Возвращает код символа в указанной позиции, относительно этого FlowElement. | FlowElement | |
Возвращает нижестоящий элемент FlowElement с заданной позицией индекса. | FlowGroupElement | ||
Выполняет поиск указанного объекта FlowElement по дочерним элементам и возвращает его позицию индекса. | FlowGroupElement | ||
|
Возвращает начало этого элемента относительно предшествующего элемента. | FlowElement | |
Возвращает первого потомка FlowLeafElement в этой группе. | FlowGroupElement | ||
Возвращает последнего потомка FlowLeafElement в этой группе. | FlowGroupElement | ||
| Возвращает следующий элемент одного с FlowElement уровня в иерархии текстового потока. | FlowElement | |
|
Возвращает объект ParagraphElement, связанный с этим элементом. | FlowElement | |
| Возвращает предыдущий элемент одного с FlowElement уровня в иерархии текстового потока. | FlowElement | |
| Возвращает значение стиля, заданного параметром styleProp, указывающим имя стиля, и имеющего возможность включать в себя любое имя стиля пользователя. | FlowElement | |
[переопределить] | FlowGroupElement | ||
|
Поднимается вверх по иерархии текстового потока для возвращения корневого объекта TextFlow для элемента. | FlowElement | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
| Вызывается для объектов MXML после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML. | FlowElement | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Удаляет указанный нижестоящий объект FlowElement из данной группы. | FlowGroupElement | ||
Удаляет нижестоящий объект FlowElement в заданной позиции. | FlowGroupElement | ||
Заменяет нижестоящие элементы в группе указанными новыми элементами. | FlowGroupElement | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
| Устанавливает стиль, указанный параметром styleProp, для значения, указанного параметром newValue. | FlowElement | |
|
Создает копию этого объекта FlowElement, при этом копируется содержимое между двумя указанными позициями символов. | FlowElement | |
Разделяет этот объект в позиции, указанной параметром childIndex. | FlowGroupElement | ||
|
Разделяет этот объект FlowElement в указанной параметром relativePosition позиции, которая является относительной текстовой позицией в этом элементе. | FlowElement | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
Сведения о свойстве
mxmlChildren | свойство |
mxmlChildren:Array| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Добавляет массив дочерних элементов к данному объекту. Использует метод replaceChildren() для добавления каждого элемента в массив. Предназначается для использования во время импорта скомпилированных файлов MXML.
Реализация
public function get mxmlChildren():Array public function set mxmlChildren(value:Array):voidВыдает
TypeError — если элемент массива не FlowElement или String
|
Связанные элементы API
numChildren | свойство |
Сведения о конструкторе
FlowGroupElement | () | Конструктор |
public function FlowGroupElement()| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Базовый класс — вызов new FlowGroupElement() создает исключения ошибки.
Сведения о методе
addChild | () | метод |
public function addChild(child:FlowElement):FlowElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Добавляет дочерний объект FlowElement. Новый нижестоящий элемент добавляется в конец списка нижестоящих элементов.
Параметры
child:FlowElement — Добавляемый дочерний элемент.
|
FlowElement — добавленный дочерний элемент FlowElement
|
Пример ( Использование этого примера )
В этом примере выполняется вызов функции
addChild() для добавления фрагмента к абзацу, а абзаца — к текстовому потоку.
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 FlowGroupElement_addChildExample extends Sprite
{
public function FlowGroupElement_addChildExample()
{
// create string for text flow
var simpleText:String = "It was a dark and stormy night.";
// define TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var paragraph:ParagraphElement = new ParagraphElement();
var span:SpanElement = new SpanElement;
span.text = simpleText;
// add span to paragraph and add paragraph to text flow
paragraph.addChild(span);
textFlow.addChild(paragraph);
// assign composer and controller and update controller to display text
textFlow.flowComposer.addController(new ContainerController(this,200,200));
textFlow.flowComposer.updateAllControllers();
}
}
}
addChildAt | () | метод |
public function addChildAt(index:uint, child:FlowElement):FlowElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Добавляет нижестоящий объект FlowElement в заданной позиции индекса.
Параметры
index:uint — индекс позиции, в которой будет добавлен дочерний элемент, начиная с 0.
| |
child:FlowElement — Добавляемый дочерний элемент.
|
FlowElement — добавленный дочерний элемент FlowElement
|
Выдает
RangeError — index выходит за пределы диапазона.
|
Пример ( Использование этого примера )
В этом примере показан вызов addChildAt для добавления трех фрагментов к абзацу.
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 FlowGroupElement_addChildAtExample extends Sprite
{
public function FlowGroupElement_addChildAtExample()
{
// define text strings for the contents of the text flow
var textA:String = "It was a dark and stormy night. ";
var textB:String = "The quick red fox jumped over the lazy brown dog. ";
var textC:String = "Mary had a little lamb. ";
// define TextFlow, ParagraphElement and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var paragraph:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
var span3:SpanElement = new SpanElement();
span1.text = textA;
span2.text = textB;
span3.text = textC;
// add spans at specified positions
paragraph.addChildAt(0, span2);
paragraph.addChildAt(0, span1);
paragraph.addChildAt(1, span3);
textFlow.addChild(paragraph);
// assign composer, controller, and update to display text
textFlow.flowComposer.addController(new ContainerController(this,200,200));
textFlow.flowComposer.updateAllControllers();
}
}
}
findChildIndexAtPosition | () | метод |
public function findChildIndexAtPosition(relativePosition:int):int| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
В случае относительного расположения текста, найдите индекс первого дочернего FlowElement, содержащего относительную позицию. Из-за нулевой длины FlowElements несколько дочерних элементов могут содержать относительную позицию.
Проверьте дочерние элементы для поиска FlowElement, содержащего относительную позицию. Предоставленная относительная позиция является относительной для этого FlowElement.
Параметры
relativePosition:int — позиция относительно данного элемента
|
int — индекс первого дочернего элемента, содержащего relativePosition
|
Пример ( Использование этого примера )
В этом примере показан поиск индекса дочернего элемента, занимающего относительную позицию в тексте, и изменение его цвета на красный.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_findChildIndexAtPositionExample extends Sprite
{
public function FlowGroupElement_findChildIndexAtPositionExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p>"+
"<flow:span id='span1'>It was a dark and stormy night.</flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Peter Piper picked a </flow:span>"+
"<flow:span fontStyle=\"italic\"> peck </flow:span>"+
"<flow:span>of pickle peppers.</flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// add composer and controller
textFlow.flowComposer.addController(new ContainerController(this,200,200));
// find the index of the child containing relative offset 21; set color to red
var index:int = textFlow.findChildIndexAtPosition(21);
textFlow.getChildAt(index).color = 0xFF0000;
// display text
textFlow.flowComposer.updateAllControllers();
}
}
}
findLeaf | () | метод |
public function findLeaf(relativePosition:int):FlowLeafElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
В случае относительного расположения текста, найдите элемент листа, содержащий позицию.
Выполняет поиск по иерархии элемента потока для нахождения FlowLeafElement, содержащего указанную позицию. Указанная позиция является относительной для данного объекта FlowElement.
Параметры
relativePosition:int — относительный индекс текста для поиска.
|
FlowLeafElement — элемент листа, содержащий относительную позицию.
|
Пример ( Использование этого примера )
В этом примере показано создание двух абзацев, поиск FlowLeafElement в относительной позиции 55 и изменение его цвета на красный.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_findLeafExample extends Sprite
{
public function FlowGroupElement_findLeafExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p>"+
"<flow:span>It was a dark and stormy night</flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Peter Piper picked a </flow:span>"+
"<flow:span fontStyle=\"italic\"> peck </flow:span>"+
"<flow:span>of pickle peppers.</flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// add composer and controller
textFlow.flowComposer.addController(new ContainerController(this,200,200));
// find the FlowLeafElement object containing relative offset 55; set color to red
var leaf:SpanElement = textFlow.findLeaf(55) as SpanElement;
leaf.color = 0xFF0000;
// display text
textFlow.flowComposer.updateAllControllers();
}
}
}
getChildAt | () | метод |
public function getChildAt(index:int):FlowElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает нижестоящий элемент FlowElement с заданной позицией индекса.
Параметры
index:int — позиция, в которой помещается объект FlowElement.
|
FlowElement — дочерний объект FlowElement в заданной позиции.
|
Пример ( Использование этого примера )
В этом примере метод
getChildAt() используется для доступа к абзацу в текстовом потоке и изменения цвета одного из его фрагментов на красный.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_getChildAtExample extends Sprite
{
public function FlowGroupElement_getChildAtExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p>"+
"<flow:span id='span1'>It was a dark and stormy night.</flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Peter Piper picked a </flow:span>"+
"<flow:span fontStyle=\"italic\"> peck </flow:span>"+
"<flow:span>of pickle peppers.</flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// add composer and controller
textFlow.flowComposer.addController(new ContainerController(this,200,200));
// find the paragraph at index position 1
var para:ParagraphElement = textFlow.getChildAt(1) as ParagraphElement;
// find the span at index position 1 of the paragraph and color it red
para.getChildAt(1).color = 0xFF0000;
// display text
textFlow.flowComposer.updateAllControllers();
}
}
}
getChildIndex | () | метод |
public function getChildIndex(child:FlowElement):int| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Выполняет поиск указанного объекта FlowElement по дочерним элементам и возвращает его позицию индекса.
Параметры
child:FlowElement — Элемент объекта FlowElement, располагаемый среди дочерних элементов.
|
int — Позиция индекса указанного нижестоящего элемента. Если элемент child не найден, возвращает -1.
|
getFirstLeaf | () | метод |
public function getFirstLeaf():FlowLeafElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает первого потомка FlowLeafElement в этой группе.
ВозвращаетFlowLeafElement — первый объект FlowLeafElement.
|
Пример ( Использование этого примера )
В этом примере показано создание двух абзацев, поиск первого объекта FlowLeafElement и изменение его цвета на красный.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_getFirstLeafExample extends Sprite
{
public function FlowGroupElement_getFirstLeafExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p>"+
"<flow:span>It was a </flow:span>"+
"<flow:span fontStyle=\"italic\">dark and stormy</flow:span>"+
"<flow:span> night.</flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Peter Piper picked a peck of pickle peppers. </flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// get first FlowLeafElement object and set its color to red
var leaf:SpanElement = textFlow.getFirstLeaf() as SpanElement;
leaf.color = 0xFF0000;
// add composer and controller and update controller to display text
textFlow.flowComposer.addController(new ContainerController(this,200,200));
textFlow.flowComposer.updateAllControllers();
}
}
}
getLastLeaf | () | метод |
public function getLastLeaf():FlowLeafElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает последнего потомка FlowLeafElement в этой группе.
ВозвращаетFlowLeafElement — последний объект FlowLeafElement.
|
Пример ( Использование этого примера )
В этом примере показано создание двух абзацев, поиск последнего объекта FlowLeafElement и изменение его цвета на красный.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_getLastLeafExample extends Sprite
{
public function FlowGroupElement_getLastLeafExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p>"+
"<flow:span>It was a dark and stormy night</flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Peter Piper picked a </flow:span>"+
"<flow:span fontStyle=\"italic\"> peck </flow:span>"+
"<flow:span>of pickle peppers.</flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// add composer and controller
textFlow.flowComposer.addController(new ContainerController(this,600,600));
//find last leaf, set its color to red and display text
var leaf:SpanElement = textFlow.getLastLeaf() as SpanElement;
leaf.color = 0xFF0000;
textFlow.flowComposer.updateAllControllers();
}
}
}
getText | () | метод |
removeChild | () | метод |
public function removeChild(child:FlowElement):FlowElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Удаляет указанный нижестоящий объект FlowElement из данной группы.
Параметры
child:FlowElement — Удаляемый дочерний элемент.
|
FlowElement — удаленный дочерний объект FlowElement
|
Выдает
ArgumentError — Элемент child не найден.
|
Пример ( Использование этого примера )
В этом примере показано удаление третьего фрагмента во втором абзаце текстового потока.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_removeChildExample extends Sprite
{
public function FlowGroupElement_removeChildExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p id='para1'>"+
"<flow:span id='span1'>It was a dark and stormy night.</flow:span>"+
"</flow:p>"+
"<flow:p id='para2'>"+
"<flow:span id='span2'>Peter Piper picked a </flow:span>"+
"<flow:span id='span3' fontStyle=\"italic\"> peck </flow:span>"+
"<flow:span id='span4'>of pickle peppers.</flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// add composer and controller
textFlow.flowComposer.addController(new ContainerController(this,600,600));
// get paragraph with ID = 'para2' and remove its child with name = 'span4'
var parent:ParagraphElement = textFlow.getElementByID("para2") as ParagraphElement;
parent.removeChild(textFlow.getElementByID("span4"));
// update controller to display text
textFlow.flowComposer.updateAllControllers();
}
}
}
removeChildAt | () | метод |
public function removeChildAt(index:uint):FlowElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Удаляет нижестоящий объект FlowElement в заданной позиции.
Параметры
index:uint — позиция удаляемого дочернего элемента.
|
FlowElement — дочерний объект FlowElement, удаленный из заданной позиции.
|
Выдает
RangeError — index выходит за пределы диапазона.
|
Пример ( Использование этого примера )
В этом примере функция
removeChildAt() вызывается для удаления второго из трех абзацев.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_removeChildAtExample extends Sprite
{
public function FlowGroupElement_removeChildAtExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p>"+
"<flow:span>It was a dark and stormy night. </flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Peter Piper picked a peck of pickle peppers. </flow:span>"+
"</flow:p>"+
"<flow:p>"+
"<flow:span>Mary had a little lamb. </flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow, import text, add composer and controller
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
textFlow.flowComposer.addController(new ContainerController(this,200,200));
// remove child at index position 1 (with first position = 0); display text
textFlow.removeChildAt(1);
textFlow.flowComposer.updateAllControllers();
}
}
}
replaceChildren | () | метод |
public function replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Заменяет дочерние элементы в группе указанными новыми элементами. Для управления операциями используйте параметры beginChildIndex и endChildIndex следующим образом:
- Для удаления элементов не передавайте элементов замены.
- Для вставки элементов передайте одинаковое значение для
beginChildIndexиendChildIndex. Новые элементы вставляются перед заданным индексом. - Для добавления элементов передайте
numChildrenдляbeginChildIndexиendChildIndex.
В противном случае, этот метод заменяет указанные элементы, начиная с элемента, имеющего индекс beginChildIndex и до (но не включая) элемента, имеющего индекс endChildIndex.
Параметры
beginChildIndex:int — Значение индекса для начального положения диапазона замены в массиве дочерних элементов.
| |
endChildIndex:int — Значение индекса для конечного положения диапазона замены в массиве дочерних элементов.
| |
... rest — Элементы для замены заданного диапазона элементов. Может существовать последовательность, содержащая вышеуказанные элементы потока, массивы или вектора.
|
Выдает
RangeError — Указанный beginChildIndex или endChildIndex выходит за пределы диапазона.
|
Пример ( Использование этого примера )
В этом примере три фрагмента во втором абзаце заменяются двумя новыми фрагментами.
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowGroupElement_replaceChildrenExample extends Sprite
{
public function FlowGroupElement_replaceChildrenExample()
{
// xml markup that defines the attributes and contents of a text flow
var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
"<flow:p id='para1'>"+
"<flow:span id='span1'>It was a dark and stormy night.</flow:span>"+
"</flow:p>"+
"<flow:p id='para2'>"+
"<flow:span id='span2'>Peter Piper picked a </flow:span>"+
"<flow:span id='span3' fontStyle=\"italic\"> peck </flow:span>"+
"<flow:span id='span4'>of pickle peppers.</flow:span>"+
"</flow:p>"+
"</flow:TextFlow>";
// define TextFlow object and import xml markup
var textFlow:TextFlow = new TextFlow();
textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
// define two new SpanElement objects
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
span1.text = "Mary had a little lamb. ";
span2.text = "And this little pig stayed home. ";
// add composer and controller
textFlow.flowComposer.addController(new ContainerController(this,200,600));
// get paragraph with ID = 'para2' and replace its children with span1 and span2
var parent:ParagraphElement = textFlow.getElementByID("para2") as ParagraphElement;
parent.replaceChildren(0, 3, [span1, span2]);
// update controller to display text
textFlow.flowComposer.updateAllControllers();
}
}
}
splitAtIndex | () | метод |
public function splitAtIndex(childIndex:int):FlowGroupElement| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Разделяет этот объект в позиции, указанной параметром childIndex. Если этот элемент группы имеет родительский элемент, то создается поверхностная копия этого объекта, и его дочерние элементы заменяются элементами вплоть до индекса. Перемещает элементы после childIndex в копию.
Параметры
childIndex:int |
FlowGroupElement — новый объект FlowGroupElement.
|
Выдает
RangeError — если childIndex больше длины дочерних элементов.
|
Tue Jun 12 2018, 11:34 AM Z