OnKeyUp-Methode der IInputEvents-Schnittstelle

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, wenn in Image Viewer, Zoom Viewer, Text Editor, Text Validator oder Document Viewer eine Taste losgelassen wird. Sie übergibt dem Client den Tastencode, die Anzahl der Wiederholungen und die verwendeten Modifikatortasten. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

Syntax

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 _
)

Parameter

KeyCode [in] Gibt den Tastaturcode der Taste an, die losgelassen wurde. Count [in] Enthält die Wiederholungsanzahl, also die Anzahl der Wiederholungen eines Tastendrucks, wenn der Benutzer die Taste gedrückt hält. Flags [in] Enthält den Scan-Code, den Tastenübergangscode, den vorherigen Tastenstatus und den Kontextcode, wie in der folgenden Liste gezeigt:

Wert	Beschreibung
0-7	Gibt den Scan-Code an. Der Wert hängt vom Originalgerätehersteller (OEM) ab.
8	Gibt an, ob es sich bei der Taste um eine erweiterte Taste handelt, z. B. um die rechten ALT- und CTRL-Tasten auf einer erweiterten Tastatur mit 101 oder 102 Tasten. Der Wert ist 1, wenn es sich um eine erweiterte Taste handelt, andernfalls 0.
9-12	Wird intern von Windows verwendet.
13	Gibt den Kontextcode an. Der Wert ist 1, wenn die ALT-Taste gedrückt gehalten wird, während die Taste gedrückt wird, andernfalls ist der Wert 0.
14	Gibt den vorherigen Tastenstatus an. Der Wert ist 1, wenn die Taste vor dem Senden der Meldung gedrückt ist, oder 0, wenn sie nicht gedrückt ist.
15	Gibt den Übergangsstatus an. Der Wert ist 1, wenn die Taste gerade losgelassen wird, oder 0, wenn sie gerade gedrückt wird.

Cancel [out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Prozess beendet werden soll. In diesem Fall gibt die entsprechende Funktion E_ABORT zurück.

Rückgabewerte

[Nur für C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet das, dass clientseitig ein Fehler aufgetreten ist; in diesem Fall wird der Wert des Parameters Cancel nicht berücksichtigt.

Hinweise

Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und behandelt werden und dass keine Ausnahmen über die Methode hinaus weitergegeben werden. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).