DOCUMENT:Q139165  11-MAY-2001  [win16sdk]
TITLE   :PRB: Memory DC Produces Monochrome Images
PRODUCT :Microsoft Windows Software Development Kit
PROD/VER:WINDOWS:3.1,3.11,95; winnt:3.51
OPER/SYS:
KEYWORDS:kbcode kbOSWinNT351 kbOSWin2000 kbOSWin310 kbOSWin95 kbDSupport kbSDKWin16

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Windows Software Development Kit (SDK) 3.1, used with:
    - Microsoft Windows 3.11 
 - Microsoft Win32 Application Programming Interface (API) 
-------------------------------------------------------------------------------

SYMPTOMS
========

When you create and use a memory Device Context (DC) to draw and store GDI
images, the bitmap displayed when transferred from the memory device context to
the physical display is monochrome. All colors are converted to either black or
white.

CAUSE
=====

When creating a compatible bitmap for the memory DC, the handle to the memory DC
is used as the first parameter to the call to CreateCompatibleBitmap(). This
create a monochrome bitmap because a memory DC created with CreateCompatibleDC()
is given a 1x1 monochrome bitmap as its default bitmap.

For example, the following code creates a monochrome bitmap and selects it into a
memory DC:

      HDC hdc, hdcMem;
      HBITMAP hBitmap;

      hdc = GetDC(hWnd);
      hdcMem = CreateCompatibleDC(hdc);
      hBitmap = CreateCompatibleBitmap(hdcMem, 400, 400);
      SelectObject(hdcMem, hBitmap);
      SetTextColor(hdcMem, RGB(0, 0, 255));

RESOLUTION
==========

Send a physical screen DC to the CreateCompatibleBitmap() function rather than
the memory DC that you plan on selecting the bitmap into.

The following example code properly sets up a color memory DC with a color bitmap
with the same bit depth as the physical display:

      HDC hdc, hdcMem;
      HBITMAP hBitmap;

      hdc = GetDC(hWnd);
      hdcMem = CreateCompatibleDC(hdc);
      hBitmap = CreateCompatibleBitmap(hdc, 400, 400);
      SelectObject(hdcMem, hBitmap);
      SetTextColor(hdcMem, RGB(0, 0, 255));

STATUS
======

This behavior is by design.

Additional query words: 3.10 4.00

======================================================================
Keywords          : kbcode kbOSWinNT351 kbOSWin2000 kbOSWin310 kbOSWin95 kbDSupport kbSDKWin16 
Technology        : kbAudDeveloper kbSDKSearch kbWinSDKSearch
Version           : WINDOWS:3.1,3.11,95; winnt:3.51
Issue type        : kbprb

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2001.