Поделиться через


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

Функция 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

См. также раздел

Функции точечных рисунков

Общие сведения о точечных изображениях

COLORREF

FloodFill

GetDeviceCaps

RGB