| Пакет | flashx.textLayout.elements |
| Класс | public class SpanElement |
| Наследование | SpanElement FlowLeafElement FlowElement Object |
| Подклассы | SpecialCharacterElement |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
ParagraphElement будет иметь отдельный объект SpanElement, если весь текст в абзаце совместно использует одинаковый набор атрибутов. Он имеет несколько объектов SpanElement, если текст в абзаце имеет несколько форматов.
Свойство 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 [переопределить] [только для чтения]
Вычисленные атрибуты формата текста, являющиеся действующими для этого элемента. | FlowLeafElement | |
![]() | 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
Устанавливает текст, основанный на содержимом внутри тегов фрагмента; всегда удаляет существующие нижестоящие элементы. | SpanElement | ||
![]() | 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 | |
| text : String
Получает строку текста, хранимую в этом объекте SpanElement. | SpanElement | ||
![]() | 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 | |
| Метод | Определено | ||
|---|---|---|---|
Конструктор создает объект SpanElement для хранения непрерывной последовательности текста в абзаце. | SpanElement | ||
![]() | Отменяет указанный параметром styleProp стиль в этом объекте FlowElement. | FlowElement | |
![]() |
Выполняет полное копирование объекта FlowElement, включая любые дочерние элементы (при этом копируется содержимое между двумя позициями символов), и возвращает эту копию как объект FlowElement. | FlowElement | |
![]() | Сравните userStyles этого с userStyles других элементов. | FlowElement | |
![]() |
Возвращает начальное местоположение элемента в текстовом потоке в виде абсолютного индекса. | FlowElement | |
![]() |
Возвращает символ в указанной позиции, относительно этого объекта FlowElement. | FlowElement | |
![]() | Возвращает код символа в указанной позиции, относительно этого FlowElement. | FlowElement | |
![]() | Возвращает объект FontMetrics для диапазона. | FlowLeafElement | |
![]() |
Возвращает начало этого элемента относительно предшествующего элемента. | FlowElement | |
![]() |
Возвращает следующий объект FlowLeafElement. | FlowLeafElement | |
![]() | Возвращает следующий элемент одного с FlowElement уровня в иерархии текстового потока. | FlowElement | |
![]() |
Возвращает объект ParagraphElement, связанный с этим элементом. | FlowElement | |
![]() |
Возвращает предыдущий объект FlowLeafElement. | FlowLeafElement | |
![]() | Возвращает предыдущий элемент одного с FlowElement уровня в иерархии текстового потока. | FlowElement | |
![]() | Возвращает значение стиля, заданного параметром styleProp, указывающим имя стиля, и имеющего возможность включать в себя любое имя стиля пользователя. | FlowElement | |
![]() |
Получает указанный диапазон текста из FlowElement. | FlowElement | |
![]() |
Поднимается вверх по иерархии текстового потока для возвращения корневого объекта TextFlow для элемента. | FlowElement | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() | Вызывается для объектов MXML после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML. | FlowElement | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Обновляет текст во фрагменте текста, основанном на указанной начальной и конечной позиции. | SpanElement | ||
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() | Устанавливает стиль, указанный параметром styleProp, для значения, указанного параметром newValue. | FlowElement | |
![]() |
Создает копию этого объекта FlowElement, при этом копируется содержимое между двумя указанными позициями символов. | FlowElement | |
![]() |
Разделяет этот объект FlowElement в указанной параметром relativePosition позиции, которая является относительной текстовой позицией в этом элементе. | FlowElement | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
mxmlChildren | свойство |
mxmlChildren:Array| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Устанавливает текст, основанный на содержимом внутри тегов фрагмента; всегда удаляет существующие дочерние элементы. Это свойство предназначено для использования во время импорта скомпилированных файлов MXML в Flex. Flash Professional игнорирует это свойство. Когда элементы разметки TLF имеют другие элементы разметки TLF в качестве дочерних элементов, дочерние элементы назначаются этому свойству.
Реализация
public function get mxmlChildren():Array public function set mxmlChildren(value:Array):voidВыдает
TypeError — Если элемент массива не SpecialCharacterElement или String.
|
text | свойство |
text:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Получает строку текста, хранимую в этом объекте SpanElement.
Текст фрагмента не включает символ возврата каретки (CR) в конце абзаца, но он включается в значение textLength.
Реализация
public function get text():String public function set text(value:String):voidSpanElement | () | Конструктор |
public function SpanElement()| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор создает объект SpanElement для хранения непрерывной последовательности текста в абзаце.
replaceText | () | метод |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Обновляет текст во фрагменте текста, основанном на указанной начальной и конечной позиции. Для вставки текста задайте конечную позицию, равную начальной позиции. Для дополнения текста существующим текстом во фрагменте следует задать начальную позицию и конечную позицию равными длине существующего текста.
Замененный текст включает в себя начальный символ и все символы вплоть до, но не включая конечный символ.
Параметры
relativeStartPosition:int — Позиция индекса начала заменяемого текста относительно начала фрагмента. Первый символ во фрагменте находится в позиции 0.
| |
relativeEndPosition:int — На одну позицию в индексе позже последнего заменяемого символа текста относительно начала фрагмента. Установите это значение равным relativeStartPos для вставки.
| |
textValue:String — Текст для замены или текст для добавления в зависимости от обстоятельств.
|
Выдает
RangeError — Указанный relativeStartPosition или relativeEndPosition находится вне диапазона, либо в результате замены была разделена суррогатная пара.
|
Пример ( Использование этого примера )
Отображение результатов в данном примере производится посредством второго фрагмента (span2).
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 SpanElement_replaceTextExample extends Sprite
{
public function SpanElement_replaceTextExample()
{
// create 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 paragraph:ParagraphElement = new ParagraphElement();
var span:SpanElement = new SpanElement;
var span2:SpanElement = new SpanElement;
// add composer and container controller
var controller:ContainerController = new ContainerController(container, 200, 700 );
textFlow.flowComposer.addController(controller);
textFlow.fontSize = 24; // set font size
// create text string and add it to the span
var str:String = "0123456";
span.text = str;
// insert at the beginning
span.replaceText(0, 0, "abc");
span2.text = span.text + '\n';
// append to the end of the text
span.replaceText(10, 10, "abc");
span2.text += span.text + '\n';
// insert string in the middle of the text
span.replaceText(5, 8, "abc");
span2.text += span.text + '\n';
// replace text with string
span.replaceText(0, 13, "abc");
span2.text += span.text + '\n';
// replace text with string
span.replaceText(0, 3, "That's all she wrote!\n");
span2.text += span.text + '\n';
// display the results
paragraph.addChild(span2);
textFlow.addChild(paragraph);
textFlow.flowComposer.updateAllControllers();
}
}
}
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 SpanElementExample extends Sprite
{
public function SpanElementExample()
{
// 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 spanHello:SpanElement = new SpanElement();
var spanWorld:SpanElement = new SpanElement();
// add text and styles to the spans
spanHello.text = "Hello, ";
spanHello.fontSize = 48;
spanWorld.text = "World!";
spanWorld.fontSize = 56;
spanWorld.fontStyle = FontPosture.ITALIC;
spanWorld.color = 0xFFCC00;
// add spans to paragraph, paragraph to text flow
p.addChild(spanHello);
p.addChild(spanWorld);
textFlow.addChild(p);
// update controller to display text
var controller:ContainerController = new ContainerController(container, 400, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers();
}
}
}
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства