Click here to Skip to main content
14,921,072 members
Articles / Desktop Programming
Article
Posted 4 Oct 2007

Stats

709.6K views
6.6K downloads
196 bookmarked

OutlookTabCtrl - Another Kind of Tab

Rate me:
Please Sign up or sign in to vote.
4.92/5 (47 votes)
16 Mar 2021Public Domain2 min read
This control is another kind of tab. Tabs are displayed as horizontal stripes and can be collapsed into buttons. Each tab is assigned its own window, which is shown when you click on the tab.

Image 1

Introduction

This control is another kind of tab. Tabs are displayed as horizontal stripes and can be collapsed into buttons located in a separate area. Each tab is assigned its own window, which is shown when you click on the tab. An additional button can be displayed in the button area. You can use it to show menu, for example.

The control is derived from CWnd and is a common control based on MFC. It is possible to put it on any window: main frame, dialog, etc.

Using the Code

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

C++
#include "OutlookTabCtrl.h"

OutlookTabCtrlEx<OutlookTabCtrlCustom1> m_TabCtrl;
CListCtrl m_List1, m_List2;

...

if( !m_TabCtrl.Create(this, WS_CHILD | WS_VISIBLE,CRect(10,10,100,200), ID_OutlookTabCtrl) )
    return -1;    // error.

// Create an ImageList with icons for tabs displayed as stripes.
m_TabCtrl.CreateStripeImage(NULL,IDB_STRIPE_NORMAL,IDB_STRIPE_DISABLE,true,24);
// Create an ImageList with icons for tabs displayed as buttons.
m_TabCtrl.CreateButtonImage(NULL,IDB_BUTTON_NORMAL,IDB_BUTTON_DISABLE,true,16);

// Create child controls.
if( !m_List1.Create(WS_CLIPCHILDREN | LVS_REPORT, CRect(0,0,0,0), &m_TabCtrl,ID_List1) ||
    !m_List2.Create(WS_CLIPCHILDREN | LVS_REPORT, CRect(0,0,0,0), &m_TabCtrl,ID_List2) )
    return -1;    // error.
m_List1.InsertColumn(0,"Mail",LVCFMT_LEFT,100);
m_List2.InsertColumn(0,"Calendar",LVCFMT_LEFT,100);

// Add child items in the m_TabCtrl.
if( !m_TabCtrl.AddItem(&m_List1,"Mail",0,0) ||
    !m_TabCtrl.AddItem(&m_List2,"Calendar",1,1) )
    return -1;    // error.

// Load state from registry.
if( !m_TabCtrl.LoadState(AfxGetApp(),"OutlookTabCtrl","State") )
    m_TabCtrl.PushVisibleItem();    // create default state.

m_TabCtrl.Update();

The OutlookTabCtrl class does not draw itself. To do this, inherit from the OutlookTabCtrl::Draw class and implement its functions. A pointer to OutlookTabCtrl::Draw must be passed to the control by calling the SetDrawManager function. The classes OutlookTabCtrlCustom1...OutlookTabCtrlCustom4 are ready-made implementations of the OutlookTabCtrl::Draw class. Each of them renders OutlookTabCtrl in its own style. The OutlookTabCtrlEx class helps you combine OutlookTabCtrl with the render class. For example, like this: OutlookTabCtrlEx<OutlookTabCtrlCustom2> ctrl; .

The OutlookTabCtrl::IRecalc interface sets the sizes of the areas in the control. The OutlookTabCtrl class has its own OutlookTabCtrl::IRecalc implementation. But you can also make your own implementation of the OutlookTabCtrl::IRecalc interface and pass a pointer to it in the control using the SetRecalcManager function.

There are also three additional classes: Ability, Notify, and ToolTip. The Ability class allows the user to select any tab. Notify informs about the occurrence of some event. ToolTip manages the creation of tooltips for tabs in button state. A pointer to the implementation of each of the classes must also be passed to OutlookTabCtrl.

Windows for all new added items should have the unique identifiers. Items can be in the state of a stripe or button. By default, an item is added as a stripe. The user should call the Update function to show the results that are set by functions DeleteItem, SetItemWindow, SelectItem, etc. You can hide an item (ShowItem) or block it (DisableItem). It is also possible to get the index of an item among all visible items (GetVisibleIndexByHandle) or in general among all items in the control (GetIndexByHandle). A control can save and load the position of its elements and their visibility from the registry or another source (LoadState/SaveState). This is only part of the possibilities. To learn more, take a look at the public interface of the OutlookTabCtrl class.

