CWnd::GetNextDlgGroupItem

Artigo
02/25/2013

Procura o controle anterior ou próximo em um grupo 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 como ponto de partida para a pesquisa.
bPrevious
Especifica como a função é procurar o grupo de controles na caixa de diálogo.Se Verdadeiro, a função procura pelo controle anterior no grupo; se Falso, ele procura pelo próximo controle no grupo.
pCurSiteOrWnd
Identifica o controle de COleControlSiteOrWnd .Para obter mais informações sobre COleControlSiteOrWnd, consulte Comentários.

Valor de retorno

Ponteiro para o controle anterior ou próximo no grupo 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 grupo de controles começa com um controle que é criado com o estilo e termina de WS_GROUP com o último controle que não foi criado com o estilo de WS_GROUP .

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

Observação
Porque o MFC suporta controles ActiveX sem janelas, controles ActiveX padrão, e janelas, se referir a um controle somente por um HWND não basta.O objeto de COleControlSiteOrWnd inclui informações que identificam o objeto como um controle ActiveX da janela, um controle ActiveX sem janelas, ou uma janela, da seguinte maneira:

Tipo de controle ou janela	Identificando informações
Controle ActiveX de janela	Contém um HWND e associa um objeto de COleControlSite com ele.O membro de m_hWnd de COleControlSiteOrWnd é definido para o HWND do controle, e os pontos de membro de m_pSite a COleControlSitedo controle.
Controle ActiveX sem o windows	Não contém nenhum HWND.O membro de m_pSite de pontos de COleControlSiteOrWnd a COleControlSitede controle, e o membro de m_hWnd são NULO.
Janela padrão	Contém apenas HWND.O membro de m_hWnd de COleControlSiteOrWnd é definido como HWND da janela, e o membro de m_pSite é NULO.