描述
定义属性表中的页面。
C/C++ 语法
#define PROPSHEETPAGEA_V1_FIELDS \ DWORD dwSize; \ DWORD dwFlags; \ HINSTANCE hInstance; \ union \ { \ LPCTSTR pszTemplate; \ PROPSHEETPAGE_RESOURCE pResource; \ } DUMMYUNIONNAME; \ union \ { \ HICON hIcon; \ LPCTSTR pszIcon; \ } DUMMYUNIONNAME2; \ LPCTSTR pszTitle; \ DLGPROC pfnDlgProc; \ LPARAM lParam; \ LPFNPSPCALLBACKA pfnCallback; \ UINT *pcRefParent; \
#define PROPSHEETPAGEW_V1_FIELDS \ DWORD dwSize; \ DWORD dwFlags; \ HINSTANCE hInstance; \ union \ { \ LPCWSTR pszTemplate; \ PROPSHEETPAGE_RESOURCE pResource; \ } DUMMYUNIONNAME; \ union \ { \ HICON hIcon; \ LPCWSTR pszIcon; \ } DUMMYUNIONNAME2; \ LPCWSTR pszTitle; \ DLGPROC pfnDlgProc; \ LPARAM lParam; \ LPFNPSPCALLBACKW pfnCallback; \ UINT *pcRefParent; \
typedef struct _PROPSHEETPAGEA_V1 { PROPSHEETPAGEA_V1_FIELDS } PROPSHEETPAGEA_V1, *LPPROPSHEETPAGEA_V1; typedef const PROPSHEETPAGEA_V1 *LPCPROPSHEETPAGEA_V1;
typedef struct _PROPSHEETPAGEA_V2 { PROPSHEETPAGEA_V1_FIELDS
LPCTSTR pszHeaderTitle; // this is displayed in the header LPCTSTR pszHeaderSubTitle; // } PROPSHEETPAGEA_V2, *LPPROPSHEETPAGEA_V2; typedef const PROPSHEETPAGEA_V2 *LPCPROPSHEETPAGEA_V2;
typedef struct _PROPSHEETPAGEA_V3 { PROPSHEETPAGEA_V1_FIELDS
LPCTSTR pszHeaderTitle; // this is displayed in the header LPCTSTR pszHeaderSubTitle; //
HANDLE hActCtx; } PROPSHEETPAGEA_V3, *LPPROPSHEETPAGEA_V3; typedef const PROPSHEETPAGEA_V3 *LPCPROPSHEETPAGEA_V3; |
PB语法
UNION PROPSHEETPAGE_DUMMYUNIONNAME pszTemplate AS ASCIIZ PTR pResource AS DWORD END UNION
UNION PROPSHEETPAGE_DUMMYUNIONNAME2 hIcon AS DWORD pszIcon AS ASCIIZ PTR END UNION
TYPE PROPSHEETPAGEA_V1_FIELDS dwSize AS DWORD dwFlags AS DWORD hInstance AS DWORD PROPSHEETPAGE_DUMMYUNIONNAME PROPSHEETPAGE_DUMMYUNIONNAME2 pszTitle AS ASCIIZ PTR pfnDlgProc AS DWORD lParam AS LONG pfnCallback AS DWORD pcRefParent AS DWORD PTR END TYPE
TYPE PROPSHEETPAGE_V1 PROPSHEETPAGEA_V1_FIELDS END TYPE
TYPE PROPSHEETPAGE_V2 PROPSHEETPAGEA_V1_FIELDS pszHeaderTitle AS ASCIIZ PTR pszHeaderSubTitle AS ASCIIZ PTR END TYPE
TYPE PROPSHEETPAGE_V3 PROPSHEETPAGEA_V1_FIELDS pszHeaderTitle AS ASCIIZ PTR pszHeaderSubTitle AS ASCIIZ PTR hActCtx AS DWORD END TYPE
UNION PROPSHEETPAGEA_V4_DUMMYUNIONNAME3 hbmHeader AS DWORD pszbmHeader AS ASCIIZ PTR END UNION
TYPE PROPSHEETPAGEA_V4 DWORD PROPSHEETPAGEA_V1_FIELDS pszHeaderTitle AS ASCIIZ PTR pszHeaderSubTitle AS ASCIIZ PTR hActCtx AS DWORD PROPSHEETPAGEA_V4_DUMMYUNIONNAME3 END TYPE
TYPE PROPSHEETPAGEA PROPSHEETPAGEA_V1_FIELDS pszHeaderTitle AS ASCIIZ PTR pszHeaderSubTitle AS ASCIIZ PTR hActCtx AS DWORD END TYPE |
Unicode版本:
UNION PROPSHEETPAGEW_DUMMYUNIONNAME pszTemplate AS WSTRINGZ PTR pResource AS DWORD END UNION
UNION PROPSHEETPAGEW_DUMMYUNIONNAME2 hIcon AS DWORD pszIcon AS WSTRINGZ PTR END UNION
TYPE PROPSHEETPAGEW_V1_FIELDS dwSize AS DWORD dwFlags AS DWORD hInstance AS DWORD PROPSHEETPAGEW_DUMMYUNIONNAME PROPSHEETPAGEW_DUMMYUNIONNAME2 pszTitle AS WSTRINGZ PTR pfnDlgProc AS DWORD lParam AS LONG pfnCallback AS DWORD pcRefParent AS DWORD PTR END TYPE
TYPE PROPSHEETPAGEW_V1 PROPSHEETPAGEW_V1_FIELDS END TYPE
TYPE PROPSHEETPAGEW_V2 PROPSHEETPAGEW_V1_FIELDS pszHeaderTitle AS WSTRINGZ PTR pszHeaderSubTitle AS WSTRINGZ PTR END TYPE
TYPE PROPSHEETPAGEW_V3 PROPSHEETPAGEW_V1_FIELDS pszHeaderTitle AS WSTRINGZ PTR pszHeaderSubTitle AS WSTRINGZ PTR hActCtx AS DWORD END TYPE
UNION PROPSHEETPAGEW_V4_DUMMYUNIONNAME3 hbmHeader AS DWORD pszbmHeader AS WSTRINGZ PTR END UNION
TYPE PROPSHEETPAGEW_V4 PROPSHEETPAGEW_V1_FIELDS pszHeaderTitle AS WSTRINGZ PTR pszHeaderSubTitle AS WSTRINGZ PTR hActCtx AS DWORD PROPSHEETPAGEW_V4_DUMMYUNIONNAME3 END TYPE
TYPE PROPSHEETPAGEW PROPSHEETPAGEW_V1_FIELDS pszHeaderTitle AS WSTRINGZ PTR pszHeaderSubTitle AS WSTRINGZ PTR hActCtx AS DWORD END TYPE |
成员
dwSize
此结构的大小(以字节为单位)。
dwFlags
指示在创建属性表页时使用哪些选项的标志。
PSP_DEFAULT
使用所有结构成员的默认值。
PSP_DLGINDIRECT
从pResource成员指向的内存对话框模板中创建页面。
PSP_HASHELP
当页面处于活动状态时,启用属性表Help按钮。
PSP_HIDEHEADER
版本5.80及以后。
PSP_PREMATURE
版本4.71或更高版本。
PSP_RTLREADING
反转显示pszTitle的方向。
PSP_USECALLBACK
在创建或销毁由此结构定义的属性表页时,调用pfnCallback成员指定的函数。
PSP_USEFUSIONCONTEXT
版本6.0及更高版本。
PSP_USEHEADERSUBTITLE
版本5.80或更高版本。
PSP_USEHEADERTITLE
版本5.80或更高版本。
PSP_USEHICON
使用hIcon作为页面选项卡上的小图标。
PSP_USEICONID
使用pszIcon作为要加载的图标资源的名称,并将其用作页面选项卡上的小图标。
PSP_USEREFPARENT
维护由pcRefParent成员指定的引用计数,用于从此结构创建的属性表页生命周期。
PSP_USETITLE
使用pszTitle成员作为属性表对话框的标题,而不是存储在对话框模板中的标题。
hInstance
处理到加载图标或字符串资源的实例。
pszTemplate
用于创建页面的对话框模板。
pResource
指向内存中的对话框模板。
hIcon
处理图标以用作页面选项卡中的图标。
pszIcon
图标资源用作页面选项卡中的图标。
pszTitle
属性表对话框的标题。
pfnDlgProc
指向页面的对话框过程。
lParam
创建页面时,页面PROPSHEETPAGE结构的副本将传递给具有WM_INITDIALOG消息的对话框过程。
pfnCallback
指向应用程序定义的回调函数,该函数在创建页面时以及即将被销毁时被调用。
pcRefParent
指向引用计数值。
Note 创建属性表页面时,pcRefParent指向的值将递增。
pszHeaderTitle
版本5.80或更高版本。
· | 在dwFlags成员中设置PSP_USEHEADERTITLE标志。 |
· | 在页面PROPSHEETHEADER结构的dwFlags成员中设置PSH_WIZARD97标志。 |
· | 确保dwFlags成员中的PSP_HIDEHEADER标志未设置。 |
pszHeaderSubTitle
版本5.80.
· | 在dwFlags成员中设置PSP_USEHEADERSUBTITLE标志。 |
· | 在页面的PROPSHEETHEADER结构的dwFlags成员中设置PSH_WIZARD97标志。 |
· | 确保dwFlags成员中的PSP_HIDEHEADER标志未设置。 |
Note使用航空风格向导(PSH_AEROWIZARD)时,会忽略此成员。
hActCtx
版本6.0或更高版本。
备注
请注意Comctl32.dll版本6及更高版本不可重新分发,但包含在Windows XP或更高版本中。
最低操作系统
Windows NT 3.51,Windows 95
引用文件 #INCLUDE Once
Prsht.inc