Функция ExtFloodFill (wingdi.h)

Статья
03/04/2024

Функция ExtFloodFill заполняет область поверхности дисплея текущей кистью.

Синтаксис

BOOL ExtFloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color,
  [in] UINT     type
);

Параметры

[in] hdc

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

[in] x

Координата X в логических единицах точки, с которой начинается заполнение.

[in] y

Координата Y в логических единицах точки начала заполнения.

[in] color

Цвет границы или заполняемой области. Интерпретация цвета зависит от значения параметра fuFillType . Чтобы создать значение цвета COLORREF , используйте макрос RGB .

[in] type

Тип выполняемой операции заполнения. Этот параметр должен иметь одно из следующих значений.

Значение	Значение
FLOODFILLBORDER	Область заливки ограничена цветом, заданным параметром color . Этот стиль идентичен заполнению, выполняемой функцией FloodFill .
FLOODFILLSURFACE	Область заливки определяется цветом, заданным цветом. Заполнение продолжается во всех направлениях до тех пор, пока встречается цвет. Этот стиль полезен для заполнения областей с разноцветными границами.

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

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

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

Не удалось завершить заполнение.
Указанная точка имеет цвет границы, заданный параметром color (если был запрошен FLOODFILLBORDER).
Указанная точка не имеет цвета, указанного цветом (если была запрошена функция FLOODFILLSURFACE).
Точка находится за пределами области отсечения, то есть не видна на устройстве.

Если параметр fuFillType имеет значение FLOODFILLBORDER, система предполагает, что заполняемая область полностью ограничена цветом, заданным параметром color . Функция начинает заполнение в точке, указанной параметрами nXStart и nYStart , и продолжается во всех направлениях, пока не достигнет границы.

Если fuFillType имеет значение FLOODFILLSURFACE, система предполагает, что заполняемая область является одним цветом. Функция начинает заполнять область в точке, указанной nXStart и nYStart , и продолжается во всех направлениях, заполняя все смежные области, содержащие цвет, указанный цветом.

Функцию ExtFloodFill поддерживают только контексты устройств памяти и устройства, поддерживающие операции растрового отображения. Чтобы определить, поддерживает ли устройство эту технологию, используйте функцию GetDeviceCaps .

Примеры

Пример см. в разделе Добавление строк и графиков в меню статьи Использование меню.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll