CDC::StretchBlt

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

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

Ненулевое значение, если точечный рисунок; в противном случае 0.

Параметры

x

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

y

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

nWidth

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

nHeight

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

pSrcDC

Указывает исходный контекст устройства.

xSrc

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

ySrc

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

nSrcWidth

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

nSrcHeight

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

dwRop

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

Примечания

Копирует растровое изображение в прямоугольник назначения, растяжение или сжатие растрового изображения при необходимости под размеры прямоугольника назначения из исходного прямоугольника. Функция использует протягивая режим контексте устройства назначения (набор 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.

CDC обзорЧлены класса | Иерархическая схема

См. такжеnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::SetStretchBltMode, :: StretchBlt

Index