PtInRect, fonction (winuser.h)

Article
08/27/2023

La fonction PtInRect détermine si le point spécifié se trouve dans le rectangle spécifié. Un point se trouve dans un rectangle s’il se trouve sur le côté gauche ou supérieur ou dans les quatre côtés. Un point sur le côté droit ou inférieur est considéré en dehors du rectangle.

Syntaxe

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

Paramètres

[in] lprc

Pointeur vers une structure RECT qui contient le rectangle spécifié.

[in] pt

Structure POINT qui contient le point spécifié.

Valeur retournée

Si le point spécifié se trouve dans le rectangle, la valeur de retour est différente de zéro.

Si le point spécifié ne se trouve pas dans le rectangle, la valeur de retour est zéro.

Remarques

Le rectangle doit être normalisé avant l’appel de PtInRect . Autrement dit, lprc.right doit être supérieur à lprc.left et lprc.bottom doit être supérieur à lprc.top. Si le rectangle n’est pas normalisé, un point n’est jamais pris en compte à l’intérieur du rectangle.

É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.

Exemples

Pour obtenir un exemple, consultez Utilisation de rectangles.

Configuration requise


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