Función FillRect (winuser.h)

Artículo
03/15/2023

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

Sintaxis

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

Parámetros

[in] hDC

Identificador del contexto del dispositivo.

[in] lprc

Puntero a una estructura RECT que contiene las coordenadas lógicas del rectángulo que se va a rellenar.

[in] hbr

Identificador del pincel usado para rellenar el rectángulo.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

El pincel identificado por el parámetro hbr puede ser un identificador de un pincel lógico o un valor de color. Si especifica un identificador en un pincel lógico, llame a una de las siguientes funciones para obtener el identificador: CreateHatchBrush, CreatePatternBrush o CreateSolidBrush. Además, puede recuperar un identificador a uno de los pinceles de stock mediante la función GetStockObject . Si especifica un valor de color para el parámetro hbr , debe ser uno de los colores del sistema estándar (el valor 1 debe agregarse al color elegido). Por ejemplo:


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

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

Al rellenar el rectángulo especificado, FillRect no incluye los lados derecho e inferior del rectángulo. GDI rellena un rectángulo hasta, pero no incluye, la columna derecha y la fila inferior, independientemente del modo de asignación actual.

Ejemplos

Para obtener un ejemplo, vea Uso de rectángulos.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-gui-l1-1-0 (introducido en Windows 8)