Compartilhar via


CDialog::OnInitDialog

Esse método é chamado em resposta à WM_INITDIALOG mensagem.

virtual BOOL OnInitDialog( );

Valor de retorno

Especifica se o aplicativo tem conjunto o foco de entrada para um dos controles na caixa de diálogo.If OnInitDialog Retorna diferente de zero, Windows define o foco de entrada para o localização padrão, o primeiro controle na caixa de diálogo. O aplicativo pode retornar a 0 somente se ele tiver explicitamente conjunto o foco de entrada para um dos controles na caixa de diálogo.

Comentários

O Windows envia o WM_INITDIALOG mensagem para a caixa de diálogo durante a Criar, CreateIndirect, or DoModal chamadas, que ocorrem imediatamente antes que a caixa de diálogo é exibida.

Ignore este método se desejar executar processamento especial quando a caixa de diálogo é inicializada.Na versão substituída, primeiro telefonar a classe base OnInitDialog mas seu valor retornado de ignorar. Normalmente, você retornará TRUE do seu método substituído.

Windows chama o OnInitDialog função usando o procedimento de caixa de diálogo global padrão comuns a todas as caixas de diálogo biblioteca Microsoft Foundation classe. Não chama esta função por meio de MAP da mensagem e, portanto, você não precisa uma entrada de MAP da mensagem para este método.

Observação:

Você não pode substituir esse método quando você usa um CFileDialog objeto em um programa é compilado em Windows Vista. Para obter mais informações sobre alterações em CFileDialog em Windows Vista Consulte Classe 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
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDialog

Gráfico de hierarquia

CDialog::criar

CDialog::CreateIndirect

WM_INITDIALOG

Outros recursos

Membros CDialog