Méthode OnKeyUp de l’interface IInputEvents

Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine lorsqu’une touche est relâchée dans Image Viewer, Zoom Viewer, Text Editor, Text Validator ou Document Viewer.

Elle transmet au client le code de la touche, le nombre de répétitions et les touches modificatrices utilisées. Cette méthode permet également d’annuler l’opération.

​

Syntaxe

​

C++

HRESULT OnKeyUp(
  int           KeyCode,
  int           Count,
  int           Flags,
  VARIANT_BOOL* Cancel
);

​

C#

void OnKeyUp(
  int      KeyCode,
  int      Count,
  int      Flags,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnKeyUp( _
  KeyCode As Integer, _
  Count As Integer, _
  Flags As Integer, _
  ByRef Cancel As Boolean _
)

​

Paramètres

KeyCode

[in] Spécifie le code clavier de la touche relâchée.

Count

[in] Contient le nombre de répétitions, c’est-à-dire le nombre de fois que la frappe est répétée lorsque l’utilisateur maintient la touche enfoncée.

Flags

[in] Contient le code de balayage, le code de transition de la touche, l’état précédent de la touche et le code de contexte, comme indiqué dans la liste suivante :

Valeur	Description
0-7	Spécifie le code de balayage. La valeur dépend du fabricant d’équipement d’origine (OEM).
8	Indique si la touche est une touche étendue, par exemple les touches ALT et CTRL de droite présentes sur un clavier étendu de 101 ou 102 touches. La valeur est 1 s’il s’agit d’une touche étendue ; sinon, elle est 0.
9-12	Utilisé en interne par Windows.
13	Spécifie le code de contexte. La valeur est 1 si la touche ALT est maintenue enfoncée pendant l’appui sur la touche ; sinon, elle est 0.
14	Spécifie l’état précédent de la touche. La valeur est 1 si la touche est enfoncée avant l’envoi du message, ou 0 si elle est relâchée.
15	Spécifie l’état de transition. La valeur est 1 si la touche est en cours de relâchement, ou 0 si elle est en cours d’enfoncement.

Cancel

[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être arrêté. Dans ce cas, la fonction correspondante renvoie E_ABORT.

​

Valeurs de retour

[C++ uniquement] Si cette méthode renvoie une valeur autre que S_OK, cela indique qu’une erreur s’est produite côté client et, dans ce cas, la valeur du paramètre Cancel n’est pas prise en compte.

​

Remarques

L’implémentation du client de cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et gérées, et qu’aucune exception n’est propagée hors de la méthode. La propagation d’une exception hors de la méthode peut entraîner des résultats imprévisibles (comme l’arrêt du programme).

​

Voir aussi

IInputEvents