CWnd::GetNextDlgGroupItem

Artículo
02/19/2013

Buscar el control siguiente o anterior dentro de un grupo de controles en un cuadro de diálogo.

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

Parámetros

pWndCtl
Identifica el control que se va a utilizar como punto inicial de la búsqueda.
bPrevious
Especifica cómo la función es buscar el grupo de controles en el cuadro de diálogo.Si TRUE, las búsquedas de la función para el control anterior en el grupo; si FALSE, se busca el control siguiente en el grupo.
pCurSiteOrWnd
identifica el control de COleControlSiteOrWnd .Para obtener más información sobre COleControlSiteOrWnd, vea Comentarios.

Valor devuelto

Puntero al control siguiente o anterior en el grupo si la función miembro es correcta.

el puntero devuelto puede ser temporal y no se debe almacenar para su uso posterior.

Comentarios

Un grupo de controles comienza con un control creado con el estilo de SE y termina por el último control que no se creó con el estilo de WS_GROUP .

De forma predeterminada, la función miembro de GetNextDlgGroupItem devuelve un puntero al control siguiente en el grupo.Si pWndCtl identifica el primer control del grupo y bPrevious es TRUE, GetNextDlgGroupItem devuelve un puntero al último control del grupo.

[!NOTA]

MFC admite controles ActiveX sin ventana, los controles ActiveX estándar, y las ventanas, hacer referencia a un control mediante sólo un HWND es suficiente ya no.El objeto de COleControlSiteOrWnd incluye información que identifica el objeto como un control ActiveX con ventanas, un control ActiveX sin ventana, la ventana o, como sigue:

Tipo de Control o de la ventana	Información de identificación
Control ActiveX Windowed	Contiene un HWND y asocia un objeto de COleControlSite al.Establece el miembro de m_hWnd de COleControlSiteOrWnd el HWND del control, y los puntos del miembro de m_pSite a COleControlSitedel control.
Control ActiveX sin ventana	No contiene ningún HWND.El miembro de m_pSite de puntos de COleControlSiteOrWnd a COleControlSitedel control, y el miembro de m_hWnd es NULL.
Ventana estándar	Contiene simplemente HWND.Establece el miembro de m_hWnd de COleControlSiteOrWnd a HWND de la ventana, y el miembro de m_pSite es NULL.