13.5.1 To add SECTabWnd or SEC3DTabWnd to a frame window

The steps for adding SECTabWnd and SEC3DTabWnd are identical.

1. Add an SECTabWnd (orSEC3DTabWnd) data member to your CFrameWnd-derived class. For example:

   SECTabWnd m_tabWnd;

   If your application is:	Then:
   SDI-based	Add the data member to your CMainFrame class.
   MDI-based	Add the data member to your CMDIChildWnd descendant.
   FDI-based	Add the data member to your SECFDIChildWnd descendant.

2. Override the OnCreateClient() method of the frame class and call the tabbed window Create() method to create the tabbed window. For example:

   BOOL CMainFrame::OnCreateClient(LPCREATESTRUCT lpcs, CCreateContext *pContext) { BOOL rtn_val; lpcs; //UNUSED rtn_val = m_tabWnd.Create(this); ... }

3. In the OnCreateClient() frame class method, add the views or any CWnd-derived objects to the tabbed window object using the AddTab() method.

   For example, the following line of code creates a new instance of a CView-derivative and inserts it into the tabbed window.

   m_tabWnd.AddTab(RUNTIME_CLASS(CDemoView1), "Tab One", pContext, nID);

   The next line inserts any pre-existing CWnd-derived object into the tabbed window.

   m_tabWnd.AddTab(pWnd, "Tab Two");

4. As the last step in your OnCreateClient() override, activate and scroll into view the tab that you want to be selected initially. For example:

   m_tabWnd.ActivateTab(0); m_tabWnd.ScrollToTab(0);

13.5.2 To add a tabbed window to a dialog

1. Edit the dialog resource in the resource editor.

2. Add an arbitrary control (for example, an edit control or a static control). Position and size it where you want the tabbed window, and give the control a unique control identifier.

3. In the OnInitDialog() handler for the dialog, retrieve the rectangle for the control and window you just added. For example:

   CWnd* pWnd = GetDlgItem(uiControlID); CEdit* pwndEdit=(CEdit*)pWnd; // Retrieve the previous window in the tab order // and the rectangle to use for the call to create // (in parent client-area coordinates). CWnd* pwndPrev = pwndEdit->GetWindow(GW_HWNDPREV); CRect rc; pWnd->GetWindowRect(&rc); this->ScreenToClient(&rc); // Now we no longer need the original window and can // safely destroy it. pWnd->DestroyWindow();

4. Now, call the tabbed window Create() method. Then, set the size, position, and tab order for the control.

   if (m_tabWnd.Create(this)) { SetWindowPos(pwndPrev, rc.TopLeft().x, rc.TopLeft().y, rc.Width(), rc.Height(), 0); }

13.5.3 Removing the 2D Tab Scroll Buttons

In the call to SECTabWnd::Create(), leave off the TWS_FULLSCROLL or TWS_LEFTRIGHTSCROLL flags.

13.5.4 To put 3D tabs on the side or top of the tabbed window

13.5.5 To enable scroll bars in the 2D tabbed window

13.5.6 To add keyboard accelerator support

1. Derive a class from SECTabWnd/SEC3DtabWnd and add handlers for the WM_CHAR and WM_KEYDOWN messages.

2. In OnChar() or OnKeyDown() or both, provide your own tab-activation code. Within the handler, you can use the SECTabWndBase::ActivateTab() method to activate a specific tab.

If the tab contains CView derived class objects:

The default message routing mechanism sends the keyboard messages to the window with the keyboard focus so the active view receives the messages.

Handle the message(s) in the view/control class contained in the tab to redirect the message(s) to the tabbed window. This ensures that your tab-window's handler is called.

void CDemoView1::OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags) { nChar; //UNUSED nRepCnt; //UNUSED nFlags; //UNUSED // Forward message to parent ASSERT(GetParent()-> IsKindOf(RUNTIME_CLASS(SECTabWndBase))); MSG msg = *GetCurrentMessage(); if (GetParent()) GetParent()->SendMessage( msg.message, msg.wParam, msg.lParam); }

If the tabbed window contains CDialog/CFormView derived class objects:

When a CDialog/CFormView derived object is the active window, the application sends keyboard messages to the control within the dialog that has the focus by default. You need to subclass the control and redirect the keyboard messages to the tabbed window.

13.5.7 To add a window to the tabbed window

Call the overloaded SECTabWndBase::AddTab() method with the following declaration.

void AddTab(CWnd* pWnd, LPCTSTR lpszLabel, HICON hIcon = NULL);

13.5.8 To create and add a view to the tabbed window

Call the overloaded SECTabWndBase::AddTab() method with the following declaration.

CWnd* AddTab(CRuntimeClass* pViewClass, LPCTSTR lpszLabel, CCreateContext* pContext = NULL, HICON hIcon = NULL, UINT nID = -1);

If the tab creation is within CFrameWnd::OnCreateClient():

Use the pContext parameter passed to the OnCreateClient() method in the AddTab() method call.

If the tab creation is not occurring within CFrameWnd::OnCreateClient():

Create a CCreateContext on the stack and pass it to the AddTab() method call. For example:

void CMyFrameWnd::OnSheetNew() { CCreateContext context; context.m_pCurrentFrame = this; context.m_pCurrentDoc = GetDocToUse(); context.m_pNewViewClass = RUNTIME_CLASS(CMyView); context.m_pNewDocTemplate = GetDocTemplateToUse(); m_wndTab.AddTab(RUNTIME_CLASS(CMyView), &context); }

The implementations of the GetDocToUse() and GetDocTemplateToUse() methods are application-specific.

---

In general, you can embed a tabbed window anywhere. This is not true if the tabbed window contains views. You cannot embed a view in a tabbed window that is, in turn, embedded in a control bar (docking window) or a dialog. However, you can embed a tabbed window containing views into a view contained in a frame using the docking views architecture.

---

13.5.9 To remove a tab

Call the RemoveTab() method. Don't forget to destroy the contained CWnd. For example:

// Don't just delete the tab, destroy the associated // window too. if (m_tabWnd.GetTabInfo(nActiveTab, lpszLabel, bSelected, pActiveWnd, pExtra)) { pActiveWnd->ShowWindow(SW_HIDE); pActiveWnd->SendMessage(WM_CLOSE); }

13.5.10 To access the CWnd associated with a tab

Call the GetTabInfo() method, which is defined as follows:

// Returns information about the tab with the supplied index. BOOL GetTabInfo(int nIndex, LPCTSTR& lpszLabel, BOOL& bSelected, CWnd*& pWnd, void*& pExtra);

For example:

m_tabWnd.GetTabInfo(nActiveTab, lpszLabel, bSelected, pActiveWnd, pExtra);

13.5.11 To change the font of a tab

Call one of the following font accessor methods.

---

If you are specifying the font for a tab on a 3D tabbed window and the tabs are placed on either the left or right side of the tabbed window, the font must be a True Type font.

---

13.5.12 To receive user event notifications from the tabbed window

13.5.13 To get a pointer to the SECTabWnd from a contained view

13.5.14 To insert a splitter window into a tabbed window

13.5.15 Problem with Tabbed Windows in Docking Views