GetNextDlgGroupItem, fonction (winuser.h)

Récupère un handle du premier contrôle d’un groupe de contrôles qui précède (ou suit) le contrôle spécifié dans une boîte de dialogue.

Syntaxe

HWND GetNextDlgGroupItem(
  [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 utilise le dernier (ou premier) contrôle de la boîte de dialogue comme point de départ de la recherche.

[in] bPrevious

Type : BOOL

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

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est un handle du contrôle précédent (ou suivant) dans le groupe de contrôles.

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 GetNextDlgGroupItem 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. Le premier contrôle du groupe doit avoir le style WS_GROUP ; tous les autres contrôles du groupe doivent avoir été créés consécutivement et ne doivent pas avoir le style WS_GROUP .

Lors de la recherche du contrôle précédent, la fonction retourne le premier contrôle qu’elle localise qui est visible et non désactivé. Si le contrôle spécifié par hCtl a le style WS_GROUP , la fonction inverse temporairement la recherche pour localiser le premier contrôle ayant le style WS_GROUP , puis reprend la recherche dans le sens d’origine, renvoyant le premier contrôle qu’elle localise qui est visible et non désactivé, ou renvoyant hCtl si aucun contrôle n’est trouvé.

Lors de la recherche du contrôle suivant, la fonction retourne le premier contrôle qu’elle localise qui est visible, non désactivé et qui n’a pas le style WS_GROUP . S’il rencontre un contrôle ayant le style WS_GROUP , la fonction inverse la recherche, localise le premier contrôle ayant le style WS_GROUP et retourne ce contrôle s’il est visible et non désactivé. Sinon, la fonction reprend la recherche dans le sens d’origine et retourne le premier contrôle qu’elle localise qui est visible et non désactivé, ou retourne hCtl si aucun contrôle de ce type n’est trouvé.

Si la recherche du contrôle suivant dans le groupe 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

Voir aussi

Conceptuel

Boîtes de dialogue

GetNextDlgTabItem

Référence