Bagikan melalui


Fungsi SetClipboardViewer (winuser.h)

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)

Lihat juga

ChangeClipboardChain

Clipboard

Konseptual

GetClipboardViewer

Referensi

SendMessage