Fungsi GetWindowDC (winuser.h)

Artikel
03/04/2024

Fungsi GetWindowDC mengambil konteks perangkat (DC) untuk seluruh jendela, termasuk bilah judul, menu, dan bilah gulir. Konteks perangkat jendela memungkinkan pengecatan di mana saja di jendela, karena asal konteks perangkat adalah sudut kiri atas jendela alih-alih area klien.

GetWindowDC menetapkan atribut default ke konteks perangkat jendela setiap kali mengambil konteks perangkat. Atribut sebelumnya hilang.

Sintaks

HDC GetWindowDC(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Handel ke jendela dengan konteks perangkat yang akan diambil. Jika nilai ini NULL, GetWindowDC mengambil konteks perangkat untuk seluruh layar.

Jika parameter ini NULL, GetWindowDC mengambil konteks perangkat untuk monitor tampilan utama. Untuk mendapatkan konteks perangkat untuk monitor tampilan lainnya, gunakan fungsi EnumDisplayMonitors dan CreateDC .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke konteks perangkat untuk jendela yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL, menunjukkan kesalahan atau parameter hWnd yang tidak valid.

Keterangan

GetWindowDC ditujukan untuk efek lukisan khusus dalam area nonkelola jendela. Pengecatan di area yang tidak tertutup dari jendela apa pun tidak disarankan.

Fungsi GetSystemMetrics dapat digunakan untuk mengambil dimensi berbagai bagian area nonkelola, seperti bilah judul, menu, dan bilah gulir.

Fungsi GetDC dapat digunakan untuk mengambil konteks perangkat untuk seluruh layar.

Setelah lukisan selesai, fungsi ReleaseDC harus dipanggil untuk merilis konteks perangkat. Tidak merilis konteks perangkat jendela memiliki efek serius pada lukisan yang diminta oleh aplikasi.

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-draw-l1-1-0 (diperkenalkan dalam Windows 8)