| Pacote | flash.ui |
| Classe | public dynamic class GameInputControl |
| Herança | GameInputControl EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.7 |
Como obter valores de controle:
A propriedade value retorna o valor atual de um controle. Esse método não retorna o último valor diretamente do controle. Em vez disso, retorna o valor que foi armazenado em cache na última vez que foi feita uma amostra do controle.
Há três modos de obter valores de controle a partir de um controle individual:
-
Polling: chame
valuesempre que desejar obter o último valor conhecido de um controle. -
Eventos de Alteração: registra um evento de alteração de um controlador. O evento
Evento.CHANGEé despachado sempre que o valor de um controle é alterado. Ao receber o evento, chamevaluepara obter o valor do controle que disparou o evento. -
Armazenamento em Cache de Valores de Amostra: o armazenamento em cache é feito em nível de dispositivo. Consulte a documentação da classe
GameInputDevicepara obter detalhes sobre armazenamento em cache e recuperação de valores de controle de amostra.
A tentativa de ler os valores de controle em um dispositivo desativado faz com que value lance um IOError. Contudo, é possível acessar propriedades que descrevem um controle (como id, minValue e maxValue) mesmo que o dispositivo não esteja ativo. Esse recurso permite determinar se um dispositivo ajusta-se às necessidades do seu aplicativo sem a necessidade de ativar primeiramente o dispositivo.
Para obter mais informações, consulte o artigo da Central do Desenvolvedor do Adobe Air: Controladores de jogos no Adobe AIR.
Para Android, este recurso suporta uma versão mínima do Android OS 4.1 e requerem o SWF versão mínima 20 e namespace 3.7. No iOS, esse recurso tem suporte para uma versão mínima do iOS 9.0 e requer o SWF versão mínima 34 e namespace 23.0.
Elementos da API relacionados
| Propriedade | Definido por | ||
|---|---|---|---|
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| device : GameInputDevice [somente leitura]
Retorna o objeto GameInputDevice que contém este controle. | GameInputControl | ||
| id : String [somente leitura]
Retorna o ID desse dispositivo. | GameInputControl | ||
| maxValue : Number [somente leitura]
Retorna o valor máximo desse controle. | GameInputControl | ||
| minValue : Number [somente leitura]
Retorna o valor mínimo desse controle. | GameInputControl | ||
| value : Number [somente leitura]
Retorna o valor deste controle. | GameInputControl | ||
| 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 valor de controle é alterado. | GameInputControl | |||
![]() | [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 | ||
device | propriedade |
device:GameInputDevice [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.7 |
Retorna o objeto GameInputDevice que contém este controle.
Implementação
public function get device():GameInputDevice id | propriedade |
maxValue | propriedade |
minValue | propriedade |
value | propriedade |
change | Evento |
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas