Fungsi GetClipboardData (winuser.h)

Artikel
08/27/2023

Mengambil data dari clipboard dalam format tertentu. Papan klip harus telah dibuka sebelumnya.

Sintaks

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Parameter

[in] uFormat

Jenis: UINT

Format clipboard. Untuk deskripsi format clipboard standar, lihat Format Clipboard Standar.

Nilai kembali

Jenis: HANDEL

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek clipboard dalam format yang ditentukan.

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

Keterangan

Hati Data clipboard tidak tepercaya. Uraikan data dengan hati-hati sebelum menggunakannya di aplikasi Anda.

Aplikasi dapat menghitung format yang tersedia terlebih dahulu dengan menggunakan fungsi EnumClipboardFormats .

Clipboard mengontrol handel yang dikembalikan fungsi GetClipboardData , bukan aplikasi. Aplikasi harus segera menyalin data. Aplikasi tidak boleh membebaskan handel atau membiarkannya terkunci. Aplikasi tidak boleh menggunakan handel setelah fungsi EmptyClipboard atau CloseClipboard dipanggil, atau setelah fungsi SetClipboardData dipanggil dengan format clipboard yang sama.

Sistem melakukan konversi format data implisit antara format clipboard tertentu saat aplikasi memanggil fungsi GetClipboardData . Misalnya, jika format CF_OEMTEXT ada di clipboard, jendela dapat mengambil data dalam format CF_TEXT . Format pada clipboard dikonversi ke format yang diminta sesuai permintaan. Untuk informasi selengkapnya, lihat Format Clipboard yang Disintesis.

Contoh

Misalnya, lihat Menyalin Informasi ke Clipboard.

Persyaratan


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 di Windows 8.1)