Click here to Skip to main content
13,247,674 members (55,088 online)
Click here to Skip to main content
Add your own
alternative version


82 bookmarked
Posted 22 Jul 2002

Dialog Header

, 22 Jul 2002
Rate this:
Please Sign up or sign in to vote.
Add a header to any dialog or property sheet


If you want to give your users some feedback and make your apps look more professional, than just use these simple classes. This code was inspired by Mustafa Demirhan's article about hacking the CPropertySheet.

The CDialogHeader class will add a header area to your dialogs that will display an icon, a title, and some description text.

Below is an image of a standard dialog with a header control added.
The header can display an icon, a title, and description text with a custom font size, alignment, and background color.

The CMyPropertySheet class incorporates the dialog header into a property sheet control.

Below are two tabs of a property sheet control with the header control built in. Each tab can have it's own individual icon and text associated with it.

How to Use the CDialogHeader Class

  1. Include the files DialogHeader.h and DialogHeader.cpp in your project.

  2. Add the include statement to your dialog header file:
    #include 'DialogHeader.h'             //For the header ctrl area
  3. Add a member variable of type CDialogHeader to your dialog class
    CDialogHeader m_HeaderCtrl;        //Dialogheader 

    In your dialogs OnInit function do the following:

    1. Set the headers display data:

      Or you can set/change each member individually using:

    2. The above functions will be the most commonly used, however you can set all of the following options:

      Font sizes


      Text alignment

      m_HeaderCtrl.SetTextAlign(DT_LEFT); //Options are {DT_LEFT,DT_CENTER,DT_RIGHT}

      Background color


      Blank icon mode

      m_HeaderCtrl.SetBlankIcon(TRUE); //TRUE=space always 
        allocated for icon

      Icon offsets

      m_HeaderCtrl.SetIconOffset(5); //Defines top left 
        corner of icon and border

      Title offset

      m_HeaderCtrl.SetTitleOffset(10); //Defines space between 
        icon and title text

      Description offset

      m_HeaderCtrl.SetDescOffset(10); //Defines the 
        amount of indent for desc text when align is DT_LEFT or DT_RIGHT

      Header height

      m_HeaderCtrl.SetHeaderHeight(x); //If x=0, automatically 
        sets height

      Note: Font sizes and offset must be set before setting header height with x=0. See the header file for a more complete description of all functions.

    3. Display the header and resize the dialog window by calling:
    4. Move dialog controls down to accommodate the header area by calling:

That’s it! The code below shows a typical example of how to initialize and display the dialog header:

//Example of using CDialogHeader
BOOL CDlgFileTypes::OnInitDialog()

    // TODO: Add extra initialization here

    //Set initial header data
    m_HeaderCtrl.SetDescText("Description text.");

    //Create the header ctrl

    //Move all dialog ctrls down to accommodate header area

    return TRUE;
    // return TRUE unless you set the focus to a control
    // EXCEPTION: OCX Property Pages should return FALSE

How to Use the MyPropertySheet Class:

  1. Include the files DialogHeader.h, DialogHeader.cpp,
    , and MyPropertyShett.cpp in your project.
  2. Add the include statement in every header file where you want to replace the standard CPropertySheet
    #include "MyPropertySheet.h"        //For the custom Propertysheet ctrl
  3. Add a new CMyPropertySheet member variable/local variable or replace CPropertySheet with CMyPropertySheet.
  4. Add the property pages to the property sheet using a PSHEETITEM variable.

Note: See the header file for a more complete description of all the functions and options.

The example below creates a property sheet with two tabs each with different icon, text, and layout:

void CDialogHeaderDemoDlg::OnButton1()
    CMyPropertySheet sheet("Options");
    PropPage1 page1;
    CPropPage2 page2;
    //Get a default header item
    //Add tab 1 to sheet
    pItem.sTitle="Title 1";
    pItem.sDesc="Propertypage number 1 options.";
    //Add tab 2 to sheet
    pItem.sTitle="Title 2";
    pItem.sDesc="Propertypage number 2 options.";
    //Change the alignment for tab 2
    //Add page two to the propertysheet
    //Display the propertysheet ctrl

I hope you enjoy the code and find it useful.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

United States United States
No Biography provided

You may also be interested in...

Comments and Discussions

NewsSmall modification to use different icon sizes Pin
Jörg Anslik3-May-11 14:57
memberJörg Anslik3-May-11 14:57 
Generallicense of CDialogHeader Pin
Jan777777710-May-10 6:08
memberJan777777710-May-10 6:08 
Generalgood,thanks Pin
hpxs3-Sep-08 18:41
memberhpxs3-Sep-08 18:41 
QuestionHow to make this PropertySheet as a stand alone application like a dialog Pin
Satyam Kumar21-Jul-06 2:36
memberSatyam Kumar21-Jul-06 2:36 
AnswerRe: How to make this PropertySheet as a stand alone application like a dialog Pin
Satyam Kumar21-Jul-06 9:19
memberSatyam Kumar21-Jul-06 9:19 
GeneralI want to use it in the CFormView, But... Pin
Anonymous8-Oct-05 16:38
sussAnonymous8-Oct-05 16:38 
GeneralRe: I want to use it in the CFormView, But... Pin
breakpoint19-Apr-06 23:21
memberbreakpoint19-Apr-06 23:21 
QuestionHow to use this class with wizard type Pin
GloryHan17-May-04 23:56
memberGloryHan17-May-04 23:56 
Questionhow to vertically align the Property Sheets ? Pin
elza18-Apr-04 1:29
memberelza18-Apr-04 1:29 
GeneralA Little Extension Pin
pfluger11-Jan-04 9:12
susspfluger11-Jan-04 9:12 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.171114.1 | Last Updated 23 Jul 2002
Article Copyright 2002 by jmgurgel
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid