Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine quando viene rilasciato 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. Con questo metodo è possibile annullare l’operazione.

​
Sintassi

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

​
Parametri

KeyCode [in] Specifica il codice del tasto che viene rilasciato. Count [in] Contiene il conteggio delle ripetizioni, ovvero il numero di volte in cui la pressione del tasto viene ripetuta quando l’utente tiene premuto il tasto. 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, come 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 è 0.
14Specifica lo stato precedente del tasto. Il valore è 1 se il tasto è già 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 interrotto. In questo caso, la funzione corrispondente restituisce E_ABORT.

​
Valori di ritorno

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

​
Osservazioni

L’implementazione client di questo metodo deve garantire che tutte le eccezioni generate all’interno del metodo vengano intercettate e gestite e che nessuna eccezione venga propagata al di fuori del metodo. La propagazione di un’eccezione al di fuori del metodo può portare a risultati imprevedibili (ad esempio, la terminazione del programma).

​
Vedi anche

IInputEvents