Método IOleDocumentView::SetRect (docobj.h)

Establece las coordenadas rectangulares de la ventanilla en la que se va a activar o restablece las coordenadas de la ventanilla en la que se activa actualmente una vista.

Sintaxis

HRESULT SetRect(
  [in] LPRECT prcView
);

Parámetros

[in] prcView

Puntero a una estructura RECT que contiene las coordenadas de la ventanilla.

Valor devuelto

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

Código devuelto	Descripción
E_FAIL	Error en la operación.

Comentarios

Para una sola aplicación de interfaz de documento (SDI), la ventanilla es el área cliente de la ventana de marco menos el espacio asignado para las barras de herramientas, la barra de estado y tal. Para una ventana de interfaz de varios documentos (MDI), la ventanilla es el área cliente de la ventana del documento MDI menos cualquier otro elemento de interfaz de usuario de nivel de marco.

Notas a los autores de llamadas

Llamar a IOleDocumentView::SetRect o IOleDocumentView::SetRectComplex forma parte de la secuencia de activación normal para objetos de documento, normalmente siguiendo una llamada a IOleDocumentView::UIActivate y antes de una llamada a IOleDocumentView::Show.

Cada vez que se cambia el tamaño de la ventana utilizada para mostrar un objeto de documento, el contenedor debe llamar a IOleDocumentView::SetRect (o IOleDocumentView::SetRectComplex) para indicar al objeto de vista de documento que cambie su tamaño a las nuevas dimensiones de ventana.

Notas para los implementadores

Las coordenadas de la ventanilla están dentro de las coordenadas de la ventana de vista, que se obtiene a través de IOleWindow::GetWindow. La vista debe cambiar su tamaño para ajustarse a las nuevas coordenadas pasadas en prcView.

Este método se define con el atributo [input_sync], lo que significa que el objeto de vista no puede producir ni realizar otra llamada RPC que no sea input_sync mientras se ejecuta este método.

Una vista de documento debe implementar este método completamente; E_NOTIMPL no es un valor devuelto aceptable.

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	docobj.h

Consulte también

IOleDocumentView