Fungsi GetWindow (winuser.h)

Artikel
03/13/2024

Mengambil handel ke jendela yang memiliki hubungan yang ditentukan (Z-Order atau pemilik) ke jendela yang ditentukan.

Sintaks

HWND GetWindow(
  [in] HWND hWnd,
  [in] UINT uCmd
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela. Handel jendela yang diambil relatif terhadap jendela ini, berdasarkan nilai parameter uCmd .

[in] uCmd

Jenis: UINT

Hubungan antara jendela yang ditentukan dan jendela yang handelnya akan diambil. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
GW_CHILD 5	Handel yang diambil mengidentifikasi jendela anak di bagian atas urutan Z, jika jendela yang ditentukan adalah jendela induk; jika tidak, handel yang diambil adalah NULL. Fungsi ini hanya memeriksa jendela anak dari jendela yang ditentukan. Ini tidak memeriksa jendela turunan.
GW_ENABLEDPOPUP 6	Handel yang diambil mengidentifikasi jendela popup yang diaktifkan yang dimiliki oleh jendela yang ditentukan (pencarian menggunakan jendela pertama yang ditemukan menggunakan GW_HWNDNEXT); jika tidak, jika tidak ada jendela popup yang diaktifkan, handel yang diambil adalah dari jendela yang ditentukan.
GW_HWNDFIRST 0	Handel yang diambil mengidentifikasi jendela dengan jenis yang sama yang tertinggi dalam urutan Z. Jika jendela yang ditentukan adalah jendela paling atas, handel akan mengidentifikasi jendela paling atas. Jika jendela yang ditentukan adalah jendela tingkat atas, handel akan mengidentifikasi jendela tingkat atas. Jika jendela yang ditentukan adalah jendela anak, handel akan mengidentifikasi jendela saudara.
GW_HWNDLAST 1	Handel yang diambil mengidentifikasi jendela dengan jenis yang sama yang terendah dalam urutan Z. Jika jendela yang ditentukan adalah jendela paling atas, handel akan mengidentifikasi jendela paling atas. Jika jendela yang ditentukan adalah jendela tingkat atas, handel akan mengidentifikasi jendela tingkat atas. Jika jendela yang ditentukan adalah jendela anak, handel akan mengidentifikasi jendela saudara.
GW_HWNDNEXT 2	Handel yang diambil mengidentifikasi jendela di bawah jendela yang ditentukan dalam urutan Z. Jika jendela yang ditentukan adalah jendela paling atas, handel akan mengidentifikasi jendela paling atas. Jika jendela yang ditentukan adalah jendela tingkat atas, handel akan mengidentifikasi jendela tingkat atas. Jika jendela yang ditentukan adalah jendela anak, handel akan mengidentifikasi jendela saudara.
GW_HWNDPREV 3	Handel yang diambil mengidentifikasi jendela di atas jendela yang ditentukan dalam urutan Z. Jika jendela yang ditentukan adalah jendela paling atas, handel akan mengidentifikasi jendela paling atas. Jika jendela yang ditentukan adalah jendela tingkat atas, handel akan mengidentifikasi jendela tingkat atas. Jika jendela yang ditentukan adalah jendela anak, handel akan mengidentifikasi jendela saudara.
GW_OWNER 4	Handel yang diambil mengidentifikasi jendela pemilik jendela yang ditentukan, jika ada. Untuk informasi selengkapnya, lihat Windows yang Dimiliki.

Nilai kembali

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan adalah handel jendela. Jika tidak ada jendela dengan hubungan yang ditentukan ke jendela yang ditentukan, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi EnumChildWindows lebih dapat diandalkan daripada memanggil GetWindow dalam perulangan. Aplikasi yang memanggil GetWindow untuk melakukan tugas ini berisiko tertangkap dalam perulangan tak terbatas atau merujuk handel ke jendela yang telah dihancurkan.

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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

Konseptual

EnumChildWindows

Referensi

Windows

Bagikan melalui