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 .
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]