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

PROPSHEETHEADER

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

描述

 

定义属性表的框架和页面。

 

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