GetNextDlgTabItem-Funktion (winuser.h)
Ruft ein Handle für das erste Steuerelement ab, das über die WS_TABSTOP-Formatvorlage verfügt, die dem angegebenen Steuerelement vorangeht (oder folgt).
Syntax
HWND GetNextDlgTabItem(
[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, schlägt die Funktion fehl.
[in] bPrevious
Typ: BOOL
Gibt an, wie die Funktion das Dialogfeld durchsuchen soll. Wenn dieser Parameter TRUE ist, sucht die Funktion im Dialogfeld nach dem vorherigen Steuerelement. Wenn dieser Parameter FALSE ist, sucht die Funktion im Dialogfeld nach dem nächsten Steuerelement.
Rückgabewert
Typ: HWND
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Fensterhandle des vorherigen (oder nächsten) Steuerelements, das über den WS_TABSTOP Stilsatz verfügt.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die GetNextDlgTabItem-Funktion durchsucht Steuerelemente in der Reihenfolge (oder umgekehrten Reihenfolge), die sie in der Dialogfeldvorlage erstellt wurden. Die Funktion gibt das erste gefundene Steuerelement zurück, das sichtbar, nicht deaktiviert ist und die WS_TABSTOP-Format aufweist. Wenn kein solches Steuerelement vorhanden ist, gibt die Funktion hCtl zurück.
Wenn bei der Suche nach dem nächsten Steuerelement mit der WS_TABSTOP-Formatvorlage ein Fenster mit der WS_EX_CONTROLPARENT-Formatvorlage gefunden 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 (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-dialogbox-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240) |
Siehe auch
Konzept
Referenz