Fungsi SetClipboardViewer (winuser.h)

Artikel
08/28/2023

Menambahkan jendela yang ditentukan ke rantai penampil clipboard. Jendela penampil papan klip menerima pesan WM_DRAWCLIPBOARD setiap kali konten clipboard berubah. Fungsi ini digunakan untuk kompatibilitas mundur dengan versi Windows yang lebih lama.

Sintaks

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

Parameter

[in] hWndNewViewer

Jenis: HWND

Handel ke jendela yang akan ditambahkan ke rantai clipboard.

Nilai kembali

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan mengidentifikasi jendela berikutnya dalam rantai penampil clipboard. Jika terjadi kesalahan atau tidak ada jendela lain dalam rantai penampil clipboard, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jendela yang merupakan bagian dari rantai penampil clipboard, yang disebut jendela penampil clipboard, harus memproses pesan clipboard WM_CHANGECBCHAIN dan WM_DRAWCLIPBOARD. Setiap jendela penampil clipboard memanggil fungsi SendMessage untuk meneruskan pesan ini ke jendela berikutnya dalam rantai penampil clipboard.

Jendela penampil clipboard akhirnya harus menghapus dirinya dari rantai penampil clipboard dengan memanggil fungsi ChangeClipboardChain — misalnya, sebagai respons terhadap pesan WM_DESTROY .

Fungsi SetClipboardViewer ada untuk memberikan kompatibilitas mundur dengan versi Windows yang lebih lama. Rantai penampil clipboard dapat dipecah oleh aplikasi yang gagal menangani pesan rantai clipboard dengan benar. Aplikasi baru harus menggunakan teknik yang lebih kuat seperti nomor urutan clipboard atau pendaftaran pendengar format clipboard. Untuk detail lebih lanjut tentang teknik alternatif ini, lihat Memantau Konten Clipboard.

Contoh

Misalnya, lihat Menambahkan Jendela ke Rantai Penampil Clipboard.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-5-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)