KeyEvent Classe

Definição

Namespace:: Android.Views

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Objeto usado para relatar eventos de tecla e botão.

[Android.Runtime.Register("android/view/KeyEvent", DoNotGenerateAcw=true)]
public class KeyEvent : Android.Views.InputEvent, IDisposable

[<Android.Runtime.Register("android/view/KeyEvent", DoNotGenerateAcw=true)>]
type KeyEvent = class
    inherit InputEvent
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herança: Object

JavaObject

Object

InputEvent
KeyEvent

Atributos: RegisterAttribute

Implementações: IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Objeto usado para relatar eventos de tecla e botão.

Cada pressionamento de tecla é descrito por uma sequência de eventos de chave. Uma tecla de pressionamento começa com um evento de tecla com #ACTION_DOWN. Se a chave for mantida suficientemente longa que se repita, a inicialização será seguida de eventos de chave adicionais e #ACTION_DOWN um valor diferente de zero para #getRepeatCount(). O último evento de chave é um #ACTION_UP para a chave para cima. Se a tecla pressionar for cancelada, o evento de teclas terá o #FLAG_CANCELED sinalizador definido.

Os principais eventos geralmente são acompanhados por um código de chave (#getKeyCode()), código de verificação (#getScanCode()) e meta estado (#getMetaState()). As constantes de código de chave são definidas nessa classe. As constantes de código de verificação são códigos brutos específicos do dispositivo obtidos do sistema operacional e, portanto, não são geralmente significativos para aplicativos, a menos que sejam interpretados usando o KeyCharacterMap. Metaes descrevem o estado pressionado de modificadores de chave, como #META_SHIFT_ON ou #META_ALT_ON.

Normalmente, os códigos de chave correspondem um a um com chaves individuais em um dispositivo de entrada. Muitas teclas e combinações de chaves servem funções bastante diferentes em diferentes dispositivos de entrada, portanto, deve-se tomar cuidado ao interpretá-las. Sempre use o KeyCharacterMap dispositivo de entrada associado ao mapear chaves para caracteres. Lembre-se de que pode haver vários dispositivos de entrada de chave ativos ao mesmo tempo e cada um terá seu próprio mapa de caracteres-chave.

Como os métodos de entrada reversível podem usar várias e inventivas maneiras de inserir texto, não há garantia de que qualquer tecla pressionada em um teclado suave gere um evento de tecla: isso é deixado a critério do IME e, na verdade, o envio desses eventos é desencorajado. Você nunca deve contar com o recebimento de KeyEvents para qualquer chave em um método de entrada reversível. Em particular, o teclado de software padrão nunca enviará qualquer evento de tecla para qualquer aplicativo direcionado a Jelly Bean ou posterior e enviará apenas eventos para algumas pressionamentos das teclas de exclusão e retorno para aplicativos direcionados ao Ice Cream Sandwich ou anterior. Lembre-se de que outros métodos de entrada de software podem nunca enviar eventos importantes independentemente da versão. Considere o uso de ações do editor, como android.view.inputmethod.EditorInfo#IME_ACTION_DONE se você precisasse de interação específica com o teclado de software, pois ele dá mais visibilidade ao usuário sobre como seu aplicativo reagirá às teclas.

Ao interagir com um IME, a estrutura pode fornecer eventos-chave com a ação #ACTION_MULTIPLE especial que especifica esse único código de chave repetido ou uma sequência de caracteres a serem inseridos.

Em geral, a estrutura não pode garantir que os principais eventos entregues a um modo de exibição sempre constituam sequências de chave completas, pois alguns eventos podem ser descartados ou modificados contendo exibições antes de serem entregues. A implementação do modo de exibição deve estar preparada para lidar #FLAG_CANCELED e deve tolerar situações anômalas, como receber um novo #ACTION_DOWN sem antes ter recebido um #ACTION_UP para a tecla anterior.

InputDevice Consulte mais informações sobre como diferentes tipos de dispositivos de entrada e fontes representam chaves e botões.

Java documentação para android.view.KeyEvent.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome	Description
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags, InputSourceType)	Crie um novo evento de chave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags)	Crie um novo evento de chave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32)	Crie um novo evento de chave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates)	Crie um novo evento de chave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32)	Crie um novo evento de chave.
KeyEvent(Int64, String, Int32, KeyEventFlags)	Crie um novo evento de chave para uma cadeia de caracteres.
KeyEvent(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.
KeyEvent(KeyEvent, Int64, Int32)	Obsoleto. Copie um evento de chave existente, modificando sua contagem de tempo e repetição.
KeyEvent(KeyEvent)	Faça uma cópia exata de um evento de chave existente.
KeyEvent(KeyEventActions, Keycode)	Crie um novo evento de chave.

Campos

Nome	Description
KeycodeClose	Obsoleto. Constante de código de chave: AC Close.
KeycodeDemoApp1	Obsoleto. Constante de código de chave: chave de aplicativo de demonstração nº 1.
KeycodeDemoApp2	Obsoleto. Constante de código de chave: chave de aplicativo de demonstração nº 2.
KeycodeDemoApp3	Obsoleto. Constante de código de chave: chave de aplicativo de demonstração nº 3.
KeycodeDemoApp4	Obsoleto. Constante de código de chave: chave de aplicativo de demonstração nº 4.
KeycodeDictate	Obsoleto. Constante de código de chave: para começar a ditar para um campo de entrada
KeycodeDoNotDisturb	Obsoleto. Constante de código de chave: para alternar o modo 'Não Incomodar'.
KeycodeEmojiPicker	Obsoleto. Constante de código de chave: para abrir o seletor de emoji.
KeycodeF13	Obsoleto. Constante de código de chave: tecla F13.
KeycodeF14	Obsoleto. Constante de código de chave: tecla F14.
KeycodeF15	Obsoleto. Constante de código de chave: chave F15.
KeycodeF16	Obsoleto. Constante de código de chave: chave F16.
KeycodeF17	Obsoleto. Constante de código de chave: tecla F17.
KeycodeF18	Obsoleto. Constante de código de chave: tecla F18.
KeycodeF19	Obsoleto. Constante de código de chave: chave F19.
KeycodeF20	Obsoleto. Constante de código de chave: chave F20.
KeycodeF21	Obsoleto. Constante de código de chave: chave F21.
KeycodeF22	Obsoleto. Constante de código de chave: chave F22.
KeycodeF23	Obsoleto. Constante de código de chave: chave F23.
KeycodeF24	Obsoleto. Constante de código de chave: tecla F24.
KeycodeFeaturedApp1	Obsoleto. Constante de código de chave: chave de aplicativo em destaque nº 1.
KeycodeFeaturedApp2	Obsoleto. Constante de código de chave: chave de aplicativo em destaque nº 2.
KeycodeFeaturedApp3	Obsoleto. Constante de código de chave: chave de aplicativo em destaque nº 3.
KeycodeFeaturedApp4	Obsoleto. Constante de código de chave: chave de aplicativo em destaque nº 4.
KeycodeFullscreen	Obsoleto. Constante de código de chave: para alternar o modo de tela inteira (no aplicativo atual).
KeycodeKeyboardBacklightDown	Obsoleto. Constante de código de chave: luz de fundo do teclado para baixo.
KeycodeKeyboardBacklightToggle	Obsoleto. Constante de código de chave: alternância de luz de fundo do teclado.
KeycodeKeyboardBacklightUp	Obsoleto. Constante de código de chave: backlight de teclado para cima.
KeycodeLock	Obsoleto. Constante de código de chave: para bloquear a tela.
KeycodeMacro1	Obsoleto. Constante de código de chave: um botão cujo uso pode ser personalizado pelo usuário por meio do sistema.
KeycodeMacro2	Obsoleto. Constante de código de chave: um botão cujo uso pode ser personalizado pelo usuário por meio do sistema.
KeycodeMacro3	Obsoleto. Constante de código de chave: um botão cujo uso pode ser personalizado pelo usuário por meio do sistema.
KeycodeMacro4	Obsoleto. Constante de código de chave: um botão cujo uso pode ser personalizado pelo usuário por meio do sistema.
KeycodeNew	Obsoleto. Constante de código de chave: AC New.
KeycodePrint	Obsoleto. Constante de código de chave: para imprimir.
KeycodeRecentApps	Obsoleto. Constante de código-chave: para abrir a exibição de aplicativos recentes (a.
KeycodeScreenshot	Obsoleto. Constante de código de chave: para fazer uma captura de tela `This key is fully handled by the framework and will not be sent to the foreground app, unlike <code data-dev-comment-type="c">KEYCODE_SYSRQ</code> which is sent to the app first and only if the app doesn't handle it, the framework handles it (to take a screenshot).`
KeycodeStylusButtonPrimary	Obsoleto. Constante de código de chave: o botão primário no barril de uma caneta.
KeycodeStylusButtonSecondary	Obsoleto. Constante de código de chave: o botão secundário no barril de uma caneta.
KeycodeStylusButtonTail	Obsoleto. Constante de código de chave: um botão na extremidade final de uma caneta.
KeycodeStylusButtonTertiary	Obsoleto. Constante de código de chave: o botão terciário no barril de uma caneta.
KeycodeVideoApp1	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 1.
KeycodeVideoApp2	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 2.
KeycodeVideoApp3	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 3.
KeycodeVideoApp4	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 4.
KeycodeVideoApp5	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 5.
KeycodeVideoApp6	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 6.
KeycodeVideoApp7	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 7.
KeycodeVideoApp8	Obsoleto. Constante de código de chave: chave de aplicativo de vídeo nº 8.
MaxKeycode	Obsoleto. Especifica o maior código de chave definido por esse nível de API.

Propriedades

Nome	Description
Action	Recupere a ação deste evento de chave.
Characters	Para o caso especial de um `#ACTION_MULTIPLE` evento com código-chave, `#KEYCODE_UNKNOWN`esta é uma cadeia de caracteres bruta de caracteres associada ao evento.
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Creator	Obtém o criador parcelado para instâncias KeyEvent.
Device	Obtém o dispositivo do qual esse evento veio. (Herdado de InputEvent)
DeviceId	Obtém a ID do dispositivo do qual esse evento veio. Uma ID de zero indica que o evento não veio de um dispositivo físico e é mapeado para o keymap padrão. Os outros números são arbitrários e você não deve depender dos valores.
DisplayLabel	Obtém o caractere primário dessa chave. Em outras palavras, o rótulo que é impresso fisicamente nele.
DownTime	Recupere a hora do evento de tecla down mais recente, na base de `android.os.SystemClock#uptimeMillis` tempo.
EventTime	Recupere a hora em que esse evento ocorreu, na base de `android.os.SystemClock#uptimeMillis` tempo.
Flags	Retorna os sinalizadores para esse evento de chave.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
HasNoModifiers	Retornará true se nenhuma tecla modificadora for pressionada.
IsAltPressed	Retorna o estado pressionado da meta-tecla ALT.
IsCanceled	Para `#ACTION_UP` eventos, indica que o evento foi cancelado de acordo `#FLAG_CANCELED`com .
IsCapsLockOn	Retorna o estado bloqueado da meta-chave CAPS LOCK.
IsCtrlPressed	Retorna o estado pressionado da meta-tecla CTRL.
IsFunctionPressed	Retorna o estado pressionado da meta-tecla FUNCTION.
IsLongPress	Para `#ACTION_DOWN` eventos, indica que o evento foi cancelado de acordo `#FLAG_LONG_PRESS`com .
IsMetaPressed	Retorna o estado pressionado da meta-tecla META.
IsNumLockOn	Retorna o estado bloqueado da meta-chave NUM LOCK.
IsPrintingKey	Retornará true se essa chave produzir um glifo.
IsScrollLockOn	Retorna o estado bloqueado da meta-chave SCROLL LOCK.
IsShiftPressed	Retorna o estado pressionado da meta-tecla SHIFT.
IsSymPressed	Retorna o estado pressionado da meta-tecla SYM.
IsSystem	Essa é uma chave do sistema? As chaves do sistema não podem ser usadas para atalhos de menu.
IsTracking	Para `#ACTION_UP` eventos, indica que o evento ainda está sendo rastreado de seu evento inicial down de acordo `#FLAG_TRACKING`com .
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
JniPeerMembers	Obtém os metadados de pares JNI usados pelo .NET para o runtime de associação do Android.
KeyCharacterMap	Obtém o KeyCharacterMap associado ao dispositivo de teclado.
KeyCode	Recupere o código de chave do evento de chave.
MaxKeyCode	Retorna o código de chave máximo.
MetaState	Retorna o estado das meta-chaves.
ModifierMetaStateMask	Obtém uma máscara que inclui todos os bits de meta estado de chave modificador válidos.
Modifiers	Retorna o estado das chaves modificadoras.
Number	Obtém o número ou símbolo associado à chave. O valor do caractere é retornado, não o valor numérico. Se a chave não for um número, mas for um símbolo, o símbolo será reajustado.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
RepeatCount	Recupere a contagem de repetição do evento.
ScanCode	Recupere a ID da chave de hardware deste evento de chave.
Source	Obtém a origem do evento.
ThresholdClass	Obtém o identificador de classe JNI usado pelo .NET para o runtime de associação do Android.
ThresholdType	Obtém o tipo gerenciado usado pelo .NET para o runtime de associação do Android.
UnicodeChar	Obtém o caractere Unicode gerado pela combinação de estado de meta-chave e chave especificada.

Métodos

Nome	Description
ChangeAction(KeyEvent, KeyEventActions)	Crie um novo evento chave que seja o mesmo que o determinado, mas cuja ação é substituída pelo valor fornecido.
ChangeFlags(KeyEvent, KeyEventFlags)	Crie um novo evento chave que seja o mesmo que o determinado, mas cujos sinalizadores são substituídos pelo valor fornecido.
ChangeTimeRepeat(KeyEvent, Int64, Int32, KeyEventFlags)	Crie um novo evento de chave que seja o mesmo que o determinado, mas cuja contagem de tempo de evento e repetição são substituídas pelo valor fornecido.
ChangeTimeRepeat(KeyEvent, Int64, Int32)	Crie um novo evento de chave que seja o mesmo que o determinado, mas cuja contagem de tempo de evento e repetição são substituídas pelo valor fornecido.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
DescribeContents()	Descreva os tipos de objetos especiais contidos na representação marshalled deste Parcelable. (Herdado de InputEvent)
Dispatch(KeyEvent+ICallback, KeyEvent+DispatcherState, Object)	Envia esse evento de chave para um receptor de retorno de chamada.
Dispatch(KeyEvent+ICallback)	Obsoleto. Envia esse evento de chave para um receptor de retorno de chamada.
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
Equals(Object)	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
GetDeadChar(Int32, Int32)	Obtenha o personagem que é produzido colocando ênfase no personagem c.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetKeyData(KeyCharacterMap+KeyData)	Obsoleto. Obtenha os dados de conversão de caracteres para um determinado código de chave.
GetMatch(Char[], Int32)	Obsoleto. Obtém o primeiro caractere candidato que esse evento chave pode produzir com o meta estado determinado.
GetMatch(Char[], MetaKeyStates)	Obtém o primeiro caractere na matriz de caracteres que pode ser gerado pelo código de chave especificado.
GetMatch(Char[])	Obtém o primeiro caractere na matriz de caracteres que pode ser gerado pelo código de chave especificado.
GetUnicodeChar(Int32)	Obsoleto. Obtém o caractere Unicode gerado por esse evento de chave com o meta state especificado.
GetUnicodeChar(MetaKeyStates)	Obtém o caractere Unicode gerado pela combinação de estado de meta-chave e chave especificada.
HasModifiers(MetaKeyStates)	Retorna true se apenas as teclas modificadoras especificadas forem pressionadas.
IsFromSource(InputSourceType)	Determina se o evento é da fonte fornecida. (Herdado de InputEvent)
IsGamepadButton(Keycode)	Retornará true se o código de chave especificado for um botão gamepad.
IsMediaSessionKey(Int32)	Retorna se essa chave será enviada para o `android.media.session.MediaSession.Callback` se não for tratado.
IsModifierKey(Keycode)	Retornará true se esse código de chave for uma chave modificadora.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
KeyCodeFromString(String)	Obtém um código-chave por seu nome simbólico, como "KEYCODE_A" ou uma constante numérica equivalente, como "29".
KeyCodeToString(Keycode)	Retorna uma cadeia de caracteres que representa o nome simbólico do código de chave especificado, como "KEYCODE_A", "KEYCODE_DPAD_UP" ou uma constante numérica equivalente, como "1001", se desconhecido.
MetaStateHasModifiers(MetaKeyStates, MetaKeyStates)	Retornará true se apenas as teclas modificadoras especificadas forem pressionadas de acordo com o estado meta especificado.
MetaStateHasNoModifiers(MetaKeyStates)	Retornará true se nenhuma tecla modificadora for pressionada de acordo com o meta state especificado.
NormalizeMetaState(MetaKeyStates)	Normaliza o meta estado especificado.
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
SetSource(InputSourceType)	Define a fonte de entrada que gerou esse evento de chave.
StartTracking()	Chame isso durante `Callback#onKeyDown` para que o sistema acompanhe a tecla por meio de sua final (possivelmente incluindo uma longa imprensa).
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Nivele esse objeto em um Pacote.

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
IJavaPeerable.Finalized()	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Objeto usado para relatar eventos de tecla e botão. (Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Objeto usado para relatar eventos de tecla e botão.

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	Objeto usado para relatar eventos de tecla e botão.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a