PSPINFO 構造体 (compstui.h)

PSPINFO 構造体は、Windows メッセージがWM_INITDIALOGされるときに、プロパティ シート ページのダイアログ ボックス プロシージャへの入力パラメーターとして使用されます。 ダイアログ ボックス プロシージャのアドレスは、 DLGPAGE 構造体で指定します。

構文

typedef struct _PSPINFO {
  WORD            cbSize;
  WORD            wReserved;
  HANDLE          hComPropSheet;
  HANDLE          hCPSUIPage;
  PFNCOMPROPSHEET pfnComPropSheet;
} PSPINFO, *PPSPINFO;

メンバー

cbSize

PSPINFO 構造体の CPSUI 指定のサイズ (バイト単位)。

wReserved

予約済み。

hComPropSheet

hCPSUIPage にハンドルが含まれているページの親に対する CPSUI 提供のハンドル。

hCPSUIPage

プロパティ シート ページへの CPSUI 提供のハンドル。

pfnComPropSheet

CPSUI によって提供される、 ComPropSheet 関数へのポインター。

注釈

CPSUI は CreatePropertySheetPage を呼び出してプロパティ シート ページを作成する前に、PSPINFO 構造体を追加するために標準の PROPSHEETPAGE 構造体のサイズを拡張します。 オペレーティング システムがダイアログ ボックス プロシージャ (DLGPAGE 構造体が指す) を呼び出し、WM_INITDIALOG メッセージを指定すると、関数の lParam メンバーは、PSPINFO 構造体を含む展開された PROPSHEETPAGE 構造体を指します。

PSPINFO 構造体のアドレスを取得するには、次のように PPSPINFO_FROM_WM_INITDIALOG_LPARAM マクロ (compstui.h で定義) を使用します。

PPSPINFO pPspInfo;
if (Msg == WM_INITDIALOG) {
    pPspInfo = PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam);
}

PSPINFO 構造体ポインターは後で使用するために保存できますが、構造体の内容を変更することはできません。

要件

要件	値
Header	compstui.h (Compstui.h を含む)