Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine quando la pressione di un tasto genera un carattere in Image Viewer, Zoom Viewer, Text Editor, Text Validator o Document Viewer. Fornisce al client il codice del carattere, il numero di ripetizioni e alcune informazioni aggiuntive sulla pressione del tasto. Con questo metodo è possibile annullare l’operazione.

​
Sintassi

​
C++

HRESULT OnChar(
  int           Character,
  int           Count,
  int           Flags,
  VARIANT_BOOL* Cancel
);

​
C#

void OnChar(
  int      Character,
  int      Count,
  int      Flags,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnChar( _
  Character As Integer, _
  Count As Integer, _
  Flags As Integer, _
  ByRef Cancel As Boolean _
)

​
Parametri

Carattere [in] Contiene il valore del codice carattere del tasto. 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 è esteso, come i tasti ALT e CTRL destri presenti su una tastiera avanzata a 101 o 102 tasti. Il valore è 1 se il tasto è esteso; in caso contrario, è 0.
9-12Utilizzato internamente da Windows.
13Specifica il codice di contesto. Il valore è 1 se il tasto ALT viene tenuto premuto mentre si preme il tasto; in caso contrario, il valore è 0.
14Specifica lo stato precedente del tasto. Il valore è 1 se il tasto è premuto prima dell’invio del messaggio, oppure 0 se è rilasciato.
15Specifica lo stato di transizione. Il valore è 1 se il tasto viene rilasciato, oppure 0 se 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 non viene preso in considerazione.

​
Osservazioni

L’implementazione lato client di questo metodo deve garantire che tutte le eccezioni sollevate 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, come la terminazione del programma.

​
Vedi anche

IInputEvents