Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine quando si preme un tasto in Image Viewer, Zoom Viewer, Text Editor, Text Validator o Document Viewer. Passa al client il codice del tasto, il numero di ripetizioni e i tasti modificatori utilizzati. Questo metodo consente anche di annullare l’operazione.

​
Sintassi

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

​
Parametri

KeyCode [in] Specifica il codice del tasto virtuale del tasto premuto. Count [in] Contiene il numero di ripetizioni, ovvero il numero di volte in cui la pressione del tasto viene ripetuta quando l’utente lo tiene premuto. Flags [in] Contiene il codice di scansione, il codice di transizione del tasto, lo stato precedente del tasto e il codice di contesto, come mostrato nell’elenco seguente:
ValoreDescrizione
0-7Specifica il codice di scansione. Il valore dipende dal produttore di apparecchiature originali (OEM).
8Specifica se il tasto è un tasto esteso, ad esempio i tasti ALT e CTRL di destra presenti su una tastiera avanzata a 101 o 102 tasti. Il valore è 1 se si tratta di un tasto esteso; altrimenti è 0.
9-12Utilizzato internamente da Windows.
13Specifica il codice di contesto. Il valore è 1 se il tasto ALT viene tenuto premuto mentre il tasto viene premuto; altrimenti il valore è 0.
14Specifica lo stato precedente del tasto. Il valore è 1 se il tasto è premuto prima dell’invio del messaggio; altrimenti è 0 se il tasto è rilasciato.
15Specifica lo stato di transizione. Il valore è 1 se il tasto viene rilasciato; altrimenti è 0 se il tasto viene premuto.
Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere terminato.

​
Valori di ritorno

[Solo C++] Se questo metodo restituisce un valore diverso da S_OK, significa che si è verificato un errore lato client e, in tal caso, il valore del parametro Cancel viene ignorato.

​
Osservazioni

L’implementazione lato client di questo metodo deve garantire che tutte le eccezioni generate all’interno del metodo vengano intercettate e gestite e che nessuna eccezione si propaghi all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può causare risultati imprevedibili, fino alla terminazione del programma.

​
Vedi anche

IInputEvents