QTabWidget

QTabWidget is a class in the Qt Widgets module that implements a tabbed container. It presents a tab bar along with a page area; each tab corresponds to a child widget that becomes the visible page when the tab is selected. Internally, QTabWidget composes a QTabBar and a QStackedWidget to manage the tabs and the pages.

Tabs are added with addTab or insertTab, providing the page widget and a label, optionally with an icon. The currently visible page can be changed with setCurrentIndex or setCurrentWidget, and currentIndex / currentWidget report the active page. The total number of tabs is accessible via count, and you can query a page via widget(index) or indexOf(widget).

Tabs can be positioned with setTabPosition (North, South, West, East, corresponding to top, bottom, left, right). A corner widget can be shown in the top-left or top-right corner with setCornerWidget. Tabs can be made closable; enabling setTabsClosable(true) emits tabCloseRequested(index) when a tab's close button is activated.

Style and text for tabs can be customized by setTabText, setTabIcon, and setTabToolTip per tab. Signals such as currentChanged(int) notify when the active tab changes. QTabWidget is widely used in desktop applications to organize complex interfaces into multiple pages within a single window.

Related classes include QTabBar and QStackedWidget; QTabWidget acts as a convenience wrapper combining both components and providing a higher-level tabbed interface.