Metode IInkDisp::ClipboardCopy (msinkaut.h)

Artikel
08/24/2023

Menyalin koleksi InkStrokes ke Clipboard.

Sintaks

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

Parameter

[in, optional] strokes

Pilihan. Menentukan goresan yang akan disalin. Jika parameter stroke adalah NULL, metode ClipboardCopy menyalin seluruh objek InkDisp . Nilai defaultnya adalah NULL.

[in, optional] ClipboardFormats

Opsional. Menentukan nilai enumerasi InkClipboardFormats dari objek InkDisp . Nilai defaultnya adalah ICF_Default.

[in, optional] ClipboardModes

Pilihan. Menentukan nilai enumerasi InkClipboardModes dari objek InkDisp . Nilai defaultnya adalah ICB_Default.

[out, retval] DataObject

Ketika metode ini kembali, berisi penunjuk ke objek data yang baru dibuat.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_INK_MISMATCHED_INK_OBJECT	Parameter stroke dikaitkan dengan objek Tinta yang berbeda.

Keterangan

Metode ini menyalin semua sifat stroke, termasuk hasil pengenalan. Mengatur parameter stroke ke NULL menyalin objek InkDisp ke Clipboard, termasuk properti CustomStrokes, dan hasil pengenalan untuk goresan dalam koleksi IInkCustomStrokes objek InkDisp dipertahankan.

Jika koleksi InkStrokes kosong diteruskan, metode mengembalikan NULL dan konten Clipboard tidak dimodifikasi.

CatatanOleInitialize(NULL) harus dipanggil sebelum API clipboard dapat berfungsi.

Hati Untuk menghindari potensi kebocoran memori sebagai akibat dari penggunaan bendera ICB_DelayedCopy , Anda harus memanggil metode OleFlushClipboard atau OleSetClipboard . Ini harus dilakukan sebelum aplikasi keluar jika panggilan terakhir ke metode ClipboardCopy menggunakan bendera ICB_DelayedCopy .

Persyaratan


Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll