KeyEvent Classe

Definizione

Spazio dei nomi:

Android.Views

Assembly:

Mono.Android.dll

Oggetto usato per segnalare eventi chiave e pulsante.

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

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

Ereditarietà

Object

Object

InputEvent

KeyEvent

Attributi

RegisterAttribute

Implementazioni

IParcelable IJavaObject IJavaPeerable IDisposable

Commenti

Oggetto usato per segnalare eventi chiave e pulsante.

Ogni tasto premuto è descritto da una sequenza di eventi chiave. Un tasto inizia con un evento chiave con #ACTION_DOWN. Se la chiave viene mantenuta sufficientemente lunga, il valore iniziale viene seguito da eventi chiave aggiuntivi con #ACTION_DOWN e un valore diverso da zero per #getRepeatCount(). L'ultimo evento chiave è un #ACTION_UP oggetto per la chiave up. Se la pressione del tasto viene annullata, l'evento key up avrà il #FLAG_CANCELED flag impostato.

Gli eventi chiave sono generalmente accompagnati da un codice chiave (), analizza codice (#getKeyCode()) e meta state (#getScanCode()#getMetaState()). Le costanti del codice chiave sono definite in questa classe. Le costanti di codice di analisi sono codici specifici del dispositivo non elaborati ottenuti dal sistema operativo e quindi non sono generalmente significativi per le applicazioni a meno che non vengano interpretate usando .KeyCharacterMap Gli stati meta descrivono lo stato premuto dei modificatori di tasti, #META_SHIFT_ON ad esempio o #META_ALT_ON.

I codici chiave corrispondono in genere uno a uno con le singole chiavi in un dispositivo di input. Molte combinazioni di chiavi e chiavi servono funzioni molto diverse su dispositivi di input diversi, quindi è necessario prestare attenzione quando vengono interpretate. Usare sempre l'oggetto associato al dispositivo di input durante il KeyCharacterMap mapping delle chiavi ai caratteri. Tenere presente che possono essere presenti più dispositivi di input chiave attivi contemporaneamente e ognuno avrà la propria mappa dei caratteri chiave.

Poiché i metodi di input soft possono usare più modi inventiva di input del testo, non vi è alcuna garanzia che qualsiasi tasto premuto su una tastiera temporanea genererà un evento chiave: questo viene lasciato alla discrezione dell'IME e in effetti l'invio di tali eventi è sconsigliato. Non è mai consigliabile basarsi sulla ricezione di KeyEvents per qualsiasi chiave in un metodo di input soft. In particolare, la tastiera software predefinita non invierà mai alcun evento chiave a qualsiasi applicazione che punta a Jelly Bean o versioni successive e invierà solo eventi per alcune presse dell'eliminazione e restituirà i tasti alle applicazioni destinate a Ice Cream Sandwich o versioni precedenti. Tenere presente che altri metodi di input software potrebbero non inviare mai eventi chiave indipendentemente dalla versione. Prendere in considerazione l'uso di azioni dell'editor, ad esempio android.view.inputmethod.EditorInfo#IME_ACTION_DONE se è necessaria un'interazione specifica con la tastiera software, in quanto offre maggiore visibilità all'utente per come l'applicazione risponderà alle pressioni dei tasti.

Quando si interagisce con un IME, il framework può recapitare eventi chiave con l'azione #ACTION_MULTIPLE speciale che specifica che un codice di chiave ripetuta o una sequenza di caratteri da inserire.

In generale, il framework non può garantire che gli eventi chiave che recapitano a una visualizzazione costituiscono sempre sequenze chiave complete perché alcuni eventi possono essere eliminati o modificati mediante visualizzazioni prima che vengano recapitate. L'implementazione della visualizzazione deve essere preparata per gestire #FLAG_CANCELED e deve tollerare situazioni anomale, ad esempio la ricezione di un nuovo senza #ACTION_DOWN aver prima ricevuto un #ACTION_UP oggetto per la pressione del tasto precedente.

InputDevice Per altre informazioni sul modo in cui diversi tipi di dispositivi di input e origini rappresentano chiavi e pulsanti.

Documentazione Java per android.view.KeyEvent.

Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .

Costruttori

KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32)	Creare un nuovo evento chiave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates)	Creare un nuovo evento chiave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32)	Creare un nuovo evento chiave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags)	Creare un nuovo evento chiave.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags, InputSourceType)	Creare un nuovo evento chiave.
KeyEvent(Int64, String, Int32, KeyEventFlags)	Creare un nuovo evento chiave per una stringa di caratteri.
KeyEvent(IntPtr, JniHandleOwnership)	Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.
KeyEvent(KeyEvent)	Creare una copia esatta di un evento chiave esistente.
KeyEvent(KeyEvent, Int64, Int32)	Obsoleti. Copiare un evento chiave esistente, modificandone il tempo e il numero di ripetizioni.
KeyEvent(KeyEventActions, Keycode)	Creare un nuovo evento chiave.

