Méthode IOleInPlaceSiteWindowless::AdjustRect (ocidl.h)

Ajuste un rectangle spécifié s'il est entièrement ou partiellement couvert par des objets opaques superposés.

Syntaxe

HRESULT AdjustRect(
  [in, out] LPRECT prc
);

Paramètres

[in, out] prc

Rectangle à ajuster.

Valeur retournée

Cette méthode retourne S_OK si le rectangle a été ajusté avec succès ; ce qui signifie que le rectangle n’a pas été entièrement couvert. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
S_FALSE	Le rectangle a été défini avec succès. Remarque : S_FALSE signifie que le rectangle a été complètement couvert. Sa largeur et sa hauteur sont désormais NULL.

Notes

La main’utilisation de cette méthode consiste à ajuster la taille du caret. Un objet prêt à créer un caret doit envoyer le rectangle de caret à son objet de site en appelant cette méthode et en utilisant le rectangle ajusté retourné par celui-ci pour le caret. Si le caret est entièrement masqué, cette méthode retourne S_FALSE et le caret ne doit pas être affiché du tout dans ce cas.

Dans une situation où des objets se chevauchent, cette méthode doit retourner le plus grand rectangle entièrement visible.

Cette méthode peut également être utilisée pour déterminer si un point ou une zone rectangulaire est visible ou masqué par des objets qui se chevauchent.

Spécifications

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

IOleInPlaceSiteWindowless