Fungsi GetDC (winuser.h)

Artikel
03/04/2024

Fungsi GetDC mengambil handel ke konteks perangkat (DC) untuk area klien dari jendela tertentu atau untuk seluruh layar. Anda dapat menggunakan handel yang dikembalikan dalam fungsi GDI berikutnya untuk menggambar di DC. Konteks perangkat adalah struktur data buram, yang nilainya digunakan secara internal oleh GDI.

Fungsi GetDCEx adalah ekstensi untuk GetDC, yang memberi aplikasi lebih banyak kontrol atas bagaimana dan apakah kliping terjadi di area klien.

Sintaks

HDC GetDC(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Handel ke jendela yang DC-nya akan diambil. Jika nilai ini NULL, GetDC mengambil DC untuk seluruh layar.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke DC untuk area klien jendela yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Fungsi GetDC mengambil DC umum, kelas, atau privat tergantung pada gaya kelas jendela yang ditentukan. Untuk DC kelas dan privat, GetDC membiarkan atribut yang ditetapkan sebelumnya tidak berubah. Namun, untuk DC umum, GetDC menetapkan atribut default ke DC setiap kali diambil. Misalnya, font defaultnya adalah Sistem, yang merupakan font bitmap. Karena itu, handel ke DC umum yang dikembalikan oleh GetDC tidak memberi tahu Anda font, warna, atau kuas apa yang digunakan ketika jendela digambar. Untuk menentukan font, panggil GetTextFace.

Perhatikan bahwa handel ke DC hanya dapat digunakan oleh satu utas kapan saja.

Setelah melukis dengan DC umum, fungsi ReleaseDC harus dipanggil untuk merilis DC. Kelas dan DC privat tidak harus dirilis. ReleaseDC harus dipanggil dari utas yang sama yang disebut GetDC. Jumlah DC hanya dibatasi oleh memori yang tersedia.

Contoh

Misalnya, lihat Menggambar dengan Mouse.

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