mensaje de 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, DialogBoxIndirectParam o DialogBoxParam usadas 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 cuadros 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 establezca el foco de teclado predeterminado.

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

Comentarios

El control para recibir el foco de teclado predeterminado es siempre el primer control del cuadro de diálogo que está visible, no deshabilitado y que tiene el estilo WS_TABSTOP . 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 visible, no deshabilitado y tiene la WS_TABSTOP.

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
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluir Windows.h)

Vea también

Referencia

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

Setfocus

Conceptual

Cuadros de diálogo

Otros recursos

PROPSHEETPAGE