IInkRecognizerContext::Clone method (msinkaut.h)

Creates a duplicate InkRecognizerContext object.

Syntax

HRESULT Clone(
  [out, retval] IInkRecognizerContext **RecoContext
);

Parameters

[out, retval] RecoContext

When this method returns, contains the newly created InkRecognizerContext 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.

InkRecognizerContext object: This method returns a copy of the original InkRecognizerContext that contains the same settings as the original, but does not include the recognition results, if any. The settings that are copied include the recognition guide, character Autocomplete mode, a reference to the original InkDisp, and all properties that improve the recognition results, such as the Factoid property and RecognitionFlags property.

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

See also

Dirty Property

IInkRecognizerContext

InkRecognizerContext Class

ModifyDrawingAttributes Method