Pacote | flash.text |
Classe | public class TextField |
Herança | TextField InteractiveObject DisplayObject EventDispatcher Object |
Subclasses | FlexTextField |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Para criar um campo de texto dinamicamente, utilize o construtor TextField()
.
Os métodos da classe TextField permitem definir, selecionar e manipular texto em um campo dinâmico ou de entrada de texto criado durante a criação ou em tempo de execução.
ActionScript fornece várias maneiras de formatar seu texto em tempo de execução. A classe TextFormat permite definir a formatação de caractere e parágrafo para objetos TextField. Você pode aplicar estilos CSS (Páginas de estilo em cascata) a campos de texto, utilizando a propriedade TextField.styleSheet
e a classe StyleSheet. Você pode utilizar CSS para aplicar um estilo a marcas HTML embutidas, definir novas marcas de formatação ou aplicar estilos. Você pode atribuir texto formatado em HTML, que pode usar estilos CSS como opção, diretamente a um campo de texto. O texto HTML atribuído a um campo de texto pode conter mídia incorporada (clipes de vídeo, arquivos SWF, arquivos GIF, arquivos PNG e arquivos JPEG). O texto é disposto na mídia incorporada da mesma maneira que um navegador da Web dispõe o texto na mídia incorporada em um documento HTML.
O Flash Player oferece suporte a um subconjunto de marcas HTML que você pode utilizar para formatar texto. Consulte a lista de marcas HTML suportadas na descrição da propriedade htmlText
.
Elementos da API relacionados
Propriedade | Definido por | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição. | DisplayObject | ||
alpha : Number
Indica o valor de transparência alfa do objeto especificado. | DisplayObject | ||
alwaysShowSelection : Boolean
Quando definida como true e o campo de texto não está em foco, o Flash Player realça a seleção no campo de texto em cinza. | TextField | ||
antiAliasType : String
O tipo de suavização de borda utilizado para esse campo de texto. | TextField | ||
autoSize : String
Controla o dimensionamento e o alinhamento automáticos de campos de texto. | TextField | ||
background : Boolean
Especifica se o campo de texto tem um preenchimento de plano de fundo. | TextField | ||
backgroundColor : uint
A cor do plano de fundo do campo de texto. | TextField | ||
blendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. | DisplayObject | ||
blendShader : Shader [somente gravação]
Define um shader usado para mesclar o primeiro plano e o segundo plano. | DisplayObject | ||
border : Boolean
Especifica se o campo de texto tem uma borda. | TextField | ||
borderColor : uint
A cor da borda do campo de texto. | TextField | ||
bottomScrollV : int [somente leitura]
Um inteiro (índice com base 1) que indica a linha na extremidade inferior que está atualmente visível no campo de texto especificado. | TextField | ||
cacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro. | DisplayObject | ||
caretIndex : int [somente leitura]
O índice da posição do ponto de inserção (circunflexo). | TextField | ||
condenseWhite : Boolean
Um valor booliano que especifica se o espaço em branco extra (espaços, quebras de linha, etc.) em um campo de texto com texto HTML deve ser removido. | TextField | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
contextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto. | InteractiveObject | ||
defaultTextFormat : flash.text:TextFormat
Especifica o formato aplicado ao texto recém-inserido, por exemplo, o texto inserido com o método replaceSelectedText() ou o texto digitado pelo usuário. | TextField | ||
displayAsPassword : Boolean
Especifica se o campo de texto é um campo de texto de senha. | TextField | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | ||
embedFonts : Boolean
Especifica se a renderização será feita com o uso de contornos de fontes incorporadas. | TextField | ||
filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | ||
focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | ||
gridFitType : String
O tipo de ajuste à grade utilizado para esse campo de texto. | TextField | ||
height : Number
Indica a altura do objeto de exibição, em pixels. | DisplayObject | ||
htmlText : String
Contém a representação HTML do conteúdo do campo de texto. | TextField | ||
length : int [somente leitura]
O número de caracteres em um campo de texto. | TextField | ||
loaderInfo : LoaderInfo [somente leitura]
Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence. | DisplayObject | ||
mask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado. | DisplayObject | ||
maxChars : int
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. | TextField | ||
maxScrollH : int [somente leitura]
O valor máximo de scrollH. | TextField | ||
maxScrollV : int [somente leitura]
O valor máximo de scrollV. | TextField | ||
metaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4. | DisplayObject | ||
mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Um valor booliano que indica se o Flash Player deverá rolar automaticamente os campos de texto de várias linhas quando o usuário clicar em um campo de texto e usar o botão de rolagem do mouse. | TextField | ||
mouseX : Number [somente leitura]
Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | ||
mouseY : Number [somente leitura]
Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | ||
multiline : Boolean
Indica se o campo é um campo de texto de várias linhas. | TextField | ||
name : String
Indica o nome da ocorrência de DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco. | InteractiveObject | ||
numLines : int [somente leitura]
Define o número de linhas de texto em um campo de texto de várias linhas. | TextField | ||
opaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. | DisplayObject | ||
parent : DisplayObjectContainer [somente leitura]
Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. | DisplayObject | ||
restrict : String
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. | TextField | ||
root : DisplayObject [somente leitura]
Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF. | DisplayObject | ||
rotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original. | DisplayObject | ||
rotationX : Number
Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rotationY : Number
Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rotationZ : Number
Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
scale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor. | DisplayObject | ||
scaleX : Number
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. | DisplayObject | ||
scaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | ||
scaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | ||
scrollH : int
A posição de rolagem horizontal atual. | TextField | ||
scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | ||
scrollV : int
A posição vertical do texto em um campo de texto. | TextField | ||
selectable : Boolean
Um valor booliano que indica se o campo de texto é selecionável. | TextField | ||
selectionBeginIndex : int [somente leitura]
O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. | TextField | ||
selectionEndIndex : int [somente leitura]
O valor de índice de caractere com base em zero do último caractere na seleção atual. | TextField | ||
sharpness : Number
A nitidez das bordas de glifo neste campo de texto. | TextField | ||
softKeyboard : String
Controla a aparência do teclado suave. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS) | InteractiveObject | ||
stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | ||
styleSheet : StyleSheet
Anexa uma folha de estilo ao campo de texto. | TextField | ||
tabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação. | InteractiveObject | ||
tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | InteractiveObject | ||
text : String
Uma string que é o texto atual no campo de texto. | TextField | ||
textColor : uint
A cor do texto em um campo de texto, em formato hexadecimal. | TextField | ||
textHeight : Number [somente leitura]
A altura do texto, em pixels. | TextField | ||
textInteractionMode : String [somente leitura]
A propriedade de modo de interação, cujo valor padrão é TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [somente leitura]
A largura do texto, em pixels. | TextField | ||
thickness : Number
A espessura das bordas de glifo neste campo de texto. | TextField | ||
transform : flash.geom:Transform
Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição. | DisplayObject | ||
type : String
O tipo do campo de texto. | TextField | ||
useRichTextClipboard : Boolean
Especifica se a formatação do texto será ou não copiada e colada junto com o texto. | TextField | ||
visible : Boolean
Se o objeto de exibição está ou não visível. | DisplayObject | ||
width : Number
Indica a largura do objeto de exibição, em pixels. | DisplayObject | ||
wordWrap : Boolean
Um valor booliano que indica se o campo de texto tem quebra automática. | TextField | ||
x : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | ||
y : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | ||
z : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai. | DisplayObject |
Método | Definido por | ||
---|---|---|---|
Cria uma nova ocorrência de TextField. | TextField | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Acrescenta a string especificada pelo parâmetro newText ao final do texto do campo de texto. | TextField | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | ||
Retorna um retângulo que é a caixa delimitadora do caractere. | TextField | ||
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x e y. | TextField | ||
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo. | TextField | ||
Retorna uma referência DisplayObject para o id especificado, para uma imagem ou arquivo SWF que foi adicionado a um campo de texto formatado em HTML com o uso da marca <img>. | TextField | ||
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x e y. | TextField | ||
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex. | TextField | ||
Retorna o número de caracteres em uma linha de texto específica. | TextField | ||
Retorna informações de métrica de uma determinada linha de texto. | TextField | ||
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex especifica. | TextField | ||
Retorna o texto da linha especificada pelo parâmetro lineIndex. | TextField | ||
Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico. | TextField | ||
Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas. | DisplayObject | ||
Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex e endIndex. | TextField | ||
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais). | DisplayObject | ||
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais). | DisplayObject | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj. | DisplayObject | ||
Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y. | DisplayObject | ||
[estático]
Retorna true se uma fonte incorporada estiver disponível com os parâmetros fontName e fontStyle especificados, em que Font.fontType é flash.text.FontType.EMBEDDED. | TextField | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco. | DisplayObject | ||
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais). | DisplayObject | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Substitui a seleção atual pelo conteúdo do parâmetro value. | TextField | ||
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. | TextField | ||
Ativa um teclado virtual. | InteractiveObject | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Define, conforme selecionado, o texto designado pelos valores de índice do primeiro e último caracteres, que são especificados com os parâmetros beginIndex e endIndex. | TextField | ||
Aplica a formatação de texto determinada pelo parâmetro format ao texto especificado em um campo de texto. | TextField | ||
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 | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando um objeto de exibição é adicionado à lista de exibição. | DisplayObject | |||
Despachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido. | DisplayObject | |||
Despachado depois que um valor de controle é modificado, ao contrário do evento textInput, que é despachado antes de o valor ser modificado. | TextField | |||
Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto. | InteractiveObject | |||
Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR. | InteractiveObject | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto. | InteractiveObject | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto. | InteractiveObject | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true". | InteractiveObject | |||
[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro. | DisplayObject | |||
[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual. | DisplayObject | |||
Despachado depois que um objeto de exibição ganha foco. | InteractiveObject | |||
Despachado depois que um objeto de exibição perde o foco. | InteractiveObject | |||
[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts. | DisplayObject | |||
Enviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque. | InteractiveObject | |||
Despachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque). | InteractiveObject | |||
Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME | InteractiveObject | |||
Despachado quando o usuário pressiona uma tecla. | InteractiveObject | |||
Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado. | InteractiveObject | |||
Despachado quando o usuário solta uma tecla. | InteractiveObject | |||
Despachado quando um usuário clica em um hiperlink em um campo de texto habilitado para HTML, em que o URL começa com "event:". | TextField | |||
Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador. | InteractiveObject | |||
Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar. | InteractiveObject | |||
Despachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop(). | InteractiveObject | |||
Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite. | InteractiveObject | |||
Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite. | InteractiveObject | |||
Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite. | InteractiveObject | |||
Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto. | InteractiveObject | |||
Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela). | InteractiveObject | |||
Enviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject. | InteractiveObject | |||
Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição. | DisplayObject | |||
Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido. | DisplayObject | |||
[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada. | DisplayObject | |||
Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado por um objeto TextField após a rolagem pelo usuário. | TextField | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto. | InteractiveObject | |||
Despachado imediatamente depois que o teclado virtual é elevado. | InteractiveObject | |||
Despachado imediatamente antes de o teclado virtual ser elevado. | InteractiveObject | |||
Despachado imediatamente depois que o teclado virtual é baixado. | InteractiveObject | |||
Despachado quando o valor do sinalizador tabChildren do objeto é alterado. | InteractiveObject | |||
Despachado quando o sinalizador tabEnabled do objeto é alterado. | InteractiveObject | |||
Despachado quando o valor da propriedade tabIndex do objeto é alterado. | InteractiveObject | |||
O Flash Player despacha o evento textInput quando um usuário digita um ou mais caracteres de texto. | TextField | |||
O Flash Player emite o evento textInteractionModeChange quando o usuário altera o modo de interação de um campo de texto. | TextField | |||
Despachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque). | InteractiveObject | |||
Despachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque). | InteractiveObject | |||
Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido. | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque). | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject |
alwaysShowSelection | propriedade |
alwaysShowSelection:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Quando definida como true
e o campo de texto não está em foco, o Flash Player realça a seleção no campo de texto em cinza. Quando definida como false
e o campo de texto não está em foco, o Flash Player não realça a seleção no campo de texto.
O valor padrão é false.
Implementação
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_alwaysShowSelection extends Sprite { public function TextField_alwaysShowSelection() { var label1:TextField = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
antiAliasType | propriedade |
antiAliasType:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
O tipo de suavização de borda utilizado para esse campo de texto. Utilize as constantes de flash.text.AntiAliasType
para essa propriedade. Você poderá controlar essa definição apenas se a fonte estiver incorporada (com a propriedade embedFonts
definida como true
). A definição padrão é flash.text.AntiAliasType.NORMAL
.
Para definir valores para essa propriedade, utilize os seguintes valores de string:
Valor de string | Descrição |
---|---|
flash.text.AntiAliasType.NORMAL | Aplica a suavização de borda de texto regular. Este valor corresponde ao tipo de suavização de borda que o Flash Player 7 e versões anteriores usavam. |
flash.text.AntiAliasType.ADVANCED | Aplica a suavização de borda avançada, que torna o texto mais legível. (Esse recurso tornou-se disponível no Flash Player 8.) A suavização de borda avançada possibilita a renderização de alta qualidade das faces de fonte em tamanhos pequenos. É melhor utilizada com aplicativos que têm uma grande quantidade de texto pequeno. A suavização de borda avançada não é recomendada para fontes superiores a 48 pontos. |
Implementação
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Elementos da API relacionados
autoSize | propriedade |
autoSize:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Controla o dimensionamento e o alinhamento automáticos de campos de texto. Valores aceitáveis para as constantes TextFieldAutoSize
: TextFieldAutoSize.NONE
(padrão), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
e TextFieldAutoSize.CENTER
.
Se autoSize
for definido como TextFieldAutoSize.NONE
(padrão), nenhum redimensionamento ocorrerá.
Se autoSize
for definido como TextFieldAutoSize.LEFT
, o texto será tratado como texto justificado à esquerda; ou seja, a margem esquerda do campo de texto permanecerá fixa e o redimensionamento de uma linha única do campo de texto ocorrerá na margem direita. Se o texto incluir uma quebra de linha (por exemplo, "\n"
ou "\r"
), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap
também estiver definido como true
, apenas a parte inferior do campo de texto será redimensionada e o lado direito permanecerá fixo.
Se autoSize
for definido como TextFieldAutoSize.RIGHT
, o texto será tratado como texto justificado à direita; ou seja, a margem direita do campo de texto permanecerá fixa e o redimensionamento de uma linha única do campo de texto ocorrerá na margem esquerda. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r")
, a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap
também estiver definido como true
, apenas a parte inferior do campo de texto será redimensionada e o lado esquerdo permanecerá fixo.
Se autoSize
for definido como TextFieldAutoSize.CENTER
, o texto será tratado como texto justificado no centro; ou seja, qualquer redimensionamento de uma linha única do campo de texto será igualmente distribuído nas margens direita e esquerda. Se o texto incluir uma quebra de linha (por exemplo, "\n"
ou "\r"
), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap
também estiver definido como true
, apenas a parte inferior do campo de texto será redimensionada e os lados esquerdo e direito permanecerão fixos.
Implementação
public function get autoSize():String
public function set autoSize(value:String):void
Lança
ArgumentError — O autoSize especificado não é um membro de flash.text.TextFieldAutoSize.
|
Elementos da API relacionados
background | propriedade |
background:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se o campo de texto tem um preenchimento de plano de fundo. Se true
, o campo de texto terá um preenchimento de plano de fundo. Se false
, o campo de texto não terá um preenchimento de plano de fundo. Utilize a propriedade backgroundColor
para definir a cor do plano de fundo de um campo de texto.
O valor padrão é false.
Implementação
public function get background():Boolean
public function set background(value:Boolean):void
Elementos da API relacionados
backgroundColor | propriedade |
backgroundColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A cor do plano de fundo do campo de texto. O valor padrão é 0xFFFFFF
(branco). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver um plano de fundo. Mas, a cor ficará visível apenas se o campo de texto tiver a propriedade background
definida como true
.
Implementação
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Elementos da API relacionados
border | propriedade |
border:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se o campo de texto tem uma borda. Se true
, o campo de texto terá uma borda. Se false
, o campo de texto não terá uma borda. Utilize a propriedade borderColor
para definir a cor da borda.
O valor padrão é false.
Implementação
public function get border():Boolean
public function set border(value:Boolean):void
Elementos da API relacionados
borderColor | propriedade |
borderColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A cor da borda do campo de texto. O valor padrão é 0x000000
(preto). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver uma borda. Mas, a cor ficará visível apenas se o campo de texto tiver a propriedade border
definida como true
.
Implementação
public function get borderColor():uint
public function set borderColor(value:uint):void
Elementos da API relacionados
bottomScrollV | propriedade |
bottomScrollV:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um inteiro (índice com base 1) que indica a linha na extremidade inferior que está atualmente visível no campo de texto especificado. Considere o campo de texto como uma janela em um bloco de texto. A propriedade scrollV
é o índice com base 1 da linha visível mais alta na janela.
Todo o texto entre as linhas indicadas por scrollV
e bottomScrollV
está visível no momento no campo de texto.
Implementação
public function get bottomScrollV():int
Elementos da API relacionados
caretIndex | propriedade |
caretIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O índice da posição do ponto de inserção (circunflexo). Se nenhum ponto de inserção for exibido, o valor será a posição em que ponto de inserção estaria se você restaurasse o foco para o campo (normalmente, onde o ponto de inserção estava ou 0 se o campo não teve foco).
Os índices de extensão da seleção têm base em zero (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante).
Implementação
public function get caretIndex():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
printCursorPosition
seja chamado. Nesse caso, os valores das propriedades caretIndex
, selectionBeginIndex
e selectionEndIndex
são apresentados.
Execute esse exemplo e tente clicar no TextField para selecionar o texto. Em seguida, clique no campo sem selecionar o texto. Quando você clica no texto sem fazer uma seleção, a propriedade caretIndex
indica onde ocorre o ponto de inserção e as propriedades selectionBeginIndex
e selectionEndIndex
se igualam ao valor da propriedade caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
condenseWhite | propriedade |
condenseWhite:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor booliano que especifica se o espaço em branco extra (espaços, quebras de linha, etc.) em um campo de texto com texto HTML deve ser removido. O valor padrão é false
. A propriedade condenseWhite
afeta apenas o texto definido com a propriedade htmlText
, não a propriedade text
. Se você definir o texto com a propriedade text
, condenseWhite
será ignorado.
Se condenseWhite
for definido como true
, use os comandos HTML padrão, como <BR>
e <P>
, para colocar quebras de linha no campo de texto.
Defina a propriedade condenseWhite
antes da propriedade htmlText
.
Implementação
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
condenseWhite
como false
e como true
:
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_condenseWhite extends Sprite { public function TextField_condenseWhite() { var tf1:TextField = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; addChild(result); return result; } } }
defaultTextFormat | propriedade |
defaultTextFormat:flash.text:TextFormat
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica o formato aplicado ao texto recém-inserido, por exemplo, o texto inserido com o método replaceSelectedText()
ou o texto digitado pelo usuário.
Observação: na seleção de caracteres que serão substituídos por setSelection()
e replaceSelectedText()
, o defaultTextFormat
só será aplicado se o texto tiver sido selecionado até e inclusive o último caractere. Veja um exemplo:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
Quando você acessa a propriedade defaultTextFormat
, o objeto TextFormat retornado tem todas as sua propriedades definidas. Nenhuma propriedade é null
.
Observação: não será possível definir essa propriedade se uma folha de estilo for aplicada ao campo de texto.
Implementação
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.
|
Elementos da API relacionados
displayAsPassword | propriedade |
displayAsPassword:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se o campo de texto é um campo de texto de senha. Se o valor dessa propriedade for true
, o campo de texto será tratado como um campo de texto de senha e ocultará os caracteres digitados utilizando asteriscos, em vez dos próprios caracteres. Se false
, o campo de texto não será tratado como um campo de texto de senha. Quando o modo de senha for ativado, os comandos Recortar e Copiar e seus atalhos de teclado correspondentes não funcionarão. Esse mecanismo de segurança impede que um usuário inescrupuloso utilize os atalhos para descobrir uma senha em um computador desprotegido.
O valor padrão é false.
Implementação
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | propriedade |
embedFonts:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se a renderização será feita com o uso de contornos de fontes incorporadas. Se false
, o Flash Player renderizará o campo de texto utilizando fontes de dispositivo.
Se você definir a propriedade embedFonts
como true
para um campo de texto, será necessário especificar uma fonte para o texto utilizando a propriedade font
de um objeto TextFormat aplicado ao campo de texto. Se a fonte especificada não estiver incorporada ao arquivo SWF, o texto não será exibido.
O valor padrão é false.
Implementação
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Elementos da API relacionados
gridFitType | propriedade |
gridFitType:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
O tipo de ajuste à grade utilizado para esse campo de texto. Essa propriedade será aplicada apenas se a propriedade flash.text.AntiAliasType
do campo de texto for definida como flash.text.AntiAliasType.ADVANCED
.
O tipo de ajuste à grade utilizado determina se o Flash Player força as linhas fortes horizontais e verticais para que caibam em uma grade de pixels ou subpixels, ou não.
Para a propriedade flash.text.GridFitType
, você pode utilizar os seguintes valores de string:
Valor de string | Descrição |
---|---|
flash.text.GridFitType.NONE | Não especifica um ajuste à grade. As linhas horizontais e verticais nos glifos não são forçadas para a grade de pixels. A definição é recomendada para animação ou tamanhos de fonte grandes. |
flash.text.GridFitType.PIXEL | Especifica que linhas fortes horizontais e verticais são ajustadas à grade de pixels. Essa definição funciona apenas para campos de texto alinhados à esquerda. Para usá-la, a propriedade flash.dispaly.AntiAliasType do campo de texto deve ser definida como flash.text.AntiAliasType.ADVANCED . Em geral, essa definição fornece a melhor legibilidade para o texto alinhado à esquerda. |
flash.text.GridFitType.SUBPIXEL | Especifica que linhas fortes horizontais e verticais são ajustadas à grade de subpixels em um monitor LCD. Para utilizar essa definição, a propriedade flash.text.AntiAliasType do campo de texto deve ser definida como flash.text.AntiAliasType.ADVANCED . A definição flash.text.GridFitType.SUBPIXEL é geralmente apropriada para texto dinâmico alinhado à direita ou centralizado e, às vezes, é uma compensação útil para animação versus qualidade de texto. |
O valor padrão é pixel.
Implementação
public function get gridFitType():String
public function set gridFitType(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
gridFitType
. Quando você usar esse exemplo, observe a diferença de legibilidade nas duas primeiras linhas. Também observe o uso ideal de GridFitType.PIXEL
para texto alinhado à esquerda e GridFitType.SUBPIXEL
para texto alinhado à direita.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | propriedade |
htmlText:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contém a representação HTML do conteúdo do campo de texto.
O Flash Player oferece suporte para marcas HTML:
Marca | Descrição |
---|---|
Marca de âncora |
A marca <a> cria um link de hipertexto e oferece suporte aos seguintes atributos:
|
Marca de negrito |
A marca <b> renderiza o texto como negrito. Uma face de tipo negrito deve estar disponível para a fonte utilizada.
|
Marca de quebra |
A marca <br> cria uma quebra de linha no campo de texto. Defina o campo de texto como um campo de texto de várias linhas para usar essa marca.
|
Marca de fonte |
A marca <font> especifica uma fonte ou uma lista de fontes para exibir o texto. A marca de fonte oferece suporte aos seguintes atributos:
|
Marca de imagem |
A marca <img> permite que você incorpore arquivos de imagem externa (JPEG, GIF, PNG), arquivos SWF e clipes de vídeo aos campos de texto. O texto flui automaticamente pelas imagens que você incorpora nos campos de texto. Defina o campo de texto como sendo de várias linhas para dispor o texto ao redor de uma imagem.
A marca
O Flash exibe a mídia incorporada em um campo de texto com o tamanho total. Para especificar as dimensões da mídia que você está incorporando, use os atributos Em geral, uma imagem incorporada em um campo de texto é exibida na linha que segue a marca Para o conteúdo do AIR na área de segurança do aplicativo, o AIR ignora tags |
Marca de itálico |
A marca <i> exibe o texto selecionado em itálico. Uma face de tipo itálico deve estar disponível para a fonte utilizada.
|
Marca de item da lista |
A marca <li> coloca um marcador na frente do texto que ela envolve. Observação: Como o Flash Player e o AIR não reconhecem as marcas de lista ordenada e não ordenada (<ol> e <ul> ), elas não modificam como a sua lista será renderizada. Todas as listas não estão ordenadas e todos os itens da lista utilizam marcadores.
|
Marca de parágrafo |
A marca <p> cria um novo parágrafo. O campo de texto deve ser definido como um campo de texto de várias linhas para usar essa marca. A marca <p> oferece suporte aos seguintes atributos:
|
Marca span |
A marca <span> está disponível apenas para uso com estilos de texto CSS. Ela oferece suporte ao seguinte atributo:
|
Marca de formato de texto |
A marca A marca
|
Marca de sublinhado |
A marca <u> sublinha o texto selecionado.
|
O Flash Player e o AIR oferecem suporte às seguintes entidades HTML:
Entidade | Descrição |
---|---|
< | < (menor que) |
> | > (maior que) |
& | & (E comercial) |
" | " (aspas duplas) |
' | ' (apóstrofo, aspas simples) |
O Flash e o AIR também oferecem suporte a códigos de caractere explícitos, como & (E comercial ASCII) e € (Símbolo Unicode €).
Implementação
public function get htmlText():String
public function set htmlText(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
tf1
e atribui uma string formatada em HTML a sua propriedade text
. Quando sua propriedade htmlText
é rastreada, a saída será a string formatada em HTML, com marcas adicionais (como <P> e <FONT>) automaticamente adicionadas pelo Flash Player. Quando o valor da propriedade text
é rastreado, a string não formatada sem as marcas HTML é exibida.
Como comparação, as mesmas etapas são executadas em outro objeto TextField denominado tf2
, além do que um objeto StyleSheet é atribuído à propriedade styleSheet
de tf2
antes que sua propriedade htmlText
seja definida. Nesse caso, quando a propriedade htmlText
é rastreada, ela inclui apenas o texto HTML exato que foi originalmente atribuído à propriedade htmlText
, mostrando que nenhuma outra marca foi adicionada pelo Flash Player.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
length | propriedade |
maxChars | propriedade |
maxChars:int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. Um script pode inserir mais texto do que é permitido por maxChars
; a propriedade maxChars
indica apenas quanto texto um usuário pode digitar. Se o valor dessa propriedade for 0
, um usuário poderá digitar uma quantidade ilimitada de texto.
O valor padrão é 0.
Implementação
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | propriedade |
maxScrollV | propriedade |
mouseWheelEnabled | propriedade |
mouseWheelEnabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Um valor booliano que indica se o Flash Player deverá rolar automaticamente os campos de texto de várias linhas quando o usuário clicar em um campo de texto e usar o botão de rolagem do mouse. Por padrão, esse valor é true
. Essa propriedade será útil se você quiser impedir a rolagem de campos de texto pela roda do mouse ou implementar sua própria rolagem de campo de texto.
Implementação
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | propriedade |
multiline:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica se o campo é um campo de texto de várias linhas. Se o valor for true
, o campo de texto será de várias linhas; se o valor for false
, o campo de texto será de uma única linha. Em um campo de tipo TextFieldType.INPUT
, o valor de multiline
determina se a tecla Enter
criará uma nova linha (com o valor false
a tecla Enter
será ignorada). Se você colar texto em um TextField
com multiline
de valor false
, as novas linhas serão removidas do texto.
O valor padrão é false.
Implementação
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Elementos da API relacionados
numLines | propriedade |
numLines:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Define o número de linhas de texto em um campo de texto de várias linhas. Se a propriedade wordWrap
for definida como true
, o número de linhas aumentará quando houver quebra automática.
Implementação
public function get numLines():int
Elementos da API relacionados
restrict | propriedade |
restrict:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. Se o valor da propriedade restrict
for null
, você poderá digitar qualquer caractere. Se o valor da propriedade restrict
for uma string vazia, você não poderá digitar um caractere. Se o valor da propriedade restrict
for uma string de caracteres, você poderá digitar apenas os caracteres da string no campo de texto. A string é pesquisada da esquerda para a direita. É possível especificar um intervalo usando o caractere hífen (-). Somente a interação do usuário está restrita; um script pode colocar qualquer texto no campo de texto. Essa propriedade não é sincronizada com as opções de Incorporar fonte no Inspetor de propriedades.
Se a string começar com um circunflexo (^), todos os caracteres serão inicialmente aceitos e os caracteres seguintes na string serão excluídos do conjunto de caracteres aceitos. Se a string não começar com um circunflexo (^), nenhum caractere será inicialmente aceito e os caracteres seguintes na string serão incluídos no conjunto de caracteres aceitos.
O seguinte exemplo só permite que caracteres em maiúsculas, espaços e números sejam digitados em um campo de texto:
my_txt.restrict = "A-Z 0-9";
O seguinte exemplo inclui todos os caracteres, mas exclui letras minúsculas:
my_txt.restrict = "^a-z";
Você pode utilizar uma barra invertida para inserir um ^ ou - textual. As sequências de barra invertida aceitas são \-, \^ ou \\. A barra invertida deve ser um caractere real na string, portanto, quando especificada no ActionScript, uma barra invertida dupla deve ser utilizada. Por exemplo, o seguinte código inclui apenas o traço (-) e o circunflexo (^):
my_txt.restrict = "\\-\\^";
O ^ pode ser usado em qualquer lugar da string para alternar entre a inclusão e a exclusão de caracteres. O seguinte código inclui apenas letras maiúsculas, mas exclui a letra maiúscula Q:
my_txt.restrict = "A-Z^Q";
Você pode utilizar a sequência de escape \u
para construir strings restrict
. O seguinte código inclui apenas os caracteres de ASCII 32 (espaço) a ASCII 126 (til).
my_txt.restrict = "\u0020-\u007E";
O valor padrão é null.
Implementação
public function get restrict():String
public function set restrict(value:String):void
scrollH | propriedade |
scrollH:int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A posição de rolagem horizontal atual. Se a propriedade scrollH
for 0, o texto não será rolado na horizontal. O valor dessa propriedade é um número inteiro que representa a posição horizontal em pixels.
As unidades de rolagem horizontal são pixels, enquanto que as unidades de rolagem vertical são linhas. A rolagem horizontal é medida em pixels porque a maioria das fontes que você normalmente usa tem espaçamento proporcional; ou seja, os caracteres podem ter diferentes larguras. O Flash Player executa a rolagem vertical por linha porque os usuários normalmente querem ver uma linha completa de texto em vez de uma linha parcial. Mesmo se uma linha utilizar várias fontes, sua altura será ajustada para acomodar a fonte maior em uso.
Observação: a propriedade scrollH
será baseada em zero, não em 1 como a propriedade de rolagem vertical scrollV
.
Implementação
public function get scrollH():int
public function set scrollH(value:int):void
Elementos da API relacionados
scrollV | propriedade |
scrollV:int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A posição vertical do texto em um campo de texto. A propriedade scrollV
é útil para direcionar os usuários para um parágrafo específico, em uma longa passagem, ou para criar campos de texto de rolagem.
As unidades de rolagem vertical são linhas, enquanto que as unidades de rolagem horizontal são pixels. Se a primeira linha exibida for a primeira linha no campo de texto, scrollV será definido como 1 (não 0). A rolagem horizontal é medida em pixels porque a maioria das fontes tem espaçamento proporcional; ou seja, os caracteres podem ter diferentes larguras. O Flash executa a rolagem vertical por linha porque os usuários normalmente querem ver uma linha completa de texto em vez de uma linha parcial. Mesmo se existirem várias fontes em uma linha, sua altura será ajustada para acomodar a fonte maior em uso.
Implementação
public function get scrollV():int
public function set scrollV(value:int):void
Elementos da API relacionados
selectable | propriedade |
selectable:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor booliano que indica se o campo de texto é selecionável. O valor true
indica se o texto é selecionável. A propriedade selectable
controla se um campo de texto é selecionável e não se ele é editável. Um campo de texto dinâmico poderá ser selecionável mesmo se ele não for editável. Se um campo de texto dinâmico não for selecionável, o usuário não poderá selecionar o texto nele contido.
Se selectable
for definido como false
, o texto no campo de texto não responderá aos comandos de seleção do mouse nem do teclado, e o texto não poderá ser copiado com o comando Copiar. Se selectable
for definido como true
, o texto no campo de texto poderá ser selecionado com o mouse ou o teclado e também poderá ser copiado com o comando Copiar. Você pode selecionar o texto dessa maneira, mesmo se o campo de texto for um campo de texto dinâmico e não de entrada.
O valor padrão é true.
Implementação
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
selecionável
definida como true
e o outro campo de texto com a propriedade selecionável
definida como false
. Quando você usar esse exemplo, tente selecionar o texto nesses campos com o mouse ou teclado.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | propriedade |
selectionBeginIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. Por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante. Se nenhum texto for selecionado, essa propriedade será o valor de caretIndex
.
Implementação
public function get selectionBeginIndex():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
printCursorPosition
seja chamado. Nesse caso, os valores das propriedades caretIndex
, selectionBeginIndex
e selectionEndIndex
são apresentados.
Execute esse exemplo e tente clicar no TextField para selecionar o texto. Em seguida, clique no campo sem selecionar o texto. Quando você clica no texto sem fazer uma seleção, a propriedade caretIndex
indica onde ocorre o ponto de inserção e as propriedades selectionBeginIndex
e selectionEndIndex
se igualam ao valor da propriedade caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
selectionEndIndex | propriedade |
selectionEndIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de índice de caractere com base em zero do último caractere na seleção atual. Por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante. Se nenhum texto for selecionado, essa propriedade será o valor de caretIndex
.
Implementação
public function get selectionEndIndex():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
printCursorPosition
seja chamado. Nesse caso, os valores das propriedades caretIndex
, selectionBeginIndex
e selectionEndIndex
são apresentados.
Execute esse exemplo e tente clicar no TextField para selecionar o texto. Em seguida, clique no campo sem selecionar o texto. Quando você clica no texto sem fazer uma seleção, a propriedade caretIndex
indica onde ocorre o ponto de inserção e as propriedades selectionBeginIndex
e selectionEndIndex
se igualam ao valor da propriedade caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
sharpness | propriedade |
sharpness:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
A nitidez das bordas de glifo neste campo de texto. Essa propriedade será aplicada apenas se a propriedade flash.text.AntiAliasType
do campo de texto for definida como flash.text.AntiAliasType.ADVANCED
. O intervalo de sharpness
é um número de -400 a 400. Se você tentar definir sharpness
como um valor fora desse intervalo, o Flash definirá a propriedade para o valor mais próximo no intervalo (-400 ou 400).
O valor padrão é 0.
Implementação
public function get sharpness():Number
public function set sharpness(value:Number):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
nitidez
para um objeto TextField. Você deve incorporar a fonte e definir a propriedade antiAliasType
como ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | propriedade |
styleSheet:StyleSheet
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anexa uma folha de estilo ao campo de texto. Para obter informações sobre como criar planilhas, consulte a classe StyleSheet e o Guia do Desenvolvedor do ActionScript 3.0.
Você pode alterar a folha de estilo associada a um campo de texto a qualquer momento. Se você alterar a folha de estilo em uso, o campo de texto será redesenhado com a nova folha de estilo. Você pode definir a folha de estilo como null
ou undefined
para removê-la. Se a folha de estilo em uso for removida, o campo de texto será redesenhado sem uma folha de estilo.
Observação: se a folha de estilo for removida, o conteúdo de TextField.text
e TextField.htmlText
será alterado para incorporar a formatação anteriormente aplicada pela folha de estilo. Para preservar o conteúdo de TextField.htmlText
sem a formatação, salve o valor em uma variável antes de remover a folha de estilo.
Implementação
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
stylesheet
antes de configurar o conteúdo.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | propriedade |
text:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Uma string que é o texto atual no campo de texto. As linhas são separadas pelo caractere de retorno de carro ('\r'
, ASCII 13). Essa propriedade contém texto não formatado no campo de texto, sem marcas HTML.
Para obter o texto em formato HTML, utilize a propriedade htmlText
.
Nota: Se uma folha de estilos for aplicada ao conteúdo do campo de texto, o conteúdo da propriedade text
será interpretado como HTML.
Implementação
public function get text():String
public function set text(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
tf1
e atribui uma string formatada em HTML a sua propriedade text
. Quando sua propriedade htmlText
é rastreada, a saída será a string formatada em HTML, com marcas adicionais (como <P> e <FONT>) automaticamente adicionadas pelo Flash Player. Quando o valor da propriedade text
é rastreado, a string não formatada sem as marcas HTML é exibida.
Como comparação, as mesmas etapas são executadas em outro objeto TextField denominado tf2
, além do que um objeto StyleSheet é atribuído à propriedade styleSheet
de tf2
antes que sua propriedade htmlText
seja definida. Nesse caso, quando a propriedade htmlText
é rastreada, ela inclui apenas o texto HTML exato que foi originalmente atribuído à propriedade htmlText
, mostrando que nenhuma outra marca foi adicionada pelo Flash Player.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textColor | propriedade |
textColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A cor do texto em um campo de texto, em formato hexadecimal. O sistema de cores hexadecimais usa seis dígitos para representar os valores de cor. Cada dígito tem 16 valores ou caracteres possíveis. Os caracteres variam de 0 a 9 e de A a F. Por exemplo, o preto é 0x000000
; o branco é 0xFFFFFF
.
O valor padrão é 0 (0x000000).
Implementação
public function get textColor():uint
public function set textColor(value:uint):void
Exemplo ( Como usar este exemplo )
textColor
para vermelho (0xFF0000
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textColor extends Sprite { public function TextField_textColor() { var tf:TextField = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textHeight | propriedade |
textHeight:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A altura do texto, em pixels.
Implementação
public function get textHeight():Number
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
trace
exibem os valores das propriedades textWidth
e textHeight
. Para comparação, as propriedades width
e height
também são exibidas. (Observe que os valores que você vê para textHeight
e textWidth
podem variar dependendo da fonte utilizada em sua máquina).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
textInteractionMode | propriedade |
textInteractionMode:String
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 11, Flash Lite 4 |
A propriedade de modo de interação, cujo valor padrão é TextInteractionMode.NORMAL. Nas plataformas móveis, o modo normal significa que o texto pode ser rolado, mas não selecionado. É possível alternar para o modo selecionável usando o menu de contexto incorporado no campo de texto. Na área de trabalho, o modo normal significa que o texto está tanto no modo rolável quanto no de seleção.
Implementação
public function get textInteractionMode():String
textWidth | propriedade |
textWidth:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A largura do texto, em pixels.
Implementação
public function get textWidth():Number
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
trace
exibem os valores das propriedades textWidth
e textHeight
. Para comparação, as propriedades width
e height
também são exibidas. (Observe que os valores que você vê para textHeight
e textWidth
podem variar dependendo da fonte utilizada em sua máquina).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
thickness | propriedade |
thickness:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
A espessura das bordas de glifo neste campo de texto. Essa propriedade será aplicada apenas quando flash.text.AntiAliasType
for definida como flash.text.AntiAliasType.ADVANCED
.
O intervalo de thickness
é um número de -200 a 200. Se você tentar definir thickness
como um valor fora desse intervalo, a propriedade será definida como o valor mais próximo no intervalo (-200 ou 200).
O valor padrão é 0.
Implementação
public function get thickness():Number
public function set thickness(value:Number):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
espessura
para um objeto TextField. Você deve incorporar a fonte e definir a propriedade antiAliasType
como ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | propriedade |
type:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O tipo do campo de texto. Uma das seguintes constantes de TextFieldType: TextFieldType.DYNAMIC
, que especifica um campo de texto dinâmico, que um usuário não pode editar, ou TextFieldType.INPUT
, que especifica um campo de texto de entrada, que um usuário pode editar.
O valor padrão é dynamic.
Implementação
public function get type():String
public function set type(value:String):void
Lança
ArgumentError — O type especificado não é um membro de flash.text.TextFieldType.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
tfDynamic
e tfInput
. O texto é digitado nos dois campos de texto. No entanto, tfDynamic
tem sua propriedade type
definida como TextFieldType.DYNAMIC
e tfInput
tem sua propriedade type
definida como TextFieldType.INPUT
, portanto, o usuário pode modificar o texto em tfInput
, mas só pode exibir o texto em tfDynamic
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_type extends Sprite { public function TextField_type() { var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
useRichTextClipboard | propriedade |
useRichTextClipboard:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica se a formatação do texto será ou não copiada e colada junto com o texto. Quando definida como true
, o Flash Player copiará e colará a formatação (como alinhamento, negrito e itálico) quando você copiar e colar entre os campos de texto. Os campos de texto de origem e de destino para o procedimento de cópia e colagem devem ter useRichTextClipboard
definida como true
. O valor padrão é false
.
Implementação
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Exemplo ( Como usar este exemplo )
tf1
) e dois campos de texto dinâmicos (tf2
e tf3
). O código atribui cada campo de texto dinâmico a um objeto TextFormat (fonte Courier Bold). O campo de texto tf2
tem a propriedade useRichTextClipboard
definida como false
. O campo de texto tf3
tem a propriedade useRichTextClipboard
definida como true
. Quando você copia o texto do campo de texto tf2
e o cola no campo de texto tf1
, o texto colado não inclui a formatação. Quando você copia texto do campo de texto tf3
(que tem o useRichTextClipboard
definido como true
) e o cola no campo de texto tf1
, o texto colado inclui a formatação.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
wordWrap | propriedade |
wordWrap:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor booliano que indica se o campo de texto tem quebra automática. Se o valor de wordWrap
for true
, o campo de texto terá uma quebra automática; se o valor for false
, o campo de texto não terá uma quebra automática. O valor padrão é false
.
Implementação
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Exemplo ( Como usar este exemplo )
wordWrap
como true
e como false
. Duas ocorrências de TextField são criadas cujo conteúdo é muito grande para suas larguras. A propriedade wordWrap
da primeira (denominada tfWrap
) é definida como true
; e definida como false
para a segunda (tfNoWrap
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_wordWrap extends Sprite { public function TextField_wordWrap() { var tfWrap:TextField = createCustomTextField(10, 10, 100, 100); tfWrap.wordWrap = true; tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field"; var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100); tfNoWrap.wordWrap = false; tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
TextField | () | Construtor |
public function TextField()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria uma nova ocorrência de TextField. Depois de criar a ocorrência de TextField, chame o método addChild()
ou addChildAt()
do objeto DisplayObjectContainer pai para adicionar a ocorrência de TextField à lista de exibição.
O tamanho padrão de um campo de texto é 100 x 100 pixels.
Exemplo ( Como usar este exemplo )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | método |
public function appendText(newText:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Acrescenta a string especificada pelo parâmetro newText
ao final do texto do campo de texto. Este método é mais eficiente do que uma atribuição de adição (+=
) em uma propriedade text
(como someTextField.text += moreText
), particularmente para um campo de texto que contém uma quantidade significativa de conteúdo.
Parâmetros
newText:String — A string a ser acrescentada ao texto existente.
|
Exemplo ( Como usar este exemplo )
O campo de texto outputText
é definido para ajustar automaticamente o texto e para redimensionar como um texto justificado à esquerda, utilizando a propriedade autoSize
. A propriedade outputText.text
escreve a primeira linha do conteúdo e o método appendText()
acrescenta o restante do conteúdo. (Não é necessário iniciar com a propriedade text
. O método appendText()
também poderia ser utilizado para acrescentar texto do início.) A definição da propriedade text
uma segunda vez sobrescreverá o texto original. Utilize o operador +=
para acrescentar conteúdo com a propriedade text
.
A instrução if
verifica se a data é Sábado (6) ou Domingo (0). Se não for, o método toLocaleTimeString()
retorna a hora local, que é acrescentada ao conteúdo do campo de texto.
A propriedade length
do campo de texto é utilizada para ler o número de caracteres antes de a função ser chamada e a propriedade numLines
é utilizada para contar o número de linhas no campo de texto. Observe que as linhas vazias são contadas no número de linhas e os espaços vazios e as quebras de linha (\n) são contados ao determinar o tamanho do conteúdo.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_appendTextExample extends Sprite { public function TextField_appendTextExample() { var outputText:TextField = new TextField(); var today:Date = new Date(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.text = "WHAT TIME IS IT?" + "\n\n"; if((today.day == 0) || (today.day == 6)) { outputText.appendText("It's the weekend."); outputText.appendText("\n\n"); } else { outputText.appendText("The time is: "); outputText.appendText(today.toLocaleTimeString() + ".\n\n"); } outputText.appendText("Number of characters including line breaks and spaces so far: "); outputText.appendText(outputText.length.toString() + "\n"); outputText.appendText("Number of lines in the outputText: "); outputText.appendText(outputText.numLines.toString()); this.addChild(outputText); } } }
getCharBoundaries | () | método |
public function getCharBoundaries(charIndex:int):Rectangle
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna um retângulo que é a caixa delimitadora do caractere.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante).
|
Rectangle — Um retângulo com os valores mínimo e máximo x e y definindo a caixa delimitadora do caractere.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
getCharBoundaries()
é utilizado para marcar (colocar um realce sobre) um caractere que é selecionado pelo usuário.
A classe define o objeto Forma spotlight
que será utilizado para desenhar um retângulo em torno de cada caractere selecionado. Quando o usuário clica no campo de texto myTextField
, o método clickHandler()
é chamado.
No método clickHandler()
, o método getCharIndexAtPoint()
obtém o índice de caractere clicado com base nas coordenadas localX
e localY
do clique do mouse, que é relativo a Sprite
contido. O método getCharIndexAtPoint()
retornará -1
se o ponto (clique do mouse) não foi sobre um caractere. Uma vez que o campo de texto pode ser maior que o texto, o inteiro retornado (index
) é marcado para garantir que o usuário clicou em um caractere. O inteiro index
também é utilizado por getCharBoundaries()
para obter um objeto Rectangle
que contém o limite do caractere. O método clear()
limpa qualquer objeto Forma spotlight
anteriormente exibido. Um novo retângulo com o tamanho dos limites de largura e altura do caractere é produzido no local do caractere [deslocamento das coordenadas (10, 10)] utilizando as coordenadas x e y do retângulo frame
retornado. Para colocar o realce sobre o caractere, o objeto Forma spotlight
é preenchido com a cor amarela e a opacidade é definida como 35 por cento, de forma que o caractere possa ser visto. Observe que espaços também são considerados um caractere.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; import flash.display.Shape; public class TextField_getCharBoundariesExample extends Sprite { private var myTextField:TextField = new TextField(); private var spotlight:Shape = new Shape(); public function TextField_getCharBoundariesExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.selectable = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "Selected a character from this text by clicking on it." myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(spotlight); } private function clickHandler (e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { var frame:Rectangle = myTextField.getCharBoundaries(index); spotlight.graphics.clear(); spotlight.graphics.beginFill(0xFFFF00, .35); spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height); spotlight.graphics.endFill(); } } } }
getCharIndexAtPoint | () | método |
public function getCharIndexAtPoint(x:Number, y:Number):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x
e y
.
Parâmetros
x:Number — A coordenada x do caractere.
| |
y:Number — A coordenada y do caractere.
|
int — O valor de índice com base em zero do caractere (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante). Retorna -1 se o ponto não estiver sobre um caractere.
|
Exemplo ( Como usar este exemplo )
O primeiro campo de texto contém o texto que o usuário irá selecionar. Para garantir que o texto seja clicado e não selecionado, a propriedade selectable
é definida como false. Quando o usuário clica no campo de texto firstTextField
, o método clickHandler()
é chamado.
No método clickHandler()
, o método getCharIndexAtPoint()
retorna o índice de caractere com base nas coordenadas localX
e localY
do clique do mouse. Uma vez que o campo de texto pode ser maior que o texto, o inteiro retornado (index
) é marcado para garantir que o usuário clicou em um caractere. (O método getCharIndexAtPoint()
retornará -1
se o ponto (clique do mouse) não foi sobre um caractere.) As coordenadas do mouse são utilizadas para definir as coordenadas do novo campo de texto em que o caractere repetido será exibido. A cor do caractere no segundo campo de texto é definida como vermelho. Por fim, o texto do segundo campo é definido como o caractere selecionado, que é recuperado utilizando o método charAt()
. Observe que utilizar a propriedade text
em vez do método appendText()
sobrescreverá o caractere no segundo campo de texto, em vez de acrescentá-lo.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; public class TextField_getCharIndexAtPointExample extends Sprite { private var firstTextField:TextField = new TextField(); private var secondTextField:TextField = new TextField(); public function TextField_getCharIndexAtPointExample() { firstTextField.x = 100; firstTextField.y = 100; firstTextField.width = 260; firstTextField.height = 20; firstTextField.border = true; firstTextField.background = true; firstTextField.selectable = false; firstTextField.text = "Selected a character from this text by clicking on it." firstTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(firstTextField); this.addChild(secondTextField); } private function clickHandler (e:MouseEvent):void { var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { secondTextField.x = mouseX; secondTextField.y = 70; secondTextField.border = true; secondTextField.selectable = false; secondTextField.background = true; secondTextField.textColor = 0xFF0000; secondTextField.autoSize = TextFieldAutoSize.LEFT; secondTextField.text = firstTextField.text.charAt(index); } } } }
getFirstCharInParagraph | () | método |
public function getFirstCharInParagraph(charIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
|
int — O valor de índice com base em zero do primeiro caractere no mesmo parágrafo.
|
Lança
RangeError — O índice de caractere especificado está fora do intervalo.
|
Exemplo ( Como usar este exemplo )
No construtor, o campo de texto myTextField
é definido como texto com quebra automática. O método getTextFormat
retorna o formato original do primeiro caractere do conteúdo do campo de texto, que é colocado no objeto TextFormat originalFormat
. Um novo objeto TextFormat (newFormat
) também é definido e sua propriedade align
é atribuída a justificado à direita. Quando o usuário clica no campo de texto, o método clickHandler()
é chamado.
No método clickHandler()
, o método getCharIndexAtPoint()
retorna o índice de caractere com base nas coordenadas localX
e localY
do clique do mouse. A primeira instrução if
verifica se o usuário clicou em um caractere. Utilizando o inteiro clickIndex
retornado pelo método getCharIndexAtPoint()
, o método getFirstCharInParagraph()
retorna o índice do primeiro caractere no parágrafo que o usuário clicou. O índice do último caractere no parágrafo é determinado pela adição do tamanho do parágrafo (utilizando o método getParagraphLength()
) ao índice do primeiro caractere no parágrafo, menos o último caractere (\n
). A segunda instrução if
verifica o formato do primeiro caractere no parágrafo. Se seu valor de alinhamento for o mesmo que o do formato original (justificado à esquerda), o novo formato será aplicado a todos os caracteres no parágrafo. Do contrário, o formato do parágrafo será definido de volta ao formato original. Alinhamento, formatação para frente como recuo, marcador, parada de tabulação, margens à esquerda e à direita são formatos próprios para parágrafos. Observe que uma vez que a quebra automática ou quebra de linha é utilizada, a formatação somente será aplicada à primeira linha do parágrafo, se o argumento endIndex
não for definido para o método setTextFormat()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFormatAlign; public class TextField_getFirstCharInParagraphExample extends Sprite { private var myTextField:TextField = new TextField(); private var originalFormat:TextFormat = new TextFormat(); private var newFormat:TextFormat = new TextFormat(); public function TextField_getFirstCharInParagraphExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 300; myTextField.background = true; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n"); originalFormat = myTextField.getTextFormat(0); newFormat.align = TextFormatAlign.RIGHT; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(clickIndex != -1) { var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex); var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1)); if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) { myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex); }else { myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex); } } } } }
getImageReference | () | método |
public function getImageReference(id:String):DisplayObject
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna uma referência DisplayObject para o id
especificado, referente a um arquivo SWF ou de imagem que foi adicionado a um campo de texto formatado em HTML com o uso de uma marca <img>
. A marca <img>
está no seguinte formato:
<img src = 'filename.jpg' id = 'instanceName' >
Parâmetros
id:String — A id para correspondência (no atributo id da marca <img> ).
|
DisplayObject — O objeto de exibição relacionado ao arquivo de imagem ou SWF com o atributo id correspondente na marca <img> do campo de texto. Para a mídia carregada de uma fonte externa, esse objeto será um objeto Loader e, uma vez carregado, o objeto de mídia será o filho do objeto Loader. Para a mídia incorporada no arquivo SWF, esse será o objeto carregado. Se não houver uma marca <img> com o id correspondente, o método retornará null .
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
A imagem (image.jpg
) é incluída via HTML. (Aqui, pressupõe-se que um arquivo de imagem esteja no mesmo diretório que o arquivo SWF.) Um atributo id
precisa ser definido para a marca img
para acessar a imagem utilizando o método getImageReference()
. A propriedade htmlText
é utilizada para incluir o conteúdo da string formatado em HTML. Quando o usuário clica no campo de texto myTextField
, o método clickHandler()
é chamado.
No método clickHandler()
, o método getImageReference()
retorna uma referência à imagem como um DisplayObject
. Essa referência pode ser utilizada para manipular a imagem, como qualquer objeto DisplayObject
. Aqui, as propriedades alpha
(transparência) e rotation
são definidas. A propriedade transform
também pode ser utilizada para acessar a matriz, a transformação de cores e os limites de pixel do objeto de exibição. Observe também que flash.display.DisplayObject
precisa ser importado.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.Event; import flash.events.MouseEvent; import flash.display.DisplayObject; import flash.text.TextFieldAutoSize; public class TextField_getImageReferenceExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_getImageReferenceExample() { var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>"; myTextField.x = 10; myTextField.y = 10; myTextField.width = 250; myTextField.height = 250; myTextField.background = true; myTextField.border = true; myTextField.border = true; myTextField.multiline = true; myTextField.htmlText = myText1; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var imageRef:DisplayObject = myTextField.getImageReference("testimage"); imageRef.rotation += 90; imageRef.x = 125; imageRef.y = 125; imageRef.alpha = 0.25; } } }
getLineIndexAtPoint | () | método |
public function getLineIndexAtPoint(x:Number, y:Number):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x
e y
.
Parâmetros
x:Number — A coordenada x da linha.
| |
y:Number — A coordenada y da linha.
|
int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante). Retorna -1 se o ponto não estiver sobre uma linha.
|
Exemplo ( Como usar este exemplo )
No construtor, o campo de texto poem
é definido como sem quebra (já que é um poema). A propriedade autoSize
também é utilizada para definir o texto para ajustar-se automaticamente e para que seja redimensionado como um texto justificado à esquerda. O campo de texto poemCopy
é colocado sob o campo de texto poem
. Quando um usuário clica em alguma linha do poema, o método clickHandler()
é chamado.
No método clickHandler()
, o método getLineIndexAtPoint()
retorna o índice de linha de onde o usuário clicou com base nas coordenadas localX
e localY
do clique do mouse. (Uma vez que o poema original se ajusta ao tamanho do campo de texto aqui, não é necessário verificar se há um erro Fora do intervalo (RangeError
) acionado pelo método getCharIndexAtPoint()
.) O índice de linha é então utilizado para obter o conteúdo da linha como uma string com o método getLineText()
, que é acrescentado ao conteúdo do campo de texto poemCopy
. A cópia pode continuar sem interrupção, mas após um ponto, o texto ficará fora do intervalo do campo de texto poemCopy
visível.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexAtPointExample extends Sprite { private var poem:TextField = new TextField(); private var poemCopy:TextField = new TextField(); public function TextField_getLineIndexAtPointExample() { poem.border = true; poem.autoSize = TextFieldAutoSize.LEFT; poem.x = 10; poem.wordWrap = false; poemCopy.height = 250; poemCopy.width = 270; poemCopy.y = 230; poemCopy.x = 10; poemCopy.background = true; poemCopy.border = true; poemCopy.wordWrap = false; poem.appendText("Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved."); poem.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(poem); this.addChild(poemCopy); } private function clickHandler(e:MouseEvent):void { var index:int = poem.getLineIndexAtPoint(e.localX, e.localY); var s:String; s = poem.getLineText(index); poemCopy.appendText(s + "\n"); } } }
getLineIndexOfChar | () | método |
public function getLineIndexOfChar(charIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex
.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
|
int — O valor de índice com base em zero da linha.
|
Lança
RangeError — O índice de caractere especificado está fora do intervalo.
|
Exemplo ( Como usar este exemplo )
getLineIndexOfChar()
retorna os números de linha do 100o. e 500o. caracteres no campo de texto.
O campo de texto myTextField
é definido para quebra automática e redimensionamento como um texto justificado à esquerda. O método getLineIndexOfChar()
retorna o índice de linha dos índices de caractere especificados (100 e 500). Essas informações são então acrescentadas após o parágrafo. Observe que uma vez começando com 0, o índice de linha (index
) é aumentado em 1 para obter o número da linha. Além disso, se a exibição for redimensionada, o número da linha poderá mudar, mas as informações aqui permanecerão iguais, uma vez que o método só é chamado uma vez.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexOfCharExample extends Sprite { public function TextField_getLineIndexOfCharExample() { var myTextField:TextField = new TextField(); myTextField.x = 10; myTextField.y = 10; myTextField.width = 200; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n"); var index:int = myTextField.getLineIndexOfChar(100); myTextField.appendText("100th character is in line: " + (index + 1) + "\n"); index = myTextField.getLineIndexOfChar(500); myTextField.appendText("500th character is in line: " + (index + 1)); this.addChild(myTextField); } } }
getLineLength | () | método |
public function getLineLength(lineIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o número de caracteres em uma linha de texto específica.
Parâmetros
lineIndex:int — O número da linha da qual você quer o tamanho.
|
int — O número de caracteres na linha.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
Exemplo ( Como usar este exemplo )
Como uma ilustração, o campo de texto myTextField
, que exibe o texto que será contado, é definido como INPUT
, ou seja, os usuários podem realmente alterar as linhas ou adicionar linhas entre as linhas ou ao final. (Há uma linha vazia criada utilizando a quebra de linha (\n
) ao final da última linha.) O campo de texto countLines
, em que o resultado da contagem do tamanho da linha é exibido, é definido abaixo do campo de texto myTextField
e seu texto não pode ser selecionado. Quando o usuário clica em uma linha no campo de texto myTextField
, o método clickHandler()
é chamado.
No método clickHandler()
, o método getLineIndexAtPoint()
retorna o índice de linha de onde o usuário clicou, utilizando as coordenadas localX
e localY
do clique do mouse. A instrução if
verifica se o usuário clicou em um caractere. Em caso afirmativo, o método getLineLength()
, utilizando o índice da linha, retorna o número de caracteres na linha. Observe que as linhas vazias entre as linhas incluem a segunda quebra de linha (\n
) e têm uma contagem de 1 caractere, enquanto a linha após a última linha tem uma contagem 0. Espaços também contam como um caractere. Os usuários podem escrever uma nova linha ou alterar uma linha e obter sua contagem de caracteres ao clicar nela. Se a quebra automática for utilizada e a tela for redimensionada, o índice de linha poderá ser alterado.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.events.Event; import flash.events.MouseEvent; public class TextField_getLineLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countLines:TextField = new TextField(); public function TextField_getLineLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 350; myTextField.height = 150; myTextField.background = true; myTextField.border = true; myTextField.type = TextFieldType.INPUT; myTextField.appendText("Click on the lines to count its number of characters:\n\n"); myTextField.appendText("This is a short line.\n"); myTextField.appendText("This is a longer line than the last line.\n\n"); myTextField.appendText("This one is even longer than the one before. It has two sentences.\n"); this.addChild(myTextField); countLines.border = true; countLines.x = 10; countLines.y = 180; countLines.height = 30; countLines.width = 200; countLines.background = true; countLines.selectable = false; this.addChild(countLines); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY); if (index != -1) { var lenght:int = myTextField.getLineLength(index); countLines.text = "Number of characters in the line is: " + lenght.toString(); } } } }
getLineMetrics | () | método |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna informações de métrica de uma determinada linha de texto.
Parâmetros
lineIndex:int — O número da linha da qual você quer informações de métrica.
|
flash.text:TextLineMetrics — Um objeto TextLineMetrics.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
O texto acrescentado tem duas linhas de Song of Myself por Walt Whitman. Um novo objeto TextFormat (newFormat
) é utilizado para definir o formato da segunda linha. A primeira linha contém o formato padrão. O método getLineMetrics()
retorna um objeto TextLineMetrics
de uma linha específica. (O índice de linha começa com 0.) Utilizando os objetos TextLineMetrics metrics1
e metrics2
para as linhas um e dois, respectivamente, o valor de subida, descida, altura e espessura da linha são recuperados e exibidos. Os números resultantes são convertidos em string, mas não são arredondados. Observe que esse valor é para a linha e não para um caractere específico. Ele reflete o intervalo de caracteres de uma linha. Por exemplo, se uma linha tiver diferentes caracteres com diferentes formatos de altura, o caractere com a altura maior determinará o valor. Isso também significa que se um dos formatos do caractere for alterado, alguns dos valores de métrica também poderão ser alterados.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextLineMetrics; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.TextFormat; public class TextField_getLineMetricsExample extends Sprite { public function TextField_getLineMetricsExample() { var myTextField:TextField = new TextField(); var newFormat:TextFormat = new TextFormat(); myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.wordWrap = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n"); myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n"); newFormat.size = 14; newFormat.font = "Arial"; newFormat.italic = true; myTextField.setTextFormat(newFormat, 67, 139); var metrics1:TextLineMetrics = myTextField.getLineMetrics(0); myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n"); var metrics2:TextLineMetrics = myTextField.getLineMetrics(1); myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n"); addChild(myTextField); } } }
getLineOffset | () | método |
public function getLineOffset(lineIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex
especifica.
Parâmetros
lineIndex:int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante).
|
int — O valor de índice com base em zero do primeiro caractere na linha.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
Exemplo ( Como usar este exemplo )
O campo de texto myTextField
é definido como quebra automática. O campo de texto countField
exibirá o primeiro caractere da linha 4. Quando o usuário clica no campo de texto myTextField
, o método clickHandler()
é chamado.
No método clickHandler()
, o método getLineOffset()
retorna o índice do primeiro caractere no índice de linha 3, que é a quarta linha do texto. (A primeira linha tem um índice 0.) O método charAt()
é utilizado para obter o caractere, utilizando o índice do primeiro caractere da quarta linha. O conteúdo do campo de texto countField
é atualizado com essas informações, utilizando a propriedade text
do campo de texto countField
. Utilizar a propriedade countField.text
significa que toda vez depois do clique, o conteúdo do campo de texto countField
será sobrescrito. Se o usuário redimensionar a exibição, o conteúdo terá uma quebra automática e o primeiro caractere da linha 4 poderá mudar. Ao clicar novamente no campo myTextField
, o conteúdo do campo de texto countField
será atualizado com o novo primeiro caractere da quarta linha.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getLineOffsetExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getLineOffsetExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 150; myTextField.height = 300; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; countField.height = 20; countField.width = 200; countField.x = 10; countField.y = 320; countField.selectable = false; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var c:String; var index:int; index = myTextField.getLineOffset(3); c = myTextField.text.charAt(index); countField.text = "The first character of line 4 is: " + c; } } }
getLineText | () | método |
public function getLineText(lineIndex:int):String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o texto da linha especificada pelo parâmetro lineIndex
.
Parâmetros
lineIndex:int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante).
|
String — A string de texto contida na linha especificada.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
Exemplo ( Como usar este exemplo )
O campo de texto poem
é definido para ajustar automaticamente o texto e para redimensionar como um texto justificado à esquerda. A propriedade wordWrap
é definida como false
, assim, as linhas do poema não são quebradas. Isso não é um problema quando a propriedade autoSize
é utilizada normalmente. O loop for
é repetido pelas linhas do soneto, utilizando a propriedade numLines
do campo de texto. O método getLineText()
retorna o conteúdo da linha como uma string. (Observe que a propriedade numLines
retorna o número de linhas, começando com a linha 1, enquanto para o método getLineText()
, o número da linha começa com 0.) Utilizando o padrão de expressão regular (/love/i
), a instrução if
procura por qualquer substring da palavra, em maiúscula ou minúscula. Se o padrão for encontrado, o método search
retornará o índice da primeira substring correspondente, do contrário, retornará -1
(se não houver correspondência). O número da linha em que "love" foi encontrado ((i + 1)
) será então colocado na string lineResult
. O método string converte o argumento de número ((i + 1)
) em uma string, desde que exista um outro argumento que seja uma string (" "). O resultado da linha da pesquisa incluirá linhas com as palavras "loved" ou "Love's". Se a string "Love was found in lines:" foi acrescentada antes do loop for
, a palavra "Love" nessa linha também terá sido incluída.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.utils.Timer; import flash.events.TimerEvent; public class TextField_getLineTextExample extends Sprite { public function TextField_getLineTextExample() { var poem:TextField = new TextField(); var lineResult:String = ""; var pattern:RegExp = /love/i; poem.x = 10; poem.y = 10; poem.background = true; poem.wordWrap = false; poem.autoSize = TextFieldAutoSize.LEFT; poem.text = "Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved.\n\n"; for (var i:int = 0; i < poem.numLines; i++) { var s:String = poem.getLineText(i); if(s.search(pattern) != -1) { lineResult += (i + 1) + " "; } } poem.appendText("Love was found in lines: " + lineResult); this.addChild(poem); } } }
getParagraphLength | () | método |
public function getParagraphLength(charIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico. O tamanho é relativo ao primeiro caractere no parágrafo (conforme retornado por getFirstCharInParagraph()
), não ao índice de caractere passado.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
|
int — Retorna o número de caracteres no parágrafo.
|
Lança
RangeError — O índice de caractere especificado está fora do intervalo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
O campo de texto myTextField
exibe os parágrafos que o usuário selecionará. Quando o usuário clica no campo de texto, o evento MouseEvent.CLICK
é despachado e o método clickHandler()
é chamado. O tamanho do parágrafo e o número de caracteres "s" serão exibidos no campo de texto countField
, que é colocado abaixo do campo de texto myTextField
.
No método clickHandler()
, o método getCharIndexAtPoint()
retorna o índice de caractere com base nas coordenadas localX
e localY
do clique do mouse. A primeira instrução if
verifica se o usuário clicou em um caractere. O método getFirstCharInParagraph()
usa esse índice para retornar o índice do primeiro caractere no mesmo parágrafo. O tamanho do parágrafo retornado pelo método getParagraphLength()
é utilizado com o índice do primeiro caractere no parágrafo para determinar o índice do final do parágrafo. Um loop for
é repetido pelo parágrafo, procurando pelo número de caracteres "s".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getParagraphLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getParagraphLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 280; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField() constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); countField.x = 10; countField.y = 300; countField.height = 50; countField.width = 250; countField.background = true; countField.selectable = false; this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(index != -1) { var beginParag:int = myTextField.getFirstCharInParagraph(index); var paragLength:int = myTextField.getParagraphLength(index); var endParag:int = beginParag + paragLength; var sCount:uint = 0; for (var i:int = beginParag; i <= endParag; i++) { if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) { sCount++; } countField.text = "Paragraph length is: " + paragLength.toString() + "\n" + "Number of 's' characters in the paragraph: " + sCount.toString(); } } } } }
getTextFormat | () | método |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex
e endIndex
. Apenas as propriedades comuns a todo o texto especificado são definidas no objeto TextFormat resultante. Qualquer propriedade que seja mixed, o que significa que ela tem diferentes valores em diferentes pontos no texto, tem um valor null
.
Se você não especificar valores para esses parâmetros, esse método será aplicado a todo o texto no campo de texto.
A seguinte tabela descreve três possíveis usos:
Uso | Descrição |
---|---|
my_textField.getTextFormat() | Retorna um objeto TextFormat contendo informações de formatação para todo o texto em um campo de texto. Apenas as propriedades comuns a todo o texto no campo de texto são definidas no objeto TextFormat resultante. Qualquer propriedade que seja mixed, o que significa que ela tem diferentes valores em diferentes pontos no texto, tem um valor null . |
my_textField.getTextFormat(beginIndex:Number) | Retorna um objeto TextFormat contendo uma cópia do formato de texto do caractere na posição beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Retorna um objeto TextFormat contendo informações de formatação para a extensão de texto de beginIndex a endIndex-1 . Apenas as propriedades comuns a todo o texto no intervalo especificado são definidas no objeto TextFormat resultante. Qualquer propriedade mixed (ou seja, tem diferentes valores em diferentes pontos no intervalo) tem seu valor definido como null . |
Parâmetros
beginIndex:int (default = -1 ) — Opcional; um inteiro que especifica o local inicial de um intervalo de texto dentro do campo de texto.
| |
endIndex:int (default = -1 ) — Opcional; um inteiro que especifica a posição do primeiro caractere após a extensão de texto desejada. Conforme desejado, se você especificar os valores beginIndex e endIndex , o texto de beginIndex a endIndex-1 será lido.
|
flash.text:TextFormat — O objeto TextFormat que representa as propriedades de formatação do texto especificado.
|
Lança
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.
|
Elementos da API relacionados
Exemplo
Como usar este exemplo
Consulte o exemplo do método getFirstCharInParagraph() ou setTextFormat() quanto a ilustrações de como usar o método
getTextFormat()
.
isFontCompatible | () | método |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Retorna true se uma fonte incorporada estiver disponível com os parâmetros fontName
e fontStyle
especificados, em que Font.fontType
é flash.text.FontType.EMBEDDED
. A partir do Flash Player 10, dois tipos de fontes incorporadas podem aparecer em um arquivo SWF. As fontes incorporadas normais são usadas somente com objetos TextField. As fontes incorporadas CFF são usadas somente com as classes flash.text.engine. Os dois tipos são diferenciados pela propriedade fontType
da classe Font
, conforme retornados pela função enumerateFonts()
.
TextField não pode usar uma fonte de tipo EMBEDDED_CFF
. Se embedFonts
for definido como true
e a única fonte disponível no tempo de execução com o nome e estilo especificados for de tipo EMBEDDED_CFF
, o Flash Player não renderizará o texto, como se não houvesse nenhuma fonte incorporada com o nome e estilo especificados.
Se as fontes EMBEDDED
e EMBEDDED_CFF
estiverem disponíveis com o mesmo nome e estilo, a fonte EMBEDDED
será selecionada e o texto será processado com a fonte EMBEDDED
.
Parâmetros
fontName:String — O nome da fonte incorporada a ser verificada.
| |
fontStyle:String — Especifica o estilo de fonte a ser verificado. Use flash.text.FontStyle
|
Boolean — true se houver uma fonte compatível incorporada está disponível, caso contrário, será false .
|
Lança
ArgumentError — O fontStyle especificado não é membro de flash.text.FontStyle .
|
Elementos da API relacionados
replaceSelectedText | () | método |
public function replaceSelectedText(value:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Substitui a seleção atual pelo conteúdo do parâmetro value
. O texto é inserido na posição da seleção atual, utilizando o formato de caractere padrão e o formato de parágrafo padrão atuais. O texto não é tratado como HTML.
Você pode utilizar o método replaceSelectedText()
para inserir e excluir texto sem romper a formatação de caractere e parágrafo do restante do texto.
Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.
Parâmetros
value:String — A string que substituirá o texto atualmente selecionado.
|
Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
Dois objetos TextField diferentes são criados e ouvintes de evento são adicionados para os eventos MouseEvent.MOUSE_UP
. Mouse para cima ocorre quando o usuário solta o mouse, um evento que normalmente ocorre depois que uma seleção de texto é feita. Observe que a definição padrão de um campo de texto é para que seu texto seja selecionado.
No método mouseHandler1()
, quando um usuário solta o mouse no campo de texto myTextField1
, o texto é apagado e substituído por uma string vazia. Isso pode continuar até que todo o texto seja apagado. No método mouseHandler2()
, quando um usuário seleciona parte do texto no campo de texto myTextField2
, as propriedades selectionBeginIndex
e selectionEndIndex
são verificadas para ver se qualquer caractere foi selecionado. (As propriedades selectionBeginIndex
e selectionEndIndex
não terão o mesmo valor se parte do texto for selecionada.) O texto selecionado é então substituído pela string "NEW TEXT". Isso pode continuar até que todo o texto original do segundo campo de texto seja substituído pela string "NEW TEXT".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_replaceSelectedTextExample extends Sprite { private var myTextField1:TextField = new TextField(); private var myTextField2:TextField = new TextField(); public function TextField_replaceSelectedTextExample() { myTextField1.x = 10; myTextField1.width = 300; myTextField1.height = 50; myTextField1.background = true; myTextField1.border = true; myTextField1.text = "Select the text you want to remove from the line."; myTextField2.x = 10; myTextField2.y = 60; myTextField2.width = 300; myTextField2.height = 50; myTextField2.background = true; myTextField2.border = true; myTextField2.text = "Select the text you want to replace with NEW TEXT."; myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1); myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2); this.addChild(myTextField1); this.addChild(myTextField2); } private function mouseHandler1(e:MouseEvent):void { myTextField1.replaceSelectedText(""); } private function mouseHandler2(e:MouseEvent):void { if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) { myTextField2.replaceSelectedText("NEW TEXT"); } } } }
replaceText | () | método |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex
e endIndex
pelo conteúdo do parâmetro newText
. Conforme desejado, o texto de beginIndex
a endIndex-1
é substituído.
Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.
Parâmetros
beginIndex:int — O valor de índice com base em zero da posição inicial do intervalo de substituição.
| |
endIndex:int — A posição do índice com base em zero do primeiro caractere após a extensão de texto desejada.
| |
newText:String — O texto a ser utilizado para substituir o intervalo especificado de caracteres.
|
Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.
|
Exemplo ( Como usar este exemplo )
replaceText()
para excluir, substituir e inserir parte do texto em um campo de texto.
O campo de texto outputText
é definido para ajustar automaticamente o texto e para redimensionar como um texto justificado à esquerda. Com a primeira chamada do método replaceText()
, a primeira linha ("This is the wrong heading") é substituída por "THIS IS THE HEADING FOR EVERYONE". Com a segunda chamada do método, o texto "CORRECT" é inserido entre "THE" e "HEADING". Com a terceira chamada do método, as palavras "FOR EVERYONE" são excluídas. Observe que com cada chamada para o método appendText()
, os índices inicial e final do texto atual são alterados. Aqui, apenas o texto final (após terem sido realizadas as alterações) será exibido.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_replaceTextExample extends Sprite { public function TextField_replaceTextExample() { var outputText:TextField = new TextField(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.appendText("This is the wrong heading"); outputText.appendText("\n\n"); outputText.appendText("This is the body of the text."); outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE"); outputText.replaceText(12, 12, "CORRECT "); outputText.replaceText(27, 40, ""); this.addChild(outputText); } } }
setSelection | () | método |
public function setSelection(beginIndex:int, endIndex:int):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Define, conforme selecionado, o texto designado pelos valores de índice do primeiro e último caracteres, que são especificados com os parâmetros beginIndex
e endIndex
. Se os dois valores de parâmetro forem iguais, este método definirá o ponto de inserção, como se você tivesse definido a propriedade caretIndex
.
Parâmetros
beginIndex:int — O valor de índice com base em zero do primeiro caractere na seleção (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
| |
endIndex:int — O valor de índice com base em zero do último caractere na seleção.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
Dois ouvintes de evento para o campo de texto myTextField
respondem aos cliques do mouse do usuário ou aos eventos de mouse para cima. Mouse para cima ocorrerá quando o usuário soltar o mouse, um evento que normalmente ocorre depois que uma seleção de texto é feita. Observe que a definição padrão de um campo de texto é para que seu texto seja selecionado. Quando parte do texto é clicada, o método clickHandler()
é chamado. Quando parte do texto é selecionada e o mouse é liberado, o método mouseUpHandler()
é chamado.
Nos métodos clickHandler()
e mouseUpHandler()
, o método setSelection()
define apenas os caracteres entre os índices 54 e 70 (TEXT IN ALL CAPS) a ser selecionado.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_setSelectionExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_setSelectionExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } private function mouseUpHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } } }
setTextFormat | () | método |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aplica a formatação de texto determinada pelo parâmetro format
ao texto especificado em um campo de texto. O valor de format
deve ser um objeto TextFormat que especifica as alterações desejadas na formatação do texto. Apenas as propriedades que não são nulas de format
são aplicadas ao campo de texto. Qualquer propriedade de format
definida como null
não é aplicada. Por padrão, todas as propriedades de um objeto TextFormat recém-criado são definidas como null
.
Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.
O método setTextFormat()
altera a formatação de texto aplicada a um intervalo de caracteres ou a todo o corpo do texto em um campo de texto. Para aplicar as propriedades de format a todo o texto no campo de texto, não especifique valores para beginIndex
e endIndex
. Para aplicar as propriedades de format a um intervalo de texto, especifique valores para os parâmetros beginIndex
e endIndex
. Você pode utilizar a propriedade length
para determinar os valores de índice.
Os dois tipos de informações de formatação em um objeto TextFormat são formatação em nível de caractere e formatação em nível de parágrafo. Cada caractere em um campo de texto pode ter suas próprias definições de formatação de caractere, como nome de fonte, tamanho de fonte, negrito e itálico.
Para parágrafos, o primeiro caractere do parágrafo é examinado quanto às definições de formatação de todo o parágrafo. Exemplos de definições de formatação de parágrafo são margem à esquerda, margem à direita e recuo.
Qualquer texto inserido manualmente pelo usuário, ou substituído pelo método replaceSelectedText()
, recebe a formatação padrão do campo de texto do novo texto e não a formatação especificada para o ponto de inserção de texto. Para definir a formatação padrão do novo texto, use defaultTextFormat
.
Parâmetros
format:flash.text:TextFormat — Um objeto TextFormat que contém informações de formatação de caractere e parágrafo.
| |||||||||
beginIndex:int (default = -1 ) — Opcional; um inteiro que especifica a posição do índice com base em zero especificando o primeiro caractere do intervalo de texto desejado.
| |||||||||
endIndex:int (default = -1 ) — Opcional; um inteiro que especifica o primeiro caractere após a extensão de texto desejada. Conforme desejado, se você especificar os valores beginIndex e endIndex , o texto de beginIndex a endIndex-1 será atualizado.
Observe que qualquer texto inserido manualmente pelo usuário, ou substituído pelo método |
Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.
| |
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
Um ouvinte de evento para o campo de texto myTextField
é adicionado para responder aos cliques do mouse ao chamar o método clickHandler()
. No método clickHandler()
, o método getTextFormat()
retorna o formato atual de um caractere (índice 55) do intervalo de texto pretendido, que é então colocado no objeto TextFormat currentTextFormat
. A instrução if
verifica o formato do texto currentTextFormat
para ver se o caractere no intervalo está utilizando o novo formato (ponto de fonte definido como 18). Se não estiver, o novo formato muda o tamanho para 18 pontos, a cor para vermelho, e aplica sublinhado e itálico ao intervalo de texto entre 54-70 (TEXT IN ALL CAPS). Se o caractere no intervalo estiver utilizando o novo formato, o formato do intervalo retornará ao formato padrão (original) do campo de texto.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.events.MouseEvent; public class TextField_setTextFormatExample extends Sprite { private var myTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_setTextFormatExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.selectable = false; myTextField.background = true; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); newFormat.color = 0xFF0000; newFormat.size = 18; newFormat.underline = true; newFormat.italic = true; this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { var currentTextFormat:TextFormat = myTextField.getTextFormat(55); if(currentTextFormat.size != 18) { myTextField.setTextFormat(newFormat, 54, 70); } else { myTextField.setTextFormat(myTextField.defaultTextFormat); } } } }
change | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.CHANGE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado depois que um valor de controle é modificado, ao contrário do evento textInput
, que é despachado antes de o valor ser modificado. Diferente da versão do Modelo de evento W3C DOM do evento change
, que despacha o evento somente depois que o controle perde o foco, a versão ActionScript 3.0 do evento change
é despachada toda vez que o controle é alterado. Por exemplo, se um usuário digitar texto em um campo de texto, um evento change
será despachado depois de cada pressionamento de tecla.
Event.CHANGE
define o valor da propriedade type
de um objeto de evento change
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | true |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que tem seus respectivos valores modificados. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Exemplo ( Como usar este exemplo )
Dois campos de texto são criados, um para a entrada do usuário e o outro (headingTextField
) para a cópia da entrada do usuário. Um objeto TextFormat também é criado e o formato de texto padrão é atribuído ao campo de texto headingTextField
. Quando o conteúdo do campo de texto é alterado, o método changeHandler()
é chamado, o qual atribui o texto do campo de texto inputTextField
ao campo de texto headingTextField
. (Se o método foi chamado para o evento TextEvent.TEXT_INPUT
em vez do evento Event.CHANGE
, o conteúdo da entrada do usuário será copiado apenas depois que o usuário inserir mais texto.)
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; import flash.text.TextFormatAlign; import flash.events.Event; import flash.events.TextEvent; public class TextField_Event_changeExample extends Sprite { private var inputTextField:TextField = new TextField(); private var headingTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_Event_changeExample() { headingTextField.x = 10; headingTextField.y = 10; headingTextField.height = 30; headingTextField.width = 400; headingTextField.background = true; headingTextField.backgroundColor = 0xF5F5DC; headingTextField.selectable = false; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 230; inputTextField.background = true; inputTextField.border = true; inputTextField.maxChars = 40; inputTextField.wordWrap = true; inputTextField.type = TextFieldType.INPUT; inputTextField.addEventListener(Event.CHANGE, changeHandler); newFormat.bold = true; newFormat.size = 18; newFormat.color = 0xFF0000; newFormat.align = TextFormatAlign.CENTER; headingTextField.defaultTextFormat = newFormat; this.addChild(inputTextField); this.addChild(headingTextField); } private function changeHandler(e:Event):void { headingTextField.text = inputTextField.text; } } }
link | Evento |
flash.events.TextEvent
propriedade TextEvent.type =
flash.events.TextEvent.LINK
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando um usuário clica em um hiperlink em um campo de texto habilitado para HTML, em que o URL começa com "event:". O restante do URL depois de "event:" é colocado na propriedade de texto do evento LINK.
Observação: o comportamento padrão, adicionar texto ao campo de texto, ocorre apenas quando o Flash Player gera o evento, que, nesse caso, acontece quando um usuário tenta inserir texto. Você não pode colocar texto em um campo de texto enviando eventos textInput
a ele.
type
de um objeto de evento link
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | true |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O campo de texto que contém o hiperlink que foi clicado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
text | O restante do URL depois de "event:" |
Exemplo ( Como usar este exemplo )
playMP3()
é definida. Um objeto TextField denominado list
é criado e preenchido com texto HTML. O texto "Track 1"
e "Track 2"
são links dentro do campo de texto. A função playMP3() é chamada quando o usuário clica nos links. O nome do arquivo MP3, que segue a string "event:" no atributo href
da marca HTML, é passado para o método linkHandler()
como a propriedade text
do objeto de evento link
.
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.events.TextEvent; import flash.media.Sound; import flash.media.SoundChannel; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_event_link extends Sprite { private var myMP3:Sound; public function TextField_event_link() { myMP3 = new Sound(); var list:TextField = new TextField(); list.autoSize = TextFieldAutoSize.LEFT; list.multiline = true; list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>"; list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>"; addEventListener(TextEvent.LINK, linkHandler); addChild(list); } private function playMP3(mp3:String):void { try { myMP3.load(new URLRequest(mp3)); myMP3.play(); } catch(err:Error) { trace(err.message); } myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); } private function linkHandler(linkEvent:TextEvent):void { playMP3(linkEvent.text); } private function errorHandler(errorEvent:IOErrorEvent):void { trace(errorEvent.text); } } }
scroll | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.SCROLL
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado por um objeto TextField após a rolagem pelo usuário.
A constanteEvent.SCROLL
define o valor da propriedade type
de um objeto de evento scroll
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto TextField que foi rolado. A propriedade target nem sempre é o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Exemplo ( Como usar este exemplo )
mouseDown
é lançado e o manipulador mouseDownScroll
associado é chamado. O manipulador mouseDownScroll()
faz um campo rolar. Em seguida, o evento scroll
é despachado e o manipulador scrollHandler()
associado atualiza o segundo campo de texto para exibir a posição de rolagem atual.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Evento |
flash.events.TextEvent
propriedade TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O Flash Player despacha o evento textInput
quando um usuário insere um ou mais caracteres de texto. Vários métodos de entrada de texto podem gerar esse evento, incluindo teclados padrão, IMEs (Editores de método de entrada), sistemas de reconhecimento de voz ou fala e até mesmo o ato de colar texto sem formatação ou informações de estilo.
type
de um objeto de evento textInput
.
Observação: Este evento não é despachado para as teclas Excluir ou Backspace.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | true |
cancelable | true ; chama o método preventDefault() para cancelar o comportamento padrão. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O campo de texto no qual os caracteres estão sendo inseridos. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
text | O caractere ou a string de caracteres inserida pelo usuário. |
Exemplo ( Como usar este exemplo )
textInput
é despachado, o manipulador textInputHandler()
é chamado e os caracteres são exibidos no segundo campo de texto: Quando um bloco de texto é colado no campo de entrada, o manipulador de evento copia o bloco inteiro para o outro bloco.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Evento |
flash.events.Event
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 11, Flash Lite 4 |
O Flash Player despacha o evento textInteractionModeChange
quando o usuário altera o modo de interação de um campo de texto. por exemplo, no Android é possível alternar do modo NORMAL para o modo SELECTION usando as opções do menu de contexto
TextFieldExample
para exibir uma mensagem de texto. Isso é realizado com as seguintes etapas:
- Uma propriedade
label
do tipo TextField é criada. - O construtor de classe chama a função
configureLabel()
. - O método
configureLabel()
cria primeiro um novo objeto TextField e o atribui à propriedadelabel
. Em seguida, define seus parâmetros como a seguir:- Justifica à esquerda o campo de texto.
- Ativa o preenchimento do plano de fundo.
- Ativa a borda.
- O método
configureLabel()
cria a variávelformat
e a atribui a uma nova ocorrência TextFormat com seus parâmetros definidos como a seguir:- Tipo de fonte = Verdana
- Cor da fonte = solid red
- Tamanho da fonte = 10
- Fonte sublinhada = true
- A propriedade
defaultTextFormat
do campo de textolabel
é definida comoformat
e a ocorrêncialabel
é adicionada à lista de exibição, que exibe inicialmente um campo de texto sem texto no palco. - O construtor define o texto do campo de texto
label
como"Hello world and welcome to the show."
chamando o métodosetLabel()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFormat; public class TextFieldExample extends Sprite { private var label:TextField; private var labelText:String = "Hello world and welcome to the show."; public function TextFieldExample() { configureLabel(); setLabel(labelText); } public function setLabel(str:String):void { label.text = str; } private function configureLabel():void { label = new TextField(); label.autoSize = TextFieldAutoSize.LEFT; label.background = true; label.border = true; var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.color = 0xFF0000; format.size = 10; format.underline = true; label.defaultTextFormat = format; addChild(label); } } }
Wed Jun 13 2018, 11:10 AM Z