Click here to Skip to main content
Click here to Skip to main content

TabCtrl

, 12 Jul 2010
Rate this:
Please Sign up or sign in to vote.
Adjustable contol with zooming and scrolling tabs, dragging with the mouse, custom drawing and much more
Prize winner in Competition "Best C++/MFC article of May 2010"
Sample Image

Introduction

This control is based on CWnd class and can be placed as a child window anywhere, for example in the client area of the frame or dialog. Tabs can be top or bottom of child windows. The user can drag tabs using the mouse. Control has a zoom (shrink of tabs) and scrolling tabs mode. Also, if there is one tab the area of tabs can be hidden.

Using the Code

Child windows are added using their HWND and they can be of any type, for example modeless dialogs. TabCtrl consists of three areas: control area, tabs area, windows area.

Sample Image

To create the control and add elements to it, you can do the next steps:

  TabCtrlEx<tabctrlstyle_vs2003_client /> m_TabCtrl;
  CListCtrl m_List1, m_List2, m_List3;
  
  ...
  ...
  
  // Creation and initialization of TabCtrl.
  if(m_TabCtrl.Create(this,WS_CHILD | WS_VISIBLE,
  	CRect(0,0,0,0),100/*id of TabCtrl*/)==false) return -1;
  m_TabCtrl.SetBehavior(TAB_BEHAVIOR_SCROLL);
  
  CImageList imagelist, imagelistSys;
  CBitmap bmp, bmpSys;
  
  imagelist.Create(16,16,ILC_COLOR24 | ILC_MASK,3,0);
  bmp.LoadBitmap(IDB_BITMAP1);
  imagelist.Add(&bmp,RGB(255,0,255));
  
  imagelistSys.Create(14,14,ILC_COLOR24 | ILC_MASK,7,0);
  bmpSys.LoadBitmap(IDB_BITMAP2);
  imagelistSys.Add(&bmpSys,RGB(255,0,255));
  
  m_TabCtrl.SetImageLists(&imagelist,NULL);
  m_TabCtrl.SetSystemImageList(&imagelistSys);
  
  // Creation of child windows.
  if(m_List1.Create(WS_CHILD | WS_CLIPCHILDREN | LVS_SHOWSELALWAYS | 
  		LVS_REPORT,CRect(0,0,0,0),&m_TabCtrl,2001)==0 ||
     m_List2.Create(WS_CHILD | WS_CLIPCHILDREN | LVS_SHOWSELALWAYS | 
     		LVS_REPORT,CRect(0,0,0,0),&m_TabCtrl,2002)==0 ||
     m_List3.Create(WS_CHILD | WS_CLIPCHILDREN | LVS_SHOWSELALWAYS | 
     		LVS_REPORT,CRect(0,0,0,0),&m_TabCtrl,2003)==0)
     return -1;
     
  // Initialization of child windows.
  m_List1.InsertColumn(0,_T("Mail"),LVCFMT_LEFT,100);
  m_List1.InsertItem(0,_T("Mail 1"));
  m_List2.InsertColumn(0,_T("Calendar"),LVCFMT_LEFT,100);
  m_List2.InsertItem(0,_T("Calendar 1"));
  m_List3.InsertColumn(0,_T("Contacts"),LVCFMT_LEFT,100);
  m_List3.InsertItem(0,_T("Contact 1"));
  
  // Attaching of child windows to the TabCtrl.
  if(m_TabCtrl.Add(m_List1,_T("1.Mail"),0)==NULL ||
     m_TabCtrl.Add(m_List2,_T("2.Calendar"),1)==NULL ||
     m_TabCtrl.Add(m_List3,_T("3.Contacts"),2)==NULL)
     return -1;
     
  // Load state from registry and update.
  m_TabCtrl.LoadState(AfxGetApp(),_T("TabCtrl"),_T("State"));
  m_TabCtrl.Update();

Class TabCtrl not perform any rendering. For its drawing, it calls the functions of TabCtrlDraw interface. In general, to set the style TabCtrl you need to create an object inherited from interface ITabCtrlStyle and pass a pointer to it, using the function InstallStyle. This interface should provide a pointer to TabCtrlDraw for drawing, ITabCtrlRecalc to specify the size and spacing of their regions, ITabCtrlBehavior to correct the behavior of the control and ITabCtrlToolTip to define custom tooltip for the tabs and buttons. Object of class of style must exist during work of control. To do this, you can create an intermediate class like TabCtrlComplex. If you are working with only one style, then use the template class TabCtrlEx. The class name of the style is defined as a template parameter, for example:

