Tabbed Dialog Box Class






4.91/5 (12 votes)
Feb 28, 2000

109392

3817
A docking dialog that auto-expands when the mouse passes over it
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
- 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.
- Insert TabDialog.cpp file into your project.
- include "TabDialog.h" file in your Dialog header File.
- Change the base class of the dialog to
CTabDialog
. Make sure you change all occurrence ofCDialog
toCTabDialog
. - 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)
- At runtime you can call the following methods:
void SetTopMost(BOOL bTopMost)
: specify the new TopMost status of the Windowvoid 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.