FillRect, fonction (winuser.h)
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) |