Функция OleCreatePropertyFrame (olectl.h)

  • Статья
  • Чтение занимает 2 мин

Вызывает новый фрейм свойства, то есть диалоговое окно листа свойств, родительский элемент которого является hwndOwner, где диалоговое окно находится в точке (x,y) в родительском окне и содержит заголовок lpszCaption.

Синтаксис

WINOLECTLAPI OleCreatePropertyFrame(
  [in] HWND      hwndOwner,
  [in] UINT      x,
  [in] UINT      y,
  [in] LPCOLESTR lpszCaption,
  [in] ULONG     cObjects,
  [in] LPUNKNOWN *ppUnk,
  [in] ULONG     cPages,
  [in] LPCLSID   pPageClsID,
  [in] LCID      lcid,
  [in] DWORD     dwReserved,
  [in] LPVOID    pvReserved
);

Параметры

[in] hwndOwner

Дескриптор родительского окна результирующего диалогового окна страницы свойств.

[in] x

Зарезервировано. Горизонтальное положение диалогового окна относительно hwndOwner.

[in] y

Зарезервировано. Положение диалогового окна по вертикали относительно hwndOwner.

[in] lpszCaption

Указатель на строку, используемую для заголовка диалогового окна.

[in] cObjects

Число указателей объектов, переданных в ppUnk.

[in] ppUnk

Массив указателей IUnknown на объекты, для которых вызывается этот лист свойств. Число элементов в массиве задается cObjects. Эти указатели передаются на каждую страницу свойств через IPropertyPage::SetObjects.

[in] cPages

Количество страниц свойств, указанных в pPageCIsID.

[in] pPageClsID

Массив размерных cages , содержащих clSID каждой страницы свойств для отображения на листе свойств.

[in] lcid

Идентификатор языкового стандарта, используемый для страницы свойств. Страницы свойств могут получить этот идентификатор с помощью IPropertyPageSite::GetLocaleID.

[in] dwReserved

Зарезервировано для будущего использования; должно иметь значение нуль.

[in] pvReserved

Зарезервировано для использования в будущем; должен иметь значение NULL.

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

Эта функция поддерживает стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY и E_UNEXPECTED, а также следующие:

Код возврата Описание
S_OK
 Диалоговое окно было выполнено и выполнено успешно.
E_POINTER
 Недопустимый адрес в lpszCaption, ppUnk или pPageCIsID . Например, любой из них может иметь значение NULL.

Комментарии

Отображаемые страницы свойств идентифицируются с помощью pPageClsID, который представляет собой массив значений CLSIDcPages. Объекты, затронутые этим листом свойств, идентифицируются в ppUnk, массиве размеров cObjects , содержащих указатели IUnknown .

Эта функция всегда создает модальное диалоговое окно и не возвращается до закрытия диалогового окна.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header olectl.h
Библиотека OleAut32.lib
DLL OleAut32.dll

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

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID