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.)

PSUIPAGEINSERT_PFNPROPSHEETUI

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

(这等效于使用函数代码 CPSFUNC_ADD_PFNPROPSHEETUI.) 调用 ComPropSheet

PSUIPAGEINSERT_PROPSHEETPAGE

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

(这等效 于使用函数 代码 CPSFUNC_ADD_PROPSHEETPAGE.)

Mode

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

INSPSUIPAGE_MODE_AFTER

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

INSPSUIPAGE_MODE_BEFORE

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

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 (索引) 。

INSPSUIPAGE_MODE_LAST_CHILD

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

ComPropSheet 的 lParam1 参数将被忽略。

dwData1

请参阅下面的 “备注 ”部分。

dwData2

请参阅下面的 “备注 ”部分。

dwData3

请参阅下面的 “备注 ”部分。

注解

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

类型成员包含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 位值，传递给其 lParam 参数的 PFNPROPSHEETUI 类型函数。

dwData3 - 未使用，必须为零。

类型成员包含PSUIPAGEINSERT_PROPSHEETPAGE

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

dwData2 - 未使用，必须为零。

dwData3 - 未使用，必须为零。

要求

要求 值
Header compstui.h (包括 Compstui.h)