Método IOleInPlaceUIWindow::SetBorderSpace (oleidl.h)

  • Artículo

Asigna espacio para el borde solicitado en la llamada a IOleInPlaceUIWindow::RequestBorderSpace.

Sintaxis

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Parámetros

[in] pborderwidths

Puntero a una estructura BORDERWIDTHS que contiene el ancho solicitado de las herramientas, en píxeles. Puede ser NULL, lo que indica que el objeto no necesita ningún espacio.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
OLE_E_INVALIDRECT
 El rectángulo no se encuentra dentro de las especificaciones devueltas por IOleInPlaceUIWindow::GetBorder.

Comentarios

El objeto debe llamar a IOleInPlaceUIWindow::SetBorderSpace. Puede hacer cualquiera de las siguientes acciones:

  • Use sus propias barras de herramientas, solicitando espacio de borde de un tamaño específico.
  • No use barras de herramientas, pero obligue al contenedor a quitar sus barras de herramientas pasando una estructura BORDERWIDTHS válida que contenga nada más que ceros en el parámetro pborderwidths .
  • No use barras de herramientas, pero permita que el contenedor en contexto deje sus barras de herramientas hacia arriba pasando NULL como el parámetro pborderwidths .
La estructura BORDERWIDTHS usada en esta llamada normalmente se habría pasado en una llamada anterior a IOleInPlaceUIWindow::RequestBorderSpace, que debe haber devuelto S_OK.

Si un objeto debe renegociar el espacio en el borde, puede llamar a IOleInPlaceUIWindow::SetBorderSpace de nuevo con los nuevos anchos. Si se produce un error en la llamada a IOleInPlaceUIWindow::SetBorderSpace , el objeto puede realizar una negociación completa para el espacio de borde con llamadas a IOleInPlaceUIWindow::GetBorder, IOleInPlaceUIWindow::RequestBorderSpace e IOleInPlaceUIWindow::SetBorderSpace.

Nota Al ejecutar IOleInPlaceUIWindow::SetBorderSpace, no realice llamadas a las funciones PeekMessage o GetMessage ni a un cuadro de diálogo. Si lo hace, puede provocar que el sistema interbloquee. Hay más restricciones sobre qué métodos y funciones de interfaz OLE se pueden llamar desde IOleInPlaceUIWindow::SetBorderSpace.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleidl.h

Consulte también

IOleInPlaceUIWindow

IOleInPlaceUIWindow::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace