Pacotemx.controls.textClasses
Classeclasse pública TextRange
HerançaTextRange Inheritance Object

A classe TextRange providencia propriedades que selecionam e formatam porções de textos nos controles Label, Text, TextArea, TextEditor, e RichTextEditor.

Ver também

mx.controls.Label
mx.controls.RichTextEditor
mx.controls.Text
mx.controls.TextArea
mx.controls.TextInput
flash.text.TextFormatAlign


Propriedades Públicas
 PropriedadeDefinido Por
  beginIndex : int
Índice baseado em zero dos campos de texto do controle do primeiro caractere na porção.
TextRange
  bullet : Boolean
Se o texto na porção está na lista pontilhada.
TextRange
  color : Object
Cor do texto na porção.
TextRange
 Inheritedconstructor : Object
Uma referência ao objeto da classe ou função construtora para uma instância determinada de um objeto.
Object
  endIndex : int
Índice baseado em zero no campo de texto do controle do ponto immediatamente após o último caractere na porção; equivalente ao índice baseado em um do último caractere.
TextRange
  fontFamily : String
Nome da fonte para o texto na porção.
TextRange
  fontSize : int
Tamanho de ponto do texto na porção.
TextRange
  fontStyle : String
Estilo da fonte na porção, como "italic" ou "normal".
TextRange
  fontWeight : String
Peso da fonte na porção, como "bold" ou "normal".
TextRange
  htmlText : String
Conteúdo da porção na forma de texto HTML.
TextRange
  kerning : Boolean
Um valor Boolean que indica se fazer o kern está ativado (true) ou desativado (false).
TextRange
  letterSpacing : Number
O número de pixels adicionais a aparecerem entre cada caractere.
TextRange
  modifiesSelection : Boolean
[leitura-somente] Se o TextRange modifica o texto atualmente selecionado.
TextRange
  owner : UIComponent
O controle que contém o texto.
TextRange
 Inheritedprototype : Object
[static] Uma referência ao objeto protótipo de uma classe ou função de objeto.
Object
  text : String
Conteúdo de texto comum da porção.
TextRange
  textAlign : String
Alinhamento do texto na porção.
TextRange
  textDecoration : String
Enfeite da fonte na porção, tal como "underline" ou "normal".
TextRange
  url : String
URL para um link de hipertexto na porção.
TextRange
Métodos Públicos
 MétodoDefinido Por
  
TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)
Cria um novo TextRange Object que representa um subconjunto de conteúdo de um controle de texto, incluindo a informação de formatação.
TextRange
 Inherited
Indica se um objeto tem uma propriedade específica definida.
Object
 Inherited
Indica se uma instância da classe Object está na corrente do protótipo do objeto determinado como parâmetro.
Object
 Inherited
Indica se a propriedade especificada existe e se é enumerável.
Object
 Inherited
Determina a disponibilidade de uma propriedade dinâmica para operações em loop.
Object
 Inherited
Retorna a representação em string de um objeto determinado.
Object
 Inherited
Retorna o valor primitivo de um objeto específico.
Object
Detalhe da Propriedade
beginIndexpropriedade
beginIndex:int  [ler-escrever]

Índice baseado em zero dos campos de texto do controle do primeiro caractere na porção. Se o quinto caractere no texto é o primeiro caractere na porção, essa propriedade tem um valor de quatro.


Implementação
    public function get beginIndex():int
    public function set beginIndex(value:int):void
bulletpropriedade 
bullet:Boolean  [ler-escrever]

Se o texto na porção está na lista pontilhada. Se apenas parte da porção estiver na lista pontilhada, esse valor é false.


Implementação
    public function get bullet():Boolean
    public function set bullet(value:Boolean):void
colorpropriedade 
color:Object  [ler-escrever]

Cor do texto na porção. Você pode ajustar esse valor usando qualquer identificador de cor válido. A propriedade retorna o valor como sendo um valor numérico. Se a porção possuir cores múltiplas, esse valor é null.


Implementação
    public function get color():Object
    public function set color(value:Object):void
endIndexpropriedade 
endIndex:int  [ler-escrever]

Índice baseado em zero no campo de texto do controle do ponto immediatamente após o último caractere na porção; equivalente ao índice baseado em um do último caractere. Se o quinto caractere no texto for o último caractere na porção, essa propriedade tem um valor de 5.


Implementação
    public function get endIndex():int
    public function set endIndex(value:int):void
fontFamilypropriedade 
fontFamily:String  [ler-escrever]

Nome da fonte para o texto na porção. Se a porção tiver fontes múltiplas, esse valor é null.


Implementação
    public function get fontFamily():String
    public function set fontFamily(value:String):void
fontSizepropriedade 
fontSize:int  [ler-escrever]

Tamanho de ponto do texto na porção. Se a porção tiver tamanhos múltiplos, esse valor é 0.


Implementação
    public function get fontSize():int
    public function set fontSize(value:int):void
fontStylepropriedade 
fontStyle:String  [ler-escrever]

Estilo da fonte na porção, como "italic" ou "normal". Ajustando a propriedade para qualquer outro string resulta em estilo normal. Se a porção tiver estilos múltiplos, esse valor é null.


