IInkRecognizerContext::get_WordList-Methode (msinkaut.h)

Ruft die Wortliste ab, die im Erkennungsprozess verwendet wird, um die Erkennungsergebnisse zu verbessern, oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_WordList(
  IInkWordList **WordList
);

Parameter

WordList

Rückgabewert

Keine

Bemerkungen

Das Festlegen dieser Eigenschaft ist nur erfolgreich, wenn die Strokes-EigenschaftNULL ist. Sie müssen die WordList-Eigenschaft festlegen, bevor Sie eine InkStrokes-Auflistung an die Strokes-Eigenschaft des InkRecognizerContext anfügen, oder Sie müssen die Strokes-Eigenschaft auf NULL festlegen und dann die WordList-Eigenschaft festlegen (und möglicherweise die InkStrokes-Auflistung erneut anfügen).

Um die aktuelle Wortliste zu entfernen und das Benutzerwörterbuch zu verwenden, legen Sie diese Eigenschaft auf NULL fest. Jede nachfolgende Änderung des InkWordList-Objekts ändert das Erkennungsergebnis nicht. Wenn Sie die Wortliste ändern möchten, legen Sie zuerst diese Eigenschaft auf NULL fest, ändern Sie die InkWordList, und fügen Sie sie dann erneut an den InkRecognizerContext an, indem Sie sie der WordList-Eigenschaft zuweisen.

Verwenden Sie die Factoid-Eigenschaft , um die Suche auf die Wortliste zu beschränken, die dem Kontext zugeordnet ist. Möglicherweise müssen Sie auch die RecognitionFlags-Eigenschaft festlegen, um die Ergebnisse zu verbessern.

Wordlist kann nicht festgelegt werden, nachdem ein Factoid festgelegt wurde. Dadurch wird verhindert, dass ein Factoid auf eine möglicherweise nicht vorhandene Wortliste verweist. Der Versuch, dies zu tun, führt zu einem E_FAIL HRESULT-Wert.

Wenn einer Wortliste eine Zeichenfolge hinzugefügt wird, werden ihre Großbuchstaben ebenfalls implizit hinzugefügt. Für instance fügt das Hinzufügen von "hello" implizit "Hello" und "HELLO" hinzu.

Die Verwendung von Wörtern, die länger als 256 Zeichen sind, führt zu einer E_POINTER Ausnahme beim Zuweisen der WordList-Eigenschaft zu InkRecognizerContext.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

IInkRecognizerContext

InkRecognizerContext-Klasse

InkWordList-Klasse