IInkDisp::Load method (msinkaut.h)
Populates a new InkDisp object with known binary data.
HRESULT Load( [in] VARIANT Data );
The stream that contains the ink data.
For more information about the VARIANT structure, see Using the COM Library.
This method can return one of these values.
||VARIANT was not of correct type (byte array).|
||Cannot allocate memory for Stream.|
||Unexpected parameter or property type.|
||An exception occurred inside the method.|
You can load ink only into a new, empty InkDisp object - one that hasn't collected any strokes or doesn't have any attached properties. If you try to load ink into an InkDisp object that has collected strokes or attached properties, even if the strokes or properties have been deleted from the InkDisp object, an exception is thrown. This occurs because of how stroke IDs are assigned. A stroke is assigned a unique ID, and this ID is not reused, even if the stroke has been deleted from an Ink object. This means that, if an InkDisp object contained a stroke with an ID of 1 and you deleted the stroke and loaded another InkDisp object into this InkDisp object, stroke IDs would start at 2. This would be confusing and therefore is not allowed.
|Minimum supported client||Windows XP Tablet PC Edition [desktop apps only]|
|Minimum supported server||None supported|