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