GetWindow

Die GetWindow -Funktion Ruft einen Handle für ein Fenster, das die angegebene Beziehung (Z-Reihenfolge oder Eigentümer) an das angegebene Fenster hat.

(HWND GetWindow HWND  hWnd, / / handle für original FensterUINTuCmd / / Beziehung Flagge);
 

Parameter

hWnd
Handle für ein Fenster. Das Fensterhandle, retrieved ist relativ zu diesem Fenster, basierend auf dem Wert des Parameters uCmd.
uCmd
Gibt die Beziehung zwischen dem angegebenen Fenster und dessen Handle abgerufen werden soll. Dieser Parameter kann eine der folgenden Werte sein:
Wert Bedeutung
GW_CHILD Das abgerufene Handle identifiziert das untergeordnete Fenster an der Spitze der Z-Reihenfolge, wenn das angegebene Fenster ein übergeordnetes Fenster ist; Andernfalls ist das abgerufene Handle NULL. Die Funktion prüft nur untergeordnete Fenster des angegebenen Fensters. Es prüft nicht untergeordneten Fenster.
GW_ENABLEDPOPUP Windows NT 5.0 und höher: Das abgerufene Handle identifiziert im Besitz des angegebenen Fensters aktiviert Popup-Fenster (die Suche verwendet die ersten solchen Fenster gefunden mit GW_HWNDNEXT); Andernfalls, wenn gibt es keine aktivierten Popupfenster ist das abgerufene Handle des angegebenen Fensters.
GW_HWNDFIRST Das abgerufene Handle identifiziert das Fenster des gleichen Typs, die höchste in der Z-Reihenfolge ist. Wenn das angegebene Fenster ein oberstes Fenster ist, gibt das Handle das oberste Fenster, das höchste in der Z-Reihenfolge ist. Wenn das angegebene Fenster ein Fenster das obersten Ebene ist, gibt das Handle der Fenster das obersten Ebene, das höchste in der Z-Reihenfolge ist. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle das nebengeordnete Fenster, das höchste in der Z-Reihenfolge ist.
GW_HWNDLAST Das abgerufene Handle identifiziert das Fenster des gleichen Typs, die in der Z-Reihenfolge am niedrigsten ist. Wenn das angegebene Fenster ein oberstes Fenster ist, gibt das Handle das oberste Fenster, das in der Z-Reihenfolge am niedrigsten ist. Wenn das angegebene Fenster ein Fenster das obersten Ebene ist, gibt das Handle der Fenster das obersten Ebene, das in der Z-Reihenfolge am niedrigsten ist. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle das nebengeordnete Fenster, das in der Z-Reihenfolge am niedrigsten ist.
GW_HWNDNEXT Das abgerufene Handle identifiziert das Fenster unter dem angegebenen Fenster in der Z-Reihenfolge. Wenn das angegebene Fenster ein oberstes Fenster ist, gibt das Handle das oberste Fenster unter dem angegebenen Fenster. Wenn das angegebene Fenster ein Fenster das obersten Ebene ist, gibt das Handle Fenster das obersten Ebene unter dem angegebenen Fenster. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle das nebengeordnete Fenster unter dem angegebenen Fenster.
GW_HWNDPREV Das abgerufene Handle identifiziert das Fenster über das angegebene Fenster in der Z-Reihenfolge. Wenn das angegebene Fenster ein oberstes Fenster ist, gibt das Handle das oberste Fenster über dem angegebenen Fenster. Wenn das angegebene Fenster ein Fenster das obersten Ebene ist, gibt das Handle Fenster das obersten Ebene über dem angegebenen Fenster. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, identifiziert das Handle das nebengeordnete Fenster über das angegebene Fenster.
GW_OWNER Das abgerufene Handle identifiziert das angegebene Fenster Besitzerfenster, falls vorhanden.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Fensterhandle. Wenn kein Fenster mit der angegebenen Beziehung an das angegebene Fenster existiert, ist der Rückgabewert NULL. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Die EnumChildWindows -Funktion ist zuverlässiger als GetWindow in einer Schleife aufrufen. Eine Anwendung, die Anrufe GetWindow zum Ausführen dieser Aufgabe werden Risiken in einer Endlosschleife abgefangen oder verweisen auf einen Handle für ein Fenster, das zerstört wurde.

Windows CE: In Windows CE, Version 1.0 wird der GW_OWNER-Flag-Wert für den Parameter uCmd nur für Dialogfelder unterstützt.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über Windows, Fensterfunktionen, EnumChildWindows

Index