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