| Pacote | mx.controls |
| Classe | classe pública Text |
| Herança | Text  Label UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
O controle Text não suporta barras de scroll. Se você precisar de scroll, você deveria usar um controle TextArea não editável.
Você pode formatar o texto em controle Text usando tags HTML, que são aplicados após os estilos CSS do controle serem aplicados. Você também pode colocar padding em volta dos quatro lados do texto.
O texto em um controle Text é selecionável por padrão, mas você pode inpossibilitar a seleção ajsutando a propriedade selectabel. false.
Se o controle não é tão largo quanto o texto, o texto irá wordwrap. O texto está sempre alinhado no topo-esquerdo no controle.
To size a Text component, it's common to specify an explicit width and let Flex determine the height as required to display all the text. If you specify an explicit height, some of the text may get clipped; unlike Label, Text does not truncate its text with "...". It's also common to use percentage widths and heights with Text.
If you leave both the width and the height unspecified,
Flex calculates them based on any explicit line breaks
in the text, with no wordwrapping within lines.
For example, if you set the text property,
the newline character "\n" causes a line break.
If you set the htmlText property, the HTML markup
<br> causes a line break.
If your text or htmlText is lengthy
and doesn't contain line breaks, you can get a very wide Text
component; you can set the maxWidth to limit
how wide the component is allowed to grow.
Text controls do not have backgrounds or borders and cannot take focus.
The Text control has the following default sizing characteristics:
| Characteristic | Description |
|---|---|
| Default size | Flex sizes the control to fit the text, with the width long enough to fit the longest line of text and height tall enough to fit the number of lines. If you do not specify a pixel width, the height is determined by the number of explicit line breaks in the text string. If the text length changes, the control resizes to fit the new text. |
| Minimum size | 0 pixels. |
| ChMaximum sizear03 | 10000 by 10000 pixels |
Ocultar Sintaxe MXML
The <mx:Text> tag inherits all of the tag attributes
of its superclass, and adds the following tag attributes:
<mx:Text leading="2" />
Ver também
| Método | Definido Por | ||
|---|---|---|---|
|
Text()
Constructor.
| Text | ||
 |
Adiciona uma instância child DisplayObject a essa instância DisplayObjectContainer.
| DisplayObjectContainer | |
|
Adiciona uma instância child DisplayObject a essa instância DisplayObjectContainer.
| DisplayObjectContainer | |
|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto event listener com um objeto do EventDispatcher para que o listener receba notificação de um evento.
| EventDispatcher | |
|
Indica se as restrições de segurança causariam qualquer objeto display a ser omitido da lista retornada chamando o método DisplayObjectContainer.getObjectUnderPoint() com o point especificado.
| DisplayObjectContainer | |
|
Coloca na fila uma função para ser chamada depois.
| UIComponent | |
|
Deleta uma propriedade de estilo dessa instância de componente.
| UIComponent | |
|
Determina se o objeto display especificado é um child da instânica DisplayObjectContainer ou a instância em si mesma.
| DisplayObjectContainer | |
|
Converte um objeto Point das coordenadas do conteúdo para coordenadas global.
| UIComponent | |
|
Converte um objeto Point de conteúdo para coordenadas locais.
| UIComponent | |
|
Retorna um conjunto de propriedades que identificam o child dentro desse container.
| UIComponent | |
|
Cria uma referência de id a esse objeto IUIComponent em seu objeto de documento parent.
| UIComponent | |
|
Deleta a referência id para esse objeto IUIComponent em seu objeto de documento parent.
| UIComponent | |
|
Retorna um objeto UITextFormat correspondendo aos estilos de texto para esse UIComponent.
| UIComponent | |
|
Despacha um evento no fluxo de eventos.
| UIComponent | |
|
Mostra ou esconde o indicador de foco em volta desse componente.
| UIComponent | |
|
drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void
Programadamente desenha um retângulo para dentro desse objeto Graphics do skin.
| UIComponent | |
|
Chamado pela instância de efeito quando pára a execução no componente.
| UIComponent | |
|
Chamado pela instância de efeito quando começa a execução no componente.
| UIComponent | |
|
Termina todos os efeitos atualmente em execução no componente.
| UIComponent | |
|
Executa a união de dados para dentro desse objeto UIComponent.
| UIComponent | |
|
Chamado depois que a impressão estiver completa.
| UIComponent | |
|
Providencia o objeto de automatização no índice especificado.
| UIComponent | |
|
Retorna um retângulo que define a área do objeto display relativo ao sistema de coordenadas do objeto targetCoordinateSpace.
| DisplayObject | |
|
Retorna o objeto child display que existe no índice especificado.
| DisplayObjectContainer | |
|
Retorna o objeto display child que existe com o nome especificado.
| DisplayObjectContainer | |
|
Retorna a posição do índice de uma instância child DisplayObject.
| DisplayObjectContainer | |
|
Acha os seletores de tipo para essa instância UIComponent.
| UIComponent | |
|
Retorna um valor layout constraint, que é o mesmo que pegar o estilo contraint para esse componente.
| UIComponent | |
|
Um método de conveniência para determinar usar a altura explícita ou medida.
| UIComponent | |
|
Um método de conveniência para determinar usar a largura explícita ou medida.
| UIComponent | |
|
Pega o objeto que atualmente tem o foco.
| UIComponent | |
|
Retorna um objeto TextLineMetrics com informações sobre a posição do texto e medidas para uma linha de texto no controle.
| Label | |
|
Retorna um array de objetos que ficam por baixo do point especificado e são children (ou grandchildren, e assim por diante) dessa instância DisplayObjectContainer.
| DisplayObjectContainer | |
|
Retorna um retângulo que define os limites do objeto display, baseado no sistema de coordenadas definido pelo parâmetro targetCoordinateSpace, excluindo qualquer traço em formas.
| DisplayObject | |
|
Retorna um item no dataProvider que foi usado pelo Repeater específico para produzir esse Repeater, ou null se esse Repeater não é repetido.
| UIComponent | |
|
Pega uma propriedade de estilo que tem sido colocado em qualquer lugar na corrente lookup de estilo desse componente
| UIComponent | |
|
Converte um objeto Point de coordenadas global a conteúdo.
| UIComponent | |
|
Converte o objeto point das coordenadas Stage (global) para as coordenadas do objeto display (local).
| DisplayObject | |
|
Verifica se o objeto do EventDispatcher tem listeners registrados para um tipo determinado de evento.
| EventDispatcher | |
|
Indica se um objeto tem uma propriedade específica definida.
| Object | |
|
Avalia o objeto display para ver se sobrepõe ou intersecta com o objeto obj display.
| DisplayObject | |
|
Avalia o objeto display para ver se sobrepõe o intersecta com o ponto especificado pelos parâmetros x e y.
| DisplayObject | |
|
Retorna um box Matrix que pode ser passado para o método drawRoundRect() como o parâmetro rot quando desenhando um gradiente horizontal.
| UIComponent | |
|
Inicializa a estrutura interna desse componente.
| UIComponent | |
|
Inicializa várias propriedades que ficam de olho em instância repetidas desse componente.
| UIComponent | |
|
Marca um componente para que seu método updateDisplayList() seja chamado durante um atualização de tela tardia.
| UIComponent | |
|
Marca um componente para que seu método commitProperties() seja chamado durante um atualização de tela tardia.
| UIComponent | |
|
Marca um componente para que seu método measure() seja chamado durante um atualização de tela tardia.
| UIComponent | |
|
Indica se uma instância da classe Object está na corrente do protótipo do objeto determinado como parâmetro.
| Object | |
|
Converte um objeto Point de coordenadas local para conteúdo.
| UIComponent | |
|
Converte o objeto point das coordenadas de um objeto display (local) para as coordenadas Stage (global).
| DisplayObject | |
|
Mede o texto HTML especificado, que pode conter tags HTML tal como <font> e <b>, supondo que é mostrado em um UITextField de linha única usando um UITextFormat determinado pelos estilos desse UIComponent.
| UIComponent | |
|
Mede o texto especificado, supondo que é mostrado em um UITextField de linha única usando um UITextFormat determinado pelos estilos desse UIComponent.
| UIComponent | |
|
Move o componente para uma posição especificada dentro de seu parent.
| UIComponent | |
|
Propaga mudança do estilo para os children.
| UIComponent | |
|
Retornam true se a corrente de propriedades de posse apontam do child para esse UIComponent.
| UIComponent | |
|
Chamado pelo Flex quando um objeto UIComponent é adicionado ou removido de um parent.
| UIComponent | |
|
Preparam um IFlexDisplayObject para imprimir.
| UIComponent | |
|
Indica se a propriedade especificada existe e se é enumerável.
| Object | |
|
Constrói ou reconstrói o cache do estilo CSS para esse componente e, se o parâmetro recursivo for true, assim também para todos os descendentes desse componente.
| UIComponent | |
|
Para cada evento efeito, registra o EffectManager como um dos event listeners.
| UIComponent | |
|
Remove a instância child DisplayObject especificado da lista child da instância DisplayObjectContainer.
| DisplayObjectContainer | |
|
Remove um child DisplayObject da posição do índice especificada na lista child do DisplayObjectContainer.
| DisplayObjectContainer | |
|
Remove um listener do objeto do EventDispatcher.
| EventDispatcher | |
|
Faz o replay do evento específico.
| UIComponent | |
|
Resolve um child usando o id providenciado.
| UIComponent | |
|
[static]
Termina o processamento de fundo de métodos colocados em fila pelo callLater(), depois chama suspendBackgroundProcessing().
| UIComponent | |
|
Coloca o tamanho do objeto.
| UIComponent | |
|
Muda a posição de um child existente no container do objeto display.
| DisplayObjectContainer | |
|
Coloca um valor de limitação do layout, que é o mesmo que colocar um estilo de limitação para esse componente.
| UIComponent | |
|
Determina o estado atual.
| UIComponent | |
|
Determina a disponibilidade de uma propriedade dinâmica para operações em loop.
| Object | |
|
Ajusta uma propriedade de estilo nessa instância do componente.
| UIComponent | |
|
Chamado quando a propriedade de visibilidade muda.
| UIComponent | |
|
Deixa o usuário arrastar o sprite especificado.
| Sprite | |
|
Finaliza o método startDrag().
| Sprite | |
|
Detecta mudanças nas propriedades de estilo.
| UIComponent | |
|
Flex chama o método stylesInitialized() quando os estilos para um componente são primeiramente inicializados.
| UIComponent | |
|
[static]
Bloqueia o processamento de fundo de métodos colocados em fila pelo callLater(), até resumeBackgroundProcessing() ser chamado.
| UIComponent | |
|
Troca a ordem z (ordem de frente para trás) de dois objetos child especificados.
| DisplayObjectContainer | |
|
Troca a ordem z (ordem de frente para trás) dos objetos child em duas posições índice especificadas na lista child.
| DisplayObjectContainer | |
|
Retorna um string indicando o local desse objeto dentro da hierarquia do DisplayObjects no Application.
| FlexSprite | |
|
Valida a posição e tamanho de children e desenha outros visuais.
| UIComponent | |
|
Validar e fazer o update de propriedades e layout desse objeto e redesenhá-lo, se necessário.
| UIComponent | |
|
Usado pela lógica do layout para validar as propriedades de um componente chamando o método commitProperties().
| UIComponent | |
|
Valida o tamanho medido do componente se o método LayoutManager.invalidateSize() for chamado com esse ILayoutManagerClient, depois o método validateSize é chamado quando é hora de fazer medidas.
| UIComponent | |
|
Maneja os eventos válidos e inválidos de um validator designado a esse componente.
| UIComponent | |
|
Retorna o valor primitivo de um objeto específico.
| Object | |
|
Retorna um box Matrix que pode ser passado ao drawRoundRect() como o parâmetro rot quando desenhando um gradiente vertical.
| UIComponent | |
|
Verifica se um event listener está registrado com esse objeto do EventDispatcher ou qualquer um de seus parents para o determinado tipo de evento.
| EventDispatcher | |
| Método | Definido Por | ||
|---|---|---|---|
|
Ajusta o retângulo de foco.
| UIComponent | |
|
Esse é um método interno usado pelo Flex framework para suportar o efeito Dissolve.
| UIComponent | |
|
Executa qualquer processo final depois que objetos child forem criados.
| UIComponent | |
| Text | |||
|
Cria objetos child para o componente.
| UIComponent | |
|
Cria um novo objeto usando um contexto baseado na fonte embeded sendo usada.
| UIComponent | |
|
Cria o objeto usando um dado moduleFactory.
| UIComponent | |
|
O event handler chamado quando um objeto UIComponent recebe foco.
| UIComponent | |
|
O event handler chamado quando um objeto UIComponent perde foco.
| UIComponent | |
|
Finaliza a inicialização desse componente.
| UIComponent | |
|
Inicializa o código de acessabilidade desse componente.
| UIComponent | |
|
Tipicamente anulado por componentes contendo objetos UITextField, onde os objetos UITextField recebem foco.
| UIComponent | |
|
O event handler chamado para um evento keyDown.
| UIComponent | |
|
Um event handler chamado para um evento keyUp.
| UIComponent | |
|
Calcula o tamanho padrão, e opcionalmente o tamanho mínimo padrão do componente.
| UIComponent | |
|
Esse método é chamado quando um UIComponent é construido, e de novo quando o ResourceManager despacha um evento "change" para indicar que os recursos localizados têm mudado de alguma forma.
| UIComponent | |
|
Desenha o objeto e/ou tamanha e posiciona seus children.
| UIComponent | |
| Estilo | Descrição | Definido Por | ||
|---|---|---|---|---|
| Tipo: String Herança CSS: não A distância vertical em pixels do canto superior da área de conteúdo á posição da base controle. | UIComponent | ||
| Tipo: String Herança CSS: não A distância vertical em pixels do canto inferior do componente ao canto inferior de sua área de conteúdo. | UIComponent | ||
| Tipo: uint Formato: Cor Herança CSS: sim Cor do texto no componente, incluindo o label do componente. | Label | ||
| Tipo: uint Formato: Cor Herança CSS: sim Cor de texto no componente se for desativado. | Label | ||
| Tipo: uint Formato: Cor Herança CSS: sim Cor do destaque do componente quando validação falha. | UIComponent | ||
| Tipo: String Herança CSS: sim Ajusta a propriedade antiAliasType de TextFields internos. | Label | ||
| Tipo: String Herança CSS: sim Nome da fonte a ser usada. | Label | ||
| Tipo: String Herança CSS: sim Ajusta a propriedade gridFitType de TextFields internos que representam texto no controle em Flex. | Label | ||
| Tipo: Number Herança CSS: sim Ajusta a propriedade sharpness de TextFields internos que representam texto no controle em Flex. | Label | ||
| Tipo: Number Formato: Comprimento Herança CSS: sim Altura do texto, em pixels. | Label | ||
| Tipo: String Herança CSS: sim Determina se o texto tem fonte itálico. | Label | ||
| Tipo: Number Herança CSS: sim Ajusta a propriedade thickness de TextFields internos que representam texto no controle em Flex. | Label | ||
| Tipo: String Herança CSS: sim Determina se o texto está em negrito. | Label | ||
| Tipo: String Herança CSS: não A distância horizontal em pixels do centro da área de conteúdo do componente ao centro do componente. | UIComponent | ||
| Tipo: Boolean Herança CSS: sim Um valor boolean que indica quando é possivel fazer o kern ( true) ou não (false). | Label | ||
|
leading
| Tipo: Number Formato: Comprimento Herança CSS: sim Espaço vertical adicional entre as linhas do texto. O valor padrão é 2. O valor padrão do controle ComboBox é 0. | Text | ||
| Tipo: String Herança CSS: não A distância horizontal em pixels da beirada esquerda da área de conteúdo do componente à beirada esquerda do componente. | UIComponent | ||
| Tipo: Number Herança CSS: sim O número de pixels adicionais a aparecerem entre cada caractere. | Label | ||
| Tipo: Number Formato: Comprimento Herança CSS: não Número de pixels entre a parte inferior do Label e a parte inferior do texto. | Label | ||
| Tipo: Number Formato: Comprimento Herança CSS: não Número de pixels entre o lado esquerdo do Label e o lado esquerdo do texto. | Label | ||
| Tipo: Number Formato: Comprimento Herança CSS: não Número de pixels entre o lado direito do Label e o lado direito do texto. | Label | ||
| Tipo: Number Formato: Comprimento Herança CSS: não Número de pixels entro o topo do Label e topo do texto. | Label | ||
| Tipo: String Herança CSS: não A distância horizontal em pixels da beirada direita do componente à beirada direita de sua área de conteúdo. | UIComponent | ||
| Tipo: String Herança CSS: sim Alinhamento do texto dentro do container. | Label | ||
| Tipo: String Herança CSS: sim Determina se o texto está sublinhado. | Label | ||
| Tipo: Number Formato: Comprimento Herança CSS: sim Offset da primeira linha do texto do lado esquerdo do container, em pixels. | Label | ||
| Tipo: String Herança CSS: não A distância vertical em pixels da beirada superior da área de conteúdo do control à beirada superior do componente. | UIComponent | ||
| Tipo: String Herança CSS: não A distância vertical em pixels do centro da área de conteúdo do componente ao centro do componente. | UIComponent | ||
| Text | () | Construtor |
Mostrar Sintaxe MXML
public function Text()
Constructor.
| commitProperties | () | método |
protected override function commitProperties():void
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Text control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Panel title="Text Control Example" height="75%" width="75%"
paddingTop="10" paddingLeft="10" paddingRight="10">
<mx:Text width="100%">
<mx:text>
This is a multiline, non-editable text component.
If you need an editable multiline component, use TextArea.
</mx:text>
</mx:Text>
<mx:Text width="100%">
<mx:htmlText>
<![CDATA[This is <font color="#FF0000">HTML text</font> in a <b>Text component</b>. Using the <u>htmlText attribute</u> of the <font color="#008800">Text component</font> you can use basic HTML markup.]]>
</mx:htmlText>
</mx:Text>
</mx:Panel>
</mx:Application>