Share via

Структура PROPPAGEINFO (ocidl.h)

  • Статья

Содержит параметры, используемые для описания страницы свойств в кадре свойств. Страница свойств заполняет предоставленную вызывающим элементом структуру в методе IPropertyPage::GetPageInfo .

Синтаксис

typedef struct tagPROPPAGEINFO {
  ULONG    cb;
  LPOLESTR pszTitle;
  SIZE     size;
  LPOLESTR pszDocString;
  LPOLESTR pszHelpFile;
  DWORD    dwHelpContext;
} PROPPAGEINFO, *LPPROPPAGEINFO;

Члены

cb

Размер структуры в байтах.

pszTitle

Указатель на OLESTR , содержащий строку, которая отображается на вкладке этой страницы. Строка должна быть выделена с помощью CoTaskMemAlloc. Вызывающий объект IPropertyPage::GetPageInfo отвечает за освобождение памяти с помощью CoTaskMemFree.

size

Обязательные размеры диалогового окна страницы в пикселях.

pszDocString

Указатель на текстовую строку, описывающую страницу, которая может отображаться в диалоговом окне страницы свойств (в текущей реализации кадра это поле не используется). Текст должен быть выделен с помощью CoTaskMemAlloc. Вызывающий объект IPropertyPage::GetPageInfo отвечает за освобождение памяти с помощью CoTaskMemFree.

pszHelpFile

Указатель на OLESTR , содержащий простое имя файла справки, описывающего эту страницу свойств, используемую вместо реализации IPropertyPage::Help. Когда пользователь нажимает "Справка", обычно вызывается метод Help. Если этот метод завершается сбоем, фрейм откроет систему справки с этим файлом справки (с префиксом значение раздела HelpDir в записях реестра страницы свойств в clSID) и укажет системе справки отобразить контекст, описанный в поле dwHelpContext . Путь должен быть выделен с помощью CoTaskMemAlloc. Вызывающий объект IPropertyPage::GetPageInfo отвечает за освобождение памяти с помощью CoTaskMemFree.

dwHelpContext

Идентификатор контекста для раздела справки в файле pszHelpFile , описывающего эту страницу.

Комментарии

Элементы pszTitle, pszDocString и pszHelpFile , указанные в этой структуре, должны содержать текст, чувствительный к языковому стандарту, полученному с помощью IPropertyPageSite::GetLocaleID.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть ocidl.h

См. также раздел

IPropertyPage::GetPageInfo

IPropertyPageSite::GetLocaleID

OLESTR