IViewObjectEx ::GetRect, méthode (ocidl.h)

Article
02/29/2024

Récupère un rectangle décrivant un aspect de dessin demandé.

Syntaxe

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

Paramètres

[in] dwAspect

Aspect dessin demandé.

[out] pRect

Pointeur vers le rectangle décrivant l’aspect de dessin demandé.

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
DV_E_DVASPECT	La méthode ne prend pas en charge l’aspect spécifié. L’objet ne prend pas en charge l’aspect demandé ou l’aspect n’est pas rectangulaire.

Remarques

Cette méthode retourne un rectangle décrivant l’aspect de dessin spécifié. Le rectangle retourné est en unités HIMETRIC , par rapport à l’origine de l’objet. Le rectangle retourné dépend de l’aspect de dessin comme suit.

Aspect dessin	Description
DVASPECT_CONTENT	Les objets doivent retourner le rectangle englobant de l’objet entier. Le coin supérieur gauche se trouve à l’origine de l’objet et la taille est égale à l’étendue retournée par IViewObject2 ::GetExtent.
DVASPECT_OPAQUE	Les objets avec une zone opaque rectangulaire doivent retourner ce rectangle. D’autres doivent échouer et retourner le code d’erreur DV_E_DVASPECT. Si un rectangle est retourné, il est garanti qu’il sera complètement masqué en appelant IViewObject ::D raw pour cet aspect. Le conteneur doit utiliser ce rectangle pour découper les parties opaques de l’objet avant de dessiner un objet derrière lui pendant le passage de l’arrière à l’avant. Si cette méthode échoue sur un objet avec une zone opaque non rectangulaire, le conteneur doit dessiner l’objet entier dans la partie arrière-avant à l’aide de l’aspect DVASPECT_CONTENT.
DVASPECT_TRANSPARENT	Les objets doivent retourner le rectangle couvrant toutes les parties transparentes ou irrégulières. Si l’objet n’a pas de parties transparentes ou irrégulières, il peut retourner DV_E_ASPECT. Un conteneur peut utiliser ce rectangle pour déterminer s’il existe d’autres objets qui chevauchent les parties transparentes d’un objet donné.

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	ocidl.h

Voir aussi

IViewObjectEx

Partager via