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
當這個方法傳回時,會包含新建立資料物件的指標。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含不正確指標。 |
|
方法內發生例外狀況。 |
|
筆劃參數與不同的 Ink 物件相關聯。 |
備註
這個方法會複製筆劃的所有屬性,包括辨識結果。 將 strokes 參數設定為 Null 會將 InkDisp 物件複製到剪貼簿,包括 CustomStrokes 屬性,以及 InkDisp 物件的 IInkCustomStrokes 集合中的筆劃辨識結果。
如果傳遞空的 InkStrokes 集合,此方法會傳回 Null ,而且不會修改剪貼簿的內容。
注意OleInitialize (Null) 必須先呼叫,剪貼簿 API 才能運作。
謹慎 若要避免使用 ICB_DelayedCopy 旗標所造成的潛在記憶體流失,您必須呼叫 OleFlushClipboard 或 OleSetClipboard 方法。 如果剪貼 簿Copy 方法的最後一次呼叫使用 ICB_DelayedCopy 旗標,則必須在應用程式結束之前完成此動作。
需求
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |