Método IOleInPlaceActiveObject::ResizeBorder (oleidl.h)

Artículo
03/01/2024

Alerta al objeto que necesita para cambiar el tamaño de su espacio de borde.

Sintaxis

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

Parámetros

[in] prcBorder

Puntero a una estructura RECT que contiene el nuevo rectángulo externo en el que el objeto puede solicitar espacio de borde para sus herramientas.

[in] pUIWindow

Puntero a un puntero de interfaz IOleInPlaceUIWindow para el objeto de ventana de marco o documento cuyo borde ha cambiado.

[in] fFrameWindow

Este parámetro es TRUE si el objeto de ventana de marco llama a IOleInPlaceActiveObject::ResizeBorder; de lo contrario, es FALSE.

Valor devuelto

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

Código devuelto	Descripción
E_INVALIDARG	Los valores de parámetro especificados no son válidos.
E_OUTOFMEMORY	No hay memoria suficiente disponible para la operación.
E_UNEXPECTED	Se ha producido un error inesperado.

Comentarios

Notas a los autores de llamadas

El objeto de ventana de marco o documento del contenedor de nivel superior llama a IOleInPlaceActiveObject::ResizeBorder cuando debe cambiar el espacio de borde asignado al objeto. Dado que el objeto activo en contexto no está informado sobre qué ventana ha cambiado (la ventana de nivel de marco o documento), IOleInPlaceActiveObject::ResizeBorder debe pasarse el puntero a la interfaz IOleInPlaceUIWindow de la ventana.

Notas para los implementadores

En la mayoría de los casos, el cambio de tamaño solo requiere que crezca, reduzca o escale los adornos del marco del objeto. Sin embargo, para adornos más complicados, es posible que tenga que renegociar para el espacio de borde con llamadas a IOleInPlaceUIWindow::SetBorderSpace e IOleInPlaceUIWindow::SetBorderSpace.

Nota Al ejecutar IOleInPlaceActiveObject::ResizeBorder, 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 IOleInPlaceActiveObject::ResizeBorder.

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