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

TextFlowLine  - AS3

Пакетflashx.textLayout.compose
Классpublic final class TextFlowLine
НаследованиеTextFlowLine Inheritance Object
Реализует IVerticalJustificationLine

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

Класс TextFlowLine представляет отдельную строку текста в текстовом потоке.

Используйте этот класс для доступа к информации о параметрах созданной строки текста: ее местоположении, высоте, ширине и т. д. При изменении текстового потока (TextFlow) строки выше и в месте изменения немедленно отмечаются как недействительные, поскольку они должны быть восстановлены. Строки ниже места изменения, возможно, не были повреждены немедленно, но они могут быть созданы заново после создания текста. Доступ к поврежденному TextFlowLine возможен, но любые его значения отражают предыдущее состояние TextFlow. При восстановлении TextFlow создаются новые строки, и можно получить новую строку для данного местоположения путем вызова TextFlow.flowComposer.findLineAtPosition().



Общедоступные свойства
 СвойствоОпределено
  absoluteStart : int
[только для чтения] Местоположение строки, как абсолютной позиции символа в объекте TextFlow.
TextFlowLine
  ascent : Number
[только для чтения] Указывает число пикселей от базовой линии до верхней точки самых высоких символов в строке.
TextFlowLine
  columnIndex : int
[только для чтения] Номер столбца, в котором была размещена строка, начиная с 0.
TextFlowLine
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  controller : ContainerController
[только для чтения] Контроллер (объект ContainerController) для контейнера, в котором была размещена строка.
TextFlowLine
  descent : Number
[только для чтения] Указывает число пикселей от базовой линии до нижней точки символов с самыми низким выносным элементом в строке.
TextFlowLine
  height : Number
[только для чтения] Высота строки в пикселях.
TextFlowLine
  lineOffset : Number
[только для чтения] Смещение строки (в пикселях) от соответствующего отступа контейнера (определяется в соответствии с направлением абзаца и размещением строк в контейнере) до выравнивания строк в абзаце.
TextFlowLine
  location : int
[только для чтения] Одно из значений из TextFlowLineLocation, указывающее местоположение строки внутри абзаца.
TextFlowLine
  paragraph : ParagraphElement
[только для чтения] Абзац (ParagraphElement), в котором находится строка.
TextFlowLine
  spaceAfter : Number
[только для чтения] Размер интервала, который должен быть оставлен после строки.
TextFlowLine
  spaceBefore : Number
[только для чтения] Размер интервала, который должен быть оставлен перед строкой.
TextFlowLine
  textHeight : Number
[только для чтения] Высота строки текста, равная сумме значений ascent и descent.
TextFlowLine
  textLength : int
[только для чтения] Количество символов до следующей линии, включая конечные пробелы.
TextFlowLine
  textLineExists : Boolean
[только для чтения] Указывает, существует ли для данного TextFlowLine объект flash.text.engine.TextLine.
TextFlowLine
  unjustifiedTextWidth : Number
[только для чтения] Ширина строки, если она не выровнена.
TextFlowLine
  validity : String
[только для чтения] Действительность строки.
TextFlowLine
  x : Number
Положение строки по горизонтали относительно ее контейнера, задаваемое смещением в пикселях от левого края контейнера.
TextFlowLine
  y : Number
Положение строки по вертикали относительно ее контейнера, задаваемое смещением в пикселях от верхнего края контейнера.
TextFlowLine
Общедоступные методы
 МетодОпределено
  
TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)
Конструктор создает новый экземпляр TextFlowLine.
TextFlowLine
  
Возвращает границы строки в виде прямоугольника.
TextFlowLine
  
Возвращает для этой строки объект flash.text.engine.TextLine, который может быть создан повторно, если его не существует вследствие выполнения «сборки мусора».
TextFlowLine
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

absoluteStart

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

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

Местоположение строки, как абсолютной позиции символа в объекте TextFlow.



Реализация
    public function get absoluteStart():int

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

ascent

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

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

Указывает число пикселей от базовой линии до верхней точки самых высоких символов в строке. Для объекта TextLine, содержащего только графический элемент, ascent имеет значение 0.



Реализация
    public function get ascent():Number

columnIndex

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

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

Номер столбца, в котором была размещена строка, начиная с 0.



Реализация
    public function get columnIndex():int

controller

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

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

Контроллер (объект ContainerController) для контейнера, в котором была размещена строка.



Реализация
    public function get controller():ContainerController

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

descent

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

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

Указывает число пикселей от базовой линии до нижней точки символов с самыми низким выносным элементом в строке. Для объекта TextLine, содержащего только графический элемент, descent имеет значение 0.



Реализация
    public function get descent():Number

height

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

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

Высота строки в пикселях.



Реализация
    public function get height():Number

lineOffset

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

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

Смещение строки (в пикселях) от соответствующего отступа контейнера (определяется в соответствии с направлением абзаца и размещением строк в контейнере) до выравнивания строк в абзаце.



Реализация
    public function get lineOffset():Number

location

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

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

Одно из значений из TextFlowLineLocation, указывающее местоположение строки внутри абзаца.



Реализация
    public function get location():int

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

paragraph

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

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

Абзац (ParagraphElement), в котором находится строка.



Реализация
    public function get paragraph():ParagraphElement

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

spaceAfter

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

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

Размер интервала, который должен быть оставлен после строки.

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



Реализация
    public function get spaceAfter():Number

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

spaceBefore

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

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

Размер интервала, который должен быть оставлен перед строкой.

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



Реализация
    public function get spaceBefore():Number

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

textHeight

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

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

Высота строки текста, равная сумме значений ascent и descent. Это значение рассчитывается по разнице между базовыми строками, окружающими строку, – идеографическими верхней и нижней, либо надстрочной и подстрочной в зависимости от того, является базовая строка с координатой y=0 идеографической (например, TextBaseline.IDEOGRAPHIC_TOP) или нет.



Реализация
    public function get textHeight():Number

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

textLength

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

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

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



Реализация
    public function get textLength():int

textLineExists

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

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

Указывает, существует ли для данного TextFlowLine объект flash.text.engine.TextLine. Значение является true, если объект TextLine не был собран сборщиком мусора; в противном случае, false.



Реализация
    public function get textLineExists():Boolean

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

unjustifiedTextWidth

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

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

Ширина строки, если она не выровнена. Для невыровненного текста это значение совпадает с textLength. Для выровненного текста это значение представляет длину, которую бы строка имела без выравнивания, а textLength представляет фактическую ширину строки. Например, когда следующая строка выравнивается и назначается с шириной 500, ее фактическая ширина составляет 500, а ширина без выравнивания – 268,9921875.



Реализация
    public function get unjustifiedTextWidth():Number

validity

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

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

Действительность строки.

Строка может быть недействительной, если после ее создания были изменены текст, примененные к нему атрибуты или параметры настройки контроллера. Недействительная строка может по-прежнему отображаться, и ее можно использовать, но она будет иметь те значения, которые она имела при создании. Строка, возвращаемая методом getTextLine(), также будет иметь статус недействительной.



Реализация
    public function get validity():String

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

x

свойство 
x:Number

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

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

Примечание. Хотя это свойство технически read-write, его необходимо обработать как read-only. Этот установщик существует только для обеспечения требований интерфейса IVerticalJustificationLine, определяющего как получателя, так и установщика этого свойства. Использование установщика, хотя это может привести к непредсказуемым результатам.



Реализация
    public function get x():Number
    public function set x(value:Number):void

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

y

свойство 
y:Number

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

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

Примечание. Хотя это свойство технически read-write, его необходимо обработать как read-only. Этот установщик существует только для обеспечения требований интерфейса IVerticalJustificationLine, определяющего как получателя, так и установщика этого свойства. Использование установщика, хотя это может привести к непредсказуемым результатам.



Реализация
    public function get y():Number
    public function set y(value:Number):void

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

Сведения о конструкторе

TextFlowLine

()Конструктор
public function TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)

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

Конструктор создает новый экземпляр TextFlowLine.

Примечание. Он не должен вызываться клиентами. Он предоставляется для записи собственного компоновщика.

Параметры
textLine:flash.text.engine:TextLine — Экранный объект TextLine, используемый для этой строки.
 
paragraph:ParagraphElement — Абзац (ParagraphElement), в который помещается строка.
 
outerTargetWidth:Number (default = 0) — Ширина создаваемой строки, исключая отступы.
 
lineOffset:Number (default = 0) — Смещение строки (в пикселях) от соответствующего отступа контейнера (определяется в соответствии с направлением абзаца и размещением строк в контейнере) до выравнивания строк в абзаце.
 
absoluteStart:int (default = 0) — Местоположение символа начала строки в текстовом потоке.
 
numChars:int (default = 0) — Количество символов в строке.

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

Сведения о методе

getBounds

()метод
public function getBounds():Rectangle

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

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

Возвращает
Rectangle — прямоугольник, представляющий границы строки.

getTextLine

()метод 
public function getTextLine(forceValid:Boolean = false):flash.text.engine:TextLine

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

Возвращает для этой строки объект flash.text.engine.TextLine, который может быть создан повторно, если его не существует вследствие выполнения «сборки мусора». Для повторного создания TextLine установите для forceValid значение true. Возвращает null, если TextLine не может быть создан повторно.

Параметры

forceValid:Boolean (default = false) — если true, TextLine создается заново, если он существует, но недействителен.

Возвращает
flash.text.engine:TextLine — объект для этой строки или null, если объект TextLine не может быть создан повторно.

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





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

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