| Pacote | flash.text |
| Classe | public class TextLineMetrics |
| Herança | TextLineMetrics Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
flash.text.TextField.getLineMetrics().
Para medidas relacionadas ao campo de texto que contém a linha de texto (por exemplo, a medida da "altura do Campo de texto" no diagrama), consulte flash.text.TextField.
O seguinte diagrama indica os pontos e as medidas de um campo de texto e a linha de texto que o campo contém:
Elementos da API relacionados
| Propriedade | Definido por | ||
|---|---|---|---|
| ascent : Number
O valor de subida do texto é o comprimento da linha de base até o topo da altura da linha em pixels. | TextLineMetrics | ||
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| descent : Number
O valor de descida do texto é o comprimento da linha de base até a parte inferior da linha em pixels. | TextLineMetrics | ||
| height : Number
O valor de altura do texto das linhas selecionadas (não necessariamente o texto completo) em pixels. | TextLineMetrics | ||
| leading : Number
O valor de entrelinha é a medida da distância vertical entre as linhas de texto. | TextLineMetrics | ||
| width : Number
O valor de largura é a largura do texto das linhas selecionadas (não necessariamente o texto completo) em pixels. | TextLineMetrics | ||
| x : Number
O valor de x é a posição esquerda do primeiro caractere em pixels. | TextLineMetrics | ||
| Método | Definido por | ||
|---|---|---|---|
TextLineMetrics(x:Number, width:Number, height:Number, ascent:Number, descent:Number, leading:Number)
Cria um objeto TextLineMetrics. | TextLineMetrics | ||
![]() |
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 | |
ascent | propriedade |
public var ascent:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de subida do texto é o comprimento da linha de base até o topo da altura da linha em pixels. Consulte a medida da "Subida" no diagrama da visão geral da classe.
Elementos da API relacionados
descent | propriedade |
public var descent:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de descida do texto é o comprimento da linha de base até a parte inferior da linha em pixels. Consulte a medida da "Descida" no diagrama da visão geral da classe.
Elementos da API relacionados
height | propriedade |
public var height:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de altura do texto das linhas selecionadas (não necessariamente o texto completo) em pixels. A altura da linha de texto não inclui a altura da medianiz. Consulte a medida da "Altura da linha" no diagrama da visão geral da classe.
Elementos da API relacionados
leading | propriedade |
public var leading:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de entrelinha é a medida da distância vertical entre as linhas de texto. Consulte a medida da "Entrelinha" no diagrama da visão geral da classe.
Elementos da API relacionados
width | propriedade |
public var width:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de largura é a largura do texto das linhas selecionadas (não necessariamente o texto completo) em pixels. A largura da linha de texto não é idêntica à largura do campo de texto. A largura da linha de texto é relativa à largura do campo de texto menos a largura da medianiz de 4 pixels (2 pixels em cada lado). Consulte a medida da "Largura da linha do texto" no diagrama da visão geral da classe.
Elementos da API relacionados
x | propriedade |
public var x:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de x é a posição esquerda do primeiro caractere em pixels. Esse valor inclui as larguras da margem, do recuo (se houver) e da medianiz. Consulte "Posição-x da linha do texto" no diagrama da visão geral da classe.
Elementos da API relacionados
TextLineMetrics | () | Construtor |
public function TextLineMetrics(x:Number, width:Number, height:Number, ascent:Number, descent:Number, leading:Number)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um objeto TextLineMetrics. O objeto TextLineMetrics contém informações sobre a métrica de texto de uma linha de texto dentro de um campo de texto. Os objetos dessa classe são retornados pelo método flash.text.TextField.getLineMetrics().
Consulte o diagrama na visão geral da classe para conferir as propriedades no contexto.
Parâmetrosx:Number — A posição esquerda do primeiro caractere, em pixels.
| |
width:Number — A largura do texto das linhas selecionadas (não necessariamente o texto completo) em pixels.
| |
height:Number — A altura do texto das linhas selecionadas (não necessariamente o texto completo) em pixels.
| |
ascent:Number — O comprimento da linha de base até o início da altura da linha em pixels.
| |
descent:Number — O comprimento da linha de base até a parte inferior da linha em pixels.
| |
leading:Number — A medida da distância vertical entre as linhas de texto.
|
Elementos da API relacionados
- Crie uma propriedade chamada
labeldo tipo TextField. - O construtor chama
configureAssets(), que faz o seguinte:- Define o alinhamento do palco como superior-esquerdo e sem escala.
- Cria um novo objeto TextField denominado
label. - Ativa o plano de fundo de
labele define a cor como branco. - Permite que o texto de
labelseja espalhado em várias linhas com quebra automática de texto. - Atribui o resultado de uma chamada a
getLabelText()para a propriedadetextdelabel. O métodogetLabelText()cria uma variável do tipo XML e a atribui a um nó XML denominadobody, preenchido com uma frase longa. - Adiciona
labelà lista de exibição utilizandoaddChild().
- Um método chamado
resizeHandler()que é ouvinte de eventosresizerealizados no palco é então adicionado. Sempre que o tamanho da janela do Flash Player for alterado, um eventoRESIZEserá despachado e acontecerá o seguinte:draw()é chamado para garantir quelabelseja exibido no centro do palco e esteja cercado por um buffer de 10 pixels.- Em seguida,
setTimeout()executashowMetrics()após um breve atraso. O atraso será adicionado porque a métrica de linha não foi atualizada depois que o eventoRESIZEfoi concluído e o palco foi totalmente redesenhado. showMetrics()atribui uma variável TextLineMetrics denominadametricsao resultado de uma chamada paragetLineMetrics()e essa variável é passada a uma nova ocorrência de uma ocorrência LineMetricsReader denominadareader. Em seguida, as duas variáveis são utilizadas nas chamadas paratrace()para imprimir a primeira (e única) linha delabele as informações fornecidas pela ocorrência LineMetricsReader através do seu métodotoString().
- O construtor força um despacho único do evento
resizepara forçar quelabelseja desenhado corretamente quando o arquivo SWF for carregado pela primeira vez.
package {
import flash.display.Sprite;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.events.*;
import flash.text.TextField;
import flash.text.TextLineMetrics;
import flash.utils.setTimeout;
public class TextLineMetricsExample extends Sprite {
private var gutter:int = 10;
private var label:TextField;
public function TextLineMetricsExample() {
configureAssets();
configureListeners();
resizeHandler(new Event(Event.RESIZE));
}
private function showMetrics():void {
var metrics:TextLineMetrics = label.getLineMetrics(0);
var reader:LineMetricsReader = new LineMetricsReader(metrics);
trace("lineText: " + label.getLineText(0));
trace("metrics: " + reader);
}
private function configureAssets():void {
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
label = new TextField();
label.background = true;
label.backgroundColor = 0xFFFFFF;
label.multiline = true;
label.wordWrap = true;
label.text = getLabelText();
addChild(label);
}
private function configureListeners():void {
stage.addEventListener(Event.RESIZE, resizeHandler);
}
private function resizeHandler(event:Event):void {
draw();
setTimeout(showMetrics, 100);
}
private function draw():void {
label.x = gutter;
label.y = gutter;
label.width = stage.stageWidth - (gutter * 2);
label.height = stage.stageHeight - (gutter * 2);
}
private function getLabelText():String {
var text:XML = <body>The Flex product line enables developers to build rich Internet applications that blend the responsiveness of desktop software, the cross-platform reach of the web, and the expressiveness of the Flash Platform.</body>
return text.toString();
}
}
}
import flash.text.TextLineMetrics;
class LineMetricsReader {
private var metrics:TextLineMetrics;
public function LineMetricsReader(metrics:TextLineMetrics) {
this.metrics = metrics;
}
public function toString():String {
return "[TextLineMetrics ascent:" + metrics.ascent
+ ", descent:" + metrics.descent
+ ", leading:" + metrics.leading
+ ", width:" + metrics.width
+ ", height:" + metrics.height
+ ", x:" + metrics.x
+ "]";
}
}
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas