GetWindow-Funktion (winuser.h)

  • Artikel

Ruft ein Handle für ein Fenster ab, das über die angegebene Beziehung (Z-Order oder Besitzer) zum angegebenen Fenster verfügt.

Syntax

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

Parameter

[in] hWnd

Typ: HWND

Das Fensterhandle Das abgerufene Fensterhandle ist relativ zu diesem Fenster, basierend auf dem Wert des uCmd-Parameters .

[in] uCmd

Typ: UINT

Die Beziehung zwischen dem angegebenen Fenster und dem Fenster, dessen Handle abgerufen werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
GW_CHILD
5
 Das abgerufene Handle identifiziert das untergeordnete Fenster am oberen Rand der Z-Reihenfolge, wenn das angegebene Fenster ein übergeordnetes Fenster ist. andernfalls ist das abgerufene Handle NULL. Die Funktion untersucht nur untergeordnete Fenster des angegebenen Fensters. Es werden keine absteigenden Fenster untersucht.
GW_ENABLEDPOPUP
6
 Das abgerufene Handle identifiziert das aktivierte Popupfenster im Besitz des angegebenen Fensters (die Suche verwendet das erste fenster, das mithilfe von GW_HWNDNEXT gefunden wurde). Andernfalls ist das abgerufene Handle das des angegebenen Fensters, wenn keine Popupfenster aktiviert sind.
GW_HWNDFIRST
0
 Das abgerufene Handle identifiziert das Fenster desselben Typs, der in der Z-Reihenfolge am höchsten ist.

Wenn das angegebene Fenster ein oberstes Fenster ist, identifiziert das Handle ein oberstes Fenster. Wenn es sich bei dem angegebenen Fenster um ein Fenster auf oberster Ebene handelt, identifiziert das Handle ein Fenster auf oberster Ebene. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle ein gleichgeordnetes Fenster.
GW_HWNDLAST
1
 Das abgerufene Handle identifiziert das Fenster desselben Typs, der in der Z-Reihenfolge am niedrigsten ist.

Wenn das angegebene Fenster ein oberstes Fenster ist, identifiziert das Handle ein oberstes Fenster. Wenn es sich bei dem angegebenen Fenster um ein Fenster auf oberster Ebene handelt, identifiziert das Handle ein Fenster auf oberster Ebene. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle ein gleichgeordnetes Fenster.
GW_HWNDNEXT
2
 Das abgerufene Handle identifiziert das Fenster unter dem angegebenen Fenster in der Z-Reihenfolge.

Wenn das angegebene Fenster ein oberstes Fenster ist, identifiziert das Handle ein oberstes Fenster. Wenn es sich bei dem angegebenen Fenster um ein Fenster auf oberster Ebene handelt, identifiziert das Handle ein Fenster auf oberster Ebene. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle ein gleichgeordnetes Fenster.
GW_HWNDPREV
3
 Das abgerufene Handle identifiziert das Fenster über dem angegebenen Fenster in der Z-Reihenfolge.

Wenn das angegebene Fenster ein oberstes Fenster ist, identifiziert das Handle ein oberstes Fenster. Wenn es sich bei dem angegebenen Fenster um ein Fenster auf oberster Ebene handelt, identifiziert das Handle ein Fenster auf oberster Ebene. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle ein gleichgeordnetes Fenster.
GW_OWNER
4
 Das abgerufene Handle identifiziert das Besitzerfenster des angegebenen Fensters, falls vorhanden. Weitere Informationen finden Sie unter Eigenes Windows.

Rückgabewert

Typ: HWND

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Fensterhandle. Wenn kein Fenster mit der angegebenen Beziehung zum angegebenen Fenster vorhanden ist, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die EnumChildWindows-Funktion ist zuverlässiger als das Aufrufen von GetWindow in einer Schleife. Eine Anwendung, die GetWindow aufruft, um diese Aufgabe auszuführen, riskiert, in einer Unendlichkeitsschleife abgefangen zu werden oder ein Handle auf ein fenster verweist, das zerstört wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

EnumChildWindows

Referenz

Windows