IInkExtendedProperties
4/8/2010
Represents a collection of IInkExtendedProperty objects that contain application–defined data.
The extended properties collection stores a vector of references to ExtendedProperty objects. It makes sure that there is only one ExtendedProperty object corresponding to each GUID value. When the IInkExtendedProperties::Add method is called more than once to set the data for a given GUID value, the data of that particular ExtendedProperty object will be replaced by the latest call. This method will not allow adding extended property with GUID value that correspond to drawing attributes and packet properties. A static list of GUIDs is stored to check for this case.
The extended property data is indexed by an application–specific globally unique identifier (GUID).
Note
You cannot store an empty IInkExtendedProperties. The object must contain data before it can be stored. For example, if you try to add extended properties to a stroke for later use, an exception is thrown if the extended property contains no data.
IInkExtendedProperties collections may be added to the IInkStrokeDisp object, the IInkDrawingAttributes object, and the IInkDisp object.
For more information about using collections for Automation, see Using the Automation Library with Windows Mobile Ink.
If you define a class that implements this interface, the new class will not interact correctly with the Tablet PC application programming interfaces (APIs).
In This Section
- IInkExtendedProperties Properties
Provides information about the Count and _NewEnum properties.
- IInkExtendedProperties Methods
Describes the methods available for the IInkExtendedProperties collection.