IViewObject2 ::GetExtent, méthode (oleidl.h)

Article
03/01/2024

Récupère la taille de dessin de l’objet de vue spécifié sur l’appareil cible spécifié.

Syntaxe

HRESULT GetExtent(
  [in]  DWORD          dwDrawAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [out] LPSIZEL        lpsizel
);

Paramètres

[in] dwDrawAspect

Vue demandée de l'objet dont la taille présente un intérêt. Les valeurs possibles sont extraites des énumérations DVASPECT et DVASPECT2 . Notez que les objets et conteneurs plus récents qui prennent en charge les interfaces de dessin optimisées prennent en charge les valeurs d’énumération DVASPECT2 . Les objets et conteneurs plus anciens qui ne prennent pas en charge les interfaces de dessin optimisées peuvent ne pas prendre en charge les DVASPECT2.

[in] lindex

Partie de l’objet qui présente un intérêt. Actuellement, la seule valeur possible est -1.

[in] ptd

Pointeur vers la structure DVTARGETDEVICE définissant l’appareil cible pour lequel la taille de l’objet doit être retournée.

[out] lpsizel

Pointeur vers l’emplacement où la taille de l’objet est retournée.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
OLE_E_BLANK	Un cache approprié n’est pas disponible.

Remarques

L’implémentation fournie par OLE de IViewObject2 ::GetExtent recherche dans le cache la taille de l’objet d’affichage.

La méthode IOleObject ::GetExtent de l’interface IOleObject fournit certaines des mêmes informations que IViewObject2 ::GetExtent.

Cette méthode doit retourner la même taille que DVASPECT_CONTENT pour tous les nouveaux aspects de DVASPECT2. IOleObject ::GetExtent doit faire la même chose.

Si l’un des nouveaux aspects est demandé dans dwAspect, cette méthode peut échouer ou retourner le même rectangle que pour l’aspect DVASPECT_CONTENT.

Remarques aux appelants

Pour empêcher l’exécution de l’objet s’il n’est pas déjà en cours d’exécution, vous pouvez appeler IViewObject2 ::GetExtent plutôt que IOleObject ::GetExtent pour déterminer la taille de la présentation à dessiner.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleidl.h
DLL	Adhocreportingexcelclient.dll