Fungsi FindWindowExW (winuser.h)

Mengambil handel ke jendela yang nama kelas dan nama jendelanya cocok dengan string yang ditentukan. Fungsi mencari jendela anak, dimulai dengan yang mengikuti jendela anak yang ditentukan. Fungsi ini tidak melakukan pencarian peka huruf besar/kecil.

Sintaksis

HWND FindWindowExW(
  [in, optional] HWND    hWndParent,
  [in, optional] HWND    hWndChildAfter,
  [in, optional] LPCWSTR lpszClass,
  [in, optional] LPCWSTR lpszWindow
);

Parameter

[in, optional] hWndParent

Jenis: HWND

Handel ke jendela induk yang jendela anaknya akan dicari.

Jika hwndParentNULL, fungsi menggunakan jendela desktop sebagai jendela induk. Fungsi ini mencari di antara jendela yang merupakan jendela anak desktop.

Jika hwndParentHWND_MESSAGE, fungsi mencari semua jendela khusus pesan.

[in, optional] hWndChildAfter

Jenis: HWND

Handel ke jendela anak. Pencarian dimulai dengan jendela anak berikutnya dalam urutan Z. Jendela anak harus berupa jendela turunan langsung hwndParent, bukan hanya jendela turunan.

Jika hwndChildAfternull, pencarian dimulai dengan jendela anak pertama hwndParent.

Perhatikan bahwa jika hwndParent dan hwndChildAfter NULL, fungsi mencari semua jendela tingkat atas dan hanya pesan.

[in, optional] lpszClass

Jenis: LPCWSTR

Nama kelas atau atom kelas yang dibuat oleh panggilan sebelumnya ke fungsi RegisterClass atau RegisterClassEx. Atom harus ditempatkan dalam kata urutan rendah lpszClass; kata urutan tinggi harus nol.

Jika lpszClass adalah string, itu menentukan nama kelas jendela. Nama kelas dapat berupa nama apa pun yang terdaftar di RegisterClass atau RegisterClassEx, atau salah satu nama kelas kontrol yang telah ditentukan sebelumnya, atau dapat MAKEINTATOM(0x8000). Dalam kasus terakhir ini, 0x8000 adalah atom untuk kelas menu. Untuk informasi selengkapnya, lihat bagian Keterangan dari topik ini.

[in, optional] lpszWindow

Jenis: LPCWSTR

Nama jendela (judul jendela). Jika parameter ini NULL, semua nama jendela cocok.

Mengembalikan nilai

Jenis: HWND

Jika fungsi berhasil, nilai pengembalian adalah handel ke jendela yang memiliki nama kelas dan jendela yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi FindWindowEx hanya mencari jendela anak langsung. Ini tidak mencari keturunan lain.

Jika parameter lpszWindow tidak NULL, FindWindowEx memanggil fungsi GetWindowText untuk mengambil nama jendela untuk perbandingan. Untuk deskripsi potensi masalah yang dapat muncul, lihat bagian Keterangan GetWindowText.

Aplikasi dapat memanggil fungsi ini dengan cara berikut.

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

Perhatikan bahwa 0x8000 adalah atom untuk kelas menu. Ketika aplikasi memanggil fungsi ini, fungsi memeriksa apakah menu konteks sedang ditampilkan yang dibuat aplikasi.

Persyaratan

Lihat juga

Konseptual

EnumWindows

FindWindow

GetClassName

GetWindowText

Referensi

RegisterClass

RegisterClassEx

Windows