Метод IShellPropSheetExt::AddPages (shobjidl_core.h)

Добавляет одну или несколько страниц на страницу свойств, отображаемую оболочкой для объекта файла. Оболочка вызывает этот метод для каждого обработчика страниц свойств, зарегистрированного в типе файла.

Синтаксис

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

Параметры

[in] pfnAddPage

Тип: LPFNADDPROPSHEETPAGE

Указатель на функцию, вызываемую обработчиком страницы свойств для добавления страницы на лист свойств. Функция принимает дескриптор листа свойств, возвращаемый функцией CreatePropertySheetPage и параметром lParam , переданным этому методу.

[in] lParam

Тип: LPARAM

Данные, относящиеся к обработчику, которые передаются в функцию, на которую указывает pfnAddPage.

Возвращаемое значение

Тип: HRESULT

В случае успешного выполнения возвращает одноуровневый индекс для указания страницы, которая должна отображаться изначально. Дополнительные сведения см. в разделе "Примечания".

Комментарии

Для каждой страницы, которую обработчик страницы свойств должен добавить на лист свойств, обработчик заполняет структуру PROPSHEETPAGE , вызывает функцию CreatePropertySheetPage , а затем вызывает функцию, на которую указывает pfnAddPage.

Тип указателя функции LPFNADDPROPSHEETPAGE определен в Prsht.h, как показано ниже. Он принимает дескриптор структуры PROPSHEETPAGE и определяемых функцией данных через lParam.

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

С помощью реализации можно запросить, чтобы в первую очередь отображалась определенная страница страницы свойств, а не страница по умолчанию. Для этого верните индекс нужной страницы по отношению к добавленным страницам. Например, если вы добавили три страницы свойств, A, B и C, и хотите, чтобы B был выбранной страницей, то возвращаемое значение должно быть равно 2. Обратите внимание, что это возвращаемое значение является только запросом. На странице свойств может по-прежнему отображаться страница по умолчанию.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 4.0 или более поздняя)