WM _ INITDIALOG 消息

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

#define WM_INITDIALOG                   0x0110

参数

wParam

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

lParam

其他初始化数据。 在调用用于创建对话框的 CreateDialogIndirectParamCreateDialogParamDialogBoxIndirectParamDialogBoxParam函数时,此数据将作为 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