CWnd::GetNextDlgGroupItem
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.
Dica
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. |
Requisitos
Cabeçalho: afxwin.h