KeyEvent Classe

Définition

Espace de noms:: Android.Views

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Objet utilisé pour signaler les événements de touche et de bouton.

[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

Héritage: Object

JavaObject

Object

InputEvent
KeyEvent

Attributs: RegisterAttribute

Implémente: IParcelable IJavaObject IJavaPeerable IDisposable

Remarques

Objet utilisé pour signaler les événements de touche et de bouton.

Chaque touche est décrite par une séquence d’événements de touche. Une touche commence par un événement de touche avec #ACTION_DOWN. Si la clé est conservée suffisamment longtemps qu’elle se répète, l’initial down est suivi d’événements clés supplémentaires avec #ACTION_DOWN et une valeur non nulle pour #getRepeatCount(). Le dernier événement de clé est une #ACTION_UP clé vers le haut. Si la touche d’appui est annulée, l’événement de mise en place de la touche aura l’indicateur #FLAG_CANCELED défini.

Les événements clés sont généralement accompagnés d’un code clé (#getKeyCode()), d’un code d’analyse (#getScanCode()) et d’un méta-état (#getMetaState()). Les constantes de code clé sont définies dans cette classe. Les constantes de code d’analyse sont des codes bruts spécifiques à l’appareil obtenus à partir du système d’exploitation et ne sont donc pas généralement significatifs pour les applications, sauf si elles sont interprétées à l’aide du KeyCharacterMap. Les états méta décrivent l’état appuyé des modificateurs de touches tels que #META_SHIFT_ON ou #META_ALT_ON.

Les codes de clé correspondent généralement un-à-un avec des clés individuelles sur un appareil d’entrée. De nombreuses touches et combinaisons de touches servent des fonctions assez différentes sur différents appareils d’entrée, de sorte que vous devez prendre soin de les interpréter. Utilisez toujours l’élément KeyCharacterMap associé à l’appareil d’entrée lors du mappage de clés à des caractères. N’oubliez pas qu’il peut y avoir plusieurs périphériques d’entrée clés actifs en même temps et que chacun aura sa propre carte de caractères de clé.

Étant donné que les méthodes d’entrée réversible peuvent utiliser plusieurs méthodes inventifs pour insérer du texte, il n’existe aucune garantie que les touches d’appui sur un clavier logiciel génèrent un événement de touche : ceci est laissé à la discrétion de l’IME, et en fait l’envoi de ces événements est déconseillé. Vous ne devez jamais compter sur la réception de KeyEvents pour toute clé sur une méthode d’entrée réversible. En particulier, le clavier logiciel par défaut n’envoie jamais d’événement de touche à n’importe quelle application ciblant Jelly Bean ou une version ultérieure, et n’envoie que des événements pour certaines pressions de la suppression et renvoyer des touches aux applications ciblant Ice Cream Sandwich ou une version antérieure. N’oubliez pas que d’autres méthodes d’entrée logicielle ne peuvent jamais envoyer d’événements clés quelle que soit la version. Envisagez d’utiliser des actions de l’éditeur comme android.view.inputmethod.EditorInfo#IME_ACTION_DONE si vous avez besoin d’une interaction spécifique avec le clavier logiciel, car elle donne plus de visibilité à l’utilisateur quant à la façon dont votre application réagira aux pressions de touches.

Lors de l’interaction avec un IME, l’infrastructure peut fournir des événements clés avec l’action #ACTION_MULTIPLE spéciale qui spécifie le code de clé répété unique ou une séquence de caractères à insérer.

En général, l’infrastructure ne peut pas garantir que les événements clés qu’il remet à une vue constituent toujours des séquences de clés complètes, car certains événements peuvent être supprimés ou modifiés en contenant des vues avant qu’ils ne soient remis. L’implémentation de la vue doit être préparée à gérer #FLAG_CANCELED et tolérer des situations anormales telles que la réception d’un nouveau #ACTION_DOWN sans avoir d’abord reçu une #ACTION_UP pour la touche précédente.

InputDevice Pour plus d’informations sur la façon dont différents types d’appareils et de sources d’entrée représentent des touches et des boutons.

Java documentation pour android.view.KeyEvent.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Constructeurs

Nom	Description
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags, InputSourceType)	Créez un événement clé.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags)	Créez un événement clé.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32)	Créez un événement clé.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates)	Créez un événement clé.
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32)	Créez un événement clé.
KeyEvent(Int64, String, Int32, KeyEventFlags)	Créez un événement de clé pour une chaîne de caractères.
KeyEvent(IntPtr, JniHandleOwnership)	Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.
KeyEvent(KeyEvent, Int64, Int32)	Obsolète. Copiez un événement de clé existant, en modifiant son temps et son nombre de répétitions.
KeyEvent(KeyEvent)	Effectuez une copie exacte d’un événement de clé existant.
KeyEvent(KeyEventActions, Keycode)	Créez un événement clé.

