GetNextDlgTabItem-Funktion (winuser.h)

  • Artikel

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

Dialogfelder

GetDlgItem

GetNextDlgGroupItem

Referenz