Функция ExtFloodFill

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

Синтаксис

BOOL ExtFloodFill(
  HDC hdc,          // дескриптор DC
  int nXStart,      // начальная x-координата 
  int nYStart,      // начальная y-координата 
  COLORREF crColor, // цвет заливки
  UINT fuFillType   // тип заливки
);

Параметры

hdc

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

nXStart

[in] Определяет x-координату, в логических единицах, точки, откуда начинается заливка.

nYStart

[in] Определяет y-координату, в логических единицах, точки, откуда начинается заливка.

crColor

[in] Определяет цвет рамки или закрашиваемой области. Интерпретация параметра crColor зависит от значения параметра fuFillType . Чтобы создать код цвета COLORREF, используйте макрокоманду RGB.

fuFillType

[in] Определяет тип операции заливки, которая будет выполнена. Этот параметр должен быть одним из нижеперечисленных значений.

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

Значение

Предназначение

FLOODFILLBORDER

Закрашиваемая область ограничивается цветом, заданным параметром crColor. Этот стиль идентичен заливке, выполненной функцией FloodFill.

FLOODFILLSURFACE

Закрашенная область определяется цветом, который задается crColor. Заливка происходит снаружи во всех направлениях, пока цвет не натолкнется на контур. Этот стиль полезен для заливки областей с разноцветными границами.

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

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

Если функция завершается с ошибкой, величина возвращаемого значения - ноль.

Windows NT/2000/XP: Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError.

Замечания

Ниже перечислены некоторые из причин, по которым эта функция может завершиться ошибкой:

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

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

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

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

Код примера

Пример смотри в статье Добавление меню Линии и Диаграммы.

Смотри также

Обзор Точечные рисунки, Функции, используемые точечными рисунками, FloodFill, GetDeviceCaps, COLORREF, RGB

Размещение и совместимость ExtFloodFill
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Gdi32.lib
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки