Compartilhar via


CWnd::GetDlgItem

Recupera um ponteiro para o controle ou janela filho especificada em uma caixa de diálogo ou outra janela.

CWnd* GetDlgItem( 
   int nID  
) const; 
void GetDlgItem( 
   int nID, 
   HWND* phWnd 
) const;

Parâmetros

  • nID
    Especifica o identificador do controle ou janela filho para ser recuperados.

  • phWnd
    Um ponteiro para a janela filho.

Valor de retorno

Um ponteiro para o controle ou janela filho determinada. Se nenhum controle com a identificação inteiro determinado pelo parâmetro de nID existir, o valor é NULO.

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

Comentários

O ponteiro retornado é geralmente convertido para o tipo de controle identificado por nID.

Exemplo

// uses GetDlgItem to return a pointer to a user interface control
CEdit* pBoxOne;
pBoxOne = (CEdit*)GetDlgItem(IDC_MYEDIT);
GotoDlgCtrl(pBoxOne);

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::GetWindow

CWnd::GetDescendantWindow

CWnd::GetWindow

GetDlgItem