CDC::MaskBlt
Объединяет данные о цвете для растровых изображений источника и назначения, используя заданную маску растровый операцию и.
BOOL MaskBlt(
int x,
int y,
int nWidth,
int nHeight,
CDC* pSrcDC,
int xSrc,
int ySrc,
CBitmap& maskBitmap,
int xMask,
int yMask,
DWORD dwRop
);
Параметры
x
Указывает логическое верхн- координату по оси x левого угла прямоугольника назначения.y
Указывает логическое верхн- координату по оси y верхнего левого угла прямоугольника назначения.nWidth
Задает ширину (в логических единицах, растрового изображения прямоугольников и источника назначения.nHeight
Указывает высоту в логических единицах, растрового изображения прямоугольников и источника назначения.pSrcDC
Определяет контекст устройства, из которого копируется растровое изображение.Оно должно быть равно нулю, если параметр dwRop растровый, которая определяет операцию, не включающий источник.xSrc
Идентифицирует логический координату по оси x левого угла верхн- растрового изображения источника.ySrc
Идентифицирует логический координату по оси y верхнего левого верхн- растрового изображения источника.maskBitmap
Задает растровое изображение маски монохромного в сочетании с растровым изображением цвета в контексте устройства источника.xMask
Задает горизонтальное смещение растрового изображения в пикселях для маски, заданного параметром maskBitmap.yMask
Определяет вертикальное смещение растрового изображения в пикселях для маски, заданного параметром maskBitmap.dwRop
Определяет коды операций и растровый переднего плана и фона троичные, функция использует для элемента управления источника сочетание и назначения.Код операции растровый фона хранится в высоком байте высокого слова этого значения; код операции низком растровый переднего плана хранится в байте высокого слова этого значения; низкое слово этого значения игнорирован и должно быть равно нулю.Макрос MAKEROP4 создает эти коды операций растровый переднего плана и фона.См. раздел примeчаний обсуждение переднего плана и фона в контексте этой функции.См. раздел BitBlt для функции-члена список стандартных кодов операций растровый.
Возвращаемое значение
Ненулевой если функция успешно; в противном случае – значение 0.
Заметки
Значение 1 в маске указанной maskBitmap указывает, что код операции растровый переднего плана, заданный dwRop должен быть применен в этом расположении.Значение 0 указывает на то, что код операции в маске растровый фона, заданный dwRop должен быть применен в этом расположении.Если операции требуют растровый источника, прямоугольник маски должен охватывать прямоугольник источника.Если нет, то функция завершится ошибкой.Если операции растровый не требуют источника, прямоугольник маски должен охватывать прямоугольник назначения.Если нет, то функция завершится ошибкой.
Если поворот или преобразование ножниц в силе для контекста устройства, то источника если эта функция называется, возникает ошибка.Однако другие типы преобразований разрешены.
Если форматы цвета источника шаблона и растровых изображений назначения отличаются, новообращенные этой функции формат шаблона или источника или и то, и другое, соответствовать формату назначения.Если растровое изображение маски не растрового изображения монохромного, возникает ошибка.Если метафайл улучшенного записывается, возникает ошибка (и функция возвращает значение 0), если контекст устройства источника определяет контекст устройства улучшенный- метафайла.Не все устройства поддерживают MaskBlt.Приложение должно вызвать GetDeviceCaps, чтобы определить, поддерживает ли устройство эту функцию.Если растровое изображение маски не указано, эта функция работает в точности так, как BitBlt, используя код операции растровый переднего плана.Пиксель offsets в сопоставлении растрового изображения маски к точке (0,0) в растровом изображении контекста устройства источника.Это полезно в случаях, в которых растровое изображение маски содержит набор масок; приложение может легко применить один из них в задаче маски - blitting с помощью смещения точки и размеры прямоугольника, отправляемые MaskBlt.
Требования
Header: afxwin.h