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


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

Выделяет пространство для границы, запрашиваемой при вызове IOleInPlaceUIWindow::RequestBorderSpace.

Синтаксис

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Параметры

[in] pborderwidths

Указатель на структуру BORDERWIDTHS, содержащую запрошенную ширину инструментов в пикселях. Он может иметь значение NULL, указывая, что объекту не требуется пробел.

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

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

Код возврата Описание
OLE_E_INVALIDRECT
Прямоугольник не находится в спецификациях, возвращаемых IOleInPlaceUIWindow::GetBorder.

Комментарии

Объект должен вызывать IOleInPlaceUIWindow::SetBorderSpace. Он может выполнять одно из следующих действий:

  • Используйте собственные панели инструментов, запрашивая пространство границ определенного размера.
  • Не используйте панели инструментов, но принудительно удалите свои панели инструментов для контейнера, передав допустимую структуру BORDERWIDTHS , содержащую только нули в параметре pborderwidths .
  • Не используйте панели инструментов, но разрешите контейнеру на месте оставить свои панели инструментов, передав значение NULL в качестве параметра pborderwidths .
Структура BORDERWIDTHS , используемая в этом вызове, обычно была передана в предыдущем вызове IOleInPlaceUIWindow::RequestBorderSpace, который должен возвращать S_OK.

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

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

Требования

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

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

IOleInPlaceUIWindow

IOleInPlaceUIWindow::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace