LPFNPSPCALLBACKA コールバック関数 (prsht.h)

  • [アーティクル]

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

構文

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

パラメーター

hwnd

種類: HWND

予約; は NULL である必要があります。

[in] uMsg

型: UINT

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

値 意味
PSPCB_ADDREF

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

[in, out] ppsp

種類: LPPROPSHEETPAGE

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

戻り値

型: UINT

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

注釈

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

メモ プロパティ シートは、この関数が呼び出されたときにページの一覧を操作する処理中です。 この通知の処理中にページを追加、削除、または挿入しないでください。 これを行うと、予測できない結果になります。
 
lParam メンバーを除き、アプリケーションで PROPSHEETPAGE 構造体を変更しないでください。 これを行うと、予測できない結果になります。 lParam メンバーにはアプリケーション定義データが含まれており、必要に応じて変更できます。

注意

prsht.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LPFNPSPCALLBACK を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー prsht.h