Структура PSPINFO (compstui.h)

  • Статья

Структура PSPINFO используется в качестве входного параметра для процедуры диалогового окна страницы страницы свойств, когда сообщение Windows WM_INITDIALOG. Адрес процедуры диалогового окна указывается в структуре DLGPAGE .

Синтаксис

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

Члены

cbSize

Предоставленный CPSUI размер структуры PSPINFO в байтах.

wReserved

Зарезервировано.

hComPropSheet

Дескриптор, предоставленный CPSUI, для родительского элемента страницы, дескриптор которого содержится в hCPSUIPage.

hCPSUIPage

Предоставленный CPSUI дескриптор на странице страницы свойств.

pfnComPropSheet

Предоставленный CPSUI указатель на функцию ComPropSheet .

Комментарии

Прежде чем CPSUI вызовет CreatePropertySheetPage для создания страницы страницы свойств, он расширяет размер стандартной структуры PROPSHEETPAGE , чтобы добавить структуру PSPINFO . Когда операционная система вызывает процедуру диалогового окна (на которую указывает структура DLGPAGE ) и задает WM_INITDIALOG сообщение, член функции lParam указывает на развернутую структуру PROPSHEETPAGE , содержащую структуру PSPINFO .

Чтобы получить адрес структуры 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)