SetStretchBltMode

Syntax

int SetStretchBltMode(hDC,nStretchMode)

This function sets the stretching mode for the StretchBlt function. The stretching mode defines which scan lines and/or columns StretchBlt eliminates when contracting a bitmap.

Parameter Type/Description  

hDC HDC Identifies the device context.  
nStretchMode int Specifies the new stretching mode. It can be one of the following values:  
  Value Meaning
  BLACKONWHITE AND in the eliminated lines. This mode preserves black pixels at the expense of white pixels by using the AND operator on the eliminated lines and those remaining.
  COLORONCOLOR Deletes the eliminated lines. This mode deletes all eliminated lines without trying to preserve their information.
  WHITEONBLACK OR in the eliminated lines. This mode preserves white pixels at the expense of black pixels by using the OR operator on the lines to be eliminated and the remaining lines.
  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.  

Return Value

The return value specifies the previous stretching mode. It can be BLACKONWHITE, COLORONCOLOR, or WHITEONBLACK.