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

Article
03/04/2024

Récupère la taille d’affichage actuelle d’un objet en cours d’exécution.

Syntaxe

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

Paramètres

[in] dwDrawAspect

Aspect de l’objet dont la limite doit être récupérée ; la valeur est obtenue à partir des énumérations DVASPECT et de 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 anciens objets et conteneurs qui ne prennent pas en charge les interfaces de dessin optimisées peuvent ne pas prendre en charge les DVASPECT2. La valeur la plus courante pour cette méthode est DVASPECT_CONTENT, qui spécifie un rendu complet de l’objet dans son conteneur.

[out] psizel

Pointeur vers l'emplacement où la taille de l'objet doit être 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
E_INVALIDARG	La valeur dwDrawAspect fournie n’est pas valide.

Remarques

Un conteneur appelle IOleObject ::GetExtent sur un objet en cours d’exécution pour récupérer sa taille d’affichage actuelle. Si le conteneur peut prendre en charge cette taille, il le fera normalement, car l’objet, après tout, sait quelle taille il doit être mieux que le conteneur ne le fait. Un conteneur effectue normalement cet appel dans le cadre de l’initialisation d’un objet.

La taille d’affichage retournée par IOleObject ::GetExtent peut différer de la dernière taille définie par IOleObject ::SetExtent , car cette dernière méthode dicte l’espace d’affichage de l’objet au moment où la méthode est appelée, mais ne modifie pas nécessairement la taille native de l’objet, telle que déterminée par son application.

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.

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

Notes aux appelants

Étant donné qu’un conteneur ne peut effectuer cet appel qu’à un objet en cours d’exécution, celui-ci doit appeler IViewObject2 ::GetExtent s’il souhaite obtenir la taille d’affichage d’un objet chargé à partir de son cache.

Notes aux implémenteurs

L’implémentation consiste à remplir la structure sizel avec la hauteur et la largeur d’un objet.

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