FillRect, fonction (winuser.h)

Article
08/27/2023

La fonction FillRect remplit un rectangle à l’aide du pinceau spécifié. Cette fonction inclut les bordures gauche et supérieure, mais exclut les bordures droite et inférieure du rectangle.

Syntaxe

int FillRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

Paramètres

[in] hDC

Handle pour le contexte de l’appareil.

[in] lprc

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

[in] hbr

Poignée du pinceau utilisée pour remplir le rectangle.

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

Le pinceau identifié par le paramètre hbr peut être un handle pour un pinceau logique ou une valeur de couleur. Si vous spécifiez un handle sur un pinceau logique, appelez l’une des fonctions suivantes pour obtenir le handle : CreateHatchBrush, CreatePatternBrush ou CreateSolidBrush. En outre, vous pouvez récupérer une poignée sur l’un des pinceaux boursiers à l’aide de la fonction GetStockObject . Si vous spécifiez une valeur de couleur pour le paramètre hbr , il doit s’agir de l’une des couleurs système standard (la valeur 1 doit être ajoutée à la couleur choisie). Par exemple :


FillRect(hdc, &rect, (HBRUSH) (COLOR_WINDOW+1));

Pour obtenir la liste de toutes les couleurs système standard, consultez GetSysColor.

Lors du remplissage du rectangle spécifié, FillRect n’inclut pas les côtés droit et inférieur du rectangle. GDI remplit un rectangle jusqu’à la colonne de droite et à la ligne inférieure, sans inclure, quel que soit le mode de mappage actuel.

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
Ensemble d’API	ext-ms-win-ntuser-gui-l1-1-0 (introduit dans Windows 8)