Метод IOleInPlaceObject::SetObjectRects (oleidl.h)

Статья
03/13/2024

Указывает, какая часть объекта на месте должна быть видимой.

Синтаксис

HRESULT SetObjectRects(
  [in] LPCRECT lprcPosRect,
  [in] LPCRECT lprcClipRect
);

Параметры

[in] lprcPosRect

Указатель на структуру RECT , содержащую положение объекта на месте, используя клиентские координаты его родительского окна.

[in] lprcClipRect

Указатель на внешний прямоугольник, содержащий прямоугольник положения объекта на месте (lprcPosRect). Этот прямоугольник определяется относительно клиентской области родительского окна объекта.

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

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
E_INVALIDARG	Указанный указатель недопустим.
E_OUTOFMEMORY	Недостаточно доступной памяти для операции.
E_UNEXPECTED	Произошла непредвиденная ошибка.

Примечание При выполнении IOleInPlaceObject::SetObjectRects не выполняйте вызовы функций PeekMessage , GetMessage или диалогового окна. Это может привести к взаимоблокировки системы. Существуют дополнительные ограничения, на которые можно вызывать методы и функции интерфейса OLE из IOleInPlaceObject::SetObjectRects.

Примечания к вызывающим абонентам

Контейнер должен вызывать IOleInPlaceObject::SetObjectRects при изменении положения окна объекта на месте и (или) видимой части объекта на месте.

Примечания для разработчиков

Объект должен иметь размер своего окна на месте в соответствии с пересечением lprcPosRect и lprcClipRect. Объект также должен рисовать свое содержимое в окне объекта на месте, чтобы обеспечить правильную обрезку.

Объект должен сравнивать свою ширину и высоту с теми, которые предоставляются его контейнером (передаются через lprcPosRect). Если сравнение не приводит к совпадению, контейнер применяет масштабирование к объекту . Затем объект должен решить, следует ли продолжить редактирование на месте в режиме масштабирования или масштаба или деактивировать.

Требования

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