IInkDisp::Clone-Methode (msinkaut.h)

Erstellt ein doppeltes InkDisp-Objekt .

Syntax

HRESULT Clone(
  [out, retval] IInkDisp **NewInk
);

Parameter

[out, retval] NewInk

Wenn diese Methode zurückgibt, enthält einen Zeiger auf das neu erstellte InkDisp-Objekt .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_OUTOFMEMORY	Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
REGDB_CLASSNOTREG	Das InkDisp-Objekt wurde nicht registriert.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.

Hinweise

Die Clone-Methode ist für die Objekte InkDisp, InkDrawingAttributes und InkRecognizerContext definiert. Die Clone-Methode gibt eine exakte Kopie des ursprünglichen Objekts zurück.

In den meisten Szenarien ist das duplizierte Objekt eine exakte Kopie des ursprünglichen Objekts, aber es besteht keine Beziehung zwischen den beiden Objekten. Ausführliche Informationen zu Ausnahmen finden Sie im Abschnitt mit den Hinweisen dieses Themas.

InkDisp-Objekt: Das einzige Szenario, in dem das doppelte InkDisp-Objekt keine exakte Kopie des ursprünglichen Objekts ist, ist, wenn ein modifiziert InkDisp-Objekt geklont wird. In diesem Fall ist die Dirty-Eigenschaft des doppelten InkDisp-ObjektsFALSE. Alle anderen Eigenschaften des geklonten InkDisp-Objekts sind exakte Kopien.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

Dirty-Eigenschaft

IInkDisp

InkDisp-Klasse

ModifyDrawingAttributes-Methode