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 |
|
| Libreria |
|