PSPINFO 結構 （compstui.h）

當 Windows 訊息WM_INITDIALOG時，PSPINFO 結構會作為屬性表頁面對話框程式的輸入參數。 對話框程式的位址是在 dlGPAGE 結構 中指定。

語法

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

成員

cbSize

PSPINFO 結構的 CPSUI 提供大小，以位元組為單位。

wReserved

保留。

hComPropSheet

CPSUI 提供的句柄，其句柄包含在 hCPSUIPage之頁面的父系。

hCPSUIPage

CPSUI 提供給屬性表頁面的句柄。

pfnComPropSheet

CPSUI 提供其 ComPropSheet 函式的指標。

言論

在 CPSUI 呼叫 CreatePropertySheetPage 來建立屬性表頁面之前，它會展開標準 PROPSHEETPAGE 結構的大小，以附加 PSPINFO 結構。 當作系統呼叫對話框程式時（由 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 結構指標可以儲存以供日後使用，但不得修改結構的內容。

要求