Fonction OffsetRect (winuser.h)

Article
08/27/2023

La fonction OffsetRect déplace le rectangle spécifié en fonction des décalages spécifiés.

Syntaxe

BOOL OffsetRect(
  [in, out] LPRECT lprc,
  [in]      int    dx,
  [in]      int    dy
);

Paramètres

[in, out] lprc

Pointeur vers une structure RECT qui contient les coordonnées logiques du rectangle à déplacer.

[in] dx

Spécifie la quantité à déplacer le rectangle vers la gauche ou la droite. Ce paramètre doit être une valeur négative pour déplacer le rectangle vers la gauche.

[in] dy

Spécifie la quantité à déplacer le rectangle vers le haut ou vers le bas. Ce paramètre doit être une valeur négative pour déplacer le rectangle vers le haut.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

É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