IViewObjectEx ::GetRect, méthode (ocidl.h)
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 |
|---|---|
|
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 |