PropertySheet函数创建一个属性表,并添加在指定的属性表头结构中定义的页面。
lppsph(
LPCPROPSHEETHEADER 【Returns a positive value if successful or - 1 otherwise.】 | |
); |
参数
【Returns a positive value if successful or - 1 otherwise.】
指向定义属性表的框架和页面的PROPSHEETHEADER结构的指针。
返回值
如果成功则返回正值,否则返回-1。
如果PROPSHEETHEADER结构的dwFlags中成员指定了PSH_MODELESS标志,则成功返回值是属性表对话框的窗口句柄。
以下返回值具有特殊含义:
值 | 含义 |
ID_PSREBOOTSYSTEM | 页面将PSM_REBOOTSYSTEM消息发送到属性表。必须重新启动计算机才能使用户的更改生效。 |
ID_PSRESTARTWINDOWS | 页面将PSM_RESTARTWINDOWS消息发送到属性表。必须重新启动Windows才能使用户的更改生效。 |
备注
默认情况下,PropertySheet创建一个模态对话框。如果PROPSHEETHEADER结构的dwFlags中成员指定了PSH_MODELESS标志,PropertySheet将创建一个无模式对话框,并在创建对话框后立即返回。在这种情况下,PropertySheet返回值是无模式对话框的窗口句柄。
对于无模式属性表,您的消息循环应使用PSM_ISDIALOGMESSAGE将消息传递到属性表对话框。您的消息循环应使用PSM_GETCURRENTPAGEHWND来确定何时销毁该对话框。当用户选择“确定”或“取消”按钮时,PSM_GETCURRENTPAGEHWND返回NULL,然后可以使用DestroyWindow功能来销毁该对话框。
也可以看看
DestroyWindow, PROPSHEETHEADER, PSM_GETCURRENTPAGEHWND, PSM_ISDIALOGMESSAGE, PSM_REBOOTSYSTEM, PSM_RESTARTWINDOWS