IInkDrawingAttributes::Clone method (msinkaut.h)

Article
10/13/2021

Creates a duplicate InkDrawingAttributes object.

Syntax

HRESULT Clone(
  [out, retval] IInkDrawingAttributes **DrawingAttributes
);

Parameters

[out, retval] DrawingAttributes

When this method returns, contains a pointer to the newly created InkDrawingAttributes object.

Return value

This method can return one of these values.

Return code	Description
S_OK	Success.
E_OUTOFMEMORY	Cannot allocate memory to complete the operation.
E_FAIL	An unspecified error occurred.
E_POINTER	A parameter contained an invalid pointer.
E_INK_EXCEPTION	An exception occurred inside the method.
REGDB_CLASSNOTREG	The InkDisp object was not registered.
E_UNEXPECTED	Unexpected parameter or property type.

Remarks

The Clone method is defined for the InkDisp, InkDrawingAttributes, and InkRecognizerContext objects. The Clone method returns an exact copy of the original object.

In most scenarios, the duplicate object is an exact copy of the original object, but no relation between the two objects exists. See the remarks section of this topic for details on exceptions to this.

InkDrawingAttributes object: Typically, you clone a master copy of the drawing attributes, modify one or more of the attributes, and call the ModifyDrawingAttributes method to use the modified drawing attributes.

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