GetNextDlgTabItem, fonction (winuser.h)

Article
08/27/2023

Récupère un handle du premier contrôle qui a le style WS_TABSTOP qui précède (ou suit) le contrôle spécifié.

Syntaxe

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

Paramètres

[in] hDlg

Type : HWND

Handle de la boîte de dialogue à rechercher.

[in, optional] hCtl

Type : HWND

Handle du contrôle à utiliser comme point de départ de la recherche. Si ce paramètre a la valeur NULL, la fonction échoue.

[in] bPrevious

Type : BOOL

Indique comment la fonction doit rechercher dans la boîte de dialogue. Si ce paramètre a la valeur TRUE, la fonction recherche le contrôle précédent dans la boîte de dialogue. Si ce paramètre a la valeur FALSE, la fonction recherche le contrôle suivant dans la boîte de dialogue.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est le handle de fenêtre du contrôle précédent (ou suivant) qui a le WS_TABSTOP de style défini.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction GetNextDlgTabItem recherche les contrôles dans l’ordre (ou l’ordre inverse) dans lequel ils ont été créés dans le modèle de boîte de dialogue. La fonction retourne le premier contrôle qu’elle localise qui est visible, non désactivé, et qui a le style WS_TABSTOP . S’il n’existe aucun contrôle de ce type, la fonction retourne hCtl.

Si la recherche du contrôle suivant avec le style WS_TABSTOP rencontre une fenêtre avec le style WS_EX_CONTROLPARENT , le système effectue une recherche récursive dans les enfants de la fenêtre.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-dialogbox-l1-1-2 (introduit dans Windows 10, version 10.0.10240)