IInkCustomStrokes interface (msinkaut.h)

Contains a collection of user-defined InkStrokes collections.

Inheritance

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

Methods

The IInkCustomStrokes interface has these methods.

IInkCustomStrokes::Add Adds an InkStrokes collection to an IInkCustomStrokes collection.
IInkCustomStrokes::Clear Clears all InkStrokes collections from the IInkCustomStrokes collection.
IInkCustomStrokes::get_Count Gets the number of objects or collections contained in a collection. (IInkCustomStrokes.get_Count)
IInkCustomStrokes::Item Retrieves the InkStrokes Collection at the location specified within the IInkCustomStrokes Interface.
IInkCustomStrokes::Remove Removes the InkStrokes collection from the IInkCustomStrokes collection.

Remarks

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).

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

See also

InkDisp Class

InkStrokes Collection