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 结构指针可以保存以供以后使用,但不得修改该结构的内容。

要求

要求 价值
标头 compstui.h (包括 Compstui.h)