Метод IOleInPlaceActiveObject::ResizeBorder (oleidl.h)

Статья
08/25/2023

Оповещает объект о том, что ему необходимо изменить размер пространства границ.

Синтаксис

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

Параметры

[in] prcBorder

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

[in] pUIWindow

Указатель на указатель интерфейса IOleInPlaceUIWindow для объекта фрейма или окна документа, граница которого изменилась.

[in] fFrameWindow

Этот параметр имеет значение TRUE , если объект окна фрейма вызывает IOleInPlaceActiveObject::ResizeBorder; в противном случае — FALSE.

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

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

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

IOleInPlaceActiveObject::ResizeBorder вызывается объектом документа или окна фрейма контейнера верхнего уровня, когда пространство границы, выделенное объекту, должно измениться. Так как активный объект на месте не сообщает о том, какое окно изменилось (окно на уровне фрейма или документа), IOleInPlaceActiveObject::ResizeBorder необходимо передать указатель на интерфейс IOleInPlaceUIWindow окна.

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

В большинстве случаев для изменения размера требуется только увеличение, сжатие или масштабирование декоративных элементов рамки объекта. Однако для более сложных украшений может потребоваться повторное согласование пространства границ с помощью вызовов IOleInPlaceUIWindow::SetBorderSpace и IOleInPlaceUIWindow::SetBorderSpace.

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

Требования

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