Freigeben über


IInkRecognizerContext::p ut_PrefixText-Methode (msinkaut.h)

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 put_PrefixText(
  BSTR Prefix
);

Parameter

Prefix

Rückgabewert

Keine

Bemerkungen

Das Präfix trägt zur Verbesserung der Erkennungsergebnisse bei, 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 des InkRecognizerContext anfügen, oder Sie müssen die Strokes-Eigenschaft auf NULL festlegen 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.
 
Durch Festlegen der PrefixText-Eigenschaft auf NULL wird jeder Präfixtext aus dem Erkennungskontext entfernt.

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

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

Wenn Ihre Anwendung beim Konvertieren von Freihand in Text eine Korrekturschnittstelle bereitstellt, ermöglicht die Anwendung dem Benutzer möglicherweise, Zeichen in einem Wort auszuwählen und den Eingabestift 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

Weitere Informationen

IInkRecognizerContext

InkRecognizerContext-Klasse

RecognitionFlags-Eigenschaft

Strokes-Eigenschaft

SuffixText-Eigenschaft