PROPSHEETPAGE 構造体

[アーティクル]
06/13/2023

プロパティシート内のページを定義します。

構文

typedef struct {
    DWORD      dwSize;
    DWORD      dwFlags;
    HINSTANCE  hInstance;
    union {
        LPCSTR                 pszTemplate;
        PROPSHEETPAGE_RESOURCE pResource;
    };
    union {
        HICON  hIcon;
        LPCSTR pszIcon;
    };
    LPCSTR          pszTitle;
    DLGPROC         pfnDlgProc;
    LPARAM          lParam;
    LPFNPSPCALLBACK pfnCallback;
    UINT            *pcRefParent;
    LPCTSTR         pszHeaderTitle;
    LPCTSTR         pszHeaderSubTitle;
    HANDLE          hActCtx;
    union 
    {
        HBITMAP     hbmHeader;
        LPCSTR      pszbmHeader;
    }
} PROPSHEETPAGE, *LPPROPSHEETPAGE;

メンバー

dwSize

型: DWORD

この構造体のサイズ (バイト単位)。

dwFlags

型: DWORD

プロパティシートページの作成時に使用するオプションを示すフラグ。このメンバーは、次の値の組み合わせにすることができます。

値	説明
PSP_DEFAULT	すべての構造体メンバーの既定の意味を使用します。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_DLGINDIRECT	pResource メンバーが指すメモリ内のダイアログボックステンプレートからページを作成します。 PropertySheet 関数は、メモリ内のテンプレートが書き込み保護されていないことを前提としています。読み取り専用テンプレートでは、一部のバージョンの Windows で例外が発生します。
PSP_HASHELP	ページがアクティブなときにプロパティシートの [ヘルプ ] ボタンを有効にします。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_HIDEHEADER	バージョン 5.80 以降。ページを選択すると、ウィザードのプロパティシートでヘッダー領域が非表示になります。透かしが指定されている場合は、ページの左側に塗りつぶされます。このフラグはウェルカムページと入力候補ページに設定し、内部ページでは省略する必要があります。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_PREMATURE	バージョン 4.71 以降。プロパティシートの作成時にページを作成します。このフラグを指定しない場合、ページは最初に選択されるまで作成されません。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_RTLREADING	pszTitle が表示される方向を反転します。通常のウィンドウには、 pszTitle、左から右 (LTR) を含むすべてのテキストが表示されます。右から左 (RTL) を読み取るヘブライ語やアラビア語などの言語の場合は、ウィンドウをミラーリングでき、すべてのテキストが RTL で表示されます。 PSP_RTLREADINGが設定されている場合、 pszTitle は通常の親ウィンドウでは RTL、ミラー化された親ウィンドウでは LTR を読み取ります。
PSP_USECALLBACK	この構造体で定義されているプロパティシートページを作成または破棄するときに、pfnCallback メンバーによって指定された関数を呼び出します。
PSP_USEFUSIONCONTEXT	バージョン 6.0 以降。アクティブ化コンテキストを使用します。アクティブ化コンテキストを使用するには、このフラグを設定し、アクティブ化コンテキストハンドルを hActCtx に割り当てる必要があります。「備考」を参照してください。
PSP_USEHEADERSUBTITLE	バージョン 5.80 以降。 pszHeaderSubTitle メンバーが指す文字列を、Wizard97 ページのヘッダー領域のサブタイトルとして表示します。このフラグを使用するには、関連付けられた PROPSHEETHEADER 構造体の dwFlags メンバーにPSH_WIZARD97 フラグも設定する必要があります。 PSP_HIDEHEADERが設定されている場合、PSP_USEHEADERSUBTITLE フラグは無視されます。 Aero スタイルのウィザードでは、タイトルがクライアント領域の上部付近に表示されます。
PSP_USEHEADERTITLE	バージョン 5.80 以降。 pszHeaderTitle メンバーが指す文字列を、Wizard97 内部ページのヘッダーのタイトルとして表示します。関連付けられた PROPSHEETHEADER 構造体の dwFlags メンバーにPSH_WIZARD97 フラグを設定する必要もあります。 PSP_HIDEHEADERが設定されている場合、PSP_USEHEADERTITLE フラグは無視されます。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_USEHICON	ページのタブの小さなアイコンとして hIcon を使用します。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_USEICONID	pszIcon をアイコンリソースの名前として使用して読み込み、ページのタブの小さなアイコンとして使用します。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。
PSP_USEREFPARENT	この構造体から作成されたプロパティシートページの有効期間中、 pcRefParent メンバーによって指定された参照カウントを保持します。
PSP_USETITLE	ダイアログボックステンプレートに格納されているタイトルではなく、プロパティシートダイアログボックスのタイトルとして pszTitle メンバーを使用します。 Aero スタイルウィザード (PSH_AEROWIZARD) を使用する場合、このフラグはサポートされていません。

hInstance

種類: HINSTANCE

アイコンまたは文字列リソースを読み込むインスタンスを処理します。 pszIcon、pszTitle、pszHeaderTitle、または pszHeaderSubTitle メンバーが読み込むリソースを識別する場合は、hInstance を指定する必要があります。

pszTemplate

種類: LPCSTR

ページの作成に使用するダイアログボックステンプレート。このメンバーは、テンプレートのリソース識別子、またはテンプレートの名前を指定する文字列のアドレスを指定できます。 dwFlags メンバーのPSP_DLGINDIRECT フラグが設定されている場合、pszTemplate は無視されます。このメンバーは、 pResource との共用体として宣言されます。

pResource

種類: LPCDLGTEMPLATE

