IInkRecognizerContext::put_PrefixText method (msinkaut.h)

Gets or sets the characters that come before the InkStrokes collection in the InkRecognizerContext object.

This property is read/write.

Syntax

HRESULT put_PrefixText(
  BSTR Prefix
);

Parameters

Prefix

Return value

None

Remarks

The prefix helps improve recognition results by supplying the recognizer with more context about the handwriting.

Setting the PrefixText property succeeds only if the Strokes property is NULL. You must set the PrefixText property before you attach a InkStrokes collection to the Strokes property of the InkRecognizerContext, or you must set the Strokes property to NULL and then set the PrefixText property.

Note  If you use the latter method, you may need to reattach the InkStrokes collection to the Strokes property of the InkRecognizerContext object.
 
Setting the PrefixText property to NULL removes any prefix text from the recognizer context.

The prefix text is ignored unless you have set both the IRM_Coerce and IRM_WordModeInkRecognitionModes flags in the RecognitionFlags property.

The SuffixText property gets or sets the characters that come after the InkStrokes collection in the InkRecognizerContext object and also helps improve the recognition result.

If your application provides a correction interface when converting ink to text, the application may allow the user to select characters within a word and use the stylus to generate replacement characters. Your application can use the PrefixText and SuffixText properties to improve recognition of the new ink.

Requirements

Requirement Value
Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msinkaut.h
Library InkObj.dll

See also

IInkRecognizerContext

InkRecognizerContext Class

RecognitionFlags Property

Strokes Property

SuffixText Property