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

Vedi anche

CreateHatchBrush

CreatePatternBrush

CreateSolidBrush

Funzioni di forma riempite

Cenni preliminari sulle forme riempite

GetStockObject

RECT