| Pacote | flashx.textLayout.compose |
| Classe | public final class TextFlowLine |
| Herança | TextFlowLine Object |
| Implementações | IVerticalJustificationLine |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Use esta classe para acessar informações sobre como uma linha de texto foi composta: sua posição, altura, largura, etc. Quando o fluxo de texto (TextFlow) for modificado, as linhas que estiverem imediatamente antes do local da modificação e nesse local serão marcadas como inválidas porque precisam ser recompostas. É possível que as linhas que estiverem depois do local da modificação não sejam danificadas imediatamente, mas elas podem ser regeneradas depois que o texto for composto. Você pode acessar uma TextFlowLine que foi danificada, mas todos os valores que você acessar refletirão o estado antigo do TextFlow. Quando o TextFlow for recomposto, ele gerará novas linhas e você poderá ler a nova linha de uma determinada posição ao chamar TextFlow.flowComposer.findLineAtPosition().
| Propriedade | Definido por | ||
|---|---|---|---|
| absoluteStart : int [somente leitura]
A localização de uma linha como a posição absoluta de um caractere no objeto TextFlow. | TextFlowLine | ||
| ascent : Number [somente leitura]
Especifica o número de pixels da linha de base até a parte superior dos caracteres mais altos da linha. | TextFlowLine | ||
| columnIndex : int [somente leitura] O número da coluna na qual a linha foi colocada, sendo a primeira coluna igual a 0. | TextFlowLine | ||
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| controller : ContainerController [somente leitura]
O controlador (objeto ContainerController) do contêiner no qual a linha foi colocada. | TextFlowLine | ||
| descent : Number [somente leitura]
Especifica o número de pixels da linha de base até a parte inferior dos caracteres mais baixos da linha. | TextFlowLine | ||
| height : Number [somente leitura] Altura da linha, em pixels. | TextFlowLine | ||
| lineOffset : Number [somente leitura]
O deslocamento da linha, em pixels, do início apropriado do contêiner (conforme definido pela direção do parágrafo e a progressão do bloco do contêiner), antes do alinhamento das linhas do parágrafo. | TextFlowLine | ||
| location : int [somente leitura]
Um dos valores de TextFlowLineLocation para especificar a localização de uma linha dentro de um parágrafo. | TextFlowLine | ||
| paragraph : ParagraphElement [somente leitura]
O parágrafo (ParagraphElement) no qual a linha reside. | TextFlowLine | ||
| spaceAfter : Number [somente leitura]
A quantidade de espaço a ser deixado após a linha. | TextFlowLine | ||
| spaceBefore : Number [somente leitura]
A quantidade de espaço a ser deixado antes da linha. | TextFlowLine | ||
| textHeight : Number [somente leitura]
A altura da linha de texto, que é igual à subida + descida. | TextFlowLine | ||
| textLength : int [somente leitura]
O número de caracteres até a próxima linha, inclusive os espaços à esquerda. | TextFlowLine | ||
| textLineExists : Boolean [somente leitura]
Indica se o objeto flash.text.engine.TextLine desta TextFlowLine existe. | TextFlowLine | ||
| unjustifiedTextWidth : Number [somente leitura]
A largura da linha, caso não esteja justificada. | TextFlowLine | ||
| validity : String [somente leitura] A validade da linha. | TextFlowLine | ||
| x : Number
A posição horizontal da linha em relação ao seu container, expresso como o deslocamento em pixels da esquerda do container. | TextFlowLine | ||
| y : Number
A posição vertical da linha em relação ao seu container, expresso como o deslocamento em pixels da parte superior do container. | TextFlowLine | ||
| Método | Definido por | ||
|---|---|---|---|
TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0) Construtor - cria uma nova instância de TextFlowLine. | TextFlowLine | ||
Gera os limites da linha como um retângulo. | TextFlowLine | ||
Gera o objeto flash.text.engine.TextLine desta linha, que pode ser recriado se não existir devido à coleta de lixo. | TextFlowLine | ||
![]() |
Indica se um objeto tem uma propriedade especificada definida. | Object | |
![]() |
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
![]() |
Indica se a propriedade especificada existe e é enumerável. | Object | |
![]() |
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
![]() |
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
![]() |
Retorna a representação de string do objeto especificado. | Object | |
![]() |
Retorna o valor primitivo do objeto especificado. | Object | |
absoluteStart | propriedade |
ascent | propriedade |
ascent:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica o número de pixels da linha de base até a parte superior dos caracteres mais altos da linha. Para um TextLine que contenha apenas um elemento gráfico, ascent é definido como 0.
Implementação
public function get ascent():NumbercolumnIndex | propriedade |
controller | propriedade |
controller:ContainerController [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O controlador (objeto ContainerController) do contêiner no qual a linha foi colocada.
Implementação
public function get controller():ContainerControllerElementos da API relacionados
descent | propriedade |
descent:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica o número de pixels da linha de base até a parte inferior dos caracteres mais baixos da linha. Para um TextLine que contenha apenas um elemento gráfico, descent é definido como 0.
Implementação
public function get descent():Numberheight | propriedade |
lineOffset | propriedade |
lineOffset:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O deslocamento da linha, em pixels, do início apropriado do contêiner (conforme definido pela direção do parágrafo e a progressão do bloco do contêiner), antes do alinhamento das linhas do parágrafo.
Implementação
public function get lineOffset():Numberlocation | propriedade |
paragraph | propriedade |
paragraph:ParagraphElement [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O parágrafo (ParagraphElement) no qual a linha reside.
Implementação
public function get paragraph():ParagraphElementElementos da API relacionados
spaceAfter | propriedade |
spaceAfter:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A quantidade de espaço a ser deixado após a linha.
Se a linha for a última linha de um parágrafo que tiver um espaço após, a linha terá um valor spaceAfter. Se a linha vier na parte inferior de uma coluna, spaceAfter será ignorado. Caso contrário, a linha virá antes de outra linha na coluna, e a linha seguinte deverá ser posicionada na vertical para garantir que haja pelo menos esse espaço restante entre essa última linha do parágrafo e a primeira linha do parágrafo seguinte.
Implementação
public function get spaceAfter():NumberElementos da API relacionados
spaceBefore | propriedade |
spaceBefore:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A quantidade de espaço a ser deixado antes da linha.
Se a linha for a primeira linha de um parágrafo que tiver um 'espaço antes' aplicado, a linha terá um valor spaceBefore. Se a linha vier no alto de uma coluna, spaceBefore será ignorado. Caso contrário, a linha seguirá outra linha da coluna e será posicionada na vertical para garantir que haja pelo menos esse espaço restante entre essa linha e a última linha do parágrafo anterior.
Implementação
public function get spaceBefore():NumberElementos da API relacionados
textHeight | propriedade |
textHeight:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A altura lógica da linha de texto, que é igual a subida + descida. O valor é calculado com base na diferença entre as linhas de base que juntam a linha, seja alto e baixo ideográfico ou subida e descida, dependendo do fato de a posição da linha de base em y=0 ser ideográfica (por exemplo, TextBaseline.IDEOGRAPHIC_TOP) ou não.
Implementação
public function get textHeight():NumberElementos da API relacionados
textLength | propriedade |
textLineExists | propriedade |
textLineExists:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica se o objeto flash.text.engine.TextLine desta TextFlowLine existe. O valor é true se o objeto TextLine não passou pela coleta de lixo, e false se passou.
Implementação
public function get textLineExists():BooleanElementos da API relacionados
unjustifiedTextWidth | propriedade |
unjustifiedTextWidth:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A largura da linha, caso não esteja justificada. Para o texto não justificado, esse valor é igual ao textLength. Para o texto justificado, esse valor é o comprimento sem justificação, e textLength representa a largura real da linha. Por exemplo, quando a seguinte string é justificada e recebe a largura de 500, ela tem uma largura real de 500 e uma largura não justificada de 268.9921875.
Implementação
public function get unjustifiedTextWidth():Numbervalidity | propriedade |
validity:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A validade da linha.
Uma linha pode ser inválida se o texto, os atributos aplicados a ele ou as configurações do controlador tiverem mudado desde a criação da linha. Uma linha inválida ainda pode ser exibida, e você pode usá-la, mas os valores usados serão os valores do momento em que ela foi criada. A linha representada por getTextLine() também estará em um estado inválido.
Implementação
public function get validity():StringElementos da API relacionados
x | propriedade |
x:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição horizontal da linha em relação ao seu container, expresso como o deslocamento em pixels da esquerda do container.
Nota: embora esta propriedade seja tecnicamente read-write, você deve tratá-la como read-only. O setter existe apenas para atender às exigências da interface de IVerticalJustificationLine que define tanto um getter como setter desta propriedade. O uso de setter, embora possível, levará a resultados imprevisíveis.
Implementação
public function get x():Number public function set x(value:Number):voidElementos da API relacionados
y | propriedade |
y:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição vertical da linha em relação ao seu container, expresso como o deslocamento em pixels da parte superior do container.
Nota: embora esta propriedade seja tecnicamente read-write, você deve tratá-la como read-only. O setter existe apenas para atender às exigências da interface de IVerticalJustificationLine que define tanto um getter como setter desta propriedade. O uso de setter, embora possível, levará a resultados imprevisíveis.
Implementação
public function get y():Number public function set y(value:Number):voidElementos da API relacionados
TextFlowLine | () | Construtor |
public function TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Construtor - cria uma nova instância de TextFlowLine.
Observação: Nenhum cliente deve chamá-lo. Está exposto para escrever o seu próprio compositor.
ParâmetrostextLine:flash.text.engine:TextLine — A TextLine exibe o objeto a ser usado nesta linha.
| |
paragraph:ParagraphElement — O parágrafo (ParagraphElement) no qual a linha será colocada.
| |
outerTargetWidth:Number (default = 0) — Largura na qual a linha será composta, exceto os recuos.
| |
lineOffset:Number (default = 0) — O deslocamento da linha, em pixels, do início apropriado do contêiner (conforme definido pela direção do parágrafo e a progressão do bloco do contêiner), antes do alinhamento das linhas do parágrafo.
| |
absoluteStart:int (default = 0) — A posição do caractere no fluxo de texto no qual a linha começa.
| |
numChars:int (default = 0) — O número de caracteres na linha.
|
Elementos da API relacionados
getBounds | () | método |
getTextLine | () | método |
public function getTextLine(forceValid:Boolean = false):flash.text.engine:TextLine| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Gera o objeto flash.text.engine.TextLine desta linha, que pode ser recriado se não existir devido à coleta de lixo. Atribui a forceValid o valor true para fazer com que a TextLine seja novamente gerada. Gera null se não for possível recriar a TextLine.
Parâmetros
forceValid:Boolean (default = false) — se for true, a TextLine será gerada novamente, se existir, mas for inválida.
|
flash.text.engine:TextLine — objeto desta linha, ou null se o objeto TextLine não ode ser recriado.
|
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas