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

Статья
03/09/2024

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

Синтаксис

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Параметры

[in] pborderwidths

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

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

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

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

Используйте собственные панели инструментов, запрашивая пространство границ определенного размера.
Не используйте панели инструментов, но принудительно удалите свои панели инструментов для контейнера, передав допустимую структуру 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