Share via


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 State Collection sample.

 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

Reference

CMFCTabCtrl Class

Hierarchy Chart