GetWindow-Funktion (winuser.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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
Referenz