wingdi.h


FillRect

La función FillRect rellena un rectángulo usando el pincel especificado. La función incluye los bordes izquierdo y superior, pero excluye los bordes derecho e inferior del rectángulo.

Sintaxis

int FillRect(
    HDC hDC,          // manipulador del contexto de dispositivo
    CONST RECT *lprc, // dirección de la estructura con el rectángulo
    HBRUSH hbr        // manipulador del pincel
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

lprc: puntero a una estructura RECT que contiene las coordenadas lógicas del rectángulo a rellenar.

hbr: identifica el pincel a usar para rellenar el rectángulo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

El pincel identificado por hbr debe ser un manipulador a un pincel lógico o un valor de color. Si se especifica un manipulador para un pincel lógico, hay que llamar a una de las siguientes funciones para obtener un manipulador: CreateHatchBrush, CreatePatternBrush o CreateSolidBrush. Además, se puede obtener un manipulador a un pincel de stock usando la función GetStockObject. Si se especifica un valor de color para el parámetro hbr, éste debe ser uno de los colores estándar del sistema. (Debe sumarse una unidad al color elegido). Por ejemplo:

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

Para ver una lista de todos los colores estándar del sistema, ver GetSysColor.

Cuando llena el rectángulo especificado, FillRect no incluye los lados derecho e inferior. GDI rellena un rectángulo hasta el límite, pero no incluye la columna derecha y la fila inferior, independientemente el modo de mapeo.