描述
定义属性表的框架和页面。
C/C++ 语法
#define PROPSHEETHEADERA_V1_FIELDS \ DWORD dwSize; \ DWORD dwFlags; \ HWND hwndParent; \ HINSTANCE hInstance; \ union \ { \ HICON hIcon; \ LPCTSTR pszIcon; \ } DUMMYUNIONNAME; \ LPCSTR pszCaption; \ UINT nPages; \ union \ { \ UINT nStartPage; \ LPCTSTR pStartPage; \ } DUMMYUNIONNAME2; \ union \ { \ LPCPROPSHEETPAGEA ppsp; \ HPROPSHEETPAGE *phpage; \ } DUMMYUNIONNAME3; \ PFNPROPSHEETCALLBACK pfnCallback;
typedef struct _PROPSHEETHEADERA_V1 { PROPSHEETHEADERA_V1_FIELDS } PROPSHEETHEADERA_V1, *LPPROPSHEETHEADERA_V1; typedef const PROPSHEETHEADERA_V1 *LPCPROPSHEETHEADERA_V1;
#if (_WIN32_IE >= 0x0400) typedef struct _PROPSHEETHEADERA_V2 { PROPSHEETHEADERA_V1_FIELDS union { HBITMAP hbmWatermark; LPCSTR pszbmWatermark; } DUMMYUNIONNAME4; HPALETTE hplWatermark; union { HBITMAP hbmHeader; // Header bitmap shares the palette with watermark LPCSTR pszbmHeader; } DUMMYUNIONNAME5; } PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2; typedef const PROPSHEETHEADERA_V2 *LPCPROPSHEETHEADERA_V2; #endif |
PB语法
UNION PROPSHEETHEADER_DUMMYUNIONNAME hIcon AS DWORD pszIcon AS ASCIIZ PTR END UNION
UNION PROPSHEETHEADER_DUMMYUNIONNAME2 nStartPage AS DWORD pStartPage AS ASCIIZ PTR END UNION
UNION PROPSHEETHEADER_DUMMYUNIONNAME3 ppsp AS PROPSHEETPAGE PTR phpage AS DWORD END UNION
TYPE PROPSHEETHEADERA_V1_FIELDS dwSize AS DWORD dwFlags AS DWORD hwndParent AS DWORD hInstance AS DWORD PROPSHEETHEADER_DUMMYUNIONNAME pszCaption AS ASCIIZ PTR nPages AS DWORD PROPSHEETHEADER_DUMMYUNIONNAME2 PROPSHEETHEADER_DUMMYUNIONNAME3 pfnCallback AS DWORD END TYPE
TYPE PROPSHEETHEADERA_V1 PROPSHEETHEADERA_V1_FIELDS END TYPE
UNION PROPSHEETHEADER_DUMMYUNIONNAME4 hbmWatermark AS DWORD pszbmWatermark AS ASCIIZ PTR END UNION
UNION PROPSHEETHEADER_DUMMYUNIONNAME5 hbmHeader AS DWORD pszbmHeader AS ASCIIZ PTR END UNION
TYPE PROPSHEETHEADERA_V2 PROPSHEETHEADERA_V1_FIELDS PROPSHEETHEADER_DUMMYUNIONNAME4 hplWatermark AS DWORD PROPSHEETHEADER_DUMMYUNIONNAME5 END TYPE
MACRO PROPSHEETHEADERA = PROPSHEETHEADERA_V2 |
Unicode版本:
UNION PROPSHEETHEADERW_DUMMYUNIONNAME hIcon AS DWORD pszIcon AS WSTRINGZ PTR END UNION
UNION PROPSHEETHEADERW_DUMMYUNIONNAME2 nStartPage AS DWORD pStartPage AS WSTRINGZ PTR END UNION
UNION PROPSHEETHEADERW_DUMMYUNIONNAME3 ppsp AS PROPSHEETPAGEW PTR phpage AS DWORD END UNION
TYPE PROPSHEETHEADERW_V1_FIELDS dwSize AS DWORD dwFlags AS DWORD hwndParent AS DWORD hInstance AS DWORD PROPSHEETHEADERW_DUMMYUNIONNAME pszCaption AS WSTRINGZ PTR nPages AS DWORD PROPSHEETHEADERW_DUMMYUNIONNAME2 PROPSHEETHEADERW_DUMMYUNIONNAME3 pfnCallback AS DWORD END TYPE
TYPE PROPSHEETHEADERW_V1 PROPSHEETHEADERW_V1_FIELDS END TYPE
UNION PROPSHEETHEADERW_DUMMYUNIONNAME4 hbmWatermark AS DWORD pszbmWatermark AS WSTRINGZ PTR END UNION
UNION PROPSHEETHEADERW_DUMMYUNIONNAME5 hbmHeader AS DWORD pszbmHeader AS WSTRINGZ PTR END UNION
TYPE PROPSHEETHEADERW_V2 PROPSHEETHEADERW_V1_FIELDS PROPSHEETHEADERW_DUMMYUNIONNAME4 hplWatermark AS DWORD PROPSHEETHEADERW_DUMMYUNIONNAME5 END TYPE
MACRO PROPSHEETHEADERW = PROPSHEETHEADERW_V2 |
成员
dwSize
此结构的大小(以字节为单位)。
dwFlags
指示在创建属性表页时使用哪些选项的标志。
PSH_DEFAULT
使用所有结构成员的默认值。
PSH_AEROWIZARD
版本7.0.
PSH_HASHELP
允许属性页页面显示Help按钮。
PSH_HEADER
版本5.80及以后。
PSH_MODELESS
导致PropertySheet函数将属??性表创建为无模式对话框,而不是作为模态对话框。
PSH_NOAPPLYNOW
删除Apply按钮。
PSH_NOCONTEXTHELP
版本5.80及以后。
PSH_PROPSHEETPAGE
使用ppsp成员并在创建属性表的页面时忽略phpage成员。
PSH_PROPTITLE
在属性表的标题栏中显示标题。
PSH_RESIZABLE
允许用户调整向导大小。
PSH_RTLREADING
反转显示pszCaption的方向。
PSH_STRETCHWATERMARK
在Microsoft Internet Explorer 4.0兼容的Wizard97风格向导中拉伸水印。
Note 此样式标志仅用于为某些应用程序提供向后兼容性。
PSH_USECALLBACK
在初始化此结构定义的属性表时,调用pfnCallback成员指定的函数。
PSH_USEHBMHEADER
版本5.80或更高版本。
PSH_USEHBMWATERMARK
版本5.80或更高版本
PSH_USEHICON
在属性表对话框的标题栏中使用hIcon作为小图标。
PSH_USEHPLWATERMARK
版本5.80或更高版本。
PSH_USEICONID
使用pszIcon作为要加载的图标资源的名称,并将其用作属性表对话框标题栏中的小图标。
PSH_USEPAGELANG
版本5.80或更高版本。
PSH_USEPSTARTPAGE
显示属性表的初始页时,使用pStartPage成员而不是nStartPage成员。
PSH_WATERMARK
版本5.80或更高版本。
PSH_WIZARD
创建向导属性表。
PSH_WIZARD97
版本5.80或更高版本。
PSH_WIZARDCONTEXTHELP
添加一个上下文相关的Help按钮(“?”),通常不在向导的标题栏中。
PSH_WIZARDHASFINISH
始终在向导上显示Finish按钮。
PSH_WIZARD_LITE
版本5.80或更高版本。
hwndParent
处理属性表的所有者窗口。
hInstance
处理到加载图标或标题字符串资源的实例。
hIcon
处理图标以用作属性表对话框标题栏中的小图标。
pszIcon
图标资源用作属性表对话框标题栏中的小图标。
pszCaption
属性表对话框的标题。
nPages
phpage数组中的元素数。
nStartPage
创建属性表对话框时显示的初始页面的基于零的索引。
pStartPage
创建属性表对话框时出现的初始页的名称。
ppsp
指向定义属性表中页面的PROPSHEETPAGE结构数组的指针。
phPage
指向属性表页面的句柄数组。
pfnCallback
指向属性表初始化时调用的应用程序定义回调函数的指针。
hbmWatermark
版本5.80或更高版本。
pszbmWatermark
版本5.80或更高版本。
hplWatermark
版本5.80或更高版本。
hbmHeader
版本5.80或更高版本。
pszbmHeader
版本5.80或更高版本。
备注
如果用户选择诸如“大字体”这样的放大对话框的设置,那么绘制在开始和结束页面上的水印也将被放大。
请注意,这种结构的几个成员仅支持Comctl32.dll 4.71版及更高版本。
但是,您必须初始化其大小的结构。
您可以通过使用当前头文件和适当设置PROPSHEETHEADER结构的大小来保持与所有Comctl32.dll版本兼容。
psh.dwSize = SIZEOF(PROPSHEETHEADER)
初始化dwSize成员。
psh.dwSize = %PROPSHEETHEADER_V1_SIZE
四个向导样式,PSH_WIZARD,PSH_WIZARD97,PSH_WIZARD_LITE和PSH_AEROWIZARD是相互不兼容的。
要将较旧的向导转换为Aero风格向导,请使用以下命令替换现有的向导标志(PSH_WIZARD,PSH_WIZARD97或PSH_WIZARD_LITE)。
%PSH_WIZARD OR %PSH_AEROWIZARD
重建向导后,它将以新样式显示。
最低操作系统
Windows 95, Windows NT 3.1.
引用文件 #INCLUDE Once
Prsht.inc