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

Artículo
08/25/2023

Recupera el tamaño de presentación actual de un objeto en ejecución.

Sintaxis

HRESULT GetExtent(
  [in]  DWORD dwDrawAspect,
  [out] SIZEL *psizel
);

Parámetros

[in] dwDrawAspect

Aspecto del objeto cuyo límite se va a recuperar; el valor se obtiene de las enumeraciones DVASPECT y de DVASPECT2. Tenga en cuenta que los objetos y contenedores más recientes que admiten interfaces de dibujo optimizadas admiten los valores de enumeración DVASPECT2 . Es posible que los objetos y contenedores antiguos que no admiten interfaces de dibujo optimizadas no admitan DVASPECT2. El valor más común para este método es DVASPECT_CONTENT, que especifica una representación completa del objeto dentro de su contenedor.

[out] psizel

Puntero al que se devolverá 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
E_INVALIDARG	El valor dwDrawAspect proporcionado no es válido.

Comentarios

Un contenedor llama a IOleObject::GetExtent en un objeto en ejecución para recuperar su tamaño de presentación actual. Si el contenedor puede acomodar ese tamaño, normalmente lo hará porque el objeto, después de todo, sabe qué tamaño debe ser mejor que el contenedor. Normalmente, un contenedor realiza esta llamada como parte de la inicialización de un objeto .

El tamaño de presentación devuelto por IOleObject::GetExtent puede diferir del último tamaño establecido por IOleObject::SetExtent porque el último método dicta el espacio para mostrar del objeto en el momento en que se llama al método, pero no cambia necesariamente el tamaño nativo del objeto, según lo determinado por su aplicación.

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.

Nota Este método debe devolver el mismo tamaño que DVASPECT_CONTENT para todos los nuevos aspectos de DVASPECT2. IViewObject2::GetExtent debe hacer lo mismo.

Notas a los autores de llamadas

Dado que un contenedor solo puede realizar esta llamada a un objeto en ejecución, el contenedor debe llamar a IViewObject2::GetExtent si desea obtener el tamaño de presentación de un objeto cargado de su memoria caché.

Notas para los implementadores

La implementación consiste en rellenar la estructura sizel con el alto y el ancho de un objeto.

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