OnKeyDown-Methode der IInputEvents-Schnittstelle

Diese Methode ist clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, wenn im Bildbetrachter, Zoom-Viewer, Texteditor, Textvalidator oder Dokumentbetrachter eine Taste gedrückt wird. Dabei werden dem Client der Tastencode, die Anzahl der Wiederholungen und die verwendeten Modifikatortasten übergeben. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

Syntax

C++

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

C#

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

Visual Basic .NET

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

Parameter

KeyCode [in] Gibt den virtuellen Tastencode der gedrückten Taste an. Count [in] Enthält die Wiederholungsanzahl, also die Anzahl, wie oft der Tastendruck wiederholt wird, wenn der Benutzer die Taste gedrückt hält. Flags [in] Enthält den Scancode, den Übergangscode, den vorherigen Tastenzustand und den Kontextcode, wie in der folgenden Liste gezeigt:

Wert	Beschreibung
0-7	Gibt den Scancode an. Der Wert hängt vom Originalgerätehersteller (OEM) ab.
8	Gibt an, ob die Taste eine erweiterte Taste ist, beispielsweise 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 0.
14	Gibt den vorherigen Tastenzustand an. Der Wert ist 1, wenn die Taste vor dem Senden der Nachricht gedrückt ist, oder 0, wenn sie nicht gedrückt ist.
15	Gibt den Übergangszustand an. Der Wert ist 1, wenn die Taste losgelassen wird, oder 0, wenn sie gedrückt wird.

Cancel [out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Prozess beendet werden soll.

Rückgabewerte

[Nur in C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet dies, 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 in 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. zur Beendigung des Programms).