Compartir a través de


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

Consulte también

DVASPECT

DVASPECT2

IOleObject::GetExtent

IViewObject

IViewObject2