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

Recupera el rectángulo externo de las barras de herramientas y los controles mientras el objeto está activo en su lugar.

Sintaxis

HRESULT GetBorder(
  [out] LPRECT lprectBorder
);

Parámetros

[out] lprectBorder

Puntero a una estructura RECT donde se va a devolver el rectángulo externo. Las coordenadas de la estructura son relativas a la ventana representada por la interfaz .

Valor devuelto

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

Código devuelto	Descripción
INPLACE_E_NOTOOLSPACE	El objeto no puede instalar barras de herramientas en este objeto de ventana.
E_OUTOFMEMORY	Memoria insuficiente disponible para esta operación.
E_UNEXPECTED	Se produjo un error inesperado.

Comentarios

Notas a los autores de llamadas

La función IOleInPlaceUIWindow::GetBorder , cuando se llama en un objeto de ventana de documento o marco, devuelve el rectángulo externo (relativo a la ventana) donde el objeto puede colocar barras de herramientas o controles similares.

Si el objeto va a instalar estas herramientas, debe negociar espacio para las herramientas de este rectángulo mediante IOleInPlaceUIWindow::RequestBorderSpace y, a continuación, llamar a IOleInPlaceUIWindow::SetBorderSpace para obtener este espacio asignado.

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

 

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::RequestBorderSpace

IOleInPlaceUIWindow::SetBorderSpace