Поделиться через


CDC::PlgBlt

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

BOOL PlgBlt( 
   LPPOINT lpPoint, 
   CDC* pSrcDC, 
   int xSrc, 
   int ySrc, 
   int nWidth, 
   int nHeight, 
   CBitmap& maskBitmap, 
   int xMask, 
   int yMask  
);

Параметры

  • lpPoint
    Указывает на массив 3 точек в логические области, которая определяет угол параллелограмма 3. Угол верхн- левой стороны прямоугольника источника сопоставить с первой точки в этом массиве, верхн- правому углу на второй точки в этом массиве и нижнего левого угла к третьему точки. Низк- правый угол прямоугольника источника сопоставлен с подразумеваемому четвертому позицию параллелограмме.

  • pSrcDC
    Определяет контекст устройства источника.

  • xSrc
    Указывает координату по оси x (в логических единицах, угла верхн- левой стороны прямоугольника источника.

  • ySrc
    Указывает координату по оси y (в логических единицах, угла верхн- левой стороны прямоугольника источника.

  • nWidth
    Задает ширину (в логических единицах, прямоугольника источника.

  • nHeight
    Указывает высоту в логических единицах, прямоугольника источника.

  • maskBitmap
    Определяет необязательное растровое изображение монохромного, который используется, чтобы замаскировать цвет прямоугольника источника.

  • xMask
    Указывает координату по оси x левого угла верхн- растрового изображения монохромного.

  • yMask
    Указывает координату по оси y верхнего левого верхн- растрового изображения монохромного.

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

Ненулевой если функция успешно; в противном случае – значение 0.

Заметки

Если заданный дескриптор битовой маски определяет допустимое растровое изображение монохромного, функция использует это растровое изображение, чтобы замаскировать биты данных о цвете из прямоугольника источника.

Четвертая вершина параллелограмма (D) определяется путем обработки первые 3 пункта (a, B и c) в качестве D векторов и вычисления = б + c - A.

Если битовая маска существует, то значение 1 указывает на то, что в маске цвет пикселя источника должен быть скопированы в месте назначения. В маске значение 0 указывает на то, что цвет пикселя назначения не быть изменен.

Если прямоугольник маски меньше, чем прямоугольники источника и назначения, то функция копирует шаблон маски.

Масштабирование, преобразование и преобразования отражения разрешены в контексте устройства источника; однако вращения и преобразования ножниц нет. Если растровое изображение маски не растрового изображения монохромного, возникает ошибка. Растянуть режим контекста устройства назначения используется для задания способа растянуть или уменьшена точек, если это необходимо. Если метафайл, улучшенная записывается ошибка возникает, если контекст устройства источника определяет контекст устройства улучшенный- метафайла.

Координаты назначения преобразованы в зависимости от контекста устройства назначения; координаты источника преобразованы в зависимости от контекста устройства источника. Если преобразование источника имеет поворот или ножницы, возвращается ошибка. Если прямоугольники назначения и источника не имеют одинаковый цветовой формат, PlgBlt преобразует прямоугольник источника для сопоставления прямоугольник назначения. Не все устройства поддерживают PlgBlt. Дополнительные сведения см. в описании функции RC_BITBLT растровый в функции-члене CDC::GetDeviceCaps.

Если контексты устройства источника и назначения представляют несовместимые устройства, то PlgBlt возвращает ошибку.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CDC::BitBlt

CDC::GetDeviceCaps

CDC::MaskBlt

CDC::StretchBlt

SetStretchBltMode

PlgBlt