Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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