DOCUMENT:Q115087  11-FEB-2002  [visualc]
TITLE   :HOWTO: Change the Background Color of a Common Dialog
PRODUCT :Microsoft C Compiler
PROD/VER::1.0,1.5,1.51,1.52,2.0,4.0
OPER/SYS:
KEYWORDS:kbATL kbMFC KbUIDesign kbVC kbVC100 kbVC150 kbVC200 kbVC400 kbFAQ

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

 - The Microsoft Foundation Classes (MFC), used with:
    - Microsoft Visual C++ for Windows, 16-bit edition, versions 1.0, 1.5, 1.51, 1.52 
    - Microsoft Visual C++, 32-bit Editions, versions 1.0, 2.0, 4.0 
-------------------------------------------------------------------------------

SUMMARY
=======

The common dialog-box classes provided by MFC can be used to modify the
background color for common dialog boxes such as the File Open dialog box and
the Print dialog box. It is necessary to derive a class from one of the MFC
common dialog classes then override the OnCtlColor() and OnDestroy() member
functions.

MORE INFORMATION
================

The sample code below uses the CFileDialog common dialog-box class to
demonstrate the process. Class Wizard was used to a generate message- handling
function for the WM_CTLCOLOR message. The function called is
"CMyDlg::OnCtlColor()".

Sample Code
-----------

      // mydlg.h : header file
      // 
      #include <dlgs.h>
      ////////////////////////////////////////////////////////////////////// 
      // CMyDlg dialog

      class CMyDlg : public CFileDialog
      {
      // Construction
      public:
          CMyDlg(CWnd* pParent = NULL);   // standard constructor

          // Add a CBrush pointer to store the new background brush
          CBrush m_pBkBrush;

      // Dialog Data
          //{{AFX_DATA(CMyDlg)
          enum { IDD = FILEOPENORD };
              // NOTE: the ClassWizard will add data members here
          //}}AFX_DATA

      // Implementation
      protected:
          virtual void DoDataExchange(CDataExchange* pDX);  // DDX/DDV support

          // Generated message map functions
          //{{AFX_MSG(CMyDlg)
          afx_msg HBRUSH OnCtlColor(CDC* pDC, CWnd* pWnd, UINT nCtlColor);
          //}}AFX_MSG
          DECLARE_MESSAGE_MAP()
      };

      // mydlg.cpp : implementation file
      // 
      #include "stdafx.h"
      #include <afxdlgs.h>
      #include "mydlg.h"

      #ifdef _DEBUG
      #undef THIS_FILE
      static char BASED_CODE THIS_FILE[] = __FILE__;
      #endif

      ////////////////////////////////////////////////////////////////////// 
      // CMyDlg dialog

      CMyDlg::CMyDlg(CWnd* pParent /*=NULL*/)
          : CFileDialog(TRUE, NULL, NULL, OFN_HIDEREADONLY)
      {
          //{{AFX_DATA_INIT(CMyDlg)
              // NOTE: the ClassWizard will add member initialization here
          //}}AFX_DATA_INIT
      }

      void CMyDlg::DoDataExchange(CDataExchange* pDX)
      {
          CDialog::DoDataExchange(pDX);
          //{{AFX_DATA_MAP(CMyDlg)
              // NOTE: the ClassWizard will add DDX and DDV calls here
          //}}AFX_DATA_MAP
      }

      BEGIN_MESSAGE_MAP(CMyDlg, CFileDialog)
          //{{AFX_MSG_MAP(CMyDlg)
          ON_WM_CTLCOLOR()
          //}}AFX_MSG_MAP
      END_MESSAGE_MAP()

      ////////////////////////////////////////////////////////////////////// 
      // CMyDlg message handlers

      HBRUSH CMyDlg::OnCtlColor(CDC* pDC, CWnd* pWnd, UINT nCtlColor)
      {
          switch (nCtlColor) {

          case CTLCOLOR_STATIC:
              // Set the static text to white on blue.
              pDC->SetTextColor(RGB(255, 255, 255));
              pDC->SetBkColor(RGB(0, 0, 255));
              // Drop through to return the background brush.

          case CTLCOLOR_DLG:
              return (HBRUSH)(m_pBkBrush.GetSafeHandle());

          default:
               return CFileDialog::OnCtlColor(pDC, pWnd, nCtlColor);
          }
      }

Additional query words:

======================================================================
Keywords          : kbATL kbMFC KbUIDesign kbVC kbVC100 kbVC150 kbVC200 kbVC400 kbFAQ 
Technology        : kbAudDeveloper kbMFC
Version           : :1.0,1.5,1.51,1.52,2.0,4.0
Issue type        : kbhowto

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

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 2002.