CMFCTabCtrl::Create

Creates the tab control and attaches it to the CMFCTabCtrl object.

BOOL Create(
   Style style,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID,
   Location location=LOCATION_BOTTOM,
   BOOL bCloseBtn=FALSE 
);

Parameters

• [in] style
  The style of the tab control. For more information, see Remarks.

• [in] rect
  A rectangle that bounds the tab control.

• [in] pParentWnd
  A pointer to a parent window. Must not be NULL.

• [in] nID
  The ID of the tab control.

• [in] location
  The location of tabs. The default value is LOCATION_BOTTOM. For more information, see Remarks.

• [in] bCloseBtn
  TRUE to display a close button on the tab; otherwise, FALSE. The default value is FALSE.

Return Value

TRUE if successful; otherwise, FALSE.

Remarks

The following table describes the values you can specify for the style parameter.

Style	Description
STYLE_3D	Creates a tab control with a three-dimensional appearance.
STYLE_FLAT	Creates a tab control with flat tabs.
STYLE_FLAT_SHARED_HORZ_SCROLL	Creates a tab control with flat tabs and a scroll bar that can scroll the tabs if they are clipped by a parent window.
STYLE_3D_ONENOTE	Creates a tab control in the style of Microsoft OneNote.
STYLE_3D_VS2005	Creates a tab control in the style of Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED	Creates a tab control with rounded tabs in the style of Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL	Creates a tab control with rounded tabs and scroll buttons in the style of Microsoft Visual Studio 2005.

The following table lists the values you can specify for the location parameter.

Location	Description
LOCATION_BOTTOM	Tabs are located at the bottom of the tab control.
LOCATION_TOP	Tabs are located at the top of the tab control.

Example

The following example demonstrates how to use the Create method in the CMFCTabCtrl class. This example is part of the StateCollection Sample: MFC Toolbar Collection Application.

   CMFCTabCtrl m_wndTabs;


...


    // Create tabs window:
    // CRect rectDummy
    // this is a pointer to a parent window
    // fourth parameter is the id of the tab control
    if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
    {
        TRACE0("Failed to create output tab window\n");
        return -1;      // fail to create
    }

Requirements

Header: afxtabctrl.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CMFCTabCtrl Class