Функция PatBlt окрашивает заданный прямоугольник, используя кисть, которая в текущий момент выбрана в заданный контекст устройства. Цвет кисти и цвет поверхности или цвета объединяются, используя указанную растровую операцию.
Синтаксис
BOOL PatBlt( HDC hdc, // дескриптор контекста устройства (DC) int nXLeft, // x-координата верхнего левого угла прямоугольника int nYLeft, // y-координата верхнего левого угла прямоугольника int nWidth, // ширина прямоугольника int nHeight, // высота прямоугольника DWORD dwRop // код растровой операции ); |
Параметры
hdc
[in] Дескриптор контекста устройства.nXLeft
[in] Устанавливает x-координату, в логических единицах измерения, верхнего левого угла окрашиваемого прямоугольника.nYLeft
[in] Устанавливает y-координату, в логических единицах измерения, верхнего левого угла окрашиваемого прямоугольника.nWidth
[in] Устанавливает ширину, в логических единицах измерения, прямоугольника.nHeight
[in] Устанавливает высоту, в логических единицах измерения, прямоугольника.dwRop
[in] Задает код растровой операции. Этот код может быть одним из ниже перечисленных значений.| Значение | Предназначение |
|---|---|
| PATCOPY | Копирует заданный узор в принимающий точечный рисунок. |
| PATINVERT | Объединяет цвета заданного узора с цветами целевого прямоугольника, используя булев оператор исключающее ИЛИ (XOR). |
| DSTINVERT | Инвертирует целевой прямоугольник. |
| BLACKNESS | Закрашивает целевой прямоугольник, используя цвет, связанный с индексом 0 в физической палитре. (Этот цвет является черным для заданной по умолчанию физической палитры.) |
| WHITENESS | Закрашивает целевой прямоугольник, используя цвет, связанный с индексом 1 в физической палитре. (Этот цвет является белым для заданной по умолчанию физической палитры.) |
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Значения параметра dwRop для этой функции - ограниченное подмножество заполненных 256 троичных кодов растровой операции; в частности, код операции, который обращается к исходному прямоугольнику, не может использоваться.
Не все устройства поддерживают функцию PatBlt. Для получения дополнительной информации, см. описание характеристик RC_BITBLT в функции GetDeviceCaps.
Код примера
Пример смотри в статье Пример создания значков пунктов меню.
Смотри также
Обзор Кисти, Функции, используемые кистями, GetDeviceCaps
|
Размещение и совместимость PatBlt |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Gdi32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |