导航:  Windows Controls Wrapper Functions > Property Sheet Control > Structures >

PROPSHEETPAGE

上一页返回章节概述下一页

描述

 

定义属性表中的页面。

 

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