CDC::MaskBlt

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

Index