Funzione SetFlags (recapis.h)

Specifica come il riconoscitore interpreta l'input penna e determina la stringa di risultato.

Chiamare questa funzione prima di elaborare l'input penna per la prima volta. Chiamare quindi la funzione SetFlags prima di chiamare la funzione Process .

Sintassi

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

Parametri

[in] hrc

Gestire nel contesto del riconoscitore.

[in] dwFlags

Nella tabella seguente sono elencati i flag che è possibile impostare per specificare come il riconoscitore interpreta l'input penna e determina la stringa di risultato. Utilizzare l'operatore OR (|) per combinare i flag in base alle esigenze.

Flag di bit	Significato
RECOFLAG_AUTOSPACE	Recognizer usa la spaziatura intelligente in base alle regole del modello linguistico.
RECOFLAG_COERCE	Riconosci il risultato in base al factoid specificato per il contesto. Ad esempio, se si specifica un factoid numero di telefono e l'utente immette la parola "hello", il riconoscitore può restituire un numero di telefono casuale o una stringa vuota. Se non si specifica questo flag, il riconoscitore restituisce "hello" come risultato.
RECOFLAG_PREFIXOK	Recognizer supporta il riconoscimento di qualsiasi parte del prefisso delle stringhe definite nel modello linguistico predefinito o specificato (factoid). Ad esempio, senza questo flag, l'utente scrive "handw" e il riconoscitore restituisce suggerimenti (ad esempio "hander" o "hand hand") che sono parole presenti nel lessico di riconoscimento. Con il flag, il riconoscitore può restituire "mano" come uno dei suggerimenti poiché è un prefisso valido della parola "grafia" esistente nel lessico di riconoscimento. Il pannello di input tablet PC imposta questo flag nella maggior parte dei casi, tranne quando l'ambito di input è IS_DEFAULT (o nessun ambito di input) o quando non è presente alcun elenco di parole utente o un'espressione regolare. I riconoscitori dei caratteri asiatici devono restituire E_INVALIDARG quando un chiamante passa questo flag.
RECOFLAG_LINEMODE	Il riconoscitore non divide le righe, ma deve comunque eseguire la separazione di caratteri e parole. Si tratta dello stesso modo della modalità allineata, ad eccezione del fatto che non esiste alcuna guida e si presuppone che tutto l'input penna sia in una singola riga. Quando questo flag è impostato, viene ignorata una guida, se impostata.
RECOFLAG_SINGLESEG	Disabilita la segmentazione multipla. Per impostazione predefinita, il riconoscimento restituisce più segmentazioni (alternative) per l'input penna. Ad esempio, se si scrive "insieme" come tratti separati, il riconoscitore può segmentare l'input penna come "per ottenerla", "per raccogliere" o "insieme". Impostare questo flag se non sono necessarie più segmentazioni dell'input penna quando si esegue una query per trovare alternative. Ciò migliora le prestazioni e riduce l'utilizzo della memoria.
RECOFLAG_WORDMODE	Recognizer considera l'input penna come una singola parola. Ad esempio, se il contesto contiene "per ottenerla", il riconoscitore restituisce "insieme".

Valore restituito

Questa funzione può restituire uno di questi valori.

Valore HRESULT	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Il flag 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_POINTER	Il contesto non è valido o uno dei parametri è un puntatore non valido.

Commenti

Prima di Microsoft Windows XP Tablet PC Edition Development Kit 1.7, il Pannello di input tablet PC ha eseguito la spaziatura intelligente. A partire da Tablet PC SDK 1.7, il pannello di input continua a produrre risultati con raccomandazioni preliminari sulla spaziatura. I risultati della spaziatura del Pannello di input del TABLET PC possono tuttavia essere modificati dalle raccomandazioni del riconoscitore (risultati). Il riconoscitore è in grado di eseguire questa operazione usando informazioni contestuali sul testo (in base alla chiamata SetTextContext effettuata dal pannello di input) e alle relative regole del modello linguistico interno.

Il pannello di input è in grado di determinare se il riconoscitore è in grado di eseguire la spaziatura automatica chiamando questa funzione con il flag RECOFLAG_AUTOSPACE impostato. Se il riconoscitore non supporta la spaziatura automatica, viene restituito E_INVALIDARG.

Nota Nella funzione SetFlags è supportata solo la modalità riga. La modalità boxed, la modalità libera e la modalità a riga singola non sono supportate.

 

Requisiti

Requisito	Valore
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

Vedi anche

Funzione SetFactoid

Funzione SetTextContext