| Pacote | flash.text |
| Classe | public final class StageText |
| Herança | StageText  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Esta classe ativa aplicativos móveis para reunir a entrada de usuário utilizando controles de entrada de texto nativos em dispositivos móveis. Os controles de entrada em dispositivos móveis muitas vezes possuem interfaces de usuário extensas e comportamentos de suporte que não existem na área de trabalho. Por exemplo, muitos dispositivos móveis suportam recursos de entrada de texto como o seguinte:
- preenchimento automático
- correção automática
- seleção de texto baseada em toque
- teclados suaves personalizados
O sistema operacional subjacente (ou uma biblioteca de componente compactada com o sistema operacional) desenha campos de entrada de texto nativos. Os campos de entrada de texto nativos fornecem uma experiência que é familiar para cada um que já tenha utilizado outros aplicativos no mesmo dispositivo. No entanto, porque o sistema operacional desenha os campos de entrada de texto em vez do player, não é possível utilizar fontes incorporadas.
Suporte de perfil do AIR: este recurso é suportado em plataformas Android e iOS. O StageText utiliza campos de entrada de texto nativos em dispositivos móveis do Android e do iOS. Em outras plataformas, o StageText utiliza o Tempo de execução de Flash TextField.
Quando as entradas nativas são utilizadas, os objetos StageText não são objetos de exibição e não podem ser adicionados à lista de exibição do Flash. Em vez disso, você exibe um objeto StageText anexando-o diretamente a um palco usando a propriedade stage. A instância StageText anexada a um palco é exibida por cima de qualquer objeto de exibição em Flash. Você controla o tamanho e a posição da área de renderização com a propriedade viewPort. Não há nenhum modo de controlar a classificação da profundidade de diferentes objetos StageText. Não é recomendável sobrepor duas instâncias.
Quando um objeto StageText tem foco, ele tem a primeira oportunidade de manipular a entrada pelo teclado. A etapa à qual o objeto StageText é anexado não despachará nenhuma entrada pelo teclado.
Como a classe de StageText envolve um controle nativo diferente em cada plataforma, seus recursos são suportados em graus variados por cada plataforma. Onde os recursos são suportados, eles poderão comportar-se diferentemente entre plataformas. Ao tentar utilizar um determinado recurso em uma determinada plataforma, é melhor testar o comportamento. Somente em plataformas de desktop onde os controles nativos não são utilizados o comportamento de StageText será semelhante ao comportamento de texto do Tempo de execução do Flash.
StageText na Apple TV recebe o foco por padrão. Para gerenciar o foco entre diferentes objetos em seu aplicativo, mantenha em mente as seguintes observações:
- Para ignorar o foco padrão de StageText, ou para atribuir foco a outro objeto em exibição, use stage.focus
- Para atribuir foco a StageText, use stageText.assignFocus()
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| autoCapitalize : String
Controla como um dispositivo aplica a capitalização automática na entrada de usuário. | StageText | ||
| autoCorrect : Boolean
Indica se um dispositivo corrige automaticamente erros de pontuação ou ortografia na entrada de usuário. | StageText | ||
| clearButtonMode : String [somente gravação]
O modo de clearButton para o objeto StageText atual. | StageText | ||
| color : uint
Especifica a cor do texto. | StageText | ||
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| displayAsPassword : Boolean
Indica se o campo de texto é um campo de texto de senha. | StageText | ||
| editable : Boolean
Indica se o usuário pode editar o campo de texto. | StageText | ||
| fontFamily : String
Indica o nome da família de fontes atual. | StageText | ||
| fontPosture : String
Especifica a situação da fonte utilizando constantes da classe FontPosture. | StageText | ||
| fontSize : int
O tamanho em pixels da família de fontes atual. | StageText | ||
| fontWeight : String
Especifica o peso da fonte utilizando constantes da classe FontWeight. | StageText | ||
| locale : String
Indica o local do texto. | StageText | ||
| maxChars : int
Indica o conjunto máximo de caracteres que um usuário pode digitar no campo de texto. | StageText | ||
| multiline : Boolean [somente leitura]
Indica se o objeto StageText pode exibir mais de uma linha de texto. | StageText | ||
| restrict : String
Limita o conjunto de caracteres que um usuário pode digitar no campo de texto. | StageText | ||
| returnKeyLabel : String
Indica o rótulo na tecla Retorno nos dispositivos que apresentam teclado suave. | StageText | ||
| selectionActiveIndex : int [somente leitura]
O valor de índice de caractere com base em zero do último caractere na seleção atual. | StageText | ||
| selectionAnchorIndex : int [somente leitura]
O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. | StageText | ||
| softKeyboardType : String
Controla a aparência do teclado suave. | StageText | ||
| stage : Stage
O palco no qual este objeto StagText é exibido. | StageText | ||
| text : String
Texto atual no campo de texto. | StageText | ||
| textAlign : String
Indica o alinhamento de parágrafo. | StageText | ||
| viewPort : Rectangle
A área do palco em que o objeto StageText é exibido. | StageText | ||
| visible : Boolean
Indica se o objeto StageText está visível. | StageText | ||
| Método | Definido por | ||
|---|---|---|---|
Cria um objeto StageText. | StageText | ||
| 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 | |
Atribuir o foco para o objeto do StageText. | StageText | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
Descarta o objeto StageText. | StageText | ||
Desenha a porta de exibição de StageWebView para um bitmap. | StageText | ||
|
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 | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
Seleciona o texto especificado pelos valores de índice do primeiro e último caracteres. | StageText | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
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 após as alterações de conteúdo de texto. | StageText | |||
| Despachado após configurar uma etapa não-nula e um viewPort não-vazio. | StageText | |||
| [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 o usuário está editando o texto e o controle tem o foco de teclado. | StageText | |||
| Despachado quando o usuário não está mais editando o texto e o controle já não tem o foco de teclado. | StageText | |||
| Despachado quando o usuário pressiona uma tecla. | StageText | |||
| Despachado quando o usuário solta uma tecla. | StageText | |||
| Despachado após o teclado suave ter sido ativado, em consequência do foco de aquisição do objeto StageText. | StageText | |||
| Despachado antes da ativação de teclado suave, em consequência do foco de aquisição de objeto StageText. | StageText | |||
| Despachado após o teclado suave ter sido desativado, em consequência do foco perdido do objeto StageText. | StageText | |||
autoCapitalize | propriedade |
autoCapitalize:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Controla como um dispositivo aplica a capitalização automática na entrada de usuário. Os valores válidos são definidos como constantes na classe AutoCapitalize:
- "none"
- "word"
- "sentence"
- "all"
Esta propriedade é somente uma dica à plataforma subjacente, porque nem todos os dispositivos e os sistemas operacionais suportam essa funcionalidade.
Observação: se você ativar o autoCapitalize enquanto o texto estiver sendo editado ou em foco, o comportamento atualizado não será aplicado até que o foco seja liberado e restabelecido.
O valor padrão é AutoCapitalize.NONE.
Implementação
public function get autoCapitalize():String public function set autoCapitalize(value:String):voidLança
ArgumentError — Em caso de definição como qualquer valor que não seja integrante de AutoCapitalize
|
Elementos da API relacionados
autoCorrect | propriedade |
autoCorrect:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica se um dispositivo corrige automaticamente erros de pontuação ou ortografia na entrada de usuário.
Esta propriedade é somente uma dica à plataforma subjacente, porque nem todos os dispositivos e os sistemas operacionais suportam essa funcionalidade.
Observação: se você ativar o autoCorrect enquanto o texto estiver sendo editado ou em foco, o comportamento atualizado não será aplicado até que o foco seja liberado e restabelecido.
O valor padrão é false.
Implementação
public function get autoCorrect():Boolean public function set autoCorrect(value:Boolean):void clearButtonMode | propriedade |
clearButtonMode:String [somente gravação] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 23 |
O modo de clearButton para o objeto StageText atual. Há quatro modos associados a essa propriedade:
-
Para mostrar o clearButton durante a edição:
StageTextClearButtonMode.WHILE_EDITING -
Para nunca mostrar o clearButton:
StageTextClearButtonMode.NEVER -
Para mostrar sempre o clearButton:
StageTextClearButtonMode.ALWAYS -
Para mostrar o clearButton sempre, exceto durante a edição:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode está definida como StageTextClearButtonMode.WHILE_EDITING.
Observação: esta propriedade é compatível somente com iOS.
Implementação
public function set clearButtonMode(value:String):void color | propriedade |
color:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Especifica a cor do texto. Especifique a cor do texto como um número que contém três componentes RGB de 8 bits. O primeiro componente representa vermelho, o segundo representa verde, e o terceiro componente representa azul. Por exemplo, 0xFF0000 especifica vermelho, 0x00FF00 especifica verde, e 0x0000FF especifica azul. A cor de texto padrão é preta (0x000000).
O valor padrão é 0x000000.
Implementação
public function get color():uint public function set color(value:uint):void displayAsPassword | propriedade |
displayAsPassword:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica se o campo de texto é um campo de texto de senha. Se true, o campo de texto oculta caracteres de entrada que utilizem um caractere substituto (por exemplo, um asterisco).
Observação: se você ativar o displayAsPassword enquanto o texto estiver sendo editado ou em foco, o comportamento atualizado não será aplicado até que o foco seja liberado e restabelecido.
Importante: No iOS, um objeto de texto da etapa com múltiplas linhas não exibirá caracteres substitutos se o valor desta propriedade for true.
O valor padrão é false.
Implementação
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):void editable | propriedade |
fontFamily | propriedade |
fontFamily:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica o nome da família de fontes atual. Um valor de nulo indica o padrão do sistema. Para enumerar as fontes disponíveis, utilizeflash.text.Font.enumerateFonts(). Se a família de fontes for desconhecida, o padrão também será utilizado.
O valor padrão é null.
Implementação
public function get fontFamily():String public function set fontFamily(value:String):void fontPosture | propriedade |
fontPosture:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Especifica a situação da fonte utilizando constantes da classe FontPosture.
O valor padrão é FontPosture.NORMAL.
Implementação
public function get fontPosture():String public function set fontPosture(value:String):voidLança
ArgumentError — Se definido como qualquer valor que não seja membro de FontPosture
|
Elementos da API relacionados
fontSize | propriedade |
fontWeight | propriedade |
fontWeight:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Especifica o peso da fonte utilizando constantes da classe FontWeight.
O valor padrão é FontWeight.NORMAL.
Implementação
public function get fontWeight():String public function set fontWeight(value:String):voidLança
ArgumentError — Se definido como qualquer valor que não seja membro de FontWeight
|
Elementos da API relacionados
locale | propriedade |
locale:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica o local do texto. O StageText utiliza identificadores de localidade padrão. Por exemplo, "en", "en_US" e "en-US" são todos inglês e "ja", japonês. Consulte iso639-2 lista de códigos de uma lista de códigos de localidade.
O valor padrão é en.
Implementação
public function get locale():String public function set locale(value:String):void maxChars | propriedade |
maxChars:int| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica o conjunto máximo de caracteres que um usuário pode digitar no campo de texto. Um script pode inserir mais texto do que maxChars permite. Se maxChars for igual a zero, um usuário poderá inserir uma quantidade ilimitada de texto no campo de texto.
O valor padrão é 0.
Implementação
public function get maxChars():int public function set maxChars(value:int):void multiline | propriedade |
multiline:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica se o objeto StageText pode exibir mais de uma linha de texto. Somente leitura. Este valor corresponde ao valor da propriedade multiline no objeto StageTextInitOptions utilizado durante a construção.
Implementação
public function get multiline():BooleanElementos da API relacionados
restrict | propriedade |
restrict:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Limita o conjunto de caracteres que um usuário pode digitar no campo de texto. O sistema rastreia a string restrict da esquerda para a direita.
O valor de restrict especifica as seguintes regras de restrição de entrada de texto:
- Se o valor for
null, um usuário poderá inserir qualquer caractere. - Se o valor for uma string vazio, um usuário não poderá inserir nenhum caractere.
- Se o valor for uma string de caracteres, um usuário poderá inserir somente os caracteres na string.
- Se o valor incluir um circunflexo (^), um usuário não poderá inserir nenhum caractere que segue o circunflexo.
- O valor poderá especificar um intervalo de caracteres de entrada admissíveis utilizando o caractere hífen (-).
- O valor pode utilizar a seqüência de escape
\upara construir uma stringrestrict.
Caracteres especiais:
Utilize uma barra oblíqua invertida para inserir um caractere textual circunflexo (^) ou traço (-). As sequências de barra invertida aceitas são \-, \^ ou \\. A barra oblíqua invertida deve ser um caractere real na string. Quando você especificar uma barra oblíqua invertida em ActionScript, utilize uma barra oblíqua invertida dupla.
Exemplos de configurações de propriedade restrict:
O seguinte exemplo permite que um usuário insira somente os caracteres traço (-) e circunflexo (^):
my_txt.restrict = "\\-\\^";
O seguinte exemplo permite que um usuário insira somente os caracteres maiúsculos, espaços e números:
my_txt.restrict = "A-Z 0-9";
O seguinte exemplo exclui somente letras minúsculas:
my_txt.restrict = "^a-z";
O seguinte exemplo permite que um usuário insira somente letras maiúsculas, mas exclua a letra maiúscula Q:
my_txt.restrict = "A-Z^Q";
O seguinte exemplo permite que um usuário insira somente os caracteres de ASCII 32 (espaço) a ASCII 126 (til).
my_txt.restrict = "\u0020-\u007E";
Nota: As restrições são aplicadas somente à entrada do usuário; um script pode inserir qualquer caractere no campo de texto.
O valor padrão é null.
Implementação
public function get restrict():String public function set restrict(value:String):void returnKeyLabel | propriedade |
returnKeyLabel:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica o rótulo na tecla Retorno nos dispositivos que apresentam teclado suave. Os valores disponíveis são constantes definidas na classe ReturnKeyLabel:
- "default"
- "done"
- "go"
- "next"
- "search"
Esta propriedade é somente uma dica à plataforma subjacente, porque nem todos os dispositivos e os sistemas operacionais suportam esses valores. Esta propriedade não tem efeito sobre dispositivos que não apresentem teclado suave.
O valor padrão é ReturnKeyLabel.DEFAULT.
Implementação
public function get returnKeyLabel():String public function set returnKeyLabel(value:String):voidLança
ArgumentError — Se definido como qualquer valor que não seja integrante de ReturnKeyLabel
|
Elementos da API relacionados
selectionActiveIndex | propriedade |
selectionActiveIndex:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
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 estiver selecionado, esse método retorna o ponto de inserção. Se a instância StageText não estiver em foco, esse método retorna -1.
No iOS, esta propriedade não é suportada para objetos StageText sem múltiplas linhas e retorna -1.
Implementação
public function get selectionActiveIndex():intElementos da API relacionados
selectionAnchorIndex | propriedade |
selectionAnchorIndex:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
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 estiver selecionado, esse método retorna o ponto de inserção. Se a instância StageText não estiver em foco, esse método retorna -1.
No iOS, esta propriedade não é suportada para objetos StageText sem múltiplas linhas e retorna -1.
Implementação
public function get selectionAnchorIndex():intElementos da API relacionados
softKeyboardType | propriedade |
softKeyboardType:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Controla a aparência do teclado suave.
Os dispositivos com teclados suaves podem personalizar os botões do teclado para corresponder com o tipo da entrada esperada. Por exemplo, se a entrada numérica for esperada, um dispositivo poderá utilizar SoftKeyboardType.NUMBER para exibir somente números no teclado suave. Os valores válidos são definidos como constantes na classe SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Estes valores servem como dicas, para ajudar um dispositivo exibir o melhor teclado para a operação atual.
O valor padrão é SoftKeyboardType.DEFAULT.
Implementação
public function get softKeyboardType():String public function set softKeyboardType(value:String):voidLança
ArgumentError — Se definido como qualquer valor que não seja integrante de SoftKeyboardType
|
Elementos da API relacionados
stage | propriedade |
text | propriedade |
text:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Texto atual no campo de texto. O caractere de retorno de carro ('\r', ASCII 13) separa as linhas do texto. O texto contido nesta propriedade está desformatado (não possui tags de formatação).
O valor padrão é null.
Implementação
public function get text():String public function set text(value:String):void textAlign | propriedade |
textAlign:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Indica o alinhamento de parágrafo. Os valores válidos são definidos como constantes na classe TextFormatAlign:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Nem todas as plataformas suportam todo valor textAlign. Para valores textAlign não suportados, as plataformas utilizam o valor padrão (TextFormatAlign.START).
O valor padrão é TextFormatAlign.START.
Implementação
public function get textAlign():String public function set textAlign(value:String):voidLança
ArgumentError — Se definido como qualquer valor que não seja integrante de TextFormatAlign
|
Elementos da API relacionados
viewPort | propriedade |
viewPort:Rectangle| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
A área do palco em que o objeto StageText é exibido. O padrão é zero rect.
Implementação
public function get viewPort():Rectangle public function set viewPort(value:Rectangle):voidLança
RangeError — O valor do Retângulo não é válido.
|
visible | propriedade |
StageText | () | Construtor |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Cria um objeto StageText.
O objeto StageText fica invisível até ser anexado a uma etapa e até que a propriedade viewPort seja definida.
initOptions:flash.text:StageTextInitOptions (default = null) |
assignFocus | () | método |
public function assignFocus():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Atribuir o foco para o objeto do StageText. Para objetos não-editáveis, assignFocus() não faz nada.
dispose | () | método |
public function dispose():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Descarta o objeto StageText.
A chamada a dispose() é opcional. Se você não mantiver uma referência a esta instância StageText, ela será elegível para ser enviada à lixeira. Chamar dispose() pode fazer o envio à lixeira ocorrer mais cedo ou em um momento mais conveniente.
drawViewPortToBitmapData | () | método |
public function drawViewPortToBitmapData(bitmap:BitmapData):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.0 |
Desenha a porta de exibição de StageWebView para um bitmap.
Capture o bitmap e defina a etapa como null para exibir o conteúdo acima do objeto StageText.
O bitmap geralmente possui as mesmas medidas de largura e altura que a janela. Começando pelo AIR 15.0, enquanto o Player está em exibições de HiDPI, a largura de bitmap e a altura podem ser ocontentsScaleFactor vezes a largura e a altura da janela. Por exemplo, em uma exibição Mac Retina, o contentsScaleFactor é 2, porque a resolução de pixels de palco é o dobro, por isso o bitmap pode ser o dobro do tamanho da janela de visão.
Se você realizar a chamada desse método antes do evento Event.COMPLETE, o método poderá desenhar a porta de exibição incorretamente.
Parâmetros
bitmap:BitmapData — O objeto BitmapData no qual será desenhada a porção visível da porta de exibição de StageText.
|
Lança
ArgumentError — A largura ou a altura do bitmap é diferente da largura ou da altura da porta de exibição.
| |
Error — O bitmap é nulo.
|
selectRange | () | método |
public function selectRange(anchorIndex:int, activeIndex:int):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Seleciona o texto especificado pelos valores de índice do primeiro e último caracteres. Especifica o primeiro e último caracteres da seleção nos parâmetros anchorIndex e activeIndex. Se os dois valores de parâmetro forem o mesmo, este método definirá o ponto de inserção.
No iOS, para objetos StageText sem múltiplas linhas, esta função não tem suporte e sempre retorna -1. Se você chamar este método selecionando a string de texto completo, a seleção será visível. Entretanto, se você chamar o método selecionando um subconjunto da string de texto, a seleção não será visível.
Para alguns dispositivos ou sistemas operacionais, a seleção somente poderá ficar visível quando o objeto StageText tiver o foco.
Parâmetros
anchorIndex:int — O valor de índice com base em zero do primeiro caractere na seleção (o valor de índice do primeiro caractere é 0).
| |
activeIndex:int — O valor de índice com base em zero do último caractere na seleção.
|
Elementos da API relacionados
change | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado após as alterações de conteúdo de texto. Este evento pode ser despachado em cada alteração ou não antes que um conjunto de alterações tenha sido concluído.
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. |
complete | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.COMPLETE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado após configurar uma etapa não-nula e um viewPort não-vazio. Indica que a implementação concluiu a exposição do objeto StageText e você poderá realizar a chamada do método drawViewPortToBitmapData. Dependendo da plataforma, este evento poderá ser despachado sincronicamente ou assincronamente com a configuração de stage, viewPort, ou ambos.
Event.COMPLETE define o valor da propriedade type de um objeto de evento complete.
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 de rede que concluiu o carregamento. |
focusIn | Evento |
flash.events.FocusEventpropriedade FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário está editando o texto e o controle tem o foco de teclado.
Define o valor da propriedadetype de um objeto de evento focusIn.
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. |
keyCode | 0; aplica-se apenas a eventos keyFocusChange. |
relatedObject | A ocorrência de InteractiveObject complementar que é afetada pela alteração no foco. |
shiftKey | false; aplica-se apenas a eventos keyFocusChange. |
target | A ocorrência InteractiveObject que acabou de receber foco. 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.
|
direção | A direção a partir da qual o foco foi atribuído. Essa propriedade relata o valor do parâmetro direction do método assignFocus() do estágio. Se o foco foi alterado por outros meios, o valor será sempre FocusDirection.NONE. Aplica-se apenas a eventos focusIn. Para todos os outros eventos de foco, o valor será FocusDirection.NONE. |
focusOut | Evento |
flash.events.FocusEventpropriedade FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário não está mais editando o texto e o controle já não tem o foco de teclado.
Define o valor da propriedadetype de um objeto de evento focusOut.
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. |
keyCode | 0; aplica-se apenas a eventos keyFocusChange. |
relatedObject | A ocorrência de InteractiveObject complementar que é afetada pela alteração no foco. |
shiftKey | false; aplica-se apenas a eventos keyFocusChange. |
target | A ocorrência InteractiveObject que acabou de perder foco. 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.
|
keyDown | Evento |
flash.events.KeyboardEventpropriedade KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário pressiona uma tecla.
Os mapeamentos entre teclas e caracteres específicos variam por dispositivo e sistema operacional. Esse tipo de evento é gerado depois que esse tipo de mapeamento ocorre, mas antes do processamento de um IME (editor de métodos de entrada). Os IMEs são utilizados para inserir caracteres que o teclado QWERTY padrão não é capaz de produzir (por exemplo, ideogramas chineses).
Esse evento ocorre antes do evento keyUp.
Este evento não é despachado para todas as chaves. As chaves que fazem com que este evento seja despachado variam conforme a plataforma.
No AIR, cancelar este evento impede o caractere de ser introduzido em um campo de texto.
A constanteKeyboardEvent.KEY_DOWN define o valor da propriedade type de um objeto de evento keyDown.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true em AIR, false em Flash Player; no AIR, o cancelamento deste evento impede o caractere de ser introduzido em um campo de texto. |
charCode | O valor de código de caractere da tecla pressionada ou solta. |
commandKey | true no Mac caso a tecla Command esteja ativa. Caso contrário, false |
controlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac caso a tecla Control esteja ativa. Caso contrário, false |
ctrlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada ou solta. |
keyLocation | O local da tecla no teclado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject com foco. 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. |
keyUp | Evento |
flash.events.KeyboardEventpropriedade KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário solta uma tecla.
Os mapeamentos entre teclas e caracteres específicos variam por dispositivo e sistema operacional. Esse tipo de evento é gerado depois que esse tipo de mapeamento ocorre, mas antes do processamento de um IME (editor de métodos de entrada). Os IMEs são utilizados para inserir caracteres que o teclado QWERTY padrão não é capaz de produzir (por exemplo, ideogramas chineses).
Este evento ocorre depois do evento keyDown.
Este evento não é despachado para todas as chaves. As chaves que fazem com que este evento seja despachado variam conforme a plataforma.
A constanteKeyboardEvent.KEY_UP define o valor da propriedade type de um objeto de evento keyUp.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
charCode | Contém o valor de código de caractere da tecla pressionada ou solta. |
commandKey | true no Mac caso a tecla Command esteja ativa. Caso contrário, false |
controlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac caso a tecla Control esteja ativa. Caso contrário, false |
ctrlKey | true no Windows se a tecla Ctrl estiver ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada ou solta. |
keyLocation | O local da tecla no teclado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject com foco. 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. |
softKeyboardActivate | Evento |
flash.events.SoftKeyboardEventpropriedade SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent. SOFT_KEYBOARD_ACTIVATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado após o teclado suave ter sido ativado, em consequência do foco de aquisição do objeto StageText.
softKeyboardActivating | Evento |
flash.events.SoftKeyboardEventpropriedade SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent. SOFT_KEYBOARD_ACTIVATING| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado antes da ativação de teclado suave, em consequência do foco de aquisição de objeto StageText.
softKeyboardDeactivate | Evento |
flash.events.SoftKeyboardEventpropriedade SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado após o teclado suave ter sido desativado, em consequência do foco perdido do objeto StageText.
A constante SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE define o valor do objeto SoftKeyboardEvent da propriedade type quando um teclado virtual é abaixado ou ocultado. Para este evento, cancelável = false.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
tipo | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
relatedObjectVal | Uma referência a um objeto de lista de exibição relacionado ao evento. |
triggerTypeVal | Indica se o evento keyboard foi disparado pelo aplicativo ou pelo usuário. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
Wed Jun 13 2018, 11:10 AM Z