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

Статья
07/16/2024

Вызывает новый фрейм свойства, то есть диалоговое окно листа свойств, родительский элемент которого 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, который является массивом значений cPagesCLSID. Объекты, затронутые этим листом свойств, определяются в ppUnkмассив размера cObjects, содержащий указатели IUnknown.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	olectl.h
библиотеки	OleAut32.lib
DLL	OleAut32.dll

См. также

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID

Поделиться через