Zum Hauptinhalt springen
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:
WertBeschreibung
0-7Gibt den Scancode an. Der Wert hängt vom Originalgerätehersteller (OEM) ab.
8Gibt 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-12Wird intern von Windows verwendet.
13Gibt den Kontextcode an. Der Wert ist 1, wenn die ALT-Taste gedrückt gehalten wird, während die Taste gedrückt wird, andernfalls 0.
14Gibt 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.
15Gibt 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).

​
Siehe auch

IInputEvents