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

プロパティ シートの作成と初期化時にシステムが呼び出すアプリケーション定義のコールバック関数。

構文

PFNPROPSHEETCALLBACK Pfnpropsheetcallback;

int Pfnpropsheetcallback(
  HWND unnamedParam1,
  UINT unnamedParam2,
  LPARAM unnamedParam3
)
{...}

パラメーター

unnamedParam1

種類: HWND

プロパティ シートへのハンドル。 通常、このパラメーターは hWnd と呼ばれます。

unnamedParam2

型: UINT

受信中のメッセージ。 このパラメーターは通常 uMsg と呼ばれます。

このパラメーターは、次のいずれかの値です。

unnamedParam3

型: LPARAM

メッセージについての追加情報。 このパラメーターは通常 、lParam と呼ばれます。

この値の意味は、 uMsg (unnamedParam2) パラメーターによって異なります。

• uMsg がPSCB_INITIALIZEDまたはPSCB_BUTTONPRESSEDの場合、このパラメーターの値は 0 です。

• uMsg がPSCB_PRECREATE場合、このパラメーターは、プロパティ シート ダイアログ ボックスを記述する DLGTEMPLATE または DLGTEMPLATEEX 構造体へのポインターになります。 構造体のシグネチャをテストして、型を決定します。 シグネチャが 0xFFFF と等しい場合、構造体は拡張ダイアログ テンプレートです。それ以外の場合、構造体は標準のダイアログ テンプレートです。 この方法を次の例に示します。

  if (uMsg == PSCB_PRECREATE) 
  {
       if (lParam)
       {
            DLGTEMPLATE *pDlgTemplate;
            DLGTEMPLATEEX *pDlgTemplateEx;
  
            pDlgTemplateEx = (DLGTEMPLATEEX *)lParam;  
            if (pDlgTemplateEx->signature == 0xFFFF)
            {
                 // pDlgTemplateEx points to an extended  
                 // dialog template structure.
            }
            else
            {
                 // This is a standard dialog template
                 //  structure.
                 pDlgTemplate = (DLGTEMPLATE *)lParam;
            }
       }    
  }
  

戻り値

型: int

ゼロを返します。

解説

PropSheetProc コールバック関数を有効にするには、PropertySheet 関数を呼び出してプロパティ シートを作成するときに PROPSHEETHEADER 構造体を使用します。 pfnCallback メンバーを使用してコールバック関数のアドレスを指定し、dwFlags メンバーに PSP_USECALLBACK フラグを設定します。

PropSheetProc は、アプリケーション定義関数名のプレースホルダーです。 PFNPROPSHEETCALLBACK 型は、PropSheetProc コールバック関数のアドレスです。

要件