Fonction SubtractRect (winuser.h)
La fonction SubtractRect détermine les coordonnées d’un rectangle formé en soustrayant un rectangle d’un autre.
Syntaxe
BOOL SubtractRect(
[out] LPRECT lprcDst,
[in] const RECT *lprcSrc1,
[in] const RECT *lprcSrc2
);
Paramètres
[out] lprcDst
Pointeur vers une structure RECT qui reçoit les coordonnées du rectangle déterminées en soustrayant le rectangle pointé par lprcSrc2 du rectangle pointé vers lprcSrc1.
[in] lprcSrc1
Pointeur vers une structure RECT à partir de laquelle la fonction soustrait le rectangle pointé par lprcSrc2.
[in] lprcSrc2
Pointeur vers une structure RECT que la fonction soustrait du rectangle pointé par lprcSrc1.
Valeur retournée
Si le rectangle résultant est vide, la valeur de retour est zéro.
Si le rectangle résultant n’est pas vide, la valeur de retour est différente de zéro.
Remarques
La fonction soustrait uniquement le rectangle spécifié par lprcSrc2 du rectangle spécifié par lprcSrc1 lorsque les rectangles se croisent complètement dans la direction x ou y. Par exemple, si *lprcSrc1 a les coordonnées (10,10,100,100,100) et *lprcSrc2 a les coordonnées (50,50.150.150), la fonction définit les coordonnées du rectangle pointé vers lprcDst sur (10,10.100.100.100). Si *lprcSrc1 a les coordonnées (10,10,100,100,100) et *lprcSrc2 a les coordonnées (50,10,150,150), toutefois, la fonction définit les coordonnées du rectangle pointé vers lprcDst sur (10,10,50,100). En d’autres termes, le rectangle résultant est le cadre englobant de la différence géométrique.
Étant donné que les applications peuvent utiliser des rectangles à des fins différentes, les fonctions rectangle n’utilisent pas d’unité de mesure explicite. Au lieu de cela, toutes les coordonnées et dimensions de rectangle sont données dans des valeurs logiques signées. Le mode de mappage et la fonction dans laquelle le rectangle est utilisé déterminent les unités de mesure.
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 | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |