int SetStretchBltMode( int nStretchMode );

Возвращаемое значение
Предыдущий режим растяжения. Это может быть STRETCH_ANDSCANS, STRETCH_DELETESCANS, или STRETCH_ORSCANS.

Параметры
nStretchMode
Определяет режим растяжения. Это может быть любое из следующих значений:

• BLACKONWHITE - Выполняет булеву операцию AND, использующуя цветные значения удаленнния существующих пикселей. Если точечный рисунок - одноцветный точечный рисунок, этот режим сохраняет черные пиксели за счет белых пикселей.
• COLORONCOLOR - Удаляет пиксели. Этот режим удаляет все удаленные линии пикселей без того, чтобы пробовать сохранять их информацию.
• HALFTONE - Отображает пиксели из исходного прямоугольника в блоки пикселей в прямоугольнике адресата. Средний цвет над блоком адресата пикселей аппроксимирует цвет исходных пикселей. После установки режима протяжения HALFTONE, прикладная программа должна вызвать функцию Win32::SetBrushOrgEx, чтобы установить стиль исходной кисти. Если это терпит неудачу, нарушение границ кисти происходит.
• STRETCH_ANDSCANS - Windows 95: Тот же самый как BLACKONWHITE.
• STRETCH_DELETESCANS - Windows 95: Тот же самый как COLORONCOLOR.
• STRETCH_HALFTONE - Windows 95: Тот же самый как HALFTONE.
• STRETCH_ORSCANS - Windows 95: Тот же самый как WHITEONBLACK.
• WHITEONBLACK - Выполняет Булеву операцию OR, использующую цветные значения для удаленных и существующих пикселей. Если точечный рисунок - одноцветный точечный рисунок, этот режим сохраняет белые пиксели за счет черных пикселей.

Замечания
Устанавливает режим растяжения точечных рисунков для StretchBlt функции. Режим растяжения точечных рисунков определяет, как информация удалена из точечных рисунков, которые сжаты, используя функцию.
BLACKONWHITE (STRETCH_ANDSCANS) и WHITEONBLACK (STRETCH_ORSCANS) режимы обычно используются, чтобы сохранить приоритетные пиксели в одноцветных точечных рисунках. COLORONCOLOR (STRETCH_DELETESCANS) режим обычно используется, чтобы сохранить цвет в цвете точечные рисунки.
HALFTONE режим требует большего количества обработки исходного изображения чем другие три режима, это медленнее чем другие, но производит более высокие качественные изображения. Также обратите внимание, что SetBrushOrgEx должен быть вызван после установки HALFTONE режима, чтобы избежать нарушения границ кисти. Дополнительные режимы растяжения могли бы также быть доступны в зависимости от возможностей драйвера устройства.