CDialog::OnInitDialog

Artigo
02/25/2013

Este método é chamado em resposta a mensagem de WM_INITDIALOG .

virtual BOOL OnInitDialog( );

Valor de retorno

Especifica se o aplicativo tiver definido o foco de entrada para um dos controles na caixa de diálogo.Se OnInitDialog retorna diferente de zero, janelas definem o foco de entrada para o local padrão, o primeiro controle na caixa de diálogo.O aplicativo pode retornar 0 somente se definiu explicitamente o foco de entrada para um dos controles na caixa de diálogo.

Comentários

As janelas envia a mensagem de WM_INITDIALOG a caixa de diálogo durante chamadas de Criar, de CreateIndirect, ou de DoModal , que ocorrem imediatamente antes da caixa de diálogo é exibida.

Substitua esse método se você deseja executar processamento especial quando a caixa de diálogo é inicializada.Em a versão sobrecarregada, a primeira chamada a classe base OnInitDialog mas ignora o valor de retorno.Você retornará normalmente TRUE de seu método substituído.

O chama a função de OnInitDialog usando um comum global padrão do procedimento da caixa de diálogo para todas as caixas de diálogo de biblioteca de classes da Microsoft foundation.Não chama essa função através do mapa de mensagem, e portanto você não precisa de uma entrada de mapa de mensagem para este método.

Observação
Você não pode substituir esse método quando você usa um objeto de CFileDialog em um programa que foi criado em Windows Vista.Para obter mais informações sobre as alterações a CFileDialog em Windows Vista consulte Classe de CFileDialog.

Exemplo

BOOL CSimpleDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   // TODO: Add extra initialization here
   m_cMyEdit.SetWindowText(_T("My Name")); // Initialize control values
   m_cMyList.ShowWindow(SW_HIDE);      // Show or hide a control, etc.

   return TRUE;  // return TRUE unless you set the focus to a control
   // EXCEPTION: OCX Property Pages should return FALSE
}