Fungsi GetDCEx (winuser.h)

Artikel
08/27/2023

Fungsi GetDCEx 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 ini adalah ekstensi untuk fungsi GetDC , yang memberikan aplikasi lebih banyak kontrol atas bagaimana dan apakah kliping terjadi di area klien.

Sintaks

HDC GetDCEx(
  [in] HWND  hWnd,
  [in] HRGN  hrgnClip,
  [in] DWORD flags
);

Parameter

[in] hWnd

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

[in] hrgnClip

Wilayah kliping yang mungkin dikombinasikan dengan wilayah DC yang terlihat. Jika nilai bendera DCX_INTERSECTRGN atau DCX_EXCLUDERGN, maka sistem operasi mengasumsikan kepemilikan wilayah dan akan secara otomatis menghapusnya ketika tidak lagi diperlukan. Dalam hal ini, aplikasi tidak boleh menggunakan atau menghapus wilayah setelah panggilan berhasil ke GetDCEx.

[in] flags

Menentukan bagaimana DC dibuat. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
DCX_WINDOW	Mengembalikan DC yang sesuai dengan persegi jendela, bukan persegi panjang klien.
DCX_CACHE	Mengembalikan DC dari cache, bukan jendela OWNDC atau CLASSDC. Pada dasarnya mengambil alih CS_OWNDC dan CS_CLASSDC.
DCX_PARENTCLIP	Menggunakan wilayah jendela induk yang terlihat. Bit gaya WS_CLIPCHILDREN dan CS_PARENTDC induk diabaikan. Asal diatur ke sudut kiri atas jendela yang diidentifikasi oleh hWnd.
DCX_CLIPSIBLINGS	Mengecualikan wilayah yang terlihat dari semua jendela saudara kandung di atas jendela yang diidentifikasi oleh hWnd.
DCX_CLIPCHILDREN	Mengecualikan wilayah yang terlihat dari semua jendela anak di bawah jendela yang diidentifikasi oleh hWnd.
DCX_NORESETATTRS	Bendera ini diabaikan.
DCX_LOCKWINDOWUPDATE	Memungkinkan menggambar bahkan jika ada panggilan LockWindowUpdate yang berlaku yang sebaliknya akan mengecualikan jendela ini. Digunakan untuk menggambar selama pelacakan.
DCX_EXCLUDERGN	Wilayah kliping yang diidentifikasi oleh hrgnClip dikecualikan dari wilayah DC yang terlihat.
DCX_INTERSECTRGN	Wilayah kliping yang diidentifikasi oleh hrgnClip bersinggungan dengan wilayah DC yang terlihat.
DCX_INTERSECTUPDATE	Dipesan; jangan gunakan.
DCX_VALIDATE	Dipesan; jangan gunakan.

Mengembalikan nilai

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

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Nilai yang tidak valid untuk parameter hWnd akan menyebabkan fungsi gagal.

Keterangan

Kecuali DC tampilan milik kelas jendela, fungsi ReleaseDC harus dipanggil untuk merilis DC setelah melukis. Selain itu, ReleaseDC harus dipanggil dari utas yang sama yang disebut GetDCEx. Jumlah DC hanya dibatasi oleh memori yang tersedia.

Fungsi mengembalikan handel ke DC milik kelas jendela jika CS_CLASSDC, CS_OWNDC, atau CS_PARENTDC ditentukan sebagai gaya dalam struktur WNDCLASS saat kelas terdaftar.

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