IInkCustomStrokes::Remove method (msinkaut.h)
Removes the InkStrokes collection from the IInkCustomStrokes collection.
Syntax
HRESULT Remove(
[in] VARIANT Identifier
);
Parameters
[in] Identifier
The name or index of the collection of strokes to remove from the collection of custom strokes.
For more information about the VARIANT structure, see Using the COM Library.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
Success. |
|
A parameter contained an invalid pointer. |
|
Cannot allocate memory to complete the operation. |
|
An exception occurred inside the method. |
|
Invalid input parameter. |
|
The InkDisp object of the InkStrokes collection and the IInkStrokeDisp object don't match. |
|
An unspecified error occurred. |
|
An invalid variant was passed in. |
Remarks
IInkCustomStrokes collections are sets of references to ink data and are not the actual data itself. This method removes only the collection of strokes from a snapshot of, or reference to, the data and does not remove the actual ink data. To delete the collection from the actual ink data, call the DeleteStrokes method of the InkDisp object.
The Identifier parameter can be either a BSTR or a LONG. Use a BSTR for the name originally given to the custom stroke when it was added to the collection, and use a long for the index of the custom stroke in the collection. To specify the name of the custom stroke when you are using late binding, such as when you use a scripting language, you must pass in the argument as a string literal and not use a variable.
For more information about the BSTR data type, see Using the COM Library.
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 |
| Library | InkObj.dll |