CWnd::GetNextDlgGroupItem

Article
03/04/2013

Recherche le contrôle précédent ou suivant au sein d'un groupe de contrôles dans une boîte de dialogue.

CWnd* GetNextDlgGroupItem(
   CWnd* pWndCtl,
   BOOL bPrevious = FALSE 
) const;
COleControlSiteOrWnd* GetNextDlgGroupItem(
   COleControlSiteOrWnd *pCurSiteOrWnd = NULL
) const;

Paramètres

pWndCtl
Identifie le contrôle à utiliser comme point de départ de la recherche.
bPrevious
Spécifie comment la fonction est de rechercher le groupe de contrôles dans la boîte de dialogue.Si TRUE, les recherches de fonction pour le contrôle précédent au groupe ; si FALSE, il recherche le contrôle suivant au groupe.
pCurSiteOrWnd
Identifie le contrôle de COleControlSiteOrWnd .Pour plus d'informations sur COleControlSiteOrWnd, consultez Notes.

Valeur de retour

Pointeur vers le contrôle précédent ou suivant au groupe si la fonction membre est réussie.

Le pointeur retourné peut être temporaire et ne doit pas être enregistré pour une utilisation ultérieure.

Notes

Un groupe de contrôles commence par un contrôle qui a été créé avec le style et la fin de WS_GROUP avec le dernier contrôle qui n'a pas été créé avec le style de WS_GROUP .

Par défaut, la fonction membre d' GetNextDlgGroupItem retourne un pointeur vers le contrôle au groupe.Si pWndCtl identifie le premier contrôle au groupe et bPrevious est TRUE, GetNextDlgGroupItem retourne un pointeur vers le dernier contrôle au groupe.

[!REMARQUE]

Les contrôles ActiveX sans fenêtre de MFC prend en charge, contrôles ActiveX standard, et les fenêtres, vous faites référence à un contrôle par un seul HWND ne suffit plus.L'objet d' COleControlSiteOrWnd inclut les informations qui identifient l'objet comme un contrôle ActiveX avec fenêtres, contrôles ActiveX sans fenêtre, ou la fenêtre, comme suit :

Type de contrôle ou de fenêtre	Les informations d'identification
Contrôle ActiveX avec fenêtres	Contient un HWND et associe un objet de COleControlSite avec lui.Le membre d' m_hWnd d' COleControlSiteOrWnd a pour valeur le HWND du contrôle, et les points de membre de m_pSite à COleControlSitedu contrôle.
Contrôle ActiveX sans fenêtre	Ne contient aucun HWND.Le membre de m_pSite des points d' COleControlSiteOrWnd à COleControlSitedu contrôle, et le membre de m_hWnd est NULL.
Fenêtre standard	Contient uniquement HWND.Le membre d' m_hWnd d' COleControlSiteOrWnd a la valeur HWND de la fenêtre, et le membre de m_pSite est NULL.