Mensaje _ WM INITDIALOG

Se envía al procedimiento del cuadro de diálogo inmediatamente antes de que se muestre un cuadro de diálogo. Los procedimientos de cuadro de diálogo suelen usar este mensaje para inicializar controles y llevar a cabo cualquier otra tarea de inicialización que afecte a la apariencia del cuadro de diálogo.

#define WM_INITDIALOG                   0x0110

Parámetros

wParam

Identificador del control para recibir el foco de teclado predeterminado. El sistema asigna el foco de teclado predeterminado solo si el procedimiento del cuadro de diálogo devuelve TRUE.

lParam

Datos de inicialización adicionales. Estos datos se pasan al sistema como el parámetro lParam en una llamada a la función CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParamo DialogBoxParam utilizada para crear el cuadro de diálogo. Para las hojas de propiedades, este parámetro es un puntero a la estructura PROPSHEETPAGE utilizada para crear la página. Este parámetro es cero si se usa cualquier otra función de creación de cuadro de diálogo.

Valor devuelto

El procedimiento del cuadro de diálogo debe devolver TRUE para dirigir el sistema para establecer el foco del teclado en el control especificado por wParam. De lo contrario, debe devolver FALSE para evitar que el sistema ajuste el foco de teclado predeterminado.

El procedimiento del cuadro de diálogo debe devolver el valor directamente. Se omite el valor _ MSGRESULT de DWL establecido por la función SetWindowLong.

Comentarios

El control para recibir el foco de teclado predeterminado siempre es el primer control del cuadro de diálogo que está visible, no deshabilitado, y que tiene el estilo _ TABSTOP de WS. Cuando el procedimiento del cuadro de diálogo devuelve TRUE, el sistema comprueba el control para asegurarse de que el procedimiento no lo ha deshabilitado. Si se ha deshabilitado, el sistema establece el foco del teclado en el siguiente control que está visible, no deshabilitado, y tiene el _ control TABSTOP de WS.

Una aplicación solo puede devolver FALSE si ha establecido el foco del teclado en uno de los controles del cuadro de diálogo.

Requisitos

Requisito Value
Cliente mínimo compatible
[Solo aplicaciones de escritorio] de Windows 2000 Professional
Servidor mínimo compatible
[Solo aplicaciones de escritorio] de Windows 2000 Server
Encabezado
Winuser.h (incluir Windows.h)

Vea también

Referencia

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

Setfocus

Conceptual

Cuadros de diálogo

Otros recursos

PROPSHEETPAGE