Freigeben über


GetNextDlgGroupItem-Funktion (winuser.h)

Ruft ein Handle für das erste Steuerelement in einer Gruppe von Steuerelementen ab, das dem angegebenen Steuerelement in einem Dialogfeld vorangestellt (oder folgt).

Syntax

HWND GetNextDlgGroupItem(
  [in]           HWND hDlg,
  [in, optional] HWND hCtl,
  [in]           BOOL bPrevious
);

Parameter

[in] hDlg

Typ: HWND

Ein Handle für das zu durchsuchende Dialogfeld.

[in, optional] hCtl

Typ: HWND

Ein Handle für das Steuerelement, das als Ausgangspunkt für die Suche verwendet werden soll. Wenn dieser Parameter NULL ist, verwendet die Funktion das letzte (oder erste) Steuerelement im Dialogfeld als Ausgangspunkt für die Suche.

[in] bPrevious

Typ: BOOL

Gibt an, wie die Funktion die Gruppe von Steuerelementen im Dialogfeld durchsuchen soll. Wenn dieser Parameter TRUE ist, sucht die Funktion nach dem vorherigen Steuerelement in der Gruppe. Wenn der Wert FALSE ist, sucht die Funktion nach dem nächsten Steuerelement in der Gruppe.

Rückgabewert

Typ: HWND

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das vorherige (oder nächste) Steuerelement in der Gruppe von Steuerelementen.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetNextDlgGroupItem-Funktion durchsucht Steuerelemente in der Reihenfolge (oder in umgekehrter Reihenfolge), in der sie in der Dialogfeldvorlage erstellt wurden. Das erste Steuerelement in der Gruppe muss die WS_GROUP Formatvorlage aufweisen. alle anderen Steuerelemente in der Gruppe müssen nacheinander erstellt worden sein und dürfen nicht über den WS_GROUP-Stil verfügen.

Bei der Suche nach dem vorherigen Steuerelement gibt die Funktion das erste gefundene Steuerelement zurück, das sichtbar und nicht deaktiviert ist. Wenn das von hCtl angegebene Steuerelement über die WS_GROUP-Formatvorlage verfügt, kehrt die Funktion die Suche vorübergehend um, um das erste Steuerelement mit dem WS_GROUP Stil zu suchen, setzt die Suche dann in der ursprünglichen Richtung fort, und gibt das erste gesuchte Steuerelement zurück, das sichtbar und nicht deaktiviert ist, oder gibt hCtl zurück, wenn kein solches Steuerelement gefunden wird.

Bei der Suche nach dem nächsten Steuerelement gibt die Funktion das erste gefundene Steuerelement zurück, das sichtbar, nicht deaktiviert ist und nicht über das WS_GROUP-Format verfügt. Wenn ein Steuerelement mit der WS_GROUP-Formatvorlage auftritt, kehrt die Funktion die Suche um, sucht das erste Steuerelement mit der WS_GROUP-Formatvorlage und gibt dieses Steuerelement zurück, wenn es sichtbar und nicht deaktiviert ist. Andernfalls setzt die Funktion die Suche in der ursprünglichen Richtung fort und gibt das erste gefundene Steuerelement zurück, das sichtbar und nicht deaktiviert ist, oder gibt hCtl zurück, wenn kein solches Steuerelement gefunden wird.

Wenn bei der Suche nach dem nächsten Steuerelement in der Gruppe ein Fenster mit der WS_EX_CONTROLPARENT-Format angezeigt wird, durchsucht das System rekursiv die untergeordneten Elemente des Fensters.

Anforderungen

   
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 (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll

Siehe auch

Konzept

Dialogfelder

GetNextDlgTabItem

Referenz