Método IViewObject2::GetExtent (oleidl.h)
Recupera el tamaño que el objeto de vista especificado se dibujará en el dispositivo de destino especificado.
Sintaxis
HRESULT GetExtent(
[in] DWORD dwDrawAspect,
[in] LONG lindex,
[in] DVTARGETDEVICE *ptd,
[out] LPSIZEL lpsizel
);
Parámetros
[in] dwDrawAspect
Vista solicitada del objeto cuyo tamaño es de interés. Los valores posibles se toman de las enumeraciones DVASPECT y DVASPECT2 . Tenga en cuenta que los objetos y contenedores más recientes que admiten interfaces de dibujo optimizadas admiten los valores de enumeración de DVASPECT2 . Es posible que los objetos y contenedores antiguos que no admitan interfaces de dibujo optimizadas no admitan DVASPECT2.
[in] lindex
Parte del objeto que es de interés. Actualmente, el único valor posible es -1.
[in] ptd
Puntero a la estructura DVTARGETDEVICE que define el dispositivo de destino para el que se debe devolver el tamaño del objeto.
[out] lpsizel
Puntero a donde se devuelve el tamaño del objeto.
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.
Código devuelto | Descripción |
---|---|
|
No hay disponible una caché adecuada. |
Comentarios
La implementación proporcionada por OLE de IViewObject2::GetExtent busca en la memoria caché el tamaño del objeto de vista.
El método IOleObject::GetExtent de la interfaz IOleObject proporciona parte de la misma información que IViewObject2::GetExtent.
Este método debe devolver el mismo tamaño que DVASPECT_CONTENT para todos los nuevos aspectos de DVASPECT2. IOleObject::GetExtent debe hacer lo mismo.
Si se solicita uno de los nuevos aspectos en dwAspect, este método puede producir un error o devolver el mismo rectángulo que para el aspecto DVASPECT_CONTENT.
Notas a los autores de llamadas
Para evitar que el objeto se ejecute si aún no se está ejecutando, puede llamar a IViewObject2::GetExtent en lugar de IOleObject::GetExtent para determinar el tamaño de la presentación que se va a dibujar.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 |
Archivo DLL | Adhocreportingexcelclient.dll |