FindWindowExA-Funktion (winuser.h)

Artikel
11/20/2024

Ruft ein Handle zu einem Fenster ab, dessen Klassenname und Fenstername den angegebenen Zeichenfolgen entsprechen. Die Funktion durchsucht untergeordnete Fenster, beginnend mit dem Fenster, das dem angegebenen untergeordneten Fenster folgt. Diese Funktion führt keine Suche mit Groß-/Kleinschreibung durch.

Syntax

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

Parameter

[in, optional] hWndParent

Typ: HWND-

Ein Handle für das übergeordnete Fenster, dessen untergeordnete Fenster durchsucht werden sollen.

Wenn hwndParentNULL-ist, verwendet die Funktion das Desktopfenster als übergeordnetes Fenster. Die Funktion sucht zwischen Fenstern, die untergeordnete Fenster des Desktops sind.

Wenn hwndParentHWND_MESSAGEist, durchsucht die Funktion alle Nur-Nachrichten-Fenster.

[in, optional] hWndChildAfter

Typ: HWND-

Ein Handle für ein untergeordnetes Fenster. Die Suche beginnt mit dem nächsten untergeordneten Fenster in der Z-Reihenfolge. Das untergeordnete Fenster muss ein direktes untergeordnetes Fenster hwndParentsein, nicht nur ein untergeordnetes Fenster.

Wenn hwndChildAfterNULL-ist, beginnt die Suche mit dem ersten untergeordneten Fenster von hwndParent.

Beachten Sie, dass sowohl hwndParent als auch hwndChildAfterNULL-sind, durchsucht die Funktion alle Fenster der obersten Ebene und nur für Nachrichten.

[in, optional] lpszClass

Typ: LPCSTR-

Der Klassenname oder ein Klassenatom, das von einem vorherigen Aufruf der RegisterClass oder RegisterClassEx--Funktion erstellt wurde. Das Atom muss im Wort "low-order" von lpszClassplatziert werden; Das Wort "Hochreihenfolge" muss null sein.

Wenn lpszClass eine Zeichenfolge ist, gibt sie den Namen der Fensterklasse an. Der Klassenname kann ein beliebiger Name sein, der mit RegisterClass oder RegisterClassEx-oder einem der vordefinierten Steuerelementklassennamen registriert ist, oder es kann MAKEINTATOM(0x8000)werden. In diesem letzteren Fall ist 0x8000 das Atom für eine Menüklasse. Weitere Informationen finden Sie im Abschnitt "Hinweise" dieses Themas.

[in, optional] lpszWindow

Typ: LPCSTR-

Der Fenstername (Der Titel des Fensters). Wenn dieser Parameter NULL-ist, stimmen alle Fensternamen überein.

Rückgabewert

Typ: HWND-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Fenster mit den angegebenen Klassen- und Fensternamen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Die FindWindowEx-Funktion durchsucht nur direkte untergeordnete Fenster. Andere Nachfolger werden nicht durchsucht.

Wenn der parameter lpszWindow nicht NULList, ruft FindWindowEx die GetWindowText--Funktion auf, um den Fensternamen für den Vergleich abzurufen. Eine Beschreibung eines potenziellen Problems, das auftreten kann, finden Sie im Abschnitt "Hinweise" von GetWindowText.

Eine Anwendung kann diese Funktion wie folgt aufrufen.

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

Beachten Sie, dass 0x8000 das Atom für eine Menüklasse ist. Wenn eine Anwendung diese Funktion aufruft, überprüft die Funktion, ob ein Kontextmenü angezeigt wird, das von der Anwendung erstellt wurde.

Anmerkung

Der winuser.h-Header definiert FindWindowEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-window-l1-1-1 (eingeführt in Windows 8.1)