Función FillRect (winuser.h)
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) |