TabCtrlEx<TabCtrlStyle_VS2003_client> m_TabCtrl;

Some styles have already been created. For example, styles similar to the tabs of working files and docking/floating panels in Visual Studio 2003, 2008 and 2010. To create your own styles, see classes TabCtrlStyle_VS2003_client, TabCtrlStyle_VS2003_bars, TabCtrlStyle_VS2008_client_classic, etc. Classes TabCtrlRecalcStub and TabCtrlBehaviorStub create a default implementation for the functions of ITabCtrlRecalc and ITabCtrlBehavior interfaces respectively. You can use them to create your own style objects.

Control requires a call of Update(true) after you add or delete tabs, as well as change its properties and state.

If the text of the tab is not fully visible and allowed tooltips (ToolTipEnable) and the mouse cursor is over the tab, then tooltip appears with its text. But if the function SetTabTooltipText was called, then the specified text is displayed always.

Control does not send messages to the parent window and uses an interface TabCtrlNotify for notification of the events. Use SetNotifyManager to set the pointer to your implementation of TabCtrlNotify.

By default, all drawing is based on double buffering, it excludes any blinking. If you want, use VirtualWindow::DoubleBuffering(false) to disable double buffering.

Good luck.

History

  • 28th May, 2010: Initial version
  • 10th June, 2010: Added redirect WM_NOTIFY message from child windows to a parent of the TabCtrl control
  • 12th June, 2010: Corrected error display of tooltips.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Borodenko Oleg
Software Developer
Belarus Belarus
No Biography provided

Comments and Discussions

 
QuestionHow to send a message when the current tab changes PinmemberBob H23-Mar-14 5:52 
AnswerRe: How to send a message when the current tab changes PinpremiumBorodenko Oleg23-Mar-14 9:11 
Questioninsert multiple CDialog ' s with the same ID PinmemberIonut Codrut15-Feb-14 1:11 
AnswerRe: insert multiple CDialog ' s with the same ID PinmemberBorodenko Oleg17-Feb-14 2:59 
GeneralRe: insert multiple CDialog ' s with the same ID PinmemberIonut Codrut17-Feb-14 17:30 
QuestionGreat job,Vote of 10! Pinmemberlanmanck15-Aug-13 17:03 
GeneralMy vote of 5 PinmemberHerusetiyadi8-Jun-13 16:56 
GeneralMy vote of 5 Pinmembernoending7-May-13 4:33 
GeneralMy vote of 5 PinmemberAlbertino26-Apr-13 6:32 
QuestionWould be the worlds best but... [modified] PinmemberAreal Person21-Dec-12 11:20 
AnswerRe: Would be the worlds best but... PinmemberBorodenko Oleg23-Dec-12 4:51 
AnswerRe: Would be the worlds best but... PinmemberBorodenko Oleg25-Dec-12 1:20 
Questionhello, about add DDX_Control(pDX, IDC_STATIC, m_picCtrl); run error Pingroupdnybz5-Oct-12 23:30 
AnswerRe: hello, about add DDX_Control(pDX, IDC_STATIC, m_picCtrl); run error Pinmembernoending27-Oct-12 18:59 
QuestionHow to add a scroll bar if the inner dialog is very large PinmemberEversoft27-Sep-12 16:04 
AnswerRe: How to add a scroll bar if the inner dialog is very large PinmemberBorodenko Oleg27-Sep-12 22:11 
GeneralMy vote of 5 PinmemberJonathanrz25-Jul-12 3:08 
Questionenable only single tab on the control Pinmembergaurish thakkar21-Jun-12 18:14 
AnswerRe: enable only single tab on the control PinmemberBorodenko Oleg21-Jun-12 19:26 
QuestionCan you use it w/o attaching HWND to tab ? PinmemberSasa Kajic2-Feb-12 1:48 
QuestionIt's so good source, and I have a little question. PinmemberMember 850081720-Dec-11 16:07 
AnswerRe: It's so good source, and I have a little question. PinmemberBorodenko Oleg20-Dec-11 23:17 
QuestionAwesome!! PinmemberYonghwi Kwon18-Nov-11 20:28 
GeneralMy vote of 5 PinmemberAlbertXiao17-Oct-11 0:04 
GeneralMy vote of 5 Pinmemberduke.liu19-Aug-11 14:42 

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

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

| Advertise | Privacy | Mobile
Web02 | 2.8.140721.1 | Last Updated 12 Jul 2010
Article Copyright 2010 by Borodenko Oleg
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid