iInkDisp：：ClipboardCopy 方法 (msinkaut.h)

项目
08/24/2023

将 InkStrokes 集合复制到剪贴板。

语法

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

参数

[in, optional] strokes

可选。指定要复制的笔划。如果 strokes 参数为 NULL，则 ClipboardCopy 方法将复制整个 InkDisp 对象。默认值为 NULL。

[in, optional] ClipboardFormats

可选。指定 InkDisp 对象的 InkClipboardFormats 枚举值。默认值为 ICF_Default。

[in, optional] ClipboardModes

可选。指定 InkDisp 对象的 InkClipboardModes 枚举值。默认值为 ICB_Default。

[out, retval] DataObject

此方法返回时，包含指向新创建的数据对象的指针。

返回值

此方法可以返回其中一个值。

返回代码	说明
S_OK	成功。
E_POINTER	参数包含无效指针。
E_INK_EXCEPTION	方法内发生异常。
E_INK_MISMATCHED_INK_OBJECT	笔划参数与不同的 Ink 对象相关联。

注解

此方法复制笔划的所有属性，包括识别结果。将笔划参数设置为 NULL 会将 InkDisp 对象复制到剪贴板，包括 CustomStrokes 属性，并维护 InkDisp 对象的 IInkCustomStrokes 集合中笔划的识别结果。

如果传递了空的 InkStrokes 集合，该方法将返回 NULL ，并且不会修改剪贴板的内容。

注意在剪贴板 API 正常工作之前，必须调用 OleInitialize (NULL) 。

谨慎若要避免因使用 ICB_DelayedCopy 标志而导致的潜在内存泄漏，必须调用 OleFlushClipboard 或 OleSetClipboard 方法。如果对 ClipboardCopy 方法的最后一次调用使用了 ICB_DelayedCopy 标志，则必须在应用程序退出之前完成 此操作 。

要求


最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	msinkaut.h
Library	InkObj.dll