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

Статья
08/25/2023

Вызывает новый фрейм свойства, то есть диалоговое окно страницы свойств, родительским элементом которого является 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

Массив размеров cPages , содержащий идентификаторы 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