CTabCtrl Class

Provides the functionality of the Windows common tab control.

class CTabCtrl : public CWnd

A "tab control" is analogous to the dividers in a notebook or the labels in a file cabinet.
By using a tab control, an application can define multiple pages for the same area of a
window or dialog box. Each page consists of a set of information or a group of controls
that the application displays when the user selects the corresponding tab. A special type
of tab control displays tabs that look like buttons. Clicking a button should immediately
perform a command instead of displaying a page.

Base Class Members

CObject Members

CCmdTarget Members

CWnd Members

Construction

Create Creates a tab control and attaches it to an instance of a CTabCtrl object.

Creates a tab control with the specified Windows extended styles and attaches it
CreateEx
to an instance of a CTabCtrl object.

CTabCtrl Constructs a CTabCtrl object.

Attributes

GetCurFocus Retrieves the tab with the current focus of a tab control.

GetCurSel Determines the currently selected tab in a tab control.

Retrieves the extended styles that are currently in use for the tab
GetExtendedStyle
control.

GetImageList Retrieves the image list associated with a tab control.

GetItem Retrieves information about a tab in a tab control.

GetItemCount Retrieves the number of tabs in the tab control.

GetItemRect Retrieves the bounding rectangle for a tab in a tab control.

GetItemState Retrieves the state of the indicated tab control item.

GetRowCount Retrieves the current number of rows of tabs in a tab control.

Retrieves the handle of the tool tip control associated with a tab
GetToolTips
control.

SetCurFocus Sets the focus to a specified tab in a tab control.

SetCurSel Selects a tab in a tab control.

SetExtendedStyle Sets the extended styles for a tab control.

SetImageList Assigns an image list to a tab control.

SetItem Sets some or all of a tab's attributes.

Sets the number of bytes per tab reserved for application-defined data
SetItemExtra
in a tab control.

SetItemSize Sets the width and height of an item.

SetItemState Sets the state of the indicated tab control item.

SetMinTabWidth Sets the minimum width of items in a tab control.

Sets the amount of space (padding) around each tab's icon and label in
SetPadding
a tab control.

SetToolTips Assigns a tool tip control to a tab control.

Operations

Calculates a tab control's display area given a window rectangle, or

AdjustRect calculates the window rectangle that would correspond to a given display
area.

DeleteAllItems Removes all items from a tab control.

DeleteItem Removes an item from a tab control.

DeselectAll Resets items in a tab control, clearing any that were pressed.
HighlightItem Sets the highlight state of a tab item.

HitTest Determines which tab, if any, is at a specified screen position.

InsertItem Inserts a new tab in a tab control.

RemoveImage Removes an image from a tab control's image list.

Overridables

DrawItem Draws a specified item of a tab control.

CTabCtrl Member Functions

CTabCtrl::AdjustRect

CTabCtrl::Create

CTabCtrl::CreateEx

CTabCtrl::CTabCtrl

CTabCtrl::DeleteAllItems

CTabCtrl::DeleteItem

CTabCtrl::DeselectAll

CTabCtrl::DrawItem

CTabCtrl::GetCurFocus

CTabCtrl::GetCurSel

CTabCtrl::GetExtendedStyle

CTabCtrl::GetImageList

CTabCtrl::GetItem

CTabCtrl::GetItemCount

CTabCtrl::GetItemRect
CTabCtrl::GetItemState

CTabCtrl::GetRowCount

CTabCtrl::GetToolTips

CTabCtrl::HighlightItem

CTabCtrl::HitTest

CTabCtrl::InsertItem

CTabCtrl::RemoveImage

CTabCtrl::SetCurFocus

CTabCtrl::SetCurSel

CTabCtrl::SetExtendedStyle

CTabCtrl::SetImageList

CTabCtrl::SetItem

CTabCtrl::SetItemExtra

CTabCtrl::SetItemSize

CTabCtrl::SetItemState

CTabCtrl::SetMinTabWidth

CTabCtrl::SetPadding
CTabCtrl::SetToolTips