描述
创建属性表并添加在指定的属性表头结构中定义的页.
FreeBASIC 语法 (Unicode format)
FUNCTION PropertySheetW ( _ BYVAL pshead AS LPCPROPSHEETHEADERW _ ) AS INT_PTR |
参数
pshead |
一个PROPSHEETHEADER结构定义的框架和一个属性页的指针. |
返回值
如果成功,返回正值,否则为模态属性表1.
返回属性表的窗口句柄的非模态属性表.
下列返回值具有特殊含义.
ID_PSREBOOTSYSTEM |
一个页面的属性表的PSM_REBOOTSYSTEM消息发送.必须重新启动计算机以使用户的更改生效. |
ID_PSRESTARTWINDOWS |
一个页面的属性表的PSM_RESTARTWINDOWS消息发送.必须重新启动微软Windows以使用户的更改生效. |
备注
检索扩展错误信息,调用GetLastError.
如果你试图添加超过99页的属性表中,该函数将失败,但没有迹象显示错误的原因：PropertySheet返回值-1,但GetLastError返回0.
Note以下言论仅指巫师不使用航空向导式（PSH_AEROWIZARD）或非巫师的属性表.
默认情况下,该PropertySheet函数创建一个模态对话框.如果该PROPSHEETHEADER结构dwFlags成员指定PSH_MODELESS旗,PropertySheet创建一个非模态对话框并返回它被创建后立即.在这种情况下,PropertySheet的返回值是非模态对话框的窗口句柄.
对于无模式属性表,您的信息回路应使用PSM_ISDIALOGMESSAGE传递消息的属性表对话框.你的消息循环使用PSM_GETCURRENTPAGEHWND确定何时销毁对话框.当用户点击OK或Cancel按钮,PSM_GETCURRENTPAGEHWND返回NULL.然后可以使用DestroyWindow函数销毁对话框.
Version 5.80.的PropertySheet返回值进行模态和非模态属性表不同的信息.在某些情况下,非模态属性表可能需要的信息他们会收到PropertySheet如果他们是模态.特别是,他们需要知道ID_PSREBOOTSYSTEM或ID_PSRESTARTWINDOWS将返回.无模式属性表可以检索一个模态属性表会等到PSM_GETCURRENTPAGEHWND返回NULL然后发送PSM_GETRESULT消息从PropertySheet收到价值.
Unicode编码
作为ANSI和Unicode版本实现.
引用文件
Prsht.bi