Пакет | 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):void
SpanElement | () | Конструктор |
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