Método IViewObject2::GetExtent (oleidl.h)

Artículo
03/15/2023

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