Champs

Nom	Description
KeycodeClose	Obsolète. Constante de code clé : AC Close.
KeycodeDemoApp1	Obsolète. Constante de code clé : clé d’application de démonstration #1.
KeycodeDemoApp2	Obsolète. Constante de code clé : clé d’application de démonstration #2.
KeycodeDemoApp3	Obsolète. Constante de code clé : clé d’application de démonstration #3.
KeycodeDemoApp4	Obsolète. Constante de code clé : clé d’application de démonstration #4.
KeycodeDictate	Obsolète. Constante de code clé : pour commencer à dicter un champ d’entrée
KeycodeDoNotDisturb	Obsolète. Constante du code clé : activer le mode « Ne pas déranger ».
KeycodeEmojiPicker	Obsolète. Constante du code clé : pour ouvrir le sélecteur d’emojis.
KeycodeF13	Obsolète. Constante de code de clé : touche F13.
KeycodeF14	Obsolète. Constante de code clé : touche F14.
KeycodeF15	Obsolète. Constante de code de clé : clé F15.
KeycodeF16	Obsolète. Constante de code de clé : touche F16.
KeycodeF17	Obsolète. Constante de code clé : touche F17.
KeycodeF18	Obsolète. Constante de code clé : clé F18.
KeycodeF19	Obsolète. Constante de code de clé : clé F19.
KeycodeF20	Obsolète. Constante de code clé : touche F20.
KeycodeF21	Obsolète. Constante de code de clé : touche F21.
KeycodeF22	Obsolète. Constante de code clé : touche F22.
KeycodeF23	Obsolète. Constante de code de clé : touche F23.
KeycodeF24	Obsolète. Constante de code clé : touche F24.
KeycodeFeaturedApp1	Obsolète. Constante de code clé : clé d’application recommandée #1.
KeycodeFeaturedApp2	Obsolète. Constante de code clé : clé d’application recommandée #2.
KeycodeFeaturedApp3	Obsolète. Constante de code clé : clé d’application recommandée #3.
KeycodeFeaturedApp4	Obsolète. Constante de code clé : clé d’application recommandée #4.
KeycodeFullscreen	Obsolète. Constante du code clé : activer/désactiver le mode plein écran (sur l’application actuelle).
KeycodeKeyboardBacklightDown	Obsolète. Constante de code clé : rétroéclairage du clavier.
KeycodeKeyboardBacklightToggle	Obsolète. Constante de code clé : bascule arrière clavier.
KeycodeKeyboardBacklightUp	Obsolète. Constante de code clé : rétroéclairage du clavier.
KeycodeLock	Obsolète. Constante de code clé : pour verrouiller l’écran.
KeycodeMacro1	Obsolète. Constante de code clé : bouton dont l’utilisation peut être personnalisée par l’utilisateur via le système.
KeycodeMacro2	Obsolète. Constante de code clé : bouton dont l’utilisation peut être personnalisée par l’utilisateur via le système.
KeycodeMacro3	Obsolète. Constante de code clé : bouton dont l’utilisation peut être personnalisée par l’utilisateur via le système.
KeycodeMacro4	Obsolète. Constante de code clé : bouton dont l’utilisation peut être personnalisée par l’utilisateur via le système.
KeycodeNew	Obsolète. Constante de code clé : AC New.
KeycodePrint	Obsolète. Constante de code clé : à imprimer.
KeycodeRecentApps	Obsolète. Constante de code clé : pour ouvrir la vue des applications récentes (a.
KeycodeScreenshot	Obsolète. Constante de code clé : pour prendre une capture d’écran `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	Obsolète. Constante de code clé : bouton principal sur le canon d’un stylet.
KeycodeStylusButtonSecondary	Obsolète. Constante de code clé : bouton secondaire sur le canon d’un stylet.
KeycodeStylusButtonTail	Obsolète. Constante de code clé : bouton situé à la fin d’un stylet.
KeycodeStylusButtonTertiary	Obsolète. Constante de code clé : bouton tertiaire sur le canon d’un stylet.
KeycodeVideoApp1	Obsolète. Constante de code clé : clé d’application vidéo #1.
KeycodeVideoApp2	Obsolète. Constante de code clé : clé d’application vidéo #2.
KeycodeVideoApp3	Obsolète. Constante de code clé : clé d’application vidéo #3.
KeycodeVideoApp4	Obsolète. Constante de code clé : clé d’application vidéo #4.
KeycodeVideoApp5	Obsolète. Constante de code clé : clé d’application vidéo #5.
KeycodeVideoApp6	Obsolète. Constante de code clé : clé d’application vidéo #6.
KeycodeVideoApp7	Obsolète. Constante de code clé : clé d’application vidéo #7.
KeycodeVideoApp8	Obsolète. Constante de code clé : clé d’application vidéo #8.
MaxKeycode	Obsolète. Spécifie le plus grand code de clé défini par ce niveau d’API.

Propriétés

Nom	Description
Action	Récupérez l’action de cet événement clé.
Characters	Pour le cas spécial d’un `#ACTION_MULTIPLE` événement avec le code clé de `#KEYCODE_UNKNOWN`, il s’agit d’une chaîne brute de caractères associée à l’événement.
Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
Creator	Obtient le créateur de colis pour les instances KeyEvent.
Device	Obtient l’appareil à partir duquel cet événement provient. (Hérité de InputEvent)
DeviceId	Obtient l’ID de l’appareil à partir duquel cet événement provient. Un ID de zéro indique que l’événement ne provient pas d’un appareil physique et est mappé au keymap par défaut. Les autres nombres sont arbitraires et vous ne devez pas dépendre des valeurs.
DisplayLabel	Obtient le caractère principal de cette clé. En d’autres termes, l’étiquette qui est imprimée physiquement dessus.
DownTime	Récupérez l’heure de l’événement de mise hors clé la plus récente, dans la `android.os.SystemClock#uptimeMillis` base de temps.
EventTime	Récupérez l’heure à laquelle cet événement s’est produit, dans la `android.os.SystemClock#uptimeMillis` base de temps.
Flags	Retourne les indicateurs de cet événement clé.
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
HasNoModifiers	Retourne true si aucune touche de modificateur n’est enfoncée.
IsAltPressed	Retourne l’état appuyé de la touche meta ALT.
IsCanceled	Pour `#ACTION_UP` les événements, indique que l’événement a été annulé en fonction `#FLAG_CANCELED`de .
IsCapsLockOn	Retourne l’état verrouillé de la méta key CAPS LOCK.
IsCtrlPressed	Retourne l’état appuyé de la touche de méta ctrl.
IsFunctionPressed	Retourne l’état appuyé de la méta key FUNCTION.
IsLongPress	Pour `#ACTION_DOWN` les événements, indique que l’événement a été annulé en fonction `#FLAG_LONG_PRESS`de .
IsMetaPressed	Retourne l’état appuyé de la métaclé META.
IsNumLockOn	Retourne l’état verrouillé de la méta key NUM LOCK.
IsPrintingKey	Retourne true si cette clé produit un glyphe.
IsScrollLockOn	Retourne l’état verrouillé de la métaclé SCROLL LOCK.
IsShiftPressed	Retourne l’état appuyé de la méta touche Maj.
IsSymPressed	Retourne l’état appuyé de la métaclé SYM.
IsSystem	Est-ce une clé système ? Les touches système ne peuvent pas être utilisées pour les raccourcis de menu.
IsTracking	Pour `#ACTION_UP` les événements, indique que l’événement est toujours suivi de son événement initial d’arrêt en fonction `#FLAG_TRACKING`de .
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
JniPeerMembers	Obtient les métadonnées d’homologue JNI utilisées par le .NET pour le runtime de liaison Android.
KeyCharacterMap	Obtient le KeyCharacterMap associé à l’appareil clavier.
KeyCode	Récupérez le code clé de l’événement de clé.
MaxKeyCode	Retourne le code clé maximal.
MetaState	Retourne l’état des métadonnées.
ModifierMetaStateMask	Obtient un masque qui inclut tous les bits d’état méta de clé de modification valides.
Modifiers	Retourne l’état des touches de modificateur.
Number	Obtient le nombre ou le symbole associé à la clé. La valeur de caractère est retournée, et non la valeur numérique. Si la clé n’est pas un nombre, mais est un symbole, le symbole est retuné.
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
RepeatCount	Récupérez le nombre de répétitions de l’événement.
ScanCode	Récupérez l’ID de clé matérielle de cet événement de clé.
Source	Obtient la source de l’événement.
ThresholdClass	Obtient le handle de classe JNI utilisé par le .NET pour le runtime de liaison Android.
ThresholdType	Obtient le type managé utilisé par le .NET pour le runtime de liaison Android.
UnicodeChar	Obtient le caractère Unicode généré par la combinaison d’état de clé et de méta-clé spécifiée.

Méthodes

Nom	Description
ChangeAction(KeyEvent, KeyEventActions)	Créez un événement de clé identique à celui donné, mais dont l’action est remplacée par la valeur donnée.
ChangeFlags(KeyEvent, KeyEventFlags)	Créez un événement de clé identique à celui donné, mais dont les indicateurs sont remplacés par la valeur donnée.
ChangeTimeRepeat(KeyEvent, Int64, Int32, KeyEventFlags)	Créez un événement de clé identique à celui donné, mais dont le nombre d’événements et de répétitions sont remplacés par la valeur donnée.
ChangeTimeRepeat(KeyEvent, Int64, Int32)	Créez un événement de clé identique à celui donné, mais dont le nombre d’événements et de répétitions sont remplacés par la valeur donnée.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
DescribeContents()	Décrivez les types d’objets spéciaux contenus dans la représentation marshallée de ce Colisable. (Hérité de InputEvent)
Dispatch(KeyEvent+ICallback, KeyEvent+DispatcherState, Object)	Répartit cet événement clé vers un récepteur de rappel.
Dispatch(KeyEvent+ICallback)	Obsolète. Répartit cet événement clé vers un récepteur de rappel.
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
Equals(Object)	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetDeadChar(Int32, Int32)	Obtenez le caractère produit en plaçant l’accentuation sur le caractère c.
GetHashCode()	Retourne une valeur de code de hachage pour l’objet. (Hérité de Object)
GetKeyData(KeyCharacterMap+KeyData)	Obsolète. Obtenez les données de conversion de caractères pour un code de clé donné.
GetMatch(Char[], Int32)	Obsolète. Obtient le premier caractère candidat que cet événement clé peut produire avec l’état méta donné.
GetMatch(Char[], MetaKeyStates)	Obtient le premier caractère du tableau de caractères qui peut être généré par le code de clé spécifié.
GetMatch(Char[])	Obtient le premier caractère du tableau de caractères qui peut être généré par le code de clé spécifié.
GetUnicodeChar(Int32)	Obsolète. Obtient le caractère Unicode généré par cet événement clé avec l’état méta spécifié.
GetUnicodeChar(MetaKeyStates)	Obtient le caractère Unicode généré par la combinaison d’état de clé et de méta-clé spécifiée.
HasModifiers(MetaKeyStates)	Retourne true si seules les touches modificateurs spécifiées sont enfoncées.
IsFromSource(InputSourceType)	Détermine si l’événement provient de la source donnée. (Hérité de InputEvent)
IsGamepadButton(Keycode)	Retourne true si le code clé spécifié est un bouton de boîtier de commande.
IsMediaSessionKey(Int32)	Retourne si cette clé est envoyée au `android.media.session.MediaSession.Callback` si elle n’est pas gérée.
IsModifierKey(Keycode)	Retourne true si ce code de clé est une clé de modificateur.
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
KeyCodeFromString(String)	Obtient un code clé par son nom symbolique tel que « KEYCODE_A » ou une constante numérique équivalente telle que « 29 ».
KeyCodeToString(Keycode)	Retourne une chaîne qui représente le nom symbolique du code clé spécifié, tel que « KEYCODE_A », « KEYCODE_DPAD_UP » ou une constante numérique équivalente telle que « 1001 » si elle est inconnue.
MetaStateHasModifiers(MetaKeyStates, MetaKeyStates)	Retourne true si seules les touches de modificateur spécifiées sont enfoncées en fonction de l’état méta spécifié.
MetaStateHasNoModifiers(MetaKeyStates)	Retourne true si aucune touche de modificateur n’est enfoncée en fonction de l’état méta spécifié.
NormalizeMetaState(MetaKeyStates)	Normalise l’état de méta spécifié.
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
SetSource(InputSourceType)	Définit la source d’entrée qui a généré cet événement de clé.
StartTracking()	Appelez-le pendant `Callback#onKeyDown` pour que le système effectue le suivi de la touche jusqu’à sa finale (éventuellement une longue pression).
ToArray<T>()	Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToString()	Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object)
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Aplatir cet objet dans un colis.

Implémentations d’interfaces explicites

Nom	Description
IJavaPeerable.Disposed()	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
IJavaPeerable.Finalized()	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Objet utilisé pour signaler les événements de touche et de bouton. (Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Objet utilisé pour signaler les événements de touche et de bouton.

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Objet utilisé pour signaler les événements de touche et de bouton.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à