WM_INITDIALOG消息

在显示对话框之前立即发送到对话框过程。 对话框过程通常使用此消息来初始化控件并执行影响对话框外观的任何其他初始化任务。

#define WM_INITDIALOG                   0x0110

参数

wParam

用于接收默认键盘焦点的控件的句柄。 仅当对话框过程返回 TRUE 时,系统才分配默认键盘焦点。

lParam

其他初始化数据。 在调用 CreateDialogIndirectParam、CreateDialogParamDialogBoxIndirectParamDialogBoxParam 函数以创建对话框时,此数据作为 lParam 参数传递给系统。 对于属性表,此参数是指向用于创建页面的 PROPSHEETPAGE 结构的指针。 如果使用任何其他对话框创建函数,则此参数为零。

返回值

对话框过程应返回 TRUE 以指示系统将键盘焦点设置为 wParam 指定的控件。 否则,它应返回 FALSE 以防止系统设置默认键盘焦点。

对话框过程应直接返回值。 忽略 SetWindowLong 函数设置的DWL_MSGRESULT值。

备注

接收默认键盘焦点的控件始终是对话框中可见、未禁用且具有 WS_TABSTOP 样式的第一个控件。 当对话框过程返回 TRUE 时,系统会检查控件以确保该过程未禁用它。 如果已禁用,系统会将键盘焦点设置为可见的下一个控件(未禁用)并具有 WS_TABSTOP

仅当应用程序已将键盘焦点设置为对话框的其中一个控件时,应用程序才能返回 FALSE

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Winuser.h (包括 Windows.h)

另请参阅

引用

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

概念性

对话框

其他资源

PROPSHEETPAGE