Fungsi OpenClipboard (winuser.h)

Artikel
03/04/2024

Membuka clipboard untuk diperiksa dan mencegah aplikasi lain memodifikasi konten clipboard.

Sintaks

BOOL OpenClipboard(
  [in, optional] HWND hWndNewOwner
);

Parameter

[in, optional] hWndNewOwner

Jenis: HWND

Handel ke jendela yang akan dikaitkan dengan clipboard yang terbuka. Jika parameter ini NULL, clipboard terbuka dikaitkan dengan tugas saat ini.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

OpenClipboard gagal jika jendela lain membuka clipboard.

Aplikasi harus memanggil fungsi CloseClipboard setelah setiap panggilan berhasil ke OpenClipboard.

Jendela yang diidentifikasi oleh parameter hWndNewOwner tidak menjadi pemilik clipboard kecuali fungsi EmptyClipboard dipanggil.

Jika aplikasi memanggil OpenClipboard dengan hwnd diatur ke NULL, EmptyClipboard mengatur pemilik clipboard ke NULL; ini menyebabkan SetClipboardData gagal.

Contoh

Misalnya, lihat Menyalin Informasi ke 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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-2-0 (diperkenalkan dalam Windows 8.1)