Metode IInkDisp::ClipboardCopyWithRectangle (msinkaut.h)

Artikel
08/24/2023

Menyalin objek IInkStrokeDisp yang terkandung dalam persegi panjang yang diketahui ke Clipboard.

Sintaks

HRESULT ClipboardCopyWithRectangle(
  [in]           IInkRectangle       *Rectangle,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

Parameter

[in] Rectangle

Menentukan persegi panjang yang berisi goresan untuk disalin ke Clipboard.

[in, optional] ClipboardFormats

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

[in, optional] ClipboardModes

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

[out, retval] DataObject

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

Nilai kembali

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 .

Keterangan

Jika klip persegi panjang mengeklik goresan, goresan tersebut dipotong dalam data yang disalin.

Mungkin berguna untuk menyalin objek InkDisp ke Clipboard ketika Anda hanya ingin menyalin properti objek InkDisp . Untuk menyalin objek InkDisp ke Clipboard, panggil metode ClipboardCopy dengan parameter goresan yang diatur ke NULL.

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 ClipboardCopyWithRectangle menggunakan bendera ICB_DelayedCopy .

Ketika ClipboardCopyWithRectangle digunakan dalam mode ICB_Cut , goresan yang dibagi menjadi dua goresan atau lebih dihapus dan stroke baru ditambahkan di tempatnya.

Selain itu, peristiwa InkAdded dan InkDeleted dihasilkan berdasarkan indeks goresan. Misalnya, jika stroke pada indeks 0,1,3,5, dan 6 akan dihapus, dua peristiwa akan dihasilkan; satu untuk stroke dengan indeks 0123 dan satu untuk stroke dengan indeks 5 dan 6. Artinya, satu peristiwa untuk setiap set yang berdamai.

Ini juga berlaku untuk peristiwa InkAdded . Algoritma internal menentukan indeks stroke yang baru ditambahkan dalam koleksi stroke dan ini berdampak pada bagaimana peristiwa InkAdded diaktifkan seperti yang dijelaskan di atas.

Jika jumlah goresan dikueri dalam penanganan aktivitas, hasilnya adalah jumlah total goresan yang ditambahkan oleh seluruh operasi termasuk goresan yang belum menghasilkan peristiwa.

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