Campi

KeycodeDemoApp1	Obsoleti. Costante del codice chiave: Chiave applicazione demo #1.
KeycodeDemoApp2	Obsoleti. Costante del codice chiave: Chiave applicazione demo #2.
KeycodeDemoApp3	Obsoleti. Costante del codice chiave: Chiave applicazione demo #3.
KeycodeDemoApp4	Obsoleti. Costante del codice chiave: Chiave applicazione demo #4.
KeycodeFeaturedApp1	Obsoleti. Costante del codice chiave: chiave applicazione in primo piano #1.
KeycodeFeaturedApp2	Obsoleti. Costante del codice chiave: chiave applicazione in primo piano #2.
KeycodeFeaturedApp3	Obsoleti. Costante codice chiave: chiave applicazione in primo piano #3.
KeycodeFeaturedApp4	Obsoleti. Costante del codice chiave: chiave applicazione in primo piano #4.
KeycodeKeyboardBacklightDown	Obsoleti. Costante del codice chiave: tastiera indietro giù
KeycodeKeyboardBacklightToggle	Obsoleti. Costante del codice chiave: interruttore della tastiera
KeycodeKeyboardBacklightUp	Obsoleti. Costante del codice chiave: tastiera di backup
KeycodeMacro1	Obsoleti. Costante del codice chiave: pulsante il cui utilizzo può essere personalizzato dall'utente tramite il sistema.
KeycodeMacro2	Obsoleti. Costante del codice chiave: pulsante il cui utilizzo può essere personalizzato dall'utente tramite il sistema.
KeycodeMacro3	Obsoleti. Costante del codice chiave: pulsante il cui utilizzo può essere personalizzato dall'utente tramite il sistema.
KeycodeMacro4	Obsoleti. Costante del codice chiave: pulsante il cui utilizzo può essere personalizzato dall'utente tramite il sistema.
KeycodeRecentApps	Obsoleti. Costante del codice chiave: per aprire la visualizzazione delle app recenti (a).
KeycodeStylusButtonPrimary	Obsoleti. Costante del codice chiave: pulsante primario sul barile di uno stilo.
KeycodeStylusButtonSecondary	Obsoleti. Costante del codice chiave: pulsante secondario sulla barra di uno stilo.
KeycodeStylusButtonTail	Obsoleti. Costante del codice chiave: pulsante sulla parte finale di uno stilo.
KeycodeStylusButtonTertiary	Obsoleti. Costante del codice chiave: pulsante terziario sulla barra di uno stilo.
KeycodeVideoApp1	Obsoleti. Costante del codice chiave: Chiave applicazione video #1.
KeycodeVideoApp2	Obsoleti. Costante del codice chiave: Chiave applicazione video #2.
KeycodeVideoApp3	Obsoleti. Costante del codice chiave: Chiave applicazione video #3.
KeycodeVideoApp4	Obsoleti. Costante del codice chiave: Chiave applicazione video #4.
KeycodeVideoApp5	Obsoleti. Costante del codice chiave: Chiave applicazione video #5.
KeycodeVideoApp6	Obsoleti. Costante del codice chiave: Chiave applicazione video #6.
KeycodeVideoApp7	Obsoleti. Costante del codice chiave: Chiave applicazione video #7.
KeycodeVideoApp8	Obsoleti. Costante del codice chiave: Chiave applicazione video #8.
MaxKeycode	Obsoleti. Metodo deprecato.

Proprietà

Action	Recuperare l'azione di questo evento chiave.
Characters	Per il caso speciale di un evento con codice chiave di #KEYCODE_UNKNOWN, si tratta di una #ACTION_MULTIPLE stringa non elaborata di caratteri associati all'evento.
Class	Restituisce la classe di runtime di questo Objectoggetto . (Ereditato da Object)
Creator
Device	Ottiene il dispositivo proveniente da questo evento. (Ereditato da InputEvent)
DeviceId	Da aggiungere
DisplayLabel	Ottiene il carattere primario per questa chiave.
DownTime	Recuperare l'ora dell'evento android.os.SystemClock#uptimeMillis chiave down più recente, nella base temporale.
EventTime	Recuperare l'ora android.os.SystemClock#uptimeMillis in cui si è verificato questo evento, nella base temporale.
Flags	Restituisce i flag per questo evento chiave.
Handle	Handle all'istanza di Android sottostante. (Ereditato da Object)
HasNoModifiers	Restituisce true se non vengono premuti tasti di modifica.
IsAltPressed	Restituisce lo stato premuto del meta key ALT.
IsCanceled	Per #ACTION_UP gli eventi, indica che l'evento è stato annullato in base a #FLAG_CANCELED.
IsCapsLockOn	Restituisce lo stato bloccato della meta chiave CAPS LOCK.
IsCtrlPressed	Restituisce lo stato premuto del tasto META CTRL.
IsFunctionPressed	Restituisce lo stato premuto del meta key FUNCTION.
IsLongPress	Per #ACTION_DOWN gli eventi, indica che l'evento è stato annullato in base a #FLAG_LONG_PRESS.
IsMetaPressed	Restituisce lo stato premuto del meta key META.
IsNumLockOn	Restituisce lo stato bloccato della meta chiave NUM LOCK.
IsPrintingKey	Restituisce true se questa chiave produce un glifo.
IsScrollLockOn	Restituisce lo stato bloccato della meta chiave SCROLL LOCK.
IsShiftPressed	Restituisce lo stato premuto del meta key MAIUSC.
IsSymPressed	Restituisce lo stato premuto del meta key SYM.
IsSystem	È una chiave di sistema? Le chiavi di sistema non possono essere usate per i tasti di scelta rapida dei menu.
IsTracking	Per #ACTION_UP gli eventi, indica che l'evento viene ancora monitorato dall'evento iniziale in base a #FLAG_TRACKING.
JniIdentityHashCode	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
JniPeerMembers	Oggetto usato per segnalare eventi chiave e pulsante.
KeyCharacterMap	Ottiene l'oggetto KeyCharacterMap associato al dispositivo da tastiera.
KeyCode	Recuperare il codice chiave dell'evento chiave.
MaxKeyCode	Restituisce il codice di chiave massimo.
MetaState	Restituisce lo stato delle chiavi meta.
ModifierMetaStateMask	Ottiene una maschera che include tutti i bit di meta stato della chiave di modifica validi.
Modifiers	Restituisce lo stato delle chiavi del modificatore.
Number	Ottiene il numero o il simbolo associato alla chiave.
PeerReference	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
RepeatCount	Recuperare il numero di ripetizioni dell'evento.
ScanCode	Recuperare l'ID chiave hardware di questo evento chiave.
Source	Da aggiungere
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
UnicodeChar	Ottiene il carattere Unicode generato dalla combinazione di stato della chiave e della meta chiave specificata.

Metodi

ChangeAction(KeyEvent, KeyEventActions)	Creare un nuovo evento chiave uguale a quello specificato, ma la cui azione viene sostituita con il valore specificato.
ChangeFlags(KeyEvent, KeyEventFlags)	Creare un nuovo evento chiave uguale a quello specificato, ma i cui flag vengono sostituiti con il valore specificato.
ChangeTimeRepeat(KeyEvent, Int64, Int32)	Creare un nuovo evento chiave uguale a quello specificato, ma il cui tempo di evento e il conteggio delle ripetizioni vengono sostituiti con il valore specificato.
ChangeTimeRepeat(KeyEvent, Int64, Int32, KeyEventFlags)	Creare un nuovo evento chiave uguale a quello specificato, ma il cui tempo di evento e il conteggio delle ripetizioni vengono sostituiti con il valore specificato.
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
DescribeContents()	Descrivere i tipi di oggetti speciali contenuti nella rappresentazione marshalled di Parcelable. (Ereditato da InputEvent)
Dispatch(KeyEvent+ICallback)
Dispatch(KeyEvent+ICallback, KeyEvent+DispatcherState, Object)	Recapitare questo evento chiave a un'interfaccia .
Dispose()	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
Dispose(Boolean)	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
GetDeadChar(Int32, Int32)	Ottenere il carattere prodotto mettendo accento sul carattere c.
GetHashCode()	Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object)
GetKeyData(KeyCharacterMap+KeyData)	Obsoleti. Ottenere i dati di conversione dei caratteri per un determinato codice chiave.
GetMatch(Char[])	Ottiene il primo carattere nella matrice di caratteri che può essere generato dal codice chiave specificato.
GetMatch(Char[], Int32)	Obsoleti. Oggetto usato per segnalare eventi chiave e pulsante.
GetMatch(Char[], MetaKeyStates)	Ottiene il primo carattere nella matrice di caratteri che può essere generato dal codice chiave specificato.
GetUnicodeChar(Int32)	Obsoleti. Oggetto usato per segnalare eventi chiave e pulsante.
GetUnicodeChar(MetaKeyStates)	Ottiene il carattere Unicode generato dalla combinazione di stato della chiave e della meta chiave specificata.
HasModifiers(MetaKeyStates)	Restituisce true se vengono premuti solo i tasti modificatori specificati.
IsFromSource(InputSourceType)	Determina se l'evento proviene dall'origine specificata. (Ereditato da InputEvent)
IsGamepadButton(Keycode)	Restituisce true se il codice chiave specificato è un pulsante gamepad.
IsMediaSessionKey(Int32)	Restituisce se questa chiave verrà inviata all'oggetto android.media.session.MediaSession.Callback se non gestito.
IsModifierKey(Keycode)	Restituisce true se questo codice chiave è una chiave di modifica.
JavaFinalize()	Chiamato dal Garbage Collector in un oggetto quando Garbage Collection determina che non sono presenti più riferimenti all'oggetto. (Ereditato da Object)
KeyCodeFromString(String)	Ottiene un codice chiave in base al nome simbolico, ad esempio "KEYCODE_A" o una costante numerica equivalente, ad esempio "29".
KeyCodeToString(Keycode)	Restituisce una stringa che rappresenta il nome simbolico del codice di chiave specificato, ad esempio "KEYCODE_A", "KEYCODE_DPAD_UP" o una costante numerica equivalente, ad esempio "1001" se sconosciuta.
MetaStateHasModifiers(MetaKeyStates, MetaKeyStates)	Restituisce true se vengono premuti solo i tasti di modifica specificati in base allo stato meta specificato.
MetaStateHasNoModifiers(MetaKeyStates)	Restituisce true se non vengono premuti tasti modificatori in base allo stato meta specificato.
NormalizeMetaState(MetaKeyStates)	Normalizza lo stato meta specificato.
Notify()	Riattiva un singolo thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
SetSource(InputSourceType)	Da aggiungere
StartTracking()	Chiamare questa operazione durante Callback#onKeyDown per tenere traccia del tasto attraverso il relativo finale (possibilmente inclusa una pressione lunga).
ToArray<T>()	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
ToString()	Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object)
UnregisterFromRuntime()	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
Wait()	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere eseguendo>una notifica</em o <em interrotto</>em>>.< (Ereditato da Object)
Wait(Int64)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64, Int32)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Appiattire questo oggetto in un pacchetto.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
IJavaPeerable.Finalized()	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Oggetto usato per segnalare eventi chiave e pulsante. (Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione dei tipi controllati dal runtime Android.
JavaCast<TResult>(IJavaObject)	Oggetto usato per segnalare eventi chiave e pulsante.
GetJniTypeName(IJavaPeerable)	Oggetto usato per segnalare eventi chiave e pulsante.