IInkRecognizer interface (msinkaut.h)

Represents the ability to process ink, or handwriting, and translate the stroke into text or gesture. The recognizer creates an InkRecognizerContext object, which is used to perform the actual handwriting recognition.


The IInkRecognizer interface inherits from the IUnknown interface. IInkRecognizer also has these types of members:


The IInkRecognizer interface has these methods.


Creates a new InkRecognizerContext object.

Gets the capabilities of the IInkRecognizer object.

Gets an array of language identifiers for the languages that the IInkRecognizer object supports.

Gets the name of the object. (IInkRecognizer.get_Name)

Gets an array of globally unique identifiers (GUIDs) that represents the preferred packet properties for the recognizer.

Gets an array of globally unique identifiers (GUIDs) that describe the properties that the IInkRecognizer object supports.

Gets the vendor name of the IInkRecognizer object.


A recognizer has specific attributes and properties that allow it to perform recognition. The properties of a recognizer must be determined before recognition can occur. The types of properties that a recognizer supports determine the types of recognition it can perform. For instance, if a recognizer doesn't support cursive handwriting, it returns inaccurate results when a user writes in cursive.

A recognizer also has built-in functionality that automatically manages many aspects of handwriting. For instance, it determines the metrics for the lines on which strokes are drawn. You can return the line number of a stroke, but you never need to specify how those line metrics are determined because of the built-in functionality of the recognizer.

For more information about recognition, see About Handwriting Recognition.

If you define a class that implements this interface, the new class will not interact correctly with the Tablet PC application programming interfaces (APIs).


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

See also

InkRecognizerContext Class

InkRecognizers Collection