CDC::SetStretchBltMode

Syntax

int SetStretchBltMode( int nStretchMode );

Parameters

nStretchMode

Specifies the new bitmap-stretching mode. It can be one of the following values:

Value Meaning

BLACKONWHITE Uses the AND operator to combine eliminated lines with the remaining lines. This mode preserves black pixels at the expense of colored or white pixels.
COLORONCOLOR Deletes the eliminated lines. Information in the eliminated lines is not preserved.
WHITEONBLACK Uses the OR operator to combine eliminated lines with the remaining lines. This mode preserves colored or white pixels at the expense of black pixels.

Remarks

Sets the bitmap-stretching mode for StretchBlt. The bitmap-stretching mode defines how information is removed from bitmaps that are compressed by using the function.

The BLACKONWHITE and WHITEONBLACK modes are typically used to preserve foreground pixels in monochrome bitmaps. The COLORONCOLOR mode is typically used to preserve color in color bitmaps.

See Also

CDC::GetStretchBltMode, CDC::StretchBlt, ::SetStretchBltMode