Good luck!

History

  • 4th October, 2007 - Original version posted
  • 11th October, 2007 - Fixed problem with addition Dialog as child control; added functions SetLayout and SetButtonsAlign for determination places of the control's areas
  • 17th December, 2008 - Just corrected some small errors
  • 16th March, 2021 - Improved sources and text of the article

License

This article, along with any associated source code and files, is licensed under A Public Domain dedication

Share

About the Author

Baradzenka Aleh
Software Developer
Canada Canada

Comments and Discussions

 
GeneralOutlookTabCtrl in CSizingControlBar Pin
presidentkevin1-May-10 22:57
Memberpresidentkevin1-May-10 22:57 
GeneralRe: OutlookTabCtrl in CSizingControlBar Pin
Baradzenka Aleh5-May-10 0:42
MemberBaradzenka Aleh5-May-10 0:42 
GeneralNot Work on other computers after release Pin
presidentkevin16-Apr-10 17:27
Memberpresidentkevin16-Apr-10 17:27 
GeneralRe: Not Work on other computers after release Pin
Baradzenka Aleh17-Apr-10 0:19
MemberBaradzenka Aleh17-Apr-10 0:19 
GeneralRe: Not Work on other computers after release Pin
presidentkevin29-Apr-10 22:23
Memberpresidentkevin29-Apr-10 22:23 
General在中文的vs2008编译成功 Pin
pophelix15-Dec-09 18:07
Memberpophelix15-Dec-09 18:07 
GeneralRe: 在中文的vs2008编译成功 Pin
Baradzenka Aleh16-Dec-09 0:05
MemberBaradzenka Aleh16-Dec-09 0:05 
GeneralRe: 在中文的vs2008编译成功 Pin
LoveVc22-Jul-10 16:03
MemberLoveVc22-Jul-10 16:03 
Nice work! cool!
Are u understand chinese?
GeneralRe: 在中文的vs2008编译成功 Pin
Baradzenka Aleh23-Jul-10 0:34
MemberBaradzenka Aleh23-Jul-10 0:34 
GeneralRe: 在中文的vs2008编译成功 Pin
Member 4408248-Dec-10 18:38
MemberMember 4408248-Dec-10 18:38 
General好极了 Pin
pophelix15-Dec-09 18:05
Memberpophelix15-Dec-09 18:05 
GeneralRe: 好极了 Pin
Member 4408248-Dec-10 18:46
MemberMember 4408248-Dec-10 18:46 
GeneralRe: 好极了 Pin
batsword26-Apr-11 20:11
Memberbatsword26-Apr-11 20:11 
GeneralRe: 好极了 [modified] Pin
Baradzenka Aleh26-Apr-11 23:53
MemberBaradzenka Aleh26-Apr-11 23:53 
GeneralRe: 好极了 Pin
batsword27-Apr-11 16:06
Memberbatsword27-Apr-11 16:06 
GeneralHide OutlookTabCtrl Pin
richi_84-Aug-09 0:13
Memberrichi_84-Aug-09 0:13 
GeneralRe: Hide OutlookTabCtrl Pin
Baradzenka Aleh4-Aug-09 0:39
MemberBaradzenka Aleh4-Aug-09 0:39 
GeneralRe: Hide OutlookTabCtrl Pin
richi_84-Aug-09 0:56
Memberrichi_84-Aug-09 0:56 
GeneralRe: Hide OutlookTabCtrl Pin
Baradzenka Aleh4-Aug-09 3:47
MemberBaradzenka Aleh4-Aug-09 3:47 
GeneralRe: Hide OutlookTabCtrl Pin
richi_84-Aug-09 4:05
Memberrichi_84-Aug-09 4:05 
GeneralInitialisation of OutlookTabCtrlBase Pin
richi_85-Jul-09 23:16
Memberrichi_85-Jul-09 23:16 
GeneralRe: Initialisation of OutlookTabCtrlBase Pin
Baradzenka Aleh8-Jul-09 1:16
MemberBaradzenka Aleh8-Jul-09 1:16 
GeneralSetSel Pin
josip cagalj21-Apr-09 3:54
Memberjosip cagalj21-Apr-09 3:54 
GeneralIcon hilited Pin
josip cagalj5-Feb-09 3:54
Memberjosip cagalj5-Feb-09 3:54 
GeneralRe: Icon hilited Pin
Baradzenka Aleh5-Feb-09 23:23
MemberBaradzenka Aleh5-Feb-09 23:23 

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.