Implementação
    public function get fontStyle():String
    public function set fontStyle(value:String):void
fontWeightpropriedade 
fontWeight:String  [ler-escrever]

Peso da fonte na porção, como "bold" ou "normal". Ajustando a propriedade para qualquer outro string resulta em peso normal. Se a porção tiver pesos múltiplos, esse valor é null.


Implementação
    public function get fontWeight():String
    public function set fontWeight(value:String):void
htmlTextpropriedade 
htmlText:String  [ler-escrever]

Conteúdo da porção na forma de texto HTML. Essa propriedade retorna toda marcação HTML para a porção, inlusive marcação para formatação que é aplicada pelo Flex, não apenas HTML que você especifica usando uma propriedade htmlText. Essa propriedade é, portanto, uma representação cheia de HTML do text como aparece no controle.


Implementação
    public function get htmlText():String
    public function set htmlText(value:String):void
kerningpropriedade 
kerning:Boolean  [ler-escrever]

Um valor boolean que indica quando é possivel fazer o kern (true) ou não (false). Fazer o kern ajusta os pixels entre certos pares de caracteres para melhorar a leitura, e deveria ser usado somente quando necessário, como em cabeçalhos com fontes grandes. Fazer o kern é apoiadoa apenas para fontes embedded. Certas fontes, como Verdana, e fontes monoespaçadas, tal como Courier New, não apoiam fazer o kern.

O valor padrão é false.


Implementação
    public function get kerning():Boolean
    public function set kerning(value:Boolean):void
letterSpacingpropriedade 
letterSpacing:Number  [ler-escrever]

O número de pixels adicionais para aparecer entre cada caractere. Um valor positivo aumento o espaçamento de caractere além do espaçamento normal, enquanto um número negativo diminui o espaçamento.

O valor padrão é 0.


Implementação
    public function get letterSpacing():Number
    public function set letterSpacing(value:Number):void
modifiesSelectionpropriedade 
modifiesSelection:Boolean  [leitura-somente]

Se o TextRange modifica o texto atualmente selecionado. Ajustado pelo contructor.


Implementação
    public function get modifiesSelection():Boolean
ownerpropriedade 
owner:UIComponent  [ler-escrever]

O controle que contém o texto. O controle proprietário deve ter uma propriedade textField, ou, como no caso do controle RichTextEditor, uma propriedade textArea. O proprietário do texto em um controle RichTextEditor é o controle RichTextEditor, não seu subcontrole TextArea. Inicialmente ajustada pelo constructor.


Implementação
    public function get owner():UIComponent
    public function set owner(value:UIComponent):void
textpropriedade 
text:String  [ler-escrever]

Conteúdo de texto comum da porção.


Implementação
    public function get text():String
    public function set text(value:String):void
textAlignpropriedade 
textAlign:String  [ler-escrever]

Alinhamento do texto na porção. As constantes flash.text.TextFormatAlign especificam os valores válidos. Ajustar essa propriedade para qualquer outro valor não tem efeito. Se a porção tiver alinhamentos múltiplos, esse valor é null.


Implementação
    public function get textAlign():String
    public function set textAlign(value:String):void

Ver também

textDecorationpropriedade 
textDecoration:String  [ler-escrever]

Enfeite da fonte na porção, tal como "underline" ou "normal". Ajustar a propriedade para qualquer outro string resulta em texto normal. Se a porção tiver ajustes de enfeite múltiplos, esse valor é null.


Implementação
    public function get textDecoration():String
    public function set textDecoration(value:String):void
urlpropriedade 
url:String  [ler-escrever]

URL para um link de hipertexto na porção. Se a porção não incluir um link, o valor é o string vazio. Se a porção incluir links múltiplos, o valor é null.


Implementação
    public function get url():String
    public function set url(value:String):void
Detalhe do Construtor
TextRange()Construtor
public function TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)

Cria um novo TextRange Object que representa um subconjunto de conteúdo de um controle de texto, incluindo a informação de formatação.

Parâmetros
owner:UIComponent — O controle que contém o texto. O controle de ter uma propriedade textField, ou, como no caso do controle RichTextEditor, uma propriedade textArea.
 
modifiesSelection:Boolean (default = false) — Se você ajustar esse parâmetro para true e não especificar um índice de início ou fim que corresponde ao texto no controle, Flex usa o índice de início ou fim da atual seleção de texto. Se esse parâmetro for true, você omite os parâmetro beginIndex e endIndex, e não tem seleção, o objeto TextRange é vazio.
 
beginIndex:int (default = -1) — Índice baseado em zero do primeiro caractere na porção. Se o parâmetro modifiesSelection for false e você omitir esse parâmetro ou especificar um valor negativo, a porção começa com o primeiro caractere do text.
 
endIndex:int (default = -1) — Índice baseado em zero da posição após o último caractere na porção. Se o parâmetro modifiesSelection for false e você omitir esse parâmetro, especifica um valor negativo, ou especifica um valor passado o final do texto, a porção termina com o último caractere do texto.