Condividi tramite


Classe InkRecognizerContext

Consente di eseguire il riconoscimento penna, recuperare il risultato del riconoscimento e recuperare alternative. InkRecognizerContext consente ai vari riconoscimento installati in un sistema di usare il riconoscimento penna per elaborare l'input in modo appropriato.

InkRecognizerContext include questi tipi di membri:

Eventi

La classe InkRecognizerContext include questi eventi.

Event Descrizione
Riconoscimento Si verifica quando il metodo InkRecognizerContext ha generato risultati dal metodo BackgroundRecognize.
RiconoscimentoWithAlternates Si verifica quando il metodo InkRecognizerContext ha generato risultati dopo aver chiamato il metodo BackgroundRecognizeWithAlternates

Interfacce

La classe InkRecognizerContext definisce queste interfacce.

Interfaccia Descrizione
IInkRecognizerContext Questo oggetto implementa l'interfaccia COM IInkRecognizerContext .

Metodi

La classe InkRecognizerContext include questi metodi.

Metodo Descrizione
BackgroundRecognize Specifica che il riconoscimento deve riconoscere i tratti associati e generare un evento di riconoscimento al termine del riconoscimento.
BackgroundRecognizeWithAlternates Specifica che il riconoscimento deve riconoscere i tratti associati e generare un evento RecognitionWithAlternates al termine del riconoscimento.
Clone Crea un duplicato InkRecognizerContext.
EndInkInput Termina l'input penna all'input penna InkRecognizerContext.
IsStringSupported Indica se il dizionario di sistema, il dizionario utente o l'elenco di parole contengono una stringa specificata.
Recognize Esegue il riconoscimento in un insieme InkStrokes e restituisce i risultati del riconoscimento.
StopBackgroundRecognition Termina il riconoscimento in background avviato con una chiamata a BackgroundRecognize o BackgroundRecognizeWithAlternates.

Proprietà

La classe InkRecognizerContext ha queste proprietà.

Proprietà Tipo di accesso Descrizione
CharacterAutoCompletion
Lettura/Scrittura
Ottiene o imposta la modalità completamento automatico del carattere, che determina quando vengono riconosciuti caratteri o parole.
Factoid
Lettura/Scrittura
Ottiene o imposta il nome stringa del factoid utilizzato dall'oggetto InkRecognizerContext .
Guida
Lettura/Scrittura
Ottiene o imposta InkRecognizerGuide da usare per l'input penna.
PrefissoText
Lettura/Scrittura
Ottiene o imposta i caratteri che vengono prima dell'insieme InkStrokes nell'oggetto InkRecognizerContext .
RiconoscimentoFlags
Lettura/Scrittura
Ottiene o imposta i flag che specificano come il riconoscimento interpreta l'input penna e determina la stringa di risultato.
Sistema di riconoscimento
Lettura/Scrittura
Ottiene o imposta l'oggetto IInkRecognizer utilizzato dall'oggetto InkRecognizerContext .
Tratti
Lettura/Scrittura
Ottiene o imposta l'insieme InkStrokes associato all'oggetto InkRecognizerContext .
Suffixtext
Lettura/Scrittura
Ottiene o imposta i caratteri che provengono dopo l'insieme InkStrokes nell'oggetto InkRecognizerContext .
Wordlist
Lettura/Scrittura
Ottiene o imposta l'oggetto InkWordList usato per migliorare i risultati del riconoscimento.

Commenti

Questo oggetto può essere creato un'istanza chiamando il metodo CoCreateInstance in C++.

Esistono due tipi di riconoscimento: sfondo (asincrono) o primo piano (sincrono). Il riconoscimento in background viene avviato da una chiamata ai metodi BackgroundRecognize o BackgroundRecognizeWithAlternates, si verifica in un thread in background e segnala i risultati all'applicazione tramite un meccanismo di evento. Il riconoscimento in primo piano non restituisce fino a quando non viene completato tutto il riconoscimento, rendendo quindi i risultati del riconoscimento disponibili per il thread chiamante senza ascoltare l'evento di riconoscimento.

L'input penna viene elaborato continuamente in background. Se un oggetto IInkStrokeDisp viene aggiunto all'insieme InkStrokes a cui fa riferimento InkRecognizerContext, viene riconosciuto immediatamente l'IInkStrokeDisp. Per altri dettagli, vedere le osservazioni nell'argomento del metodo EndInkInput .

Tutto il riconoscimento si verifica tramite un contesto di riconoscimento. Il contesto definisce le impostazioni per una singola sessione di riconoscimento. Riceve l'input penna che deve essere riconosciuto e definisce i vincoli sull'input penna e sull'output del riconoscimento. I vincoli che possono essere impostati nel contesto includono la lingua, il dizionario e la grammatica usata.

Nota

L'impostazione di proprietà diverse dalle proprietà Strokes o CharacterAutoCompletion ha esito positivo solo se l'insieme InkStrokes è NULL. È necessario impostare le altre proprietà prima di collegare l'insieme InkStrokes all'oggetto InkRecognizerContext oppure è necessario impostare l'insieme InkStrokes su NULL e quindi impostare le altre proprietà. Se si imposta l'insieme InkStrokes su NULL e quindi si impostano le altre proprietà, potrebbe essere necessario riassegnare l'insieme InkStrokes. Questo perché il riconoscimento inizia subito dopo l'assegnazione di InkStrokes a InkRecognizerContext. Quando viene effettuata una chiamata al metodo Recognize [Classe InkRecognizeContext] o BackgroundRecognize, i risultati delle chiamate potrebbero essere già disponibili.

Per migliorare le prestazioni dell'applicazione, eliminare l'oggetto InkRecognizerContext quando non è più necessario.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato
Nessuno supportato
Intestazione
Msinkaut.h (richiede anche Msinkaut_i.c)
Libreria
InkObj.dll

Vedi anche

Interfaccia IInkRecognizer

Raccolta InkStrokes