IInkDisp::ClipboardCopy-Methode (msinkaut.h)

Artikel
08/24/2023

Kopiert die InkStrokes-Auflistung in die Zwischenablage.

Syntax

HRESULT ClipboardCopy(
  [in, optional] IInkStrokes         *strokes,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

Parameter

[in, optional] strokes

Optional. Gibt die zu kopierenden Striche an. Wenn der Strichparameter NULL ist, kopiert die ClipboardCopy-Methode das gesamte InkDisp-Objekt . Der Standardwert ist NULL.

[in, optional] ClipboardFormats

Optional. Gibt den InkClipboardFormats-Enumerationswert des InkDisp-Objekts an. Der Standardwert ist ICF_Default.

[in, optional] ClipboardModes

Optional. Gibt den InkClipboardModes-Enumerationswert des InkDisp-Objekts an. Der Standardwert ist ICB_Default.

[out, retval] DataObject

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

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INK_MISMATCHED_INK_OBJECT	Der Strichparameter ist einem anderen Ink-Objekt zugeordnet.

Hinweise

Diese Methode kopiert alle Eigenschaften des Strichs, einschließlich der Erkennungsergebnisse. Durch Festlegen des Strichparameters auf NULL wird das InkDisp-Objekt in die Clipboard kopiert, einschließlich der CustomStrokes-Eigenschaft, und die Erkennungsergebnisse für Striche in der IInkCustomStrokes-Auflistung des InkDisp-Objekts werden beibehalten.

Wenn eine leere InkStrokes-Auflistung übergeben wird, gibt die Methode NULL zurück, und der Inhalt der Zwischenablage wird nicht geändert.

HinweisOleInitialize(NULL) muss aufgerufen werden, bevor die Zwischenablage-APIs funktionieren können.

Vorsicht Um potenzielle Speicherverluste durch die Verwendung des ICB_DelayedCopy-Flags zu vermeiden, müssen Sie die OleFlushClipboard- oder OleSetClipboard-Methode aufrufen. Dies muss vor dem Beenden der Anwendung erfolgen, wenn beim letzten Aufruf der ClipboardCopy-Methode das Flag ICB_DelayedCopy verwendet wurde.

Anforderungen


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