Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flashx.textLayout.elements 

FlowGroupElement  - AS3

Пакетflashx.textLayout.elements
Классpublic class FlowGroupElement
НаследованиеFlowGroupElement Inheritance FlowElement Inheritance Object
Подклассы ParagraphFormattedElement, SubParagraphGroupElementBase

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Класс FlowGroupElement — это базовый класс для объектов FlowElement, которые могут содержать массив дочерних элементов. Эти классы включают TextFlow, ParagraphElement, DivElement и LinkElement.

Объект FlowGroupElement невозможно создать напрямую. При вызове new FlowGroupElement() выдается исключение error.

Свойство MXML по умолчаниюmxmlChildren

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



Общедоступные свойства
 СвойствоОпределено
 InheritedalignmentBaseline : *
TextLayoutFormat: определяет базовую линию, по которой выравнивается основная базовая линия.
FlowElement
 InheritedbackgroundAlpha : *
TextLayoutFormat: альфа-значение (прозрачности) для фона (принимает значение по умолчанию, если имеет значение undefined в процессе каскада).
FlowElement
 InheritedbackgroundColor : *
TextLayoutFormat: цвет фона (принимает значение по умолчанию, если имеет значение undefined в процессе каскада).
FlowElement
 InheritedbaselineShift : *
TextLayoutFormat: величина сдвига базовой линии от значения dominantBaseline.
FlowElement
 InheritedblockProgression : *
TextLayoutFormat: указывает размещение срок по вертикали или горизонтали.
FlowElement
 InheritedbreakOpportunity : *
TextLayoutFormat: определяет допустимые места разбиения строк, когда обтекающий текст разбивается на несколько строк.
FlowElement
 InheritedcffHinting : *
TextLayoutFormat: тип используемого для текста хинтинга CFF.
FlowElement
 InheritedclearFloats : *
TextLayoutFormat: определяет тип обтекания текста вокруг плавающего объекта.
FlowElement
 Inheritedcolor : *
TextLayoutFormat: цвет текста.
FlowElement
 InheritedcolumnCount : *
TextLayoutFormat: число колонок текста (принимает значение по умолчанию, если имеет значение undefined в процессе каскада).
FlowElement
 InheritedcolumnGap : *
TextLayoutFormat: определяет величину промежутка между колонками в пикселях (принимает значение по умолчанию, если имеет значение undefined в процессе каскада).
FlowElement
 InheritedcolumnWidth : *
TextLayoutFormat: ширина колонки в пикселях (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined).
FlowElement
 InheritedcomputedFormat : flashx.textLayout.formats:ITextLayoutFormat
[только для чтения] Возвращает вычисленные атрибуты формата, являющиеся действующими для этого элемента.
FlowElement
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcoreStyles : Object
[только для чтения] Возвращает coreStyles в этот FlowElement.
FlowElement
 InheriteddigitCase : *
TextLayoutFormat: тип регистра цифр, используемого для текста.
FlowElement
 InheriteddigitWidth : *
TextLayoutFormat: тип ширины цифр, используемый для этого текста.
FlowElement
 Inheriteddirection : *
TextLayoutFormat: задает уровень двунаправленной вложенности текста в блоке по умолчанию.
FlowElement
 InheriteddominantBaseline : *
TextLayoutFormat: указывает, какая из базовых линий элемента привязывается к alignmentBaseline для определения позиции элемента в строке по вертикали.
FlowElement
 InheritedfirstBaselineOffset : *
TextLayoutFormat: определяет положение базовой линии первой строки в контейнере.
FlowElement
 InheritedfontFamily : *
TextLayoutFormat: имя используемого шрифта или разделенный запятой список имен шрифтов.
FlowElement
 InheritedfontLookup : *
TextLayoutFormat: поиск используемых шрифтов.
FlowElement
 InheritedfontSize : *
TextLayoutFormat: размер текста в пикселях.
FlowElement
 InheritedfontStyle : *
