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

  • Статья

Функция PatBlt закрашивает указанный прямоугольник с помощью кисти, выбранной в данный момент в указанном контексте устройства. Цвета кисти и цвета поверхности объединяются с помощью указанной операции растра.

Синтаксис

BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

Параметры

[in] hdc

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

[in] x

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

[in] y

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

[in] w

Ширина прямоугольника в логических единицах.

[in] h

Высота прямоугольника в логических единицах.

[in] rop

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

Значение Значение
PATCOPY
 Копирует указанный шаблон в целевой растровый рисунок.
PATINVERT
 Объединяет цвета указанного узора с цветами прямоугольника назначения с помощью логического оператора XOR.
DSTINVERT
 Инвертирует прямоугольник назначения.
ЧЕРНОТА
 Заполняет прямоугольник назначения, используя цвет, связанный с индексом 0 в физической палитре. (Черный цвет для физической палитры по умолчанию).
БЕЛИЗНЫ
 Заполняет прямоугольник назначения, используя цвет, связанный с индексом 1 в физической палитре. (Белый цвет для физической палитры по умолчанию.)

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

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

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

Комментарии

Значения параметра dwRop для этой функции являются ограниченным подмножеством полных 256 кодов тернарных растровых операций; в частности, нельзя использовать код операции, ссылающийся на исходный прямоугольник.

Не все устройства поддерживают функцию PatBlt . Дополнительные сведения см. в описании возможности RC_BITBLT в функции GetDeviceCaps .

Примеры

Пример см. в разделе "Пример Menu-Item растровых изображений" статьи Использование меню.

Требования

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

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

Функции кисти

Обзор кистей

GetDeviceCaps