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

Метод IOleInPlaceUIWindow::GetBorder (oleidl.h)

  • Статья

Извлекает внешний прямоугольник для панелей инструментов и элементов управления, пока объект активен на месте.

Синтаксис

HRESULT GetBorder(
  [out] LPRECT lprectBorder
);

Параметры

[out] lprectBorder

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

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

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

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

Комментарии

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

Функция IOleInPlaceUIWindow::GetBorder при вызове для объекта окна документа или фрейма возвращает внешний прямоугольник (относительно окна), в который объект может поместить панели инструментов или аналогичные элементы управления.

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

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

Требования

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

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

IOleInPlaceUIWindow

IOleInPlaceUIWindow::RequestBorderSpace

IOleInPlaceUIWindow::SetBorderSpace