IViewObject2 ::GetExtent, méthode (oleidl.h)
Récupère la taille de dessin de l’objet de vue spécifié sur l’appareil cible spécifié.
HRESULT GetExtent(
[in] DWORD dwDrawAspect,
[in] LONG lindex,
[in] DVTARGETDEVICE *ptd,
[out] LPSIZEL lpsizel
);
[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.
Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.
Code de retour | Description |
---|---|
|
Un cache approprié n’est pas disponible. |
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.
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.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 |