Bagikan melalui


Fungsi GetDC (winuser.h)

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

Lihat juga

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

GetDCEx

GetTextFace

GetWindowDC

ReleaseDC

WindowFromDC