LPFNPSPCALLBACKW

コールバック

シグネチャ

DWORD LPFNPSPCALLBACKW(
    HWND hwnd,
    PSPCB_MESSAGE uMsg,
    PROPSHEETPAGEW* ppsp
);

パラメーター

フィールド

型

説明

hwnd

HWND

予約されています。NULL を指定する必要があります。

uMsg

PSPCB_MESSAGE

アクションフラグ。このパラメーターには次のいずれかの値を指定できます。

値	意味
PSPCB_ADDREF	バージョン 5.80 以降。ページが作成されようとしています。戻り値は使用されません。
PSPCB_CREATE	ページのダイアログボックスが作成されようとしています。作成を許可する場合は 0 以外を、作成させない場合は 0 を返します。
PSPCB_RELEASE	ページが破棄されようとしています。戻り値は無視されます。

ppsp

PROPSHEETPAGEW*

作成または破棄されるページを定義する PROPSHEETPAGE 構造体へのポインター。詳細については「解説」セクションを参照してください。

公式ドキュメント

プロパティシートがページの作成時および破棄される直前に呼び出す、アプリケーション定義のコールバック関数を指定します。アプリケーションはこの関数を使用して、ページの初期化処理およびクリーンアップ処理を実行できます。

戻り値

型: UINT

戻り値は uMsg パラメーターの値によって異なります。

解説(Remarks)

アプリケーションは、PROPSHEETPAGE 構造体を CreatePropertySheetPage 関数に渡す前に、その構造体の pfnCallback メンバーにこのコールバック関数のアドレスを指定する必要があります。

メモこの関数が呼び出される時点で、プロパティシートはページの一覧を操作している最中です。この通知を処理している間に、ページの追加、削除、挿入を試みないでください。行った場合、結果は予測できません。

lParam メンバーを除き、アプリケーションは PROPSHEETPAGE 構造体を変更しないでください。変更した場合、結果は予測できません。lParam メンバーにはアプリケーション定義のデータが格納されており、必要に応じて変更できます。

メモ

prsht.h ヘッダーは LPFNPSPCALLBACK を、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)