Click here to Skip to main content
11,412,516 members (69,945 online)
Click here to Skip to main content

Setup a Tab Control Easily to Show and Hide Objects With STabCtrl

, 13 Mar 2002 CPOL
Rate this:
Please Sign up or sign in to vote.
Set up a tab control easily to show and hide objects with STabCtrl

Sample Image - STabCtrl.gif

Introduction

I first submitted this code and article way back in Feb '99 and Jul '99 on the CodeGuru site. Wow, do the years go by fast! It's still there and going strong, and I still use the control today in newer projects that I've worked on since the one in whcih the control first turned up in. I've never had a need to change the code so far, but have decided to re-submit here on CodeProject.

Anyway, a lot of projects that I've working make use of tab controls, and on the tab pages there are typically up to 10 controls! And using the ON_NOTIFY(TCN_SELCHANGE... ) message, in the parent window becomes painful. 'Why not use property pages?' people ask. Sure that would make things easier, but the pages on property pages take up the entire parent window and we've got layouts that require any number of controls to not be on a page but around the tab control somewhere. To do that with property pages requires a bit of painful coding to get things where you want them, and if scaling of the page is involved it's even harder!

The STabCtrl, although very simple, I've found to be extremely useful. It implements a tab control that automatically handles the showing and hiding of objects attached to a tab's various pages, eliminating the need to do so via the ON_NOTIFY(TCN_SELCHANGE... ) message in a parent window.

To use the control:

  1. Simply replace any instance of a CTabCtrl with CSTabCtrl (remember to include the header file STabCtrl.h), initialize it as you would an MFC CTabCtrl.
  2. Use the AttachControlToTab member to attach you objects to the various available pages.
  3. Use the SetCurSel member to programmatically show a tab's particular page.

Note Steps 1, 2 & 3 are typically done in the parent dialogs ::OnInitDialog() member. Once done, the tab control will show and hide the attached objects depending on the users tab selection.

// file : SomeDialogClass.h 

class CSomeDialogClass : public CDialog 
{ 
    CSTabCtrl m_TabCtrl; 
    CTreeCtrl m_TreeCtrl; 
    CListCtrl m_ListCtrl; 
    CComboBox m_ComboCtrl; 

    virtual BOOL OnInitDialog(); 
}; 

// file : SomeDialogClass.cpp
BOOL CSomeDialogClass::OnInitDialog() 
{ 
    CDialog::OnInitDialog();

    //////////////////////////////////////////////////////// 
    // set up tabs. 

    PSTR pszTabItems[] = 
    { 
        "Tab Sheet 1 : Tree control", 
        "Tab Sheet 2 : List control", 
        "Tab Sheet 3 : Combobox control", 
        NULL 
    }; 

    TC_ITEM tcItem; 

    for(INT i = 0; pszTabItems[i] != NULL; i++) 
    { 
        tcItem.mask = TCIF_TEXT; 
        tcItem.pszText = pszTabItems[i]; 
        tcItem.cchTextMax = strlen(pszTabItems[i]); 
        m_TabCtrl.InsertItem(i,&tcItem); 
    } 

    // attach controls to tabs pages.
    // attach tree control to first page 
    m_TabCtrl.AttachControlToTab(&m_TreeCtrl,0); 
    // attach list control to second page 
    m_TabCtrl.AttachControlToTab(&m_ListCtrl,1); 
    // attach combo box control to third page
    m_TabCtrl.AttachControlToTab(&m_ComboCtrl,2); 

    // initialize tab to first page. 
    m_TabCtrl.SetCurSel(0); 

    //////////////////////////////////////////////////////// 
}

Anyway...hope this is of use to everyone!

License

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

Share

About the Author

Parko
Web Developer
Australia Australia
Parko, aka Simon Parkinson-Bates, spends his days cutting code, his evenings chasing after his 5.5 year old daughter and cleaning up after his 3.5 year old son, and his nights cutting code.

Comments and Discussions

 
QuestionIt couldn't work under SDI? Pin
Syouki_kou at 6-May-08 18:15
memberSyouki_kou6-May-08 18:15 
AnswerRe: It couldn't work under SDI? Pin
Member 3195035 at 19-Jan-09 5:31
memberMember 319503519-Jan-09 5:31 
GeneralUsing CSTabCtrl without a resource entry Pin
Michael Farrugia at 11-Jun-07 12:00
memberMichael Farrugia11-Jun-07 12:00 
QuestionXP static background issue Pin
CASILASI at 16-Apr-06 1:29
memberCASILASI16-Apr-06 1:29 
GeneralRe: XP static background issue Pin
Douglas Fraser at 28-Apr-08 4:50
memberDouglas Fraser28-Apr-08 4:50 
QuestionIs it possible to do multiline (stacked ) tabs with STabCtrl? Pin
JimatKC at 28-Mar-06 17:05
memberJimatKC28-Mar-06 17:05 
AnswerRe: Is it possible to do multiline (stacked ) tabs with STabCtrl? Pin
Parko at 28-Mar-06 18:26
memberParko28-Mar-06 18:26 
GeneralRe: Is it possible to do multiline (stacked ) tabs with STabCtrl? Pin
JimatKC at 28-Mar-06 21:22
memberJimatKC28-Mar-06 21:22 
General'AttachControlToTab' : is not a member of 'CTabCtrl' Pin
pepeyman at 19-Apr-05 3:58
memberpepeyman19-Apr-05 3:58 
GeneralRe: 'AttachControlToTab' : is not a member of 'CTabCtrl' Pin
Parko at 19-Apr-05 13:11
memberParko19-Apr-05 13:11 
GeneralSTabCtrl without resource Pin
Fred_123 at 23-Jan-03 21:23
memberFred_12323-Jan-03 21:23 
GeneralRe: STabCtrl without resource Pin
matlin123 at 29-Mar-05 12:06
membermatlin12329-Mar-05 12:06 
GeneralRe: STabCtrl without resource Pin
Parko at 29-Mar-05 15:48
memberParko29-Mar-05 15:48 
QuestionResource View?? Pin
anonymous at 26-Sep-02 10:46
sussanonymous26-Sep-02 10:46 
AnswerRe: Resource View?? Pin
Parko at 27-Sep-02 2:52
memberParko27-Sep-02 2:52 
GeneralRe: Resource View?? Pin
stealth kid at 31-Aug-03 23:49
memberstealth kid31-Aug-03 23:49 
QuestionPaint? Pin
Tobias at 1-Jul-02 4:12
memberTobias1-Jul-02 4:12 

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 | Terms of Use | Mobile
Web04 | 2.8.150427.1 | Last Updated 14 Mar 2002
Article Copyright 2002 by Parko
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid