PROPSHEETHEADERA_V2 結構 (prsht.h)

定義屬性工作表的框架和頁面。

注意

此結構不適合直接在程式碼中使用。 請改用 PROPSHEETHEADER 結構。

語法

typedef struct _PROPSHEETHEADERA_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCSTR  pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCSTR  pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2;

成員

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

類型： HBITMAP

5.80 版或更新版本。 浮水印點陣圖的控制碼。 如果 dwFlags 成員不包含PSH_USEHBMWATERMARK，則會忽略此成員。

DUMMYUNIONNAME4.pszbmWatermark

類型： LPCTSTR

5.80 版或更新版本。 要當做浮水印使用的點陣圖資源。 這個成員可以指定點陣圖資源的識別碼或指定點陣圖資源名稱的字串位址。 如果 dwFlags 成員包含PSH_USEHBMWATERMARK，則會忽略此成員。

hplWatermark

類型： HPALETTE

5.80 版或更新版本。 用於繪製浮水印點陣圖和/或標頭點陣圖的HPALETTE結構。 如果 dwFlags 成員不包含PSH_USEHPLWATERMARK，則會忽略此成員。

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

類型： HBITMAP

5.80 版或更新版本。 標頭點陣圖的控制碼。 如果 dwFlags 成員不包含PSH_USEHBMHEADER，則會忽略此成員。

DUMMYUNIONNAME5.pszbmHeader

類型： LPCSTR

5.80 版或更新版本。 要作為標頭使用的點陣圖資源。 這個成員可以指定點陣圖資源的識別碼或指定點陣圖資源名稱的字串位址。 如果 dwFlags 成員包含PSH_USEHBMHEADER，則會忽略此成員。

備註

如果使用者選擇大型字型之類的設定，這會放大對話方塊，則會放大開始和完成頁面上繪製浮水印。 原始點陣圖的大小和位置會維持不變。 其他區域會填入點陣圖左上角圖元的色彩。

請注意，只有 Comctl32.dll 4.71 版和更新版本才支援此結構的數個成員。 您可以在標頭中包含下列其中一項來啟用這些成員。

#define _WIN32_IE 0x0400 // For version 4.71

或

#define _WIN32_IE 0x0500 // For version 5.80

不過，您必須使用其大小來初始化 結構。 如果您使用目前定義的結構大小，應用程式可能無法與舊版 Comctl32.dll 一起執行，這預期結構較小。 這包括未安裝 Internet Explorer 4.0 或更新版本之 Windows 95 或 Microsoft Windows NT 4.0 的所有系統。 您可以藉由定義適當的 版本號碼，在 4.71 版 Comctl32.dll 上執行您的應用程式。 不過，如果您的應用程式也需要在具有較新版本的系統上執行，這可能會造成問題。

您可以使用目前的標頭檔與所有 Comctl32.dll 版本保持相容，並適當地設定 PROPSHEETHEADER 結構的大小。 在初始化結構之前，請使用 DllGetVersion 函式來判斷系統上已安裝哪些 Comctl32.dll 版本。 如果是 4.71 版或更新版本，請使用

psh.dwSize = sizeof(PROPSHEETHEADER);

表示初始化 dwSize 成員。 對於舊版，PROPSHEETHEADER_V1_SIZE常數會提供 4.71 前結構的大小。 使用

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

PSH_WIZARD、PSH_WIZARD97和PSH_WIZARD_LITE樣式互不相容。 應該只設定其中一個樣式旗標。 PSH_AEROWIZARD應該與PSH_WIZARD結合。

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	prsht.h