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