GetNextWindow-Makro (winuser.h)

Artikel
11/20/2024

Ruft ein Handle zum nächsten oder vorherigen Fenster im Z-Order-ab. Das nächste Fenster befindet sich unterhalb des angegebenen Fensters. Das vorherige Fenster befindet sich oben.

Wenn das angegebene Fenster ein oberstes Fenster ist, sucht die Funktion nach einem obersten Fenster. Wenn das angegebene Fenster ein Fenster der obersten Ebene ist, sucht die Funktion nach einem Fenster der obersten Ebene. Wenn das angegebene Fenster ein untergeordnetes Fenster ist, sucht die Funktion nach einem untergeordneten Fenster.

Syntax

void GetNextWindow(
  [in]  hWnd,
  [in]  wCmd
);

Parameter

[in] hWnd

Typ: HWND-

Ein Handle zu einem Fenster. Das abgerufene Fensterhandle ist relativ zu diesem Fenster, basierend auf dem Wert des wCmd-Parameters.

[in] wCmd

Typ: UINT-

Gibt an, ob die Funktion ein Handle an das nächste Fenster oder das vorherige Fenster zurückgibt. Dieser Parameter kann eine der folgenden Werte sein.

Wert	Bedeutung
GW_HWNDNEXT 2	Gibt ein Handle an das Fenster unterhalb des angegebenen Fensters zurück.
GW_HWNDPREV 3	Gibt ein Handle für das Fenster oberhalb des angegebenen Fensters zurück.

Rückgabewert

Typ: HWND-

Wenn die Funktion erfolgreich ist, handelt es sich beim Rückgabewert um ein Fensterhandle. Wenn kein Fenster mit der angegebenen Beziehung zum angegebenen Fenster vorhanden ist, wird der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Diese Funktion wird als Aufruf der GetWindow--Funktion implementiert.

#define GetNextWindow(hWnd, wCmd) GetWindow(hWnd, wCmd)

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)

Siehe auch

Konzeptionelle

GetTopWindow-

GetWindow-

Referenz-

Windows

Freigeben über