Fungsi FindWindowExA (winuser.h)

Artikel
02/01/2024

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

Sintaks

HWND FindWindowExA(
  [in, optional] HWND   hWndParent,
  [in, optional] HWND   hWndChildAfter,
  [in, optional] LPCSTR lpszClass,
  [in, optional] LPCSTR lpszWindow
);

Parameter

[in, optional] hWndParent

Jenis: HWND

Handel ke jendela induk yang jendela anaknya akan dicari.

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

Jika hwndParentHWND_MESSAGE, fungsi akan 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 anak langsung dari hwndParent, bukan hanya jendela turunan.

Jika hwndChildAfter adalah NULL, pencarian dimulai dengan jendela anak pertama hwndParent.

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

[in, optional] lpszClass

Jenis: LPCSTR

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 nama kelas kontrol yang telah ditentukan sebelumnya, atau bisa .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: LPCSTR

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

Nilai kembali

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan 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, hubungi GetLastError.

Keterangan

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

Jika parameter lpszWindow bukan NULL, FindWindowEx memanggil fungsi GetWindowText untuk mengambil nama jendela untuk perbandingan. Untuk deskripsi potensi masalah yang dapat muncul, lihat bagian Keterangan di 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 ditampilkan bahwa aplikasi dibuat.

Catatan

Header winuser.h mendefinisikan FindWindowEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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-1 (diperkenalkan dalam Windows 8.1)