IInkDrawingAttributes::Clone-Methode (msinkaut.h)

Erstellt ein doppeltes InkDrawingAttributes -Objekt.

Syntax

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

Parameter

[out, retval] DrawingAttributes

Wenn diese Methode zurückgegeben wird, enthält sie einen Zeiger auf das neu erstellte InkDrawingAttributes -Objekt.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_OUTOFMEMORY
Speicher kann nicht zugewiesen werden, um den Vorgang abzuschließen.
E_FAIL
Ein nicht angegebener Fehler ist aufgetreten.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION
In der Methode ist eine Ausnahme aufgetreten.
REGDB_CLASSNOTREG
Das InkDisp-Objekt wurde nicht registriert.
E_UNEXPECTED
Unerwarteter Parameter oder Eigenschaftentyp.

Bemerkungen

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

In den meisten Szenarien ist das duplizierte Objekt eine genaue Kopie des ursprünglichen Objekts, aber keine Beziehung zwischen den beiden Objekten vorhanden. Ausführliche Informationen zu Ausnahmen hierzu finden Sie im Abschnitt "Hinweise" dieses Themas.

InkDrawingAttributes-Objekt : Normalerweise klonen Sie eine Masterkopie der Zeichnungsattribute, ändern einen oder mehrere Attribute, und rufen Sie die ModifyDrawingAttributes-Methode auf, um die geänderten Zeichnungsattribute zu verwenden.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

Dirty-Eigenschaft

IInkDrawingAttributes

InkDrawingAttribute-Klasse

ModifyDrawingAttributes-Methode