WM_INITDIALOG
The
WM_INITDIALOG message is sent to the dialog box procedure immediately before a
dialog box is displayed. Dialog box procedures typically use this message to
initialize controls and carry out any other initialization tasks that affect
the appearance of the dialog box.
WM_INITDIALOG
hwndFocus = (HWND) wParam; // handle of control to
receive focus
lInitParam = lParam; // initialization parameter
Parameters
hwndFocus
Value of wParam.
Identifies the control to receive the default keyboard focus. Windows assigns
the default keyboard focus only if the dialog box procedure returns TRUE.
lInitParam
Value of lParam.
Specifies additional initialization data. This data is passed to Windows as the
lParamInit parameter in a call to the CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam, or DialogBoxParam function used to create the
dialog box. This parameter is zero if any other dialog box creation function is
used.
Return Values
The dialog
box procedure should return TRUE to direct Windows to set the keyboard focus to
the control given by hwndFocus. Otherwise, it should return FALSE to
prevent Windows from setting the default keyboard focus.
Remarks
The control
to receive the default keyboard focus is always the first control in the dialog
box that is visible, not disabled, and that has the WS_TABSTOP style. When the
dialog box procedure returns TRUE, Windows checks the control to ensure that
the procedure has not disabled it. If it has been disabled, Windows sets the
keyboard focus to the next control that is visible, not disabled, and has the
WS_TABSTOP.
An
application can return FALSE only if it has set the keyboard focus to one of
the controls of the dialog box.
See Also