CWnd::GetNextDlgGroupItem

Artigo
08/25/2010

Localiza o controle anterior ou seguinte dentro de um agrupar de controles em uma caixa de diálogo.

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

Parâmetros

pWndCtl
Identifica o controle a ser usado sistema autônomo ponto de partida para a Pesquisar.
bPrevious
Especifica como a função deve pesquisar o agrupar de controles na caixa de diálogo.If TRUE, a função de pesquisa para o controle anterior de agrupar; caso FALSE, ele procura o próximo controle no agrupar.
pCurSiteOrWnd
Identifica o COleControlSiteOrWnd controle.Para obter mais informações sobre o COleControlSiteOrWnd, consulte Comentários.

Valor de retorno

Ponteiro para o controle anterior ou seguinte no agrupar se a função de membro for bem-sucedida.

O ponteiro retornado pode ser temporário e não deve ser armazenado para uso posterior.

Comentários

Um agrupar de controles começa com um controle que foi criado com o WS_GROUP estilo de e termina com o último controle que não foi criado com o WS_GROUP estilo.

Por padrão, a GetNextDlgGroupItem função de membro retorna um ponteiro para o próximo controle no agrupar. If pWndCtl identifica o primeiro controle no agrupar e bPrevious é TRUE, GetNextDlgGroupItem Retorna um ponteiro para o último controle no agrupar.

Observação:
Como o MFC oferece suporte a contr ActiveX sem janelas ferramentas, padrão e controles ActiveX, janelas, fazendo referência a um controle por apenas um HWND não é suficiente.O COleControlSiteOrWnd objeto inclui informações que identifica o objeto sistema autônomo um controle ActiveX em janelas, um controle ActiveX sem janelas ou uma janela, da seguinte maneira:

Tipo de controle ou janela	Informações de identificação
Controle ActiveX em janelas	Contém um HWND e associa um COleControlSite objeto com ele.The m_hWnd membro de COleControlSiteOrWnd é conjunto para o HWND do controle e o m_pSite membro aponta para COleControlSite.
Controle ActiveX sem janelas	Não contémHWND. The m_pSite membro COleControlSiteOrWnd pontos de controle COleControlSitee o m_hWnd membro é NULO.
Janela padrão	Contém apenas um HWND. The m_hWnd membro de COleControlSiteOrWnd é definido como o HWND da janela e o m_pSite membro é NULO.