Die Community zu .NET und Classic VB.
Menü

GetWindow

 von 

Deklaration  

Declare Function GetWindow Lib "user32" ( _
                 ByVal hWnd As Long, _
                 ByVal wCmd As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetWindow des API-Wikis.

GetWindow durchsucht die Fensterliste der Eltern- und Kindfenster nach dem Fenster, das mit den im Parameter wCmd angegebenen Kriterien übereinstimmt. GetWindow stellt eine einfache Alternative zu EnumWindows und EnumChildWindows dar, wenn die Anzahl der zu suchenden Fenster gering ist.

Parameter
hWndDas Fensterhandle, auf dem die Suchkreiterien in wCmd basieren.
wCmdDie Beziehung, die das zurückzugebende Fenster zu dem im Parameter hWnd vorgegebenen Fenster hat. Dieser Parameter kann auf einen der Werte der folgenden Tabelle gesetzt werden.

Tabelle 1


Zulässige Werte für wCmd
GW_CHILDGibt das erste Kindfenster des Fensters zurück.
GW_HWNDFIRSTHandelt es sich bei dem vorgegebenen Fenster um ein obenliegendes, wird das erste obenliegende Fesnter zurückgegeben. Handelt es sich um ein Kindfenster, wird das erste gleichgestellte Kindfenster zurückgegeben.
GW_HWNDLASTHandelt es sich bei dem vorgegebenen Fenster um ein obenliegendes, wird das erste obenliegende Fesnter zurückgegeben. Handelt es sich um ein Kindfenster, wird das letzte gleichgestellte Kindfenster zurückgegeben.
GW_HWNDNEXTGibt das nächste Fensterhandle in der Liste des Fenstermanagers zurück.
GW_HWNDPREVGibt das vorherige Fensterhandle in der Liste des Fenstermanagers zurück.
GW_OWNERGibt das Elternfenster des vorgegebenen Fensters zurück.

Tabelle 2


Rückgabewerte
hWndDas Handle des den Kriterien entsprechenden Fensters.
0Es wurde kein den Kriterien entsprechendes Fenster gefunden.

Tabelle 3


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetActiveWindow, GetNextWindow, GetTopWindow

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel