Click here to Skip to main content
15,879,535 members
Articles / Desktop Programming / MFC
Article

Tabbed Dialog Box Class

Rate me:
Please Sign up or sign in to vote.
4.91/5 (12 votes)
27 Feb 2000 108.7K   3.8K   57   4
A docking dialog that auto-expands when the mouse passes over it
  • Download demo project - 27 Kb
  • Download source files - 8 Kb
  • Sample Image - TabDialog1.jpg   Sample Image - TabDialog2.jpg

    Introduction

    This class implements a brand new kind of dialog box that can be used with dialog based aplications.

    This class contains a Tab instead of the Dialog Title Bar. What is so cool about this dialog is that the dialog actually docks to side of the desktop. Then when the dialog loses focus, the main body of the dialog disappears with only the tab remaining visible! This is great for admin type applications that you always want your user to have available, yet not in the way.

    Then when you want to reactivate the dialog, instead of searching either the Task Bar or the Task Manager for your dialog, you simply move your mouse over the dialog's tab and the complete dialog reappears!

    Implementing the Tab Dialog

    1. Create your dialog resource as normal and get Class Wizard to generate a dialog class and data members for you. The dialog should'nt have the "Title Bar" and "System Menu" styles enabled.
    2. Insert TabDialog.cpp file into your project.
    3. include "TabDialog.h" file in your Dialog header File.
    4. Change the base class of the dialog to CTabDialog. Make sure you change all occurrence of CDialog to CTabDialog.
    5. On your Dialog constructor, you can modify the TabDialog properties :

      • m_hTitleIcon : handle to an icon to use as the Tab Icon
      • m_sTitle : Title to display in the Tab
      • m_bCloseBox : TRUE if you want a close bbox to appear in the Tab
      • m_bAutoTabSize : TRUE if you want the Tab Dialog to automatically compute the Tab size, depending of the Icon, the title and the close box.
      • m_nBorderPos : indicate the desktop border you want your tab dialog to be attached on. follwing values are possibles:
        TAB_BORDER_LEFT
        TAB_BORDER_RIGHT
        TAB_BORDER_TOP
        TAB_BORDER_BOTTOM
      • m_nXpos or m_nYpos : indicate the position in pixels of the tab Dialog, on the border you chosed.
      • m_bTopMost : TRUE if you want the Tab Dialog to be topMost
      • m_bAutoHide : TRUE if you want the Tab Dialog to auto show/hide when the mouse move on and out of it
      • m_nTabHeight : height of the tab in pixels.
      • m_nTabWidth : width of the tab in pixels (used if m_bAutoTabSize = FALSE)
    6. At runtime you can call the following methods:

      void SetTopMost(BOOL bTopMost) : specify the new TopMost status of the Window
      void SetAutoHide(BOOL bAutoHide): 
      specify the new AutoHide status of the Window

    The Sample Project

    I have included a sample Dialog based project which illustrates how the CTabDialog class can be used. It is a very simple dialog-based application which displays some basic controls.

    License

    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


    Written By
    United States United States
    This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

    Comments and Discussions

     
    GeneralMy vote of 5 Pin
    Member 100661393-Jun-13 4:21
    professionalMember 100661393-Jun-13 4:21 
    GeneralNice dialog class.. Pin
    cool_raja7-May-07 19:13
    cool_raja7-May-07 19:13 
    GeneralGreat, but...... Pin
    Bill S6-May-02 9:16
    professionalBill S6-May-02 9:16 
    Users should be able to undock and redock the window and there should be an option to always display the UI when the mouse leaves the client area.

    Best Regards
    GeneralDynamic Resize Pin
    sanpee4-Jul-01 22:31
    sanpee4-Jul-01 22:31 

    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.