通过

INSERTPSUIPAGE_INFO结构 （compstui.h）

  • 项目

如果函数代码 CPSFUNC_INSERT_PSUIPAGE，INSERTPSUIPAGE_INFO 结构用作 CPSUI ComPropSheet 函数的输入参数。 所有成员值必须由 ComPropSheet 调用方提供。

语法

typedef struct _INSERTPSUIPAGE_INFO {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Mode;
  ULONG_PTR dwData1;
  ULONG_PTR dwData2;
  ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;

成员

cbSize

INSERTPSUIPAGE_INFO结构的调用方提供的大小（以字节为单位）。

Type

调用方提供的整数值，指示请求插入的类型。 该成员可以包含以下常量之一：

PSUIPAGEINSERT_DLL

CPSUI 调用指定的 PFNPROPSHEETUI 类型化函数，其原因值为PROPSHEETUI_REASON_INIT。 该函数包含在单独的 DLL 中。

PSUIPAGEINSERT_GROUP_PARENT

CPSUI 创建新的 组父。

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI 插入通过调用 CreatePropertySheetPage创建的页面。

（这相当于使用函数代码 CPSFUNC_ADD_HPROPSHEETPAGE调用 ComPropSheet。

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI 插入由 COMPROPSHEETUI 结构描述的页面。

（这相当于使用函数代码 CPSFUNC_ADD_PCOMPROPSHEETUI调用 ComPropSheet。

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI 调用指定的 PFNPROPSHEETUI 类型化函数，其原因值为PROPSHEETUI_REASON_INIT。

（这相当于使用函数代码 CPSFUNC_ADD_PFNPROPSHEETUI调用 comPropSheet 。

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI 插入由指定的 PROPSHEETPAGE 结构描述的页面。

（这相当于使用函数代码 CPSFUNC_ADD_PROPSHEETPAGE调用 ComPropSheet。

Mode

调用方提供的值，指示 CPSUI 应插入新页面的位置。 它必须是以下值之一：

INSPSUIPAGE_MODE_AFTER

CPSUI 在由 lParam1 参数指定的 CPSUI 页面句柄标识的页面之后插入页，ComPropSheet。

INSPSUIPAGE_MODE_BEFORE

CPSUI 在由 lParam1 参数指定的 CPSUI 页句柄标识的页面之前插入页，以 ComPropSheet。

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI 将页面作为由 hComPropSheet 参数标识的父组的第一个子级插入到 ComPropSheet。

忽略 ComPropSheet 的 lParam1 参数。

INSPUIPAGE_MODE_INDEX

CPSUI 将页面作为由 hComPropSheet 参数标识的父组的子级插入到 ComPropSheet。

要 ComPropSheet 的 lParam1 参数指定从零开始的索引，该索引标识应在子项集中插入指定的页面。 如果 lParam1 为 0，则从第 1 页开始插入页面;如果 lParam1 为 1，则从第 2 页开始插入页面;等等。 如果索引大于现有子项的数目，则新页将添加为最后一个子级。 lParam1 值必须指定为 HINSPSUIPAGE_INDEX（index）。

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI 将页面作为由 hComPropSheet 参数标识的父组的最后一个子级插入到 ComPropSheet。

忽略 ComPropSheet 的 lParam1 参数。

dwData1

请参阅下面的 备注 部分。

dwData2

请参阅下面的 备注 部分。

dwData3

请参阅下面的 备注 部分。

言论

dwData1、dwData2 和 dwData3 成员包含调用方提供的值，这些值取决于 类型 成员的内容，如下所示：

类型成员包含PSUIPAGEINSERT_DLL

dwData1 - 调用方提供的指向表示 DLL 路径名称的 NULL 终止字符串的指针。

dwData2 - 调用方提供的指向 NULL 终止的字符串的指针，表示指定 DLL 中包含的 PFNPROPSHEETUI 类型化函数的名称。

dwData3 - 调用方提供的 32 位值，传递给其 lParam 参数的 PFNPROPSHEETUI 类型函数。

类型成员包含PSUIPAGEINSERT_GROUP_PARENT

dwData1 - 未使用，必须为零。

dwData2 - 未使用，必须为零。

dwData3 - 未使用，必须为零。

类型成员包含PSUIPAGEINSERT_HPROPSHEETPAGE

dwData1 - 调用方提供的属性表句柄，由 CreatePropertySheetPage返回。

dwData2 - 未使用，必须为零。

dwData3 - 未使用，必须为零。

类型成员包含PSUIPAGEINSERT_PCOMPROPSHEETUI

dwData1 - 调用方提供的指向 COMPROPSHEETUI 结构的指针。

dwData2 - 成功后，接收插入的页数。 失败时，会收到ERR_CPSUI前缀的错误代码。

dwData3 - 未使用，必须为零。

类型成员包含PSUIPAGEINSERT_PFNPROPSHEETUI

dwData1 - 调用方提供的指向 PFNPROPSHEETUI 类型函数的指针。

dwData2 - 调用方提供的 32 位值，传递给 PFNPROPSHEETUI 类型函数的 lParam 参数。

dwData3 - 未使用，必须为零。

类型成员包含PSUIPAGEINSERT_PROPSHEETPAGE

dwData1 - 调用方提供的指向 PROPSHEETPAGE 结构的指针。

dwData2 - 未使用，必须为零。

dwData3 - 未使用，必须为零。

要求

要求 价值
标头 compstui.h （包括 Compstui.h）