HRECOCONTEXT Handle

Un handle HRECOCONTEXT viene usato per aggiungere input penna al contesto, eseguire il riconoscimento dell'input penna (in modo sincrono o asincrono), recuperare il risultato del riconoscimento e recuperare alternative.

Il motivo principale per cui sono presenti handle di contesto di riconoscimento consiste nel distinguere tra input input penna. Ad esempio, è possibile creare un'applicazione con due finestre, l'utente è in grado di eseguire l'input penna in una delle due finestre. Non si vuole che l'input penna della prima finestra si confonda con l'input penna della seconda finestra quando si chiede al riconoscitore di riconoscere l'input penna di una delle finestre. In questo tipo di applicazione si creano due contesti di riconoscimento (uno per ogni finestra) e si aggiungono tratti che entrano nella finestra 1 nel contesto di riconoscimento 1 e tratti dalla finestra 2 al contesto di riconoscimento 2. Per restituire i risultati del riconoscimento, chiamare il processo nel contesto del riconoscimento 1 o nel contesto del riconoscitore 2 a seconda che si vogliano ottenere i risultati per la finestra 1 o 2.

L'handle di contesto del riconoscitore può essere qualsiasi elemento desiderato. Ma in genere si tratta di un indice in una matrice globale di strutture. Le strutture possono contenere tutti i tratti immessi e tutte le variabili usate dal riconoscitore per quel particolare pezzo di inchiostro (ad esempio, la struttura del reticolo interno o lo stato corrente del riconoscimento). Una struttura può contenere tutte le informazioni richieste dal riconoscitore e usarle per un particolare elemento di input penna.

Per ottenere un handle HRECOCONTEXT , chiamare la funzione CreateContext .

typedef HANDLE HRECOCONTEXT;

Commenti

Di seguito sono riportate le funzioni HRECOCONTEXT

Funzione	Descrizione
AddStroke	Aggiunge un tratto input penna al contesto del riconoscitore.
AdviseInkChange	Impedisce al riconoscitore di elaborare l'input penna perché viene aggiunto o eliminato un nuovo tratto.
CloneContext	Crea un contesto di riconoscimento che contiene le stesse impostazioni dell'originale. Il nuovo contesto di riconoscimento non include i risultati dell'input penna o del riconoscimento dell'originale.
EndInkInput	Indica che al contesto non verrà aggiunto più input penna.
GetAlternateList	Restituisce un elenco di alternative per la stringa di risultati migliore.
GetBestAlternate	Restituisce un puntatore handle HRECOALT per il miglior risultato alternativo.
GetBestResultString	Restituisce la stringa di risultato migliore.
GetContextPropertyList	Restituisce un elenco di proprietà supportate dal riconoscitore.
GetContextPropertyValue	Restituisce un valore di proprietà specificato dal contesto del riconoscitore.
GetEnabledUnicodeRanges	Restituisce un elenco di intervalli di punti Unicode abilitati nel contesto.
GetGuide	Restituisce la guida utilizzata per l'input boxed o fiancheggiato.
GetLatticePtr	Restituisce un puntatore al reticolo per i risultati correnti.
IsStringSupported	Restituisce un valore che indica se una parola, una data, un'ora, un numero o un altro testo passato è contenuto nel dizionario.
Processo	Esegue il riconoscimento dell'input penna in modo sincrono.
ResetContext	Elimina i risultati correnti dell'input penna e del riconoscimento dal contesto.
SetCACMode	Specifica la modalità di completamento automatico dei caratteri per il riconoscimento di caratteri o parole.
SetContextPropertyValue	Aggiunge una proprietà al contesto del riconoscitore. Se esiste già una proprietà, il relativo valore viene modificato.
SetEnabledUnicodeRanges	Abilita uno o più intervalli di punti Unicode nel contesto.
SetFactoid	Imposta il factoid usato da un riconoscitore per vincolare la ricerca del risultato.
SetFlags	Imposta il modo in cui il riconoscitore interpreta l'input penna e determina la stringa di risultato.
SetGuide	Imposta la guida da utilizzare per l'input boxed o fiancheggiato.
SetTextContext	Fornisce le stringhe di testo precedenti e successive al testo contenuto nel contesto del riconoscitore. Per i riconoscitori di caratteri asiatici, la funzione SetTextContext fornisce caratteri anziché stringhe di testo.
SetWordList	Imposta l'elenco di parole per il contesto del riconoscitore corrente da riconoscere.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	Recapis.h