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


CDC::StretchBlt

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

BOOL StretchBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   int nSrcWidth,
   int nSrcHeight,
   DWORD dwRop 
);

Параметры

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

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

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

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

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

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

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

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

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

  • dwRop
    Указывает растровый операцию, которую необходимо выполнить.Коды операций определяют способ сочетает цвета GDI растровый в операциях вывода, которые включают текущую кисть, возможно, растровое изображение источника и растровое изображение назначения.Этот параметр может принимать следующие значения:

    • BLACKNESS Включает всю черноту вывода.

    • DSTINVERT Изменяет растровое изображение назначения.

    • MERGECOPY Объединяет шаблон и растровое изображение источника с помощью логического ОПЕРАТОРА and.

    • MERGEPAINT Объединяет обращенное растровое изображение источника с растровым изображением назначения с помощью логического оператора "ИЛИ".

    • Копирует NOTSRCCOPY обращенное растровое изображение источника в назначение.

    • NOTSRCERASE Изменяет результат объединения растровые изображения и источника ИЛИ назначения с помощью логического оператора.

    • Копирует PATCOPY шаблон в растровое изображение назначения.

    • PATINVERT Объединяет растровое изображение назначения с шаблоном с использованием логический оператор исключающего логического сложения.

    • PATPAINT Объединяет обращенное растровое изображение источника с шаблоном с помощью логического оператора "ИЛИ".Объединяет результат этой операции с растровым изображением назначения с помощью логического оператора "ИЛИ".

    • SRCAND Объединяет точки растровых изображений назначения и источника с помощью логического ОПЕРАТОРА and.

    • SRCCOPY Копирует растровое изображение источника в растровое изображение назначения.

    • SRCERASE Изменяет растровое изображение назначения и объединяет результат с растровым изображением источника с помощью логического ОПЕРАТОРА and.

    • SRCINVERT Объединяет точки растровых изображений назначения и источника с помощью логического оператора исключающего логического сложения.

    • SRCPAINT Объединяет точки растровых изображений назначения и источника с помощью логического оператора "ИЛИ".

    • WHITENESS Включает весь вывод белой.

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

Ненулевой если растровое изображение нарисовано; в противном случае – значение 0.

Заметки

Функция использует растянуть режим контекста устройства назначения (набора SetStretchBltMode) для определения того, как растянуть или уменьшена растровое изображение.

Функция StretchBlt перемещает растровое изображение с устройства источника, pSrcDC для устройства назначения, представляемому объектом устройство- контекста функции-члена которого вызова.xSrc, ySrc, nSrcWidth и параметры nSrcHeight определяет угол верхн- левой и измерения прямоугольника источника.X, y, nWidth и параметры nHeight что левый угол верхн- и измерения прямоугольника назначения.Указанная операция dwRop указывает растровый в качестве источника объединяются растровое изображение и биты уже находится на устройстве назначения.

Функция StretchBlt создает зеркальное отображение растрового изображения, если символы nSrcWidth и nWidth или nSrcHeight и параметров nHeight отличаются.Если nSrcWidth и nWidth имеют различные знаки, функция создает зеркальное отображение растрового изображения по оси X.Если nSrcHeight и nHeight имеют различные знаки, функция создает зеркальное отображение растрового изображения по оси Y.

Функция StretchBlt растянет или сжимает растровое изображение источника в памяти и затем копирует результат на месте назначения.Если шаблон объединению с результатом, он не слияния до тех пор, пока растянутое растровое изображение не копируется источника в назначение.Если кисть, выбранную кисть в контексте устройства назначения.Координаты назначения преобразованы в зависимости от контекста устройства назначения; координаты источника преобразованы в зависимости от контекста устройства источника.

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

Если StretchBlt должен преобразовать растровое изображение монохромного для рисования, то оно присвоит белые биты (1) в качестве значения цвет бит цвета фона и черноты (0) на первый план.Чтобы преобразовать цвета к монохромному, оно присвоит точки, которые соответствуют цвету фона к белому (1) и задает все остальные точки, черный (0).Используются цвета фона и переднего плана контекста устройства с цветом.

Не все устройства поддерживают функцию StretchBlt.Чтобы определить, поддерживает ли устройство StretchBlt, вызовите функцию-член GetDeviceCaps с индексом RASTERCAPS и проверяйте возвращаемое значение для RC_STRETCHBLT пометить.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

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

CDC::BitBlt

CDC::GetDeviceCaps

CDC::SetStretchBltMode

StretchBlt