Функция FillRect (winuser.h)

Статья
03/15/2023

Функция FillRect заполняет прямоугольник с помощью указанной кисти. Эта функция включает левую и верхнюю границы, но исключает правую и нижнюю границы прямоугольника.

Синтаксис

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

Параметры

[in] hDC

Дескриптор контекста устройства.

[in] lprc

Указатель на структуру RECT , содержащую логические координаты заполняемого прямоугольника.

[in] hbr

Маркер кисти, используемой для заполнения прямоугольника.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Кисть, определяемая параметром hbr , может быть дескриптором логической кисти или значением цвета. При указании дескриптора для логической кисти вызовите одну из следующих функций, чтобы получить дескриптор: CreateHatchBrush, CreatePatternBrush или CreateSolidBrush. Кроме того, вы можете получить дескриптор одной из кистей акции с помощью функции GetStockObject . Если для параметра hbr указано значение цвета, оно должно быть одним из стандартных системных цветов (значение 1 должно быть добавлено к выбранному цвету). Пример:


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

Список всех стандартных системных цветов см. в разделе GetSysColor.

При заполнении указанного прямоугольника FillRect не включает правую и нижнюю стороны прямоугольника. GDI заполняет прямоугольник вплоть до правого столбца и нижней строки независимо от текущего режима сопоставления.

Примеры

Пример см. в разделе Использование прямоугольников.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-gui-l1-1-0 (появилось в Windows 8)