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