Edit

Tab Control Styles

  • Article

This section lists supported tab control styles.

Constant Description
TCS_BOTTOM
 Version 4.70. Tabs appear at the bottom of the control. This value equals TCS_RIGHT. This style is not supported if you use ComCtl32.dll version 6.
TCS_BUTTONS
 Tabs appear as buttons, and no border is drawn around the display area.
TCS_FIXEDWIDTH
 All tabs are the same width. This style cannot be combined with the TCS_RIGHTJUSTIFY style.
TCS_FLATBUTTONS
 Version 4.71. Selected tabs appear as being indented into the background while other tabs appear as being on the same plane as the background. This style only affects tab controls with the TCS_BUTTONS style.
TCS_FOCUSNEVER
 The tab control does not receive the input focus when clicked.
TCS_FOCUSONBUTTONDOWN
 The tab control receives the input focus when clicked.
TCS_FORCEICONLEFT
 Icons are aligned with the left edge of each fixed-width tab. This style can only be used with the TCS_FIXEDWIDTH style.
TCS_FORCELABELLEFT
 Labels are aligned with the left edge of each fixed-width tab; that is, the label is displayed immediately to the right of the icon instead of being centered. This style can only be used with the TCS_FIXEDWIDTH style, and it implies the TCS_FORCEICONLEFT style.
TCS_HOTTRACK
 Version 4.70. Items under the pointer are automatically highlighted. You can check whether hot tracking is enabled by calling SystemParametersInfo.
TCS_MULTILINE
 Multiple rows of tabs are displayed, if necessary, so all tabs are visible at once.
TCS_MULTISELECT
 Version 4.70. Multiple tabs can be selected by holding down the CTRL key when clicking. This style must be used with the TCS_BUTTONS style.
TCS_OWNERDRAWFIXED
 The parent window is responsible for drawing tabs.
TCS_RAGGEDRIGHT
 Rows of tabs will not be stretched to fill the entire width of the control. This style is the default.
TCS_RIGHT
 Version 4.70. Tabs appear vertically on the right side of controls that use the TCS_VERTICAL style. This value equals TCS_BOTTOM. This style is not supported if you use visual styles.
TCS_RIGHTJUSTIFY
 The width of each tab is increased, if necessary, so that each row of tabs fills the entire width of the tab control. This window style is ignored unless the TCS_MULTILINE style is also specified.
TCS_SCROLLOPPOSITE
 Version 4.70. Unneeded tabs scroll to the opposite side of the control when a tab is selected.
TCS_SINGLELINE
 Only one row of tabs is displayed. The user can scroll to see more tabs, if necessary. This style is the default.
TCS_TABS
 Tabs appear as tabs, and a border is drawn around the display area. This style is the default.
TCS_TOOLTIPS
 The tab control has a tooltip control associated with it.
TCS_VERTICAL
 Version 4.70. Tabs appear at the left side of the control, with tab text displayed vertically. This style is valid only when used with the TCS_MULTILINE style. To make tabs appear on the right side of the control, also use the TCS_RIGHT style. This style is not supported if you use ComCtl32.dll version 6.

Remarks

The following styles can be modified after the control is created.

  • TCS_BOTTOM
  • TCS_BUTTONS
  • TCS_FIXEDWIDTH
  • TCS_FLATBUTTONS
  • TCS_FORCEICONLEFT
  • TCS_FORCELABELLEFT
  • TCS_MULTILINE
  • TCS_OWNERDRAWFIXED
  • TCS_RAGGEDRIGHT
  • TCS_RIGHT
  • TCS_VERTICAL

Requirements

Requirement Value
Header
CommCtrl.h