PROPSHEETHEADERW_V2構造体 (prsht.h)

プロパティ シートのフレームとページを定義します。

構文

typedef struct _PROPSHEETHEADERW_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCWSTR pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCWSTR pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERW_V2, *LPPROPSHEETHEADERW_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

or

#define _WIN32_IE 0x0500 // For version 5.80

ただし、構造体のサイズを使用して初期化する必要があります。 現在定義されている構造体のサイズを使用する場合、アプリケーションは以前のバージョンの Comctl32.dll で実行されない可能性があります。これは、より小さい構造を想定しています。 これには、インターネット エクスプローラー 4.0 以降がインストールされていない Windows 95 または Microsoft Windows NT 4.0 を使用するすべてのシステムが含まれます。 適切な バージョン番号を定義することで、4.71 より前のバージョンの Comctl32.dll でアプリケーションを実行できます。 ただし、新しいバージョンのシステムでもアプリケーションを実行する必要がある場合は、問題が発生する可能性があります。

現在のヘッダー ファイルを使用し、 PROPSHEETHEADER 構造体のサイズを適切に設定することで、すべての Comctl32.dll バージョンとの互換性を維持できます。 構造体を初期化する前に、 DllGetVersion 関数を使用して、システムにインストールされている Comctl32.dll バージョンを確認します。 バージョン 4.71 以降の場合は、

psh.dwSize = sizeof(PROPSHEETHEADER);

dwSize メンバーを初期化します。 以前のバージョンでは、4.71 より前の構造体のサイズは、PROPSHEETHEADER_V1_SIZE定数によって指定されます。 用途

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

PSH_WIZARD、PSH_WIZARD97、およびPSH_WIZARD_LITEのスタイルは相互に互換性がありません。 これらのスタイル フラグの 1 つだけを設定する必要があります。 PSH_AEROWIZARDをPSH_WIZARDと組み合わせる必要があります。

要件