IInkCustomStrokes interface (msinkaut.h)

Contains a collection of user-defined InkStrokes collections.


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


The IInkCustomStrokes interface has these methods.


Adds an InkStrokes collection to an IInkCustomStrokes collection.

Clears all InkStrokes collections from the IInkCustomStrokes collection.

Gets the number of objects or collections contained in a collection. (IInkCustomStrokes.get_Count)

Retrieves the InkStrokes Collection at the location specified within the IInkCustomStrokes Interface.

Removes the InkStrokes collection from the IInkCustomStrokes collection.


The custom strokes are essentially named InkStrokes collections that are persisted and recalled for later use.

You use a collection of custom strokes to store strokes that have the same meaning or that are related in some way. Examples of strokes that you may want to persist include:

  • All the strokes drawn by the same cursor (pen)
  • The strokes in an InkDisp object that correspond to a word or paragraph
  • All the strokes that intersect a known region
For example, suppose you want to draw with two different cursors and keep separate the set of strokes that you draw with each cursor. You could recognize the strokes drawn with the first cursor and attach an IInkRecognitionResult object to that collection of strokes. To persist the recognition result, add the strokes to the CustomStrokes collection of the InkDisp object. You can later access the first collection of strokes by getting the persisted CustomStrokes collection from the InkDisp object.

Each IInkCustomStrokes collection is referenced by name.

IInkCustomStrokes collections are references to ink data, not the actual data itself.

For more information about collections in COM, see Using the COM Library.

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


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

See also

InkDisp Class

InkStrokes Collection