CBCGPTabbedControlBar

Detailed Description

The CBCGPTabbedControlBar class implements the functionality of a tabbed window with detachable tabs that behaves as a docking control bar.

This class can be created automatically by the framework when the user attaches one control bar to another while points to the caption of the second control bar. In this case it replaces the second control bar in its container.

All tabbed control bars that were created by the framework have ID -1.

You can create a CBCGPTabbedControlBar object as a regular docking control bar and then use AddTab() to attach additional tabs.

See also

CBCGPDockingControlBar, CBCGPBaseTabbedBar, CBCGPOutlookBar

Example:

Copy

CBCGPTabbedControlBar* pTabbededBar = new CBCGPTabbedControlBar(TRUE);

if (!pTabbededBar->Create (_T(""), this, CRect(0, 0, 200, 200),

TRUE, (UINT) -1, WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_LEFT | CBRS_FLOAT_MULTI))

{

TRACE0("Failed to create tabbed bar\n");

return FALSE; // fail to create

}

pTabbededBar->AddTab(&m_wndPane1);

pTabbededBar->AddTab(&m_wndPane2);

pTabbededBar->AddTab(&m_wndPane3);

pTabbededBar->EnableDocking(CBRS_ALIGN_ANY);

DockControlBar(pTabbededBar);

/*

Another way to create a tabbed control bar object is using CBCGDockingControlBar::AttachToTabWnd.

AttachToTabWnd creates a tabbed control bar object dynamically according to the runtime class

information set by CBCGPDockingControlBar::SetTabbedControlBarRTC. Also, you can pass the

CBRS_BCGP_REGULAR_TABS style to the CBCGPDockingControlBar::CreateEx.

The following example creates a tabbed control bar dynamically, attaches two control bars and makes the second tab non-detachable:

*/

DockControlBar(&m_wndPane1);

CBCGPTabbedControlBar* pTabbedBar = NULL;

m_wndPane2.AttachToTabWnd(&m_wndPane1, DM_SHOW, TRUE, (CBCGPDockingControlBar**) &pTabbedBar);

m_wndPane3.AttachToTabWnd(pTabbedBar, DM_SHOW, TRUE, (CBCGPDockingControlBar**) &pTabbedBar);

pTabbedBar->GetUnderlinedWindow ()->EnableTabDetach(1, FALSE);

// It's recommended to dock the first control bar before you attach the second control bar to it creating a tabbed control bar.