IInkRecognizerContext::get_PrefixText-Methode (msinkaut.h)

Artikel
08/25/2023

Ruft die Zeichen ab, die vor der InkStrokes-Auflistung im InkRecognizerContext-Objekt enthalten sind, oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_PrefixText(
  BSTR *Prefix
);

Parameter

Prefix

Rückgabewert

Keine

Bemerkungen

Das Präfix hilft dabei, die Erkennungsergebnisse zu verbessern, indem der Erkennung mehr Kontext zur Handschrift bereitgestellt wird.

Das Festlegen der PrefixText-Eigenschaft ist nur erfolgreich, wenn die Strokes-EigenschaftNULL ist. Sie müssen die PrefixText-Eigenschaft festlegen, bevor Sie eine InkStrokes-Auflistung an die Strokes-Eigenschaft von InkRecognizerContext anfügen, oder Sie müssen die Strokes-Eigenschaft auf NULL und dann die PrefixText-Eigenschaft festlegen.

Hinweis Wenn Sie die letztere Methode verwenden, müssen Sie die InkStrokes-Auflistung möglicherweise erneut an die Strokes-Eigenschaft des InkRecognizerContext-Objekts anfügen.

Wenn Sie die PrefixText-Eigenschaft auf NULL festlegen, wird jeder Präfixtext aus dem Erkennungskontext entfernt.

Der Präfixtext wird ignoriert, es sei denn, Sie haben sowohl die flags IRM_Coerce als auch IRM_WordModeInkRecognitionModes in der RecognitionFlags-Eigenschaft festgelegt.

Die SuffixText-Eigenschaft ruft die Zeichen ab oder legt sie fest, die nach der InkStrokes-Auflistung im InkRecognizerContext-Objekt kommen, und trägt auch zur Verbesserung des Erkennungsergebnisses bei.

Wenn Ihre Anwendung beim Konvertieren von Freihand in Text eine Korrekturschnittstelle bereitstellt, kann die Anwendung es dem Benutzer ermöglichen, Zeichen innerhalb eines Worts auszuwählen und den Stift zum Generieren von Ersatzzeichen zu verwenden. Ihre Anwendung kann die Eigenschaften PrefixText und SuffixText verwenden, um die Erkennung der neuen Freihandeingabe zu verbessern.

Anforderungen


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