TextLayoutFormat: стиль текста.
FlowElement
 InheritedfontWeight : *
TextLayoutFormat: толщина текста.
FlowElement
 Inheritedformat : flashx.textLayout.formats:ITextLayoutFormat
Свойства TextLayoutFormat, применяются непосредственно к этому элементу.
FlowElement
 Inheritedid : String
Присваивает элементу идентификатор, позволяя задавать стиль для элемента путем ссылки на его id.
FlowElement
 InheritedjustificationRule : *
TextLayoutFormat: правило, используемое для выравнивания текста в абзаце.
FlowElement
 InheritedjustificationStyle : *
TextLayoutFormat: стиль, используемый для выравнивания абзаца.
FlowElement
 Inheritedkerning : *
TextLayoutFormat: кернинг регулирует количество пикселов между определенными парами символов с целью улучшения удобочитаемости текста.
FlowElement
 InheritedleadingModel : *
TextLayoutFormat: указывает модель межстрочного интервала, которая представляет собой комбинацию основы межстрочного интервала и направления межстрочного интервала.
FlowElement
 InheritedligatureLevel : *
TextLayoutFormat: указывает, какая из лигатур, определенных в шрифте, может использоваться в тексте.
FlowElement
 InheritedlineBreak : *
TextLayoutFormat: определяет перенос слов в контейнере (принимает значение по умолчанию, если имеет значение undefined в процессе каскада).
FlowElement
 InheritedlineHeight : *
TextLayoutFormat: определяет межстрочные интервалы в тексте.
FlowElement
 InheritedlineThrough : *
TextLayoutFormat: если значение равно true, применяет перечеркивание, размещая линию посередине строки.
FlowElement
 InheritedlinkActiveFormat : *
TextLayoutFormat: определяет атрибуты форматирования для ссылок в нормальном состоянии.
FlowElement
 InheritedlinkHoverFormat : *
TextLayoutFormat: определяет атрибуты форматирования, используемые для ссылок в состоянии наведения, когда указатель мыши находится в пределах ссылки.
FlowElement
 InheritedlinkNormalFormat : *
TextLayoutFormat: определяет атрибуты форматирования для ссылок в нормальном состоянии.
FlowElement
 InheritedlistAutoPadding : *
TextLayoutFormat: определяет автоотступ начального края списков, если значением заполнения этой стороны списка является auto.
FlowElement
 InheritedlistMarkerFormat : *
TextLayoutFormat: определяет маркеры для списка атрибутов форматирования.
FlowElement
 InheritedlistStylePosition : *
TextLayoutFormat: допустимы значения ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. По умолчанию значение равно undefined, что указывает на то, что оно не установлено. Если значение равно undefined, в процессе каскада это свойство наследует свое значение от вышестоящего элемента.
FlowElement
 InheritedlistStyleType : *
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
 Inheritedlocale : *
TextLayoutFormat: локаль текста.
FlowElement
  mxmlChildren : Array
Добавляет массив дочерних элементов к данному объекту.
FlowGroupElement
  numChildren : int
[только для чтения] Возвращает число дочерних элементов FlowElement у этого объекта FlowGroupElement.
FlowGroupElement
 InheritedpaddingBottom : *
TextLayoutFormat: нижний отступ в пикселах.
FlowElement
 InheritedpaddingLeft : *
TextLayoutFormat: левый отступ в пикселях.
FlowElement
 InheritedpaddingRight : *
TextLayoutFormat: правый отступ в пикселях.
FlowElement
 InheritedpaddingTop : *
TextLayoutFormat: верхний отступ в пикселях.
FlowElement
 InheritedparagraphEndIndent : *
TextLayoutFormat: число, определяющее величину отступа для конца абзаца, в пикселях.
FlowElement
 InheritedparagraphSpaceAfter : *
TextLayoutFormat: число, определяющее величину интервала в пикселях, оставляемого после абзаца.
FlowElement
 InheritedparagraphSpaceBefore : *
TextLayoutFormat: число, определяющее величину интервала в пикселях, оставляемого перед абзацем.
FlowElement
 InheritedparagraphStartIndent : *
TextLayoutFormat: число, определяющее величину отступа для начала абзаца, в пикселях.
FlowElement
 Inheritedparent : FlowGroupElement
[только для чтения] Возвращает родительский элемент этого объекта FlowElement.
FlowElement
 InheritedparentRelativeEnd : int
[только для чтения] Возвращает относительный конец этого объекта FlowElement в родительском элементе.
FlowElement
 InheritedparentRelativeStart : int
[только для чтения] Возвращает относительное начало этого объекта FlowElement в родительском элементе.
FlowElement
 InheritedrenderingMode : *
TextLayoutFormat: режим визуализации, используемый для данного текста.
FlowElement
 InheritedstyleName : *
TextLayoutFormat: присваивает элементу класс-идентификатор, позволяя задавать стиль для элемента путем ссылки на его styleName.
FlowElement
 Inheritedstyles : Object
[только для чтения] Возвращает стили в FlowElement.
FlowElement
 InheritedtabStops : *
TextLayoutFormat: указывает позиции табуляции, связанные с абзацем.
FlowElement
 InheritedtextAlign : *
TextLayoutFormat: выравнивание строк в абзаце относительно контейнера.
FlowElement
 InheritedtextAlignLast : *
TextLayoutFormat: выравнивание последней (или единственной) строки в абзаце относительно контейнера в выровненном тексте.
FlowElement
 InheritedtextAlpha : *
TextLayoutFormat: альфа-значение (прозрачности) для текста.
FlowElement
 InheritedtextDecoration : *
TextLayoutFormat: оформление текста.
FlowElement
 InheritedtextIndent : *
TextLayoutFormat: число, определяющее величину отступа первой строки абзаца в пикселях.
FlowElement
 InheritedtextJustify : *
TextLayoutFormat: указывает параметры выравнивания текста.
FlowElement
 InheritedtextLength : int
[только для чтения] Возвращает общую длину текста, принадлежащего этому объекту FlowElement и его дочерним элементам.
FlowElement
 InheritedtextRotation : *
TextLayoutFormat: указывает число градусов для поворота данного текста.
FlowElement
 Inheritedtracking : Object
[только для записи] Устанавливает трекинг и является синонимом свойства trackingRight.
FlowElement
 InheritedtrackingLeft : *
TextLayoutFormat: число в пикселях (или процент от fontSize, например, 120%), определяющее размер трекинга (ручного кернинга), применяемого слева от каждого символа.
FlowElement
 InheritedtrackingRight : *
TextLayoutFormat: число в пикселях (или процент от fontSize, например, 120%), определяющее размер трекинга (ручного кернинга), применяемого справа от каждого символа.
FlowElement
 InheritedtypeName : String
У каждого FlowElement есть typeName.
FlowElement
 InheritedtypographicCase : *
TextLayoutFormat: тип регистра текста, используемый для этого текста.
FlowElement
 InheriteduserStyles : Object
Позволяет считывать и записывать стили пользователя в объект FlowElement.
FlowElement
 InheritedverticalAlign : *
TextLayoutFormat: выравнивание по вертикали (принимает значение по умолчанию, если в процессе каскада было установлено значение undefined).
FlowElement
 InheritedwhiteSpaceCollapse : *
TextLayoutFormat: сворачивает или сохраняет пустое пространство при импорте текста в TextFlow.
FlowElement
 InheritedwordSpacing : *
TextLayoutFormat: указывает оптимальный, минимальный и максимальный интервал (как множитель к ширине обычного интервала) между словами для использования при выравнивании.
FlowElement
Общедоступные методы
 МетодОпределено
  
Базовый класс — вызов new FlowGroupElement() создает исключения ошибки.
FlowGroupElement
  
Добавляет нижестоящий объект FlowElement.
FlowGroupElement
  
Добавляет нижестоящий объект FlowElement в заданной позиции индекса.
FlowGroupElement
 Inherited
Отменяет указанный параметром styleProp стиль в этом объекте FlowElement.
FlowElement
 Inherited
deepCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement
Выполняет полное копирование объекта FlowElement, включая любые дочерние элементы (при этом копируется содержимое между двумя позициями символов), и возвращает эту копию как объект FlowElement.
FlowElement
 Inherited
Сравните userStyles этого с userStyles других элементов.
FlowElement
  
findChildIndexAtPosition(relativePosition:int):int
В случае относительного расположения текста, найдите индекс первого нижестоящего FlowElement, содержащего относительную позицию.
FlowGroupElement
  
findLeaf(relativePosition:int):FlowLeafElement
В случае относительного расположения текста, найдите элемент листа, содержащий позицию.
FlowGroupElement
 Inherited
Возвращает начальное местоположение элемента в текстовом потоке в виде абсолютного индекса.
FlowElement
 Inherited
getCharAtPosition(relativePosition:int):String
Возвращает символ в указанной позиции, относительно этого объекта FlowElement.
FlowElement
 Inherited
getCharCodeAtPosition(relativePosition:int):int
Возвращает код символа в указанной позиции, относительно этого FlowElement.
FlowElement
  
Возвращает нижестоящий элемент FlowElement с заданной позицией индекса.
FlowGroupElement
  
Выполняет поиск указанного объекта FlowElement по дочерним элементам и возвращает его позицию индекса.
FlowGroupElement
 Inherited
Возвращает начало этого элемента относительно предшествующего элемента.
FlowElement
  
Возвращает первого потомка FlowLeafElement в этой группе.
FlowGroupElement
  
Возвращает последнего потомка FlowLeafElement в этой группе.
FlowGroupElement
 Inherited
Возвращает следующий элемент одного с FlowElement уровня в иерархии текстового потока.
FlowElement
 Inherited
Возвращает объект ParagraphElement, связанный с этим элементом.
FlowElement
 Inherited
Возвращает предыдущий элемент одного с FlowElement уровня в иерархии текстового потока.
FlowElement
 Inherited
getStyle(styleProp:String):*
Возвращает значение стиля, заданного параметром styleProp, указывающим имя стиля, и имеющего возможность включать в себя любое имя стиля пользователя.
FlowElement
  
getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String
[переопределить]
FlowGroupElement
 Inherited
Поднимается вверх по иерархии текстового потока для возвращения корневого объекта TextFlow для элемента.
FlowElement
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Вызывается для объектов MXML после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML.
FlowElement
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Удаляет указанный нижестоящий объект FlowElement из данной группы.
FlowGroupElement
  
Удаляет нижестоящий объект FlowElement в заданной позиции.
FlowGroupElement
  
replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void
Заменяет нижестоящие элементы в группе указанными новыми элементами.
FlowGroupElement
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
Устанавливает стиль, указанный параметром styleProp, для значения, указанного параметром newValue.
FlowElement
 Inherited
shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement
Создает копию этого объекта FlowElement, при этом копируется содержимое между двумя указанными позициями символов.
FlowElement
  
Разделяет этот объект в позиции, указанной параметром childIndex.
FlowGroupElement
 Inherited
splitAtPosition(relativePosition:int):FlowElement
Разделяет этот объект FlowElement в указанной параметром relativePosition позиции, которая является относительной текстовой позицией в этом элементе.
FlowElement
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
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

свойство 
numChildren:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Возвращает число дочерних элементов FlowElement у этого объекта FlowGroupElement.



Реализация
    public function get numChildren():int
Сведения о конструкторе

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

()метод 
override public function getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String

Параметры

relativeStart:int (default = 0)
 
relativeEnd:int (default = -1)
 
paragraphSeparator:String (default = " ")

Возвращает
String

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 больше длины дочерних элементов.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.