Compartir a través de

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

  • Artículo

Establece las coordenadas rectangulares de la ventanilla, las barras de desplazamiento y el cuadro de tamaño.

Sintaxis

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

Parámetros

[in] prcView

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

[in] prcHScroll

Puntero a una estructura RECT que contiene las coordenadas de la barra de desplazamiento horizontal.

[in] prcVScroll

Puntero a una estructura RECT que contiene las coordenadas de la barra de desplazamiento vertical.

[in] prcSizeBox

Puntero a una estructura RECT que contiene las coordenadas del cuadro de tamaño.

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.
E_NOTIMPL
 El objeto de documento que posee esta vista no admite rectángulos complejos.

Comentarios

Los marcos de vista que admiten una metáfora de libro, en la que un único documento consta de varias hojas o páginas, normalmente llaman a este método para establecer las coordenadas que se usarán en común en todas las hojas o páginas.

Notas a los autores de llamadas

Llamar a IOleDocumentView::SetRectComplex forma parte de la secuencia de activación normal para objetos de documento que admiten rectángulos complejos, 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::SetRectComplex o IOleDocumentView::SetRect para indicar al objeto de vista que cambie su tamaño a las nuevas dimensiones de ventana.

Notas para los implementadores

Los objetos de documento que admiten rectángulos complejos se marcan con DOCMISC_SUPPORTCOMPLEXRECTANGLES, como se describe en DOCMISC e IOleDocument::GetDocMiscStatus. Los objetos de documento que no admiten este método pueden devolver E_NOTIMPL.

Al recibir una llamada a este método, una vista debe cambiar su tamaño para ajustarse a las coordenadas especificadas en prcView y ajustar sus barras de desplazamiento y cuadro de tamaño a las áreas descritas en prcHScroll, prcVScroll y prcSizeBox.

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

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

IOleDocument::GetDocMiscStatus

IOleDocumentView