структура INSERTPSUIPAGE_INFO (compstui.h)

Статья
02/06/2025

Структура INSERTPSUIPAGE_INFO используется в качестве входного параметра для функции ComPropSheet comPropSheet CPSUI, если код функции CPSFUNC_INSERT_PSUIPAGE. Все значения элементов должны быть предоставлены вызывающим 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.

(Это эквивалентно вызову comPropSheet с кодом функции CPSFUNC_ADD_HPROPSHEETPAGE.)

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI вставляет страницы, описанные структурой COMPROPSHEETUI.

(Это эквивалентно вызову comPropSheet с кодом функции CPSFUNC_ADD_PCOMPROPSHEETUI.)

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI вызывает указанную PFNPROPSHEETUI типизированной функции с значением причины PROPSHEETUI_REASON_INIT.

(Это эквивалентно вызову comPropSheet с кодом функции CPSFUNC_ADD_PFNPROPSHEETUI.)

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI вставляет страницу, описанную указанной структурой PROPSHEETPAGE.

(Это эквивалентно вызову comPropSheet с кодом функции CPSFUNC_ADD_PROPSHEETPAGE.)

Mode

Указанное вызывающее значение, указывающее, где CPSUI должен вставлять новые страницы. Это должно быть одно из следующих значений:

INSPSUIPAGE_MODE_AFTER

CPSUI вставляет страницы после страницы, определяемой дескриптором страницЫ CPSUI, указанной параметром lParam1, чтобы ComPropSheet.

INSPSUIPAGE_MODE_BEFORE

CPSUI вставляет страницы перед страницей, определяемой дескриптором страниц CPSUI, указанным параметром lParam1, чтобы ComPropSheet.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI вставляет страницы в качестве первых дочерних элементов родительской группы, определяемой параметром hComPropSheet, чтобы ComPropSheet.

Параметр lParam1 для ComPropSheet игнорируется.

INSPUIPAGE_MODE_INDEX

CPSUI вставляет страницы в качестве дочерних элементов родительской группы, определяемой параметром hComPropSheet, чтобы ComPropSheet.

Параметр lParam1 для ComPropSheet задает отсчитываемый от нуля индекс, определяющий, где в наборе дочерних элементов необходимо вставить указанные страницы. Если lParam1 равно 0, страницы вставляются начиная с страницы 1; Если lParam1 равно 1, страницы вставляются начиная с страницы 2; и т. д. Если индекс больше числа существующих дочерних элементов, новые страницы добавляются в качестве последних дочерних элементов. Значение lParam1 должно быть указано как HINSPSUIPAGE_INDEX(index).

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI вставляет страницы в качестве последних дочерних элементов родительской группы, определяемой параметром hComPropSheet, чтобы ComPropSheet.

Параметр lParam1 для ComPropSheet игнорируется.

dwData1

См. раздел примечания ниже.

dwData2

См. раздел примечания ниже.

dwData3

См. раздел примечания ниже.

Замечания

Элементы dwData1, dwData2 и dwData3 содержат значения, предоставленные вызывающим пользователем, которые зависят от содержимого элемента типа следующим образом:

Элемент типа содержит PSUIPAGEINSERT_DLL

dwData1 — указатель, предоставленный вызывающим абонентом, на строку, завершающую значение NULL, представляющую имя пути DLL.

dwData2 — указатель, предоставленный вызывающим абонентом, на строку, завершающую значение NULL, представляющую имя типизированной функции PFNPROPSHEETUI, содержащейся в указанной библиотеке DLL.

dwData3 — 32-разрядное значение, предоставленное вызывающим, передается в типизированный параметр PFNPROPSHEETUI для параметра lParam.