Condividi tramite


Funzione SetTextContext (recapis.h)

Fornisce le stringhe di testo precedenti e successive al testo contenuto nel contesto del riconoscitore.

Questa funzione viene chiamata prima di elaborare l'input penna per la prima volta. Chiamare quindi la funzione SetTextContext prima di chiamare la funzione Process .

Sintassi

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

Parametri

hrc

Gestire nel contesto del riconoscitore.

cwcBefore

Numero di caratteri in pwcBefore.

pwcBefore

Stringa di testo che precede il testo contenuto nel contesto del riconoscitore. La stringa non è null terminata.

cwcAfter

Numero di caratteri in pwcAfter.

pwcAfter

Stringa di testo che segue il testo contenuto nel contesto del riconoscitore. La stringa non è NULL con terminazione.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Operazione completata.
E_POINTER
Il contesto non è valido o uno dei parametri è un puntatore non valido.
E_NOTIMPL
Il riconoscitore non supporta questa funzione.
E_OUTOFMEMORY
Impossibile allocare memoria per completare l'operazione.
E_FAIL
Si è verificato un errore non specificato.
E_INVALIDARG
È stato specificato un argomento non valido.

Commenti

La funzione SetTextContext fornisce il contesto per una frase o una parola, aumentando l'accuratezza del riconoscimento. Ad esempio, se la stringa pwcBefore pwcBefore è "sotto " e la stringa pwcAfter è "in casa", è possibile distorsione del riconoscimento usando una parola o parole tra le stringhe. Il riconoscitore deve considerare lo spazio dopo "the" e prima di "in" durante l'esecuzione del riconoscimento.

Tuttavia, se la stringa pwcAfter è "Hel" e la stringa pwcBefore è "o", la mancanza di spazio tra le stringhe indica che il riconoscitore deve riconoscere una o più lettere all'interno di una parola che inizia con "Hel" e termina con "o".

È consigliabile limitare la lunghezza del contesto di testo a non più di 1024 caratteri ciascuno per i contesti sinistro e destro.

Requisiti

   
Client minimo supportato Windows XP Tablet PC Edition [app desktop | App UWP]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione recapis.h
DLL inkobjcore.dll