Funzione FillRect (winuser.h)
La funzione FillRect riempie un rettangolo usando il pennello specificato. Questa funzione include i bordi sinistro e superiore, ma esclude i bordi destro e inferiore del rettangolo.
Sintassi
int FillRect(
[in] HDC hDC,
[in] const RECT *lprc,
[in] HBRUSH hbr
);
Parametri
[in] hDC
Handle per il contesto del dispositivo.
[in] lprc
Puntatore a una struttura RECT contenente le coordinate logiche del rettangolo da riempire.
[in] hbr
Handle per il pennello utilizzato per riempire il rettangolo.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Il pennello identificato dal parametro hbr può essere un handle per un pennello logico o un valore di colore. Se si specifica un handle per un pennello logico, chiamare una delle funzioni seguenti per ottenere l'handle: CreateHatchBrush, CreatePatternBrush o CreateSolidBrush. Inoltre, è possibile recuperare un handle in uno dei pennelli di magazzino usando la funzione GetStockObject . Se si specifica un valore di colore per il parametro hbr , deve essere uno dei colori di sistema standard (il valore 1 deve essere aggiunto al colore scelto). Ad esempio:
FillRect(hdc, &rect, (HBRUSH) (COLOR_WINDOW+1));
Per un elenco di tutti i colori di sistema standard, vedere GetSysColor.
Quando si riempie il rettangolo specificato, FillRect non include i lati destro e inferiore del rettangolo. GDI riempie un rettangolo fino a, ma non include, la colonna destra e la riga inferiore, indipendentemente dalla modalità di mapping corrente.
Esempio
Per un esempio, vedere Uso di rettangoli.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-gui-l1-1-0 (introdotto in Windows 8) |