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é.
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 |
---|---|
|
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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour