| Pacote | flash.text.engine |
| Classe | public final class ElementFormat |
| Herança | ElementFormat  Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Um objeto ElementFormat aplicado a um ContentElement de um TextBlock não invalida o TextBlock. Uma vez que um ElementFormat é aplicado a um ContentElement, sua propriedade locked é definida como true. As propriedades de um objeto ElementFormat bloqueado não podem ser alteradas. Em vez disso, use o método clone() para criar uma cópia desbloqueada do objeto, que pode ser modificada e atribuída ao ContentElement.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| alignmentBaseline : String
Especifica o tipo da linha de base no elemento contido para o qual alinhar as linhas de base dominantes dos elementos que têm este formato. | ElementFormat | ||
| alpha : Number
Especifica a transparência dos elementos de linha afetados por este obect. | ElementFormat | ||
| baselineShift : Number
Indica o deslocamento da linha de base do elemento em pixels. | ElementFormat | ||
| breakOpportunity : String
A oportunidade de quebra de linha aplicada ao texto. | ElementFormat | ||
| color : uint
Indica a cor do texto. | ElementFormat | ||
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| digitCase : String
As maiúsculas/minúsculas do dígito usadas no texto. | ElementFormat | ||
| digitWidth : String
A largura do dígito usada no texto. | ElementFormat | ||
| dominantBaseline : String
Especifica o tipo da linha de base para usar como a linha de base dominante. | ElementFormat | ||
| fontDescription : FontDescription
Um objeto cujas propriedades descrevem uma fonte. | ElementFormat | ||
| fontSize : Number
O tamanho do texto, em pixels. | ElementFormat | ||
| kerning : String
O kerning ajusta os pixels entre determinados pares de caracteres para aprimorar a legibilidade. | ElementFormat | ||
| ligatureLevel : String
O nível de ligatura usado no texto. | ElementFormat | ||
| locale : String
O local do texto. | ElementFormat | ||
| locked : Boolean
Indica se o objeto ElementFormat está bloqueado. | ElementFormat | ||
| textRotation : String
Define o giro aplicado a glifos individuais. | ElementFormat | ||
| trackingLeft : Number
O espaçamento ou kerning manual aplicados à esquerda de cada glifo, em pixels. | ElementFormat | ||
| trackingRight : Number
O espaçamento ou kerning manual aplicados à direita de cada glifo, em pixels. | ElementFormat | ||
| typographicCase : String
As maiúsculas/minúsculas tipográficas usadas no texto. | ElementFormat | ||
| Método | Definido por | ||
|---|---|---|---|
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Cria um objeto ElementFormat. | ElementFormat | ||
Constrói uma cópia clonada desbloqueada de ElementFormat. | ElementFormat | ||
Retorna um objeto FontMetrics com propriedades que descrevem emBox, a posição do tachado, a espessura do tachado, a posição do sublinhado e a espessura do sublinhado da fonte especificada por fontDescription e fontSize.
| ElementFormat | ||
|
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 | |
alignmentBaseline | propriedade |
alignmentBaseline:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica o tipo da linha de base no elemento contido para o qual alinhar as linhas de base dominantes dos elementos que têm este formato. Use constantes TextBaseline para essa propriedade.
O maior elemento vertical na linha determina as linhas de base, a menos que TextBlock.baselineFontDescription e TextBlock.baselineFontSize sejam definidos para substituir essa lógica.
O valor padrão é TextBaseline.USE_DOMINANT_BASELINE.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
TextBaseline.ROMAN | dominantBaseline se alinha com a linha de base romana da linha. |
TextBaseline.ASCENT | dominantBaseline se alinha com a linha de base elevada da linha. |
TextBaseline.DESCENT | dominantBaseline se alinha com a linha de base de descida da linha. |
TextBaseline.IDEOGRAPHIC_TOP | dominantBaseline se alinha com a linha de base ideográfica superior da linha. |
TextBaseline.IDEOGRAPHIC_CENTER | dominantBaseline se alinha com a linha de base ideográfica central da linha. |
TextBaseline.IDEOGRAPHIC_BOTTOM | dominantBaseline se alinha com a linha de base ideográfica inferior da linha. |
TextBaseline.USE_DOMINANT_BASELINE | dominantBaseline se alinha com a mesma linha de base da linha. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Define a linha de base de alinhamento da linha com que dominantBaseline do elemento gráfico se alinha. |
GroupElement | Não tem efeito. |
TextElement | Define a linha de base de alinhamento da linha com que dominantBaseline do elemento de texto se alinha. |
Implementação
public function get alignmentBaseline():String public function set alignmentBaseline(value:String):voidLança
ArgumentError — Se for definido como qualquer valor que não seja membro de TextBaseline.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
alpha | propriedade |
alpha:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica a transparência dos elementos de linha afetados por este obect. Os valores válidos são de 0 (totalmente transparente) a 1 (totalmente opaco). Objetos exibidos com alpha definida como 0 são ativos, mesmo estando invisíveis.
O valor padrão é 1.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Aplica a alfa especificada ao elemento gráfico. Combina em termos multiplicativos com qualquer alfa definido no gráfico DisplayObject nele mesmo ou em TextLine. |
GroupElement | Não tem efeito. |
TextElement | Aplica a alfa especificada ao elemento de texto. Combina em termos multiplicativos com qualquer alfa definido em TextLine. |
Implementação
public function get alpha():Number public function set alpha(value:Number):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
baselineShift | propriedade |
baselineShift:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indica o deslocamento da linha de base do elemento em pixels.
O elemento é deslocado de dominantBaseline de acordo com esse valor. O deslocamento é adicionado na posição y dos membros do elemento, logo, em texto não girado, um deslocamento de linha de base positivo move o elemento para baixo e o deslocamento de linha de base negativo, para cima.
O valor padrão é 0,0, o que indica não haver deslocamento.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Desloca o gráfico em relação à linha de base. |
GroupElement | Não tem efeito. |
TextElement | Desloca o texto em relação à linha de base. |
Implementação
public function get baselineShift():Number public function set baselineShift(value:Number):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
breakOpportunity | propriedade |
breakOpportunity:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
A oportunidade de quebra de linha aplicada ao texto. Essa propriedade determina os caracteres que podem ser usados na quebra de texto em várias linhas. Use constantes BreakOpportunity para essa propriedade.
O valor padrão é BreakOpportunity.AUTO.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
BreakOpportunity.AUTO | As oportunidades de quebra de linha são baseada em propriedades de caractere Unicode padrão como, por exemplo, quebrar palavras e hífens. |
BreakOpportunity.ANY | Qualquer caractere no objeto ContentElement é tratado uma oportunidade de quebra de linha. O valor costuma ser usado quando há texto romano incorporado em texto asiático, e quebras são desejáveis no meio das palavras. |
BreakOpportunity.NONE | Nenhum caractere da faixa é tratado como oportunidade de quebra de linha. |
BreakOpportunity.ALL | Todos os caracteres no intervalo são tratados como oportunidades de quebra de linha, significando que uma quebra de linha ocorrerá depois de cada caractere. Útil para criar efeitos como texto em um caminho. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Determina a oportunidade de quebra entre elementos de texto adjacentes no grupo. Se o elementFormat do grupo for null, será usado o formato do primeiro dos elementos adjacentes. |
TextElement | Determina a oportunidade de quebra entre os caracteres do elemento de texto. |
Implementação
public function get breakOpportunity():String public function set breakOpportunity(value:String):voidLança
ArgumentError — Se for definido como um valor que não seja membro de BreakOpportunity.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
color | propriedade |
color:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indica a cor do texto. Um inteiro que contém três componentes RGB de 8 bits; por exemplo, 0xFF0000 é vermelho e 0x00FF00, verde.
O valor padrão é 0x000000 que é o preto.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Define a cor do texto. |
Implementação
public function get color():uint public function set color(value:uint):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
digitCase | propriedade |
digitCase:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
As maiúsculas/minúsculas do dígito usadas no texto. As maiúsculas/minúsculas de dígitos afetam o estilo e o posicionamento de grupos de caracteres numéricos. Use constantes DigitCase para essa propriedade.
O valor padrão é DigitCase.DEFAULT.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
DigitCase.DEFAULT | Aplica maiúsculas/minúsculas de dígito padrão ao texto. |
DigitCase.LINING | Aplica maiúsculas/minúsculas de dígito internas ao texto. |
DigitCase.OLD_STYLE | Aplica dígito em estilo antigo ao texto. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina as maiúsculas/minúsculas de dígito usadas para o texto no elemento. |
Implementação
public function get digitCase():String public function set digitCase(value:String):voidLança
ArgumentError — Em caso de definição como qualquer valor que não seja membro de DigitWidth.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
digitWidth | propriedade |
digitWidth:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
A largura do dígito usada no texto. Use constantes DigitWidth para essa propriedade.
O valor padrão é DigitWidth.DEFAULT.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
DigitWidth.DEFAULT | Aplica largura de dígito padrão ao texto. |
DigitWidth.PROPORTIONAL | Aplica largura de dígito proporcional ao texto. |
DigitWidth.TABULAR | Aplica largura de dígito tabular ao texto. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina a largura de dígito usada para o texto no elemento. |
Implementação
public function get digitWidth():String public function set digitWidth(value:String):voidLança
ArgumentError — Em caso de definição como qualquer valor que não seja membro de DigitWidth.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
dominantBaseline | propriedade |
dominantBaseline:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica o tipo da linha de base para usar como a linha de base dominante. A linha de base dominante está alinhada com a linha de base de alinhamento para determinar a posição vertical do elemento na linha. Use constantes TextBaseline para essa propriedade.
O conteúdo do elemento determina as linhas de base. No caso de um TextElement, a fonte e o tamanho do ponto determinam as linhas de base. No caso de um GraphicElement, a altura do elemento determina as linhas de base.
O valor padrão é TextBaseline.ROMAN.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
TextBaseline.ROMAN | A linha de base romana do elemento se alinha com alignmentBaseline. |
TextBaseline.ASCENT | A linha de base elevada do elemento se alinha com alignmentBaseline. |
TextBaseline.DESCENT | A linha de base de descida do elemento se alinha com alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_TOP | A linha de base ideográfica superior do elemento se alinha com alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_CENTER | A linha de base ideográfica central do elemento se alinha com alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_BOTTOM | A linha de base ideográfica inferior do elemento se alinha com alignmentBaseline. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Determina qual das linhas de base do elemento gráfico se alinha com alignmentBaseline. |
GroupElement | Não tem efeito. |
TextElement | Determina qual das linhas de base do elemento de texto se alinha com alignmentBaseline. |
Implementação
public function get dominantBaseline():String public function set dominantBaseline(value:String):voidLança
ArgumentError — Se for definido como qualquer valor que não seja membro de TextBaseline.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
fontDescription | propriedade |
fontDescription:FontDescription| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Um objeto cujas propriedades descrevem uma fonte.
O valor padrão é um objeto FontDescription padrão construído.
Quando a propriedade fontDescription é definido, o objeto FontDescription fornecido é bloqueado: a propriedade locked é definida como true. Um objeto FontDescription bloqueado não pode ser modificado.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina a fonte usada para o texto no elemento. |
Implementação
public function get fontDescription():FontDescription public function set fontDescription(value:FontDescription):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
fontSize | propriedade |
fontSize:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O tamanho do texto, em pixels.
O valor padrão é 12,0.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina o tamanho do texto em pixels no elemento. |
Implementação
public function get fontSize():Number public function set fontSize(value:Number):voidLança
ArgumentError — Se definido como um valor menor que zero.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
kerning | propriedade |
kerning:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O kerning ajusta os pixels entre determinados pares de caracteres para aprimorar a legibilidade. O kerning é suportado por todas as fontes que têm tabelas de kerning.
O valor padrão é Kerning.ON.
Para estabelecer valores desta propriedade, use as seguintes constantes na classe de Kerning de espaço:
| Valor de string | Descrição |
|---|---|
Kerning.ON | Kerning está ativado. |
Kerning.OFF | Kerning está desativado. |
Kerning.AUTO | O Kerning é ativado exceto onde impróprio na tipografia asiática. O Kerning é aplicado entre dois caracteres caso sejam Kanji, Hiragana ou Katakana. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Determina se o kerning é aplicado entre elementos de texto adjacentes no grupo. Se o elementFormat do grupo for null, será usado o formato do primeiro dos elementos adjacentes. |
TextElement | Determina se o kerning é aplicado entre os caracteres do elemento de texto. |
Implementação
public function get kerning():String public function set kerning(value:String):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
ligatureLevel | propriedade |
ligatureLevel:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O nível de ligatura usado no texto. Ocorre uma ligatura quando duas ou mais letras são unidas como um único glifo. As ligaturas geralmente substituem caracteres consecutivos que compartilham componentes comuns, como os pares de letras 'fi', 'fl' ou 'ae'. Elas são usadas com conjuntos de caracteres latinos e não latinos. Use constantes LigatureLevel para essa propriedade.
O valor padrão é LigatureLevel.COMMON.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
LigatureLevel.NONE | Nenhuma ligatura foi criada. |
LigatureLevel.MINIMUM | Ligaturas mínimas foram criadas. |
LigatureLevel.COMMON | Ligaturas comuns foram criadas. |
LigatureLevel.UNCOMMON | Ligaturas incomuns foram criadas. |
LigatureLevel.EXOTIC | Ligaturas exóticas foram criadas. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Determina o nível de ligatura entre elementos de texto adjacentes no grupo. Se o elementFormat do grupo for null, será usado o formato do primeiro dos elementos adjacentes. |
TextElement | Determina o nível de ligatura entre os caracteres do elemento de texto. |
Implementação
public function get ligatureLevel():String public function set ligatureLevel(value:String):voidLança
ArgumentError — Em caso de definição como qualquer valor que não seja membro de LigatureLevel.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
locale | propriedade |
locale:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O local do texto. Controla as transformações de maiúsculas/minúsculas e forma. São usados identificadores de localidade padrão. Por exemplo, "en", "en_US" e "en-US" são todos inglês e "ja", japonês. Ver iso639-2 lista de códigos de uma lista de códigos de localidade.
O valor padrão é "en".
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina as transformações e a forma para o texto no elemento. |
Implementação
public function get locale():String public function set locale(value:String):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
locked | propriedade |
locked:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Indica se o objeto ElementFormat está bloqueado. Se for true, o ElementFormat não poderá ser modificado. Chame ElementFormat.clone() para obter uma cópia desbloqueada do objeto ElementFormat.
Implementação
public function get locked():Boolean public function set locked(value:Boolean):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
textRotation | propriedade |
textRotation:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Define o giro aplicado a glifos individuais. Use constantes definidas na classe TextRotation para esta propriedade.
O valor padrão é TextRotation.AUTO.
O giro final de qualquer glifo é a soma de ElementFormat.textRotation, ContentElement.textRotation e TextBlock.lineRotation.
Você normalmente usa esta propriedade do texto asiático onde os caracteres devem ser girados para exibir propriamente no layout vertical. Usar TextRotation. AUTO em combinação com TextBlock.lineRotation = TextRotation. ROTATE_90 para realizar isto.
A definição dessa propriedade em fontes que não contêm informações de layout vertical pode apresentar resultados indesejáveis. Fontes que contêm uma tabela vmtx ou VORG, por exemplo, a fonte em japonês "MS Mincho", e funcionam corretamente porque as tabelas fornecem os dados de que o mecanismo de layout precisa para conseguir o layout correto. As fontes, como Verdana, não funcionam porque não contêm as informações necessárias.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
TextRotation.ROTATE_0 | Os glifos não são girados. |
TextRotation.ROTATE_90 | Os glifos são girados 90 graus em sentido horário. |
TextRotation.ROTATE_180 | Os glifos são girados 180 graus. |
TextRotation.ROTATE_270 | Os glifos são girados 270 graus em sentido horário. |
TextRotation.AUTO | Especifica uma rotação de 90 graus no sentido anti-horário somente para glifos de largura total, conforme determinado pelas propriedades Unicode do glifo. Esse valor é normalmente usado com texto asiático para girar somente os glifos que exigem rotação. Essa rotação é aplicada somente no texto vertical para retornar caracteres de largura inteira para uma orientação vertical, sem afetar outros caracteres. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina o giro dos glifos no elemento de texto. |
Implementação
public function get textRotation():String public function set textRotation(value:String):voidLança
ArgumentError — Em caso de definição como qualquer valor que não seja membro de TextRotation.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
trackingLeft | propriedade |
trackingLeft:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
O espaçamento ou kerning manual aplicados à esquerda de cada glifo, em pixels. Se kerning for ativado, o valor trackingLeft será adicionado aos valores na tabela de kerning da fonte. Se kerning for desativado, o valor trackingLeft será usado como valor de kerning manual. Oferece suporte a valores positivos e negativos.
Geralmente, o valor de espaçamento desejado é dividido entre trackingRight e trackingLeft. Caso contrário, em texto de direção mista, haverá o dobro de espaçamento em um limite bidirecional e nenhum no outro.
O valor padrão é 0,0.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Determina o espaçamento aplicado ao lado esquerdo do gráfico. |
GroupElement | Não tem efeito. |
TextElement | Determina o espaçamento aplicado ao lado esquerdo dos caracteres do elemento de texto. |
Exemplo:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingLeft = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingLeft = -1.0;
Implementação
public function get trackingLeft():Number public function set trackingLeft(value:Number):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
trackingRight | propriedade |
trackingRight:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
O espaçamento ou kerning manual aplicados à direita de cada glifo, em pixels. Se kerning for ativado, o valor trackingRight será adicionado aos valores na tabela de kerning da fonte. Se kerning for desativado, o valor trackingRight será usado como valor de kerning manual. Oferece suporte a valores positivos e negativos.
Geralmente, o valor de espaçamento desejado é dividido entre trackingRight e trackingLeft. Caso contrário, em texto de direção mista, haverá o dobro de espaçamento em um limite bidirecional e nenhum no outro.
O valor padrão é 0,0.
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Determina o espaçamento aplicado ao lado direito do gráfico. |
GroupElement | Não tem efeito. |
TextElement | Determina o espaçamento aplicado ao lado direito dos caracteres do elemento de texto. |
Exemplo:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingRight = -1.0;
Implementação
public function get trackingRight():Number public function set trackingRight(value:Number):voidLança
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
typographicCase | propriedade |
typographicCase:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
As maiúsculas/minúsculas tipográficas usadas no texto. Use constantes definidas na classe TypographicCase para esta propriedade.
O valor padrão é true.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
TypographicCase.DEFAULT | Especifica que a caixa normal é usada para todos os caracteres. |
TypographicCase.TITLE | Especifica se caracteres em maiúsculas usam glifos de título na saída. |
TypographicCase.CAPS | Especifica se o espaçamento é ajustado em relação a caracteres em maiúsculas na saída. |
TypographicCase.SMALL_CAPS | Especifica se caracteres em maiúsculas usam glifos de versalete na saída. |
TypographicCase.UPPERCASE | Especifica se todos os caracteres usam glifos em maiúsculas na saída. |
TypographicCase.LOWERCASE | Especifica se todos os caracteres usam glifos em minúsculas na saída. |
TypographicCase.CAPS_AND_SMALL_CAPS | Especifica se todos os caracteres em minúsculas usam glifos de versalete na saída. |
| Subclasse | Efeito da definição da propriedade |
|---|---|
GraphicElement | Não tem efeito. |
GroupElement | Não tem efeito. |
TextElement | Determina as maiúsculas/minúsculas tipográficas usadas para o texto no elemento. |
Implementação
public function get typographicCase():String public function set typographicCase(value:String):voidLança
ArgumentError — Se for definido como um valor que não seja membro de TypographicCase.
| |
IllegalOperationError — Se definido após o objeto ElementFormat for bloqueado(locked é true).
|
Elementos da API relacionados
ElementFormat | () | Construtor |
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Cria um objeto ElementFormat.
ParâmetrosfontDescription:FontDescription (default = null)null. Caso nenhuma descrição de fonte seja fornecida, uma descrição padrão é criada.
| |
fontSize:Number (default = 12.0) | |
color:uint (default = 0x000000) | |
alpha:Number (default = 1.0)alpha aplicada a todos os núcleos de linha com base no formato de elemento.
| |
textRotation:String (default = "auto") | |
dominantBaseline:String (default = "roman") | |
alignmentBaseline:String (default = "useDominantBaseline") | |
baselineShift:Number (default = 0.0) | |
kerning:String (default = "on") | |
trackingRight:Number (default = 0.0) | |
trackingLeft:Number (default = 0.0) | |
locale:String (default = "en") | |
breakOpportunity:String (default = "auto") | |
digitCase:String (default = "default") | |
digitWidth:String (default = "default") | |
ligatureLevel:String (default = "common") | |
typographicCase:String (default = "default") |
Lança
ArgumentError — O fontSize especificado é menor do que 0.
| |
ArgumentError — O textRotation especificado não é membro de TextRotation.
| |
ArgumentError — O dominantBaseline especificado não é membro de TextBaseline.
| |
ArgumentError — O alignmentBaseline especificado não é membro de TextBaseline.
| |
ArgumentError — O kerning especificado não é membro de Kerning.
| |
ArgumentError — O breakOpportunity especificado não é membro de BreakOpportunity.
| |
ArgumentError — O digitCase especificado não é membro de DigitCase.
| |
ArgumentError — O digitWidth especificado não é membro de DigitWidth.
| |
ArgumentError — O ligatureLevel especificado não é membro de LigatureLevel.
| |
ArgumentError — O typographicCase especificado não é membro de TypographicCase.
|
clone | () | método |
public function clone():ElementFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Constrói uma cópia clonada desbloqueada de ElementFormat.
RetornaElementFormat — Uma cópia desbloqueada do objeto ElementFormat.
|
Exemplo ( Como usar este exemplo )
Esse exemplo cria um objeto ElementFormat e define a propriedade FontSize. Um novo TextElement é criado usando o ElementFormat (bloqueando-o), e o TextElement é usado como conteúdo de um TextBlock. Uma linha de texto é criada a partir do TextBlock.
Para modificar o objeto ElementFormat, verifique primeiro a propriedade locked. Se verdadeiro, use o método clone() para criar uma cópia desbloqueada de ElementFormat, altere suas propriedades e vincule novamente o novo ElementFormat ao TextBlock. Quando as linhas forem novamente quebradas, as novas linhas terão as novas configurações de fonte.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormat_cloneExample extends Sprite {
private var ef1:ElementFormat;
private var ef2:ElementFormat;
public function ElementFormat_cloneExample():void {
var fd:FontDescription = new FontDescription();
fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
fd.fontName = "Palatino";
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize=20;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
ef2 = (ef1.locked) ? ef1.clone() : ef1;
ef2.fontSize = 32;
tb.content.elementFormat=ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
}
}
}
getFontMetrics | () | método |
public function getFontMetrics():FontMetrics| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Retorna um objeto FontMetrics com propriedades que descrevem emBox, a posição do tachado, a espessura do tachado, a posição do sublinhado e a espessura do sublinhado da fonte especificada por fontDescription e fontSize.
FontMetrics — Um objeto FontMetrics que descreve as propriedades da fonte especificada por fontDescription.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
ElementFormat com uma FontDescription atribuída e usa o método getFontMetrics para exibir a métrica da fonte escolhida em 24 pontos.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class FontMetricsExample extends Sprite {
public function FontMetricsExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 24;
var fm1:FontMetrics = ef1.getFontMetrics();
trace(fm1.emBox);
trace(fm1.strikethroughOffset);
trace(fm1.strikethroughThickness);
trace(fm1.subscriptScale);
trace(fm1.subscriptOffset);
trace(fm1.superscriptScale);
trace(fm1.superscriptOffset);
trace(fm1.underlineOffset);
trace(fm1.underlineThickness);
}
}
}
O exemplo cria dois objetos ElementFormat e define várias propriedades. Ele atribui o novo ElementFormats a um objeto TextElement, que foi atribuído como conteúdo de TextBlock. Observe que alterar ElementFormat de TextElement não afeta TextLines criado anteriormente pelo TextBlock pai.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormatExample extends Sprite {
public function ElementFormatExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 30;
ef1.color = 0xFF0000;
ef1.alpha = 100;
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 2;
ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
var ef2:ElementFormat = new ElementFormat(fd);
ef2.fontSize = 30;
ef2.color = 0xFF0000;
ef2.alpha = 0.3;
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
line1.x = 15;
line1.y = 30;
tb.content.elementFormat = ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
line2.x = 15;
line2.y = 60;
}
}
}
Wed Jun 13 2018, 11:10 AM Z