メモリ内のダイアログボックステンプレートへのポインター。 PropertySheet 関数は、テンプレートが書き込み保護されていないことを前提としています。読み取り専用テンプレートでは、一部のバージョンの Windows で例外が発生します。このメンバーを使用するには、 dwFlags メンバーで PSP_DLGINDIRECT フラグを設定する必要があります。このメンバーは、 pszTemplate との共用体として宣言されます。

hIcon

種類: HICON

ページのタブのアイコンとして使用するアイコンを処理します。 dwFlags メンバーにPSP_USEHICONが含まれていない場合、このメンバーは無視されます。このメンバーは、 pszIcon との共用体として宣言されます。

pszIcon

種類: LPCSTR

ページのタブのアイコンとして使用するアイコンリソース。このメンバーは、アイコンリソースの識別子、またはアイコンリソースの名前を指定する文字列のアドレスを指定できます。このメンバーを使用するには、 dwFlags メンバーで PSP_USEICONID フラグを設定する必要があります。このメンバーは、 hIcon との共用体として宣言されます。

pszTitle

種類: LPCSTR

プロパティシートダイアログボックスのタイトル。このタイトルは、ダイアログボックステンプレートで指定されたタイトルよりも優先されます。このメンバーは、文字列リソースの識別子またはタイトルを指定する文字列のアドレスを指定できます。このメンバーを使用するには、 dwFlags メンバーで PSP_USETITLE フラグを設定する必要があります。

pfnDlgProc

種類: DLGPROC

ページのダイアログボックスプロシージャへのポインター。ページはモードレスダイアログボックスとして作成されるため、ダイアログボックスプロシージャで EndDialog 関数を呼び出してはなりません。

lParam

種類: LPARAM

ページが作成されると、ページの PROPSHEETPAGE 構造体のコピーが、 WM_INITDIALOG メッセージを含むダイアログボックスプロシージャに渡されます。 lParam メンバーを使用すると、アプリケーション固有の情報をダイアログボックスプロシージャに渡すことができます。ページ自体には影響しません。

pfnCallback

型: LPFNPSPCALLBACK

ページが作成され、破棄されるときに呼び出されるアプリケーション定義のコールバック関数へのポインター。コールバック関数の詳細については、「 LPFNPSPCALLBACKA コールバック関数」を参照してください。このメンバーを使用するには、 dwFlags メンバーで PSP_USECALLBACK フラグを設定する必要があります。

pcRefParent

型: UINT*

参照カウント値へのポインター。このメンバーを使用するには、 dwFlags メンバーで PSP_USEREFPARENT フラグを設定する必要があります。

注意

プロパティシートページが作成されると、 pcRefParent が指す値がインクリメントされます。プロパティシートページを暗黙的に作成するには、PROPSHEETHEADER の dwFlags メンバーで PSH_PROPSHEETPAGE フラグを設定し、PropertySheet 関数を呼び出します。これを明示的に行うには、 CreatePropertySheetPage 関数を使用します。プロパティシートページが破棄されると、 pcRefParent メンバーが指す値がデクリメントされます。これは、プロパティシートが破棄されたときに自動的に行われます。 DestroyPropertySheetPage 関数を使用して、プロパティシートページを明示的に破棄できます。

pszHeaderTitle

種類: LPCTSTR

バージョン 5.80 以降。ヘッダー領域のタイトル。 Wizard97 スタイルのウィザードでこのメンバーを使用するには、次の操作も行う必要があります。

dwFlags メンバーでPSP_USEHEADERTITLE フラグを設定します。
ページの PROPSHEETHEADER 構造体の dwFlags メンバーにPSH_WIZARD97 フラグを設定します。
dwFlags メンバーのPSP_HIDEHEADER フラグが設定されていないことを確認します。

pszHeaderSubTitle

種類: LPCTSTR

バージョン 5.80 以降。ヘッダー領域のサブタイトル。このメンバーを使用するには、次の操作を行う必要があります。

dwFlags メンバーでPSP_USEHEADERSUBTITLE フラグを設定します。
ページの PROPSHEETHEADER 構造体の dwFlags メンバーにPSH_WIZARD97 フラグを設定します。
dwFlags メンバーのPSP_HIDEHEADER フラグが設定されていないことを確認します。

注意

Aero スタイルウィザードを使用する場合、このメンバーは無視されます (PSH_AEROWIZARD)

hActCtx

型: HANDLE

バージョン 6.0 以降。アクティブ化コンテキストハンドル。このメンバーを、 CreateActCtx を使用してアクティブ化コンテキストを作成するときに返されるハンドルに設定します。ダイアログボックスを作成する前に、このコンテキストがアクティブ化されます。グローバルマニフェストを使用する場合は、このメンバーを使用する必要はありません。

hbmHeader

種類: HBITMAP

このメンバーは、 pszbmHeader を持つ共用体として宣言されます。

pszbmHeader

種類: LPCSTR

このメンバーは、 hbmHeader との共用体として宣言されます。

解説

バージョン 6 以降Comctl32.dll再頒布可能ではありません。バージョン 6 以降Comctl32.dll使用するには、マニフェストで.dll ファイルを指定します。マニフェストの詳細については、「ビジュアルスタイルの有効化」を参照してください。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ]
ヘッダー	Prsht.h
Unicode 名と ANSI 名	PROPSHEETHEADERW (Unicode) と PROPSHEETHEADERA (ANSI)

次の方法で共有

PROPSHEETPAGE 構造体

構文

メンバー

解説

必要条件

フィードバック

その他のリソース