Fonction SubtractRect (winuser.h)

  • Article

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

Voir aussi

IntersectRect

RECT

Fonctions rectangles

Vue d’ensemble des rectangles

UnionRect