Microsoft Foundation Classes (mfc.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
CDC::SetStretchBltMode
CDC                                         Up Contents Index Back
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  int SetStretchBltMode( int nStretchMode );
 
  Parameter      Description
 
  <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
 
 
                                     -♦-