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
value
sempre 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, chamevalue
para 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
GameInputDevice
para 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