Pacote | fl.controls |
Classe | public class TextInput |
Herança | TextInput UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementações | IFocusManagerComponent |
Subclasses | DataGridCellEditor |
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Um componente TextInput pode estar ativado ou desativado em um aplicativo. Quando o componente TextInput está desativado, ele não pode receber entradas do mouse ou do teclado. Um componente TextInput implementa foco, seleção e navegação, como um objeto TextField do ActionScript.
É possível usar estilos para personalizar o componente TextInput alterando sua aparência -- por exemplo, quando está desativado. Algumas outras personalizações que podem ser aplicadas a esse componente incluem sua formatação com HTML ou sua definição como um campo de senha cujo texto deve ser oculto.
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
Obtém ou define um valor booliano que indica como uma seleção é exibida quando o campo de texto não possui foco. | TextInput | ||
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 | ||
buttonMode : Boolean
Especifica o modo de botão desta entidade gráfica. | Sprite | ||
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 | ||
condenseWhite : Boolean
Obtém ou define um valor booliano que indica se o espaço em branco extra é removido de um componente TextInput que contém texto HTML. | TextInput | ||
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 | ||
displayAsPassword : Boolean
Obtém ou define um valor booliano que indica se a ocorrência do componente TextInput foi criada para conter uma senha ou um texto. | TextInput | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | ||
dropTarget : DisplayObject [somente leitura]
Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta. | Sprite | ||
editable : Boolean
Obtém ou define um valor booliano que indica se o campo de texto pode ser editado pelo usuário. | TextInput | ||
enabled : Boolean [substituir]
Obtém ou define um valor que indica se o componente pode aceitar a interação do usuário. | TextInput | ||
filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | ||
focusEnabled : Boolean
Obtém ou define um valor booliano que indica se o componente pode receber foco depois que o usuário clicar nele. | UIComponent | ||
focusManager : IFocusManager
Obtém ou define o FocusManager que controla o foco para este componente e seus semelhantes. | UIComponent | ||
focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | ||
graphics : Graphics [somente leitura]
Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer. | Sprite | ||
height : Number [substituir]
Obtém ou define a altura do componente, em pixels. | UIComponent | ||
hitArea : Sprite
Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica. | Sprite | ||
horizontalScrollPosition : int
Obtém ou define a posição da miniatura da barra de rolagem horizontal. | TextInput | ||
htmlText : String
Contém a representação HTML da string que o campo de texto contém. | TextInput | ||
imeMode : String
Obtém ou define o modo do editor de métodos de entrada (IME). | TextInput | ||
length : int [somente leitura]
Obtém o número de caracteres em um componente TextInput. | TextInput | ||
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
Obtém ou define o número máximo de caracteres que um usuário pode inserir no campo de texto. | TextInput | ||
maxHorizontalScrollPosition : int [somente leitura]
Obtém um valor que descreve a posição mais distante até a qual o campo de texto pode ser rolado para a direita. | TextInput | ||
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 | ||
mouseChildren : Boolean
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Obtém ou define um valor que indica se o componente pode receber foco depois que o usuário clicar nele. | UIComponent | ||
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 | ||
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 | ||
numChildren : int [somente leitura]
Retorna o número de filhos deste objeto. | DisplayObjectContainer | ||
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
Obtém ou define a string de caracteres que o campo de texto aceita de um usuário. | TextInput | ||
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 [substituir]
Multiplica a largura atual do componente por um fator escalar. | UIComponent | ||
scaleY : Number [substituir]
Multiplica a altura atual do componente por um fator escalar. | UIComponent | ||
scaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | ||
scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | ||
selectionBeginIndex : int [somente leitura]
Obtém o valor de índice do primeiro caractere selecionado em uma seleção de um ou mais caracteres. | TextInput | ||
selectionEndIndex : int [somente leitura]
Obtém a posição de índice do último caractere selecionado em uma seleção de um ou mais caracteres. | TextInput | ||
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 | ||
soundTransform : flash.media:SoundTransform
Controla o som nesta entidade gráfica. | Sprite | ||
stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | ||
tabChildren : Boolean
Determina se os filhos do objeto estão ativados para tabulação. | DisplayObjectContainer | ||
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
Obtém ou define uma string que contém o texto que se encontra atualmente no componente TextInput. | TextInput | ||
textField : flash.text:TextField
Uma referência ao campo de texto interno do componente TextInput. | TextInput | ||
textHeight : Number [somente leitura]
A altura do texto, em pixels. | TextInput | ||
textSnapshot : flash.text:TextSnapshot [somente leitura]
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
textWidth : Number [somente leitura]
A largura do texto, em pixels. | TextInput | ||
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 | ||
useHandCursor : Boolean
Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true". | Sprite | ||
visible : Boolean [substituir]
Obtém ou define um valor que indica se a ocorrência do componente atual é visível. | UIComponent | ||
width : Number [substituir]
Obtém ou define a largura do componente, em pixels. | UIComponent | ||
x : Number [substituir]
Obtém ou define a coordenada x que representa a posição do componente ao longo do eixo x em seu contêiner-pai. | UIComponent | ||
y : Number [substituir]
Obtém ou define a coordenada y que representa a posição do componente ao longo do eixo y em seu contêiner-pai. | UIComponent | ||
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 do componente TextInput. | TextInput | ||
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
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 após o último caractere que TextArea contém. | TextInput | ||
Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado. | DisplayObjectContainer | ||
Exclui uma propriedade de estilo desta ocorrência do componente. | UIComponent | ||
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
[substituir]
Mostra ou oculta o indicador de foco neste componente. | TextInput | ||
Inicia uma operação imediata de desenho, sem invalidar nada como faz invalidateNow. | UIComponent | ||
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 a ocorrência do objeto de exibição-filho que existe no índice especificado. | DisplayObjectContainer | ||
Retorna o objeto de exibição-filho que existe com o nome especificado. | DisplayObjectContainer | ||
Retorna a posição de índice de uma ocorrência-filho de DisplayObject. | DisplayObjectContainer | ||
Recupera o objeto que possui foco no momento. | UIComponent | ||
Recupera informações sobre uma linha de texto especificada. | TextInput | ||
Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
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 | ||
Recupera uma propriedade de estilo definida na cadeia de pesquisa de estilo do componente. | UIComponent | ||
[estático]
Recupera o mapa de estilos padrão do componente atual. | TextInput | ||
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 | ||
Marca uma propriedade como inválida e redesenha o componente no quadro seguinte, a não ser que especificado de outra forma. | UIComponent | ||
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 | ||
[estático]
Mescla os estilos de várias classes em um objeto. | UIComponent | ||
Move o componente até a posição especificada em seu pai. | UIComponent | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer. | DisplayObjectContainer | ||
Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer. | DisplayObjectContainer | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Ativa um teclado virtual. | InteractiveObject | ||
Altera a posição de um filho existente no contêiner de objetos de exibição. | DisplayObjectContainer | ||
Define o foco para este componente. | UIComponent | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Define a faixa de uma seleção feita em uma área de texto que possui foco. | TextInput | ||
Define o componente para a largura e altura especificadas. | UIComponent | ||
Define uma propriedade de estilo nesta ocorrência do componente. | UIComponent | ||
Permite ao usuário arrastar a entidade gráfica especificada. | Sprite | ||
Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque. | Sprite | ||
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto. | DisplayObjectContainer | ||
Finaliza o método startDrag(). | Sprite | ||
Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque. | Sprite | ||
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. | DisplayObjectContainer | ||
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. | DisplayObjectContainer | ||
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 | ||
Valida e atualiza as propriedades e o layout deste objeto, redesenhando-o se necessário. | UIComponent | ||
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 quando a entrada do usuário altera o texto no componente TextInput. | TextInput | |||
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 | |||
Despachado quando o usuário pressiona a tecla Enter. | TextInput | |||
[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 | |||
Despachado depois que a visibilidade do componente muda de visível para invisível. | UIComponent | |||
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 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 após a movimentação do componente. | UIComponent | |||
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 após o redimensionamento do componente. | UIComponent | |||
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 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 depois que a visibilidade do componente muda de invisível para visível. | UIComponent | |||
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 | |||
Despachado quando o usuário insere texto. | TextInput | |||
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 |
Os estilos são comuns ou associados a um tema específico. Se o estilo for comum, poderá ser usado com qualquer tema. Se o estilo for associado a um tema específico, só poderá ser usado se o seu aplicativo usar esse tema.
Estilo | Descrição | Definido por | ||
---|---|---|---|---|
disabledSkin | Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O nome da classe a ser usada como plano de fundo para o componente TextInput quando sua propriedade ativado é definida como false .
O valor padrão é TextInput_disabledSkin . | TextInput | ||
Tipo: flash.text.TextFormat Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O objeto TextFormat a ser usado para renderizar o rótulo do componente quando o botão é desabilitado. | UIComponent | |||
embedFonts | Tipo: Boolean Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Indica se os contornos de fonte incorporados são usados para renderizar o campo de texto. Se esse valor for true , o Flash Player renderiza o campo de texto usando contornos de fontes incorporados. Se esse valor for false , o Flash Player renderiza o campo de texto usando fontes do dispositivo.
Se você definir a propriedade false . | TextInput | ||
Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento que separa os limites externos do componente das arestas externas do indicador de foco, em pixels. | UIComponent | |||
Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa a ser usada para exibir indicadores de foco. | UIComponent | |||
Tipo: flash.text.TextFormat Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O objeto TextFormat a ser usado para renderizar o rótulo do componente. | UIComponent | |||
textPadding | Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento que separa a borda do componente do texto, em pixels. O valor padrão é 0 . | TextInput | ||
upSkin | Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O nome da classe a ser usada como plano de fundo para o componente TextInput. O valor padrão é TextInput_upSkin . | TextInput |
alwaysShowSelection | propriedade |
alwaysShowSelection:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define um valor booliano que indica como uma seleção é exibida quando o campo de texto não possui foco.
Quando esse valor é definido como true
e o campo de texto não tem foco, o Flash Player realça a seleção no campo de texto em cinza. Quando esse valor é definido como false
e o campo de texto não tem 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
Exemplo ( Como usar este exemplo )
setSelection()
:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
condenseWhite | propriedade |
condenseWhite:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define um valor booliano que indica se o espaço em branco extra é removido de um componente TextInput que contém texto HTML. Os exemplos de espaço em branco adicional no componente incluem espaços e quebras de linha. Um valor true
indica que o espaço em branco adicional foi removido; um valor false
indica que o espaço em branco adicional não foi removido.
Essa propriedade afeta apenas o texto definido pelo uso da propriedade htmlText
; ela não afeta o texto definido pela propriedade text
. Se você estiver usando a propriedade text
para definir texto, a propriedade condenseWhite
é ignorada.
Se a propriedade condenseWhite
for definida como verdadeira
, é necessário usar comandos HTML padrão, como <br> e <p>, para inserir quebras de linha no campo de texto.
O valor padrão é false.
Implementação
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Elementos da API relacionados
displayAsPassword | propriedade |
displayAsPassword:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define um valor booliano que indica se a ocorrência do componente TextInput foi criada para conter uma senha ou um texto. Um valor de true
indica que a ocorrência do componente é um campo de texto de senha; um valor de false
indica que a ocorrência do componente é um campo de texto normal.
Quando essa propriedade é definida como verdadeira
, para cada caractere que o usuário inserir no campo de texto, a ocorrência do componente TextInput exibe um asterisco. Além disso, os comandos Recortar e Copiar e seus atalhos de teclado ficam desativados. Essas medidas impedem a recuperação de uma senha em um computador autônomo.
O valor padrão é false.
Implementação
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
displayAsPassword
definida como verdadeira
e outra com a essa propriedade definida como false
:
import fl.controls.Label; import fl.controls.TextInput; var usernameLabel:Label = new Label(); usernameLabel.text = "User name:"; usernameLabel.move(10, 10); addChild(usernameLabel); var usernameTextInput:TextInput = new TextInput(); usernameTextInput.move(90, 10); addChild(usernameTextInput); var passwordLabel:Label = new Label(); passwordLabel.text = "Password:"; passwordLabel.move(10, 40); addChild(passwordLabel); var passwordTextInput:TextInput = new TextInput(); passwordTextInput.displayAsPassword = true; passwordTextInput.move(90, 40); addChild(passwordTextInput);
editable | propriedade |
editable:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define um valor booliano que indica se o campo de texto pode ser editado pelo usuário. Um valor true
indica que o usuário pode editar o campo de texto; um valor false
indica que o usuário não pode editar o campo de texto.
O valor padrão é true.
Implementação
public function get editable():Boolean
public function set editable(value:Boolean):void
enabled | propriedade |
enabled:Boolean
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define um valor que indica se o componente pode aceitar a interação do usuário. O valor true
indica que o componente pode aceitar interação do usuário; o valor false
indica que ele não pode aceitar.
Se você definir a propriedade enabled
como false
, a cor do contêiner ficará esmaecia e a entrada do usuário será bloqueada (com exceção dos componentes Label e ProgressBar).
Implementação
override public function get enabled():Boolean
override public function set enabled(value:Boolean):void
horizontalScrollPosition | propriedade |
horizontalScrollPosition:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define a posição da miniatura da barra de rolagem horizontal.
O valor padrão é 0.
Implementação
public function get horizontalScrollPosition():int
public function set horizontalScrollPosition(value:int):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
horizontalScrollPosition
e maxHorizontalScrollPosition
:
import fl.controls.Label; import fl.controls.Slider; import fl.controls.TextInput; import fl.events.SliderEvent; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.width = 120; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler); myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler); addChild(myTextInput); var mySlider:Slider = new Slider(); mySlider.snapInterval = 1; mySlider.tickInterval = 10; mySlider.minimum = 0; mySlider.maximum = myTextInput.maxHorizontalScrollPosition; mySlider.value = myTextInput.horizontalScrollPosition; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler); mySlider.width = 120; mySlider.move(10, 40); addChild(mySlider); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = ""; myLabel.move(10, 50); addChild(myLabel); getScrollPosition(); function getScrollPosition():void { myTextInput.drawNow(); var scrollPos:uint = myTextInput.horizontalScrollPosition; var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition; myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos; mySlider.value = scrollPos; mySlider.maximum = maxScrollPos; } function scrollHandler(event:Event):void { getScrollPosition(); } function sliderChangeHandler(event:SliderEvent):void { myTextInput.horizontalScrollPosition = event.value; getScrollPosition(); } function textInputChangeHandler(event:Event):void { getScrollPosition(); }
htmlText | propriedade |
htmlText:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Contém a representação HTML da string que o campo de texto contém.
O valor padrão é "".
Implementação
public function get htmlText():String
public function set htmlText(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
htmlText
para aplicar a formatação HMTL ao texto do campo de texto:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.editable = false; myTextInput.enabled = false; myTextInput.htmlText = "(<i>auto assigned</i>)"; myTextInput.move(10, 10); addChild(myTextInput);
imeMode | propriedade |
imeMode:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define o modo do editor de métodos de entrada (IME). IME torna possível o uso de um teclado QWERTY pelos usuários, para inserir caracteres do conjunto de caracteres chineses, japoneses e coreanos.
O Flash define o IME como o modo especificado quando o componente obtém o foco e o restaura para o valor original, depois que o componente perde o foco.
A classe flash.system.IMEConversionMode define constantes para os valores válidos para essa propriedade. Defina essa propriedade como null
para impedir o uso do IME com o componente.
Implementação
public function get imeMode():String
public function set imeMode(value:String):void
length | propriedade |
length:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém o número de caracteres em um componente TextInput.
O valor padrão é 0.
Implementação
public function get length():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
maxChars
e restrict
para restringir os caracteres que podem ser inseridos:
import fl.controls.Label; import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "0-9A-F"; myTextInput.maxChars = 6; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; myLabel.move(10, 30); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; }
maxChars | propriedade |
maxChars:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define o número máximo de caracteres que um usuário pode inserir no campo de texto.
O valor padrão é 0.
Implementação
public function get maxChars():int
public function set maxChars(value:int):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
maxChars
e restrict
para restringir os caracteres que podem ser inseridos:
import fl.controls.Label; import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "0-9A-F"; myTextInput.maxChars = 6; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; myLabel.move(10, 30); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; }
maxHorizontalScrollPosition | propriedade |
maxHorizontalScrollPosition:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém um valor que descreve a posição mais distante até a qual o campo de texto pode ser rolado para a direita.
O valor padrão é 0.
Implementação
public function get maxHorizontalScrollPosition():int
Elementos da API relacionados
restrict | propriedade |
restrict:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define a string de caracteres que o campo de texto aceita de um usuário. Observe que os caracteres que não são incluídos nessa string são aceitos no campo de texto, se forem inseridos de forma programática.
Os caracteres na string são lidos da esquerda para a direita. É possível especificar uma faixa de caracteres usando o caractere hífen (-).
Se o valor dessa propriedade for null, o campo de texto aceita todos os caracteres. Se essa propriedade for definida como uma string vazia (""), o campo de texto não aceita caracteres.
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 valor padrão é null.
Implementação
public function get restrict():String
public function set restrict(value:String):void
Elementos da API relacionados
selectionBeginIndex | propriedade |
selectionBeginIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém o valor de índice do primeiro caractere selecionado em uma seleção de um ou mais caracteres.
A posição de índice de um caractere selecionado tem base em zero e é calculada a partir do primeiro caractere exibido na área de texto. Se não houver seleção, esse valor é definido como a posição do circunflexo.
O valor padrão é 0.
Implementação
public function get selectionBeginIndex():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
selectionBeginIndex
e selectionEndIndex
para um componente TextInput. Esse exemplo também cria duas ocorrências do componente Slider, que podem ser usadas para definir o índice de início da seleção e o índice de final de seleção de forma programática usando o método setSelection()
:
import fl.controls.Label; import fl.controls.Slider; import fl.controls.TextInput; import fl.events.SliderEvent; var myTextInput:TextInput = new TextInput(); myTextInput.alwaysShowSelection = true; myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.width = 120; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler); myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = ""; myLabel.move(10, 30); addChild(myLabel); var beginSlider:Slider = new Slider(); beginSlider.maximum = myTextInput.length; beginSlider.snapInterval = 1; beginSlider.liveDragging = true; beginSlider.width = 120; beginSlider.move(10, 65); beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler); addChild(beginSlider); var endSlider:Slider = new Slider(); endSlider.maximum = myTextInput.length; endSlider.snapInterval = 1; endSlider.liveDragging = true; endSlider.width = 120; endSlider.move(10, 85); endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler); addChild(endSlider); var t:Timer = new Timer(50); t.addEventListener(TimerEvent.TIMER, timerHandler); function changeHandler(event:Event):void { beginSlider.maximum = myTextInput.length; endSlider.maximum = myTextInput.length; updateUI(); } function focusInHandler(event:FocusEvent):void { t.start(); } function focusOutHandler(event:FocusEvent):void { t.stop(); } function beginChangeHandler(event:SliderEvent):void { myTextInput.setSelection(event.value, myTextInput.selectionEndIndex); updateUI(); } function endChangeHandler(event:SliderEvent):void { myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value); updateUI(); } function timerHandler(event:TimerEvent):void { updateUI(); } function updateUI():void { myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n"; myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex; beginSlider.value = myTextInput.selectionBeginIndex; endSlider.value = myTextInput.selectionEndIndex; }
selectionEndIndex | propriedade |
selectionEndIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém a posição de índice do último caractere selecionado em uma seleção de um ou mais caracteres.
A posição de índice de um caractere selecionado tem base em zero e é calculada a partir do primeiro caractere exibido na área de texto. Se não houver seleção, esse valor é definido como a posição do circunflexo.
O valor padrão é 0.
Implementação
public function get selectionEndIndex():int
Elementos da API relacionados
text | propriedade |
text:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém ou define uma string que contém o texto que se encontra atualmente no componente TextInput. Essa propriedade contém texto sem formatação e sem marcas HTML. Para recuperar esse texto formatado como HTML, use a propriedade htmlText
.
O valor padrão é "".
Implementação
public function get text():String
public function set text(value:String):void
Elementos da API relacionados
textField | propriedade |
public var textField:flash.text:TextField
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Uma referência ao campo de texto interno do componente TextInput.
Exemplo ( Como usar este exemplo )
textField
para acessar o objeto nativo subjacente TextField do ActionScript, além de chamar seu método replaceText()
:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.textField.replaceText(41, 44, "fox"); myTextInput.textField.replaceText(16, 19, "dog"); addChild(myTextInput);
textHeight | propriedade |
textWidth | propriedade |
textWidth:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
A largura do texto, em pixels.
O valor padrão é 0.
Implementação
public function get textWidth():Number
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
textWidth
e textHeight
sempre que o conteúdo do campo de texto for alterado:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); function changeHandler(event:Event):void { trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight); }
TextInput | () | Construtor |
public function TextInput()
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Cria uma nova ocorrência do componente TextInput.
appendText | () | método |
public function appendText(text:String):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Acrescenta a string especificada após o último caractere que TextArea contém. Esse método é mais eficiente do que concatenar duas strings usando uma atribuição de adição em uma propriedade de texto; por exemplo, myTextArea.text += moreText
. Esse método é particularmente útil quando o componente TextArea tem uma quantidade significativa de conteúdo.
Parâmetros
text:String — A string a ser anexada ao texto existente.
|
drawFocus | () | método |
override public function drawFocus(draw:Boolean):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Mostra ou oculta o indicador de foco neste componente.
A classe UIComponent implementa este método criando e posicionando uma ocorrência da classe que é especificada pelo estilo focusSkin
.
Parâmetros
draw:Boolean — Indica se é para mostrar ou ocultar o indicador de foco. Se este valor for true , o indicador de foco será exibido; se o valor for false , o indicador de foco ficará oculto.
|
getLineMetrics | () | método |
public function getLineMetrics(index:int):flash.text:TextLineMetrics
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera informações sobre uma linha de texto especificada.
Parâmetros
index:int — O número de linha para o qual a informação está sendo recuperada.
|
flash.text:TextLineMetrics |
Exemplo ( Como usar este exemplo )
var format:TextFormat = new TextFormat(); format.size = 72; format.font = "Georgia"; import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.setSize(393,82); ti.move(10,10); ti.setStyle("textFormat",format); ti.text = "Hello World"; ti.drawNow(); var metrics:TextLineMetrics = ti.getLineMetrics(0); var ascenderColoring:Shape = new Shape(); var descenderColoring:Shape = new Shape(); ti.addChild(ascenderColoring); ti.addChild(descenderColoring); ascenderColoring.graphics.clear(); ascenderColoring.graphics.beginFill(0xFF0000,0.2); ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent); descenderColoring.graphics.clear(); descenderColoring.graphics.beginFill(0x0000FF,0.2); descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
getStyleDefinition | () | método |
public static function getStyleDefinition():Object
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera o mapa de estilos padrão do componente atual. O mapa de estilos contém o tipo que é apropriado para o componente, de acordo com o estilo que o componente usa. Por exemplo, o estilo disabledTextFormat
contém o valor null
ou um objeto TextFormat. Você pode usar estes estilos e chamar setStyle()
no componente atual. O código a seguir substitui o estilo disabledTextFormat
padrão no componente especificado:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Objeto de estilos padrão.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
setSelection | () | método |
public function setSelection(beginIndex:int, endIndex:int):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Define a faixa de uma seleção feita em uma área de texto que possui foco. A faixa de seleção inicia no índice especificado pelo parâmetro inicial e termina no índice especificado pelo parâmetro final. Se os valores de parâmetros que especificam a faixa de seleção forem os mesmos, esse método define o ponto de inserção do mesmo modo que a propriedade caretIndex
.
O texto selecionado é tratado como uma string de caracteres com base em zero, na qual o primeiro caractere selecionado está localizado no índice 0, o segundo caractere está localizado no índice 1, e assim por diante.
Esse método não tem efeitos, se o campo de texto não tiver foco.
Parâmetros
beginIndex:int — O local de índice do primeiro caractere na seleção.
| |
endIndex:int — O local de índice do último caractere na seleção.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.text = "Hello World"; ti.setFocus(); ti.setSelection(6, 11);
setSelection()
:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
change | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.CHANGE
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Despachado quando a entrada do usuário altera o texto no componente TextInput.
Observação: esse evento não ocorre se o ActionScript for utilizado para alterar o texto.
A constanteEvent.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. |
enter | Evento |
fl.events.ComponentEvent
propriedade ComponentEvent.type =
fl.events.ComponentEvent.ENTER
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Despachado quando o usuário pressiona a tecla Enter.
Define o valor da propriedadetype
de um objeto de evento enter
.
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 de evento com um ouvinte de evento. |
target | O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento. |
textInput | Evento |
flash.events.TextEvent
propriedade TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flash CS3 |
Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Despachado quando o usuário insere texto.
Define o valor da propriedadetype
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. |
- Adicione os componentes TextInput, Label e Button à biblioteca
- Salve esse código como TextInputExample.as no mesmo diretório de FLA.
- Defina DocumentClass em FLA como TextInputExample
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.events.Event; import fl.controls.TextInput; import fl.controls.Label; import fl.controls.Button; public class TextInputExample extends Sprite { private var ti1:TextInput; private var ti2:TextInput; private var label1:Label; private var label2:Label; private var submitBtn:Button; public function TextInputExample() { setupLabels(); setupInputFields(); setupButton(); } private function setupInputFields():void { ti1 = new TextInput(); ti2 = new TextInput(); ti1.move(50,10); ti2.move(50,40); ti2.displayAsPassword = true; ti1.addEventListener(Event.CHANGE, textEntered); ti2.addEventListener(Event.CHANGE, textEntered); addChild(ti1); addChild(ti2); } private function setupLabels():void { label1 = new Label(); label2 = new Label(); label1.move(10,10); label2.move(10,40); label1.text = "User:"; label2.text = "Pass:" addChild(label1); addChild(label2); } private function setupButton():void { submitBtn = new Button(); submitBtn.move(150,70); submitBtn.label = "Go"; submitBtn.enabled = false; submitBtn.setSize(50,20); submitBtn.addEventListener(MouseEvent.CLICK, submitLogin); addChild(submitBtn); } private function textEntered(e:Event):void { if(ti1.text != "" && ti2.text != "") { submitBtn.enabled = true; } else { submitBtn.enabled = false; } } private function submitLogin(e:MouseEvent):void { var submitLabel:Label = new Label(); submitLabel.move(10,70); submitLabel.autoSize = "left"; submitLabel.text = "Login has been submitted." addChild(submitLabel); submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin); } } }
Wed Jun 13 2018, 11:10 AM Z