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():Number
columnIndex | 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():ContainerController
Elementos 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():Number
height | 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():Number
location | 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():ParagraphElement
Elementos 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():Number
Elementos 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():Number
Elementos 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():Number
Elementos 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():Boolean
Elementos 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():Number
validity | 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():String
Elementos 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):void
Elementos 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):void
Elementos 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