CDialog::OnInitDialog

Artículo
02/19/2013

Se llama a este método en respuesta al mensaje de WM_INITDIALOG .

virtual BOOL OnInitDialog( );

Valor devuelto

Especifica si la aplicación ha establecido el foco en uno de los controles en el cuadro de diálogo.Si OnInitDialog devuelve cero, Windows establece el foco en la ubicación predeterminada, el primer control del cuadro de diálogo.La aplicación puede devolver 0 sólo si se ha establecido el foco en uno de los controles en el cuadro de diálogo.

Comentarios

Windows envía el mensaje de WM_INITDIALOG al cuadro de diálogo durante las llamadas de Crear, de CreateIndirect, o de DoModal , que aparecen inmediatamente antes de que se muestra el cuadro de diálogo.

Invalide este método si desea realizar el procesamiento especial cuando inicializa el cuadro de diálogo.En la versión invalidada, llame primero a la clase base OnInitDialog pero omite el valor devuelto.Se devolverá normalmente TRUE de método invalidado.

Windows llama a la función de OnInitDialog mediante el común global estándar de procedimiento del cuadro de diálogo a todos los cuadros de diálogo de la biblioteca Microsoft Foundation Class.No llama a esta función a través del mapa de mensajes, y por consiguiente no necesita un mensaje asignar la entrada para este método.

[!NOTA]

No puede reemplazar este método cuando se usa un objeto de CFileDialog en un programa que se compilará en Windows Vista.Para obtener más información sobre los cambios a CFileDialog en Windows Vista vea Clase CFileDialog.

Ejemplo

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
}