共用方式為


IInkDisp::ClipboardCopy 方法 (msinkaut.h)

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 物件相關聯。

備註

這個方法會複製筆劃的所有屬性,包括辨識結果。 將 strokes 參數設定為 Null 會將 InkDisp 物件複製到剪貼簿,包括 CustomStrokes 屬性,以及 InkDisp 物件的 IInkCustomStrokes 集合中的筆劃辨識結果。

如果傳遞空的 InkStrokes 集合,此方法會傳回 Null ,而且不會修改剪貼簿的內容。

注意OleInitialize (Null) 必須先呼叫,剪貼簿 API 才能運作。
 
謹慎 若要避免使用 ICB_DelayedCopy 旗標所造成的潛在記憶體流失,您必須呼叫 OleFlushClipboardOleSetClipboard 方法。 如果剪貼 簿Copy 方法的最後一次呼叫使用 ICB_DelayedCopy 旗標,則必須在應用程式結束之前完成此動作。
 

需求

   
最低支援的用戶端 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 msinkaut.h
程式庫 InkObj.dll

另請參閱

ClipboardCopyWithRectangle 方法

IInkDisp

InkClipboardFormats 列舉

InkClipboardModes 列舉

InkDisp 類別

InkStrokes 集合