The Widget Classes▲
The following sections list the widget classes. See the Qt Widget Gallery for some examples.
Basic Widget Classes▲
These basic widgets (controls), e.g. buttons, comboboxes and scroll bars, are designed for direct use.
							![]()  | 
						
							![]()  | 
						
							![]()  | 
					
							![]()  | 
						
							![]()  | 
						
							![]()  | 
					
- 
						
QCheckBox: The QCheckBox widget provides a checkbox with a text label.
 - 
						
QComboBox: The QComboBox widget is a combined button and popup list.
 - 
						
QCommandLinkButton: The QCommandLinkButton widget provides a Vista style command link button.
 - 
						
QDateEdit: The QDateEdit class provides a widget for editing dates based on the QDateTimeEdit widget.
 - 
						
QDateTimeEdit: The QDateTimeEdit class provides a widget for editing dates and times.
 - 
						
QDial: The QDial class provides a rounded range control (like a speedometer or potentiometer).
 - 
						
QDoubleSpinBox: The QDoubleSpinBox class provides a spin box widget that takes doubles.
 - 
						
QFocusFrame: The QFocusFrame widget provides a focus frame which can be outside of a widget's normal paintable area.
 - 
						
QFontComboBox: The QFontComboBox widget is a combobox that lets the user select a font family.
 - 
						
QLCDNumber: The QLCDNumber widget displays a number with LCD-like digits.
 - 
						
QLabel: The QLabel widget provides a text or image display.
 - 
						
QLineEdit: The QLineEdit widget is a one-line text editor.
 - 
						
QMenu: The QMenu class provides a menu widget for use in menu bars, context menus, and other popup menus.
 - 
						
QProgressBar: The QProgressBar widget provides a horizontal or vertical progress bar.
 - 
						
QPushButton: The QPushButton widget provides a command button.
 - 
						
QRadioButton: The QRadioButton widget provides a radio button with a text label.
 - 
						
QScrollArea: The QScrollArea class provides a scrolling view onto another widget.
 - 
						
QScrollBar: The QScrollBar widget provides a vertical or horizontal scroll bar.
 - 
						
QSizeGrip: The QSizeGrip class provides a resize handle for resizing top-level windows.
 - 
						
QSlider: The QSlider widget provides a vertical or horizontal slider.
 - 
						
QSpinBox: The QSpinBox class provides a spin box widget.
 - 
						
QTabBar: The QTabBar class provides a tab bar, e.g. for use in tabbed dialogs.
 - 
						
QTabWidget: The QTabWidget class provides a stack of tabbed widgets.
 - 
						
QTimeEdit: The QTimeEdit class provides a widget for editing times based on the QDateTimeEdit widget.
 - 
						
QToolBox: The QToolBox class provides a column of tabbed widget items.
 - 
						
QToolButton: The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar.
 - 
						
QWidget: The QWidget class is the base class of all user interface objects.
 
Advanced Widget Classes▲
Advanced GUI widgets, e.g. tab widgets and progress bars, provide more complex user interface controls.
							![]()  | 
						
							![]()  | 
						
							![]()  | 
					
- 
						
QCalendarWidget: The QCalendarWidget class provides a monthly based calendar widget allowing the user to select a date.
 - 
						
QColumnView: The QColumnView class provides a model/view implementation of a column view.
 - 
						
QDataWidgetMapper: The QDataWidgetMapper class provides mapping between a section of a data model to widgets.
 - 
						
QListView: The QListView class provides a list or icon view onto a model.
 - 
						
QTableView: The QTableView class provides a default model/view implementation of a table view.
 - 
						
QTreeView: The QTreeView class provides a default model/view implementation of a tree view.
 - 
						
QUndoView: The QUndoView class displays the contents of a QUndoStack.
 
Abstract Widget Classes▲
The abstract widget classes are base classes. They are not usable as standalone classes but provide functionality when they are subclassed.
- 
						
QAbstractButton: The QAbstractButton class is the abstract base class of button widgets, providing functionality common to buttons.
 - 
						
QAbstractScrollArea: The QAbstractScrollArea widget provides a scrolling area with on-demand scroll bars.
 - 
						
QAbstractSlider: The QAbstractSlider class provides an integer value within a range.
 - 
						
QAbstractSpinBox: The QAbstractSpinBox class provides a spinbox and a line edit to display values.
 - 
						
QDialog: The QDialog class is the base class of dialog windows.
 - 
						
QFrame: The QFrame class is the base class of widgets that can have a frame.
 
Organizer Widget Classes▲
Classes like splitters, tab bars, button groups, etc are used for organizing and grouping GUI primitives into more complex applications and dialogs.
- 
						
QButtonGroup: The QButtonGroup class provides a container to organize groups of button widgets.
 - 
						
QGroupBox: The QGroupBox widget provides a group box frame with a title.
 - 
						
QSplitter: The QSplitter class implements a splitter widget.
 - 
						
QSplitterHandle: The QSplitterHandle class provides handle functionality for the splitter.
 - 
						
QStackedWidget: The QStackedWidget class provides a stack of widgets where only one widget is visible at a time.
 - 
						
QTabWidget: The QTabWidget class provides a stack of tabbed widgets.
 
Graphics View Classes▲
- 
						
QAbstractGraphicsShapeItem: The QAbstractGraphicsShapeItem class provides a common base for all path items.
 - 
						
QGraphicsAnchor: The QGraphicsAnchor class represents an anchor between two items in a QGraphicsAnchorLayout.
 - 
						
QGraphicsAnchorLayout: The QGraphicsAnchorLayout class provides a layout where one can anchor widgets together in Graphics View.
 - 
						
QGraphicsEffect: The QGraphicsEffect class is the base class for all graphics effects.
 - 
						
QGraphicsEllipseItem: The QGraphicsEllipseItem class provides an ellipse item that you can add to a QGraphicsScene.
 - 
						
QGraphicsGridLayout: The QGraphicsGridLayout class provides a grid layout for managing widgets in Graphics View.
 - 
						
QGraphicsItem: The QGraphicsItem class is the base class for all graphical items in a QGraphicsScene.
 - 
						
QGraphicsItemGroup: The QGraphicsItemGroup class provides a container that treats a group of items as a single item.
 - 
						
QGraphicsLayout: The QGraphicsLayout class provides the base class for all layouts in Graphics View.
 - 
						
QGraphicsLayoutItem: The QGraphicsLayoutItem class can be inherited to allow your custom items to be managed by layouts.
 - 
						
QGraphicsLineItem: The QGraphicsLineItem class provides a line item that you can add to a QGraphicsScene.
 - 
						
QGraphicsLinearLayout: The QGraphicsLinearLayout class provides a horizontal or vertical layout for managing widgets in Graphics View.
 - 
						
QGraphicsObject: The QGraphicsObject class provides a base class for all graphics items that require signals, slots and properties.
 - 
						
QGraphicsPathItem: The QGraphicsPathItem class provides a path item that you can add to a QGraphicsScene.
 - 
						
QGraphicsPixmapItem: The QGraphicsPixmapItem class provides a pixmap item that you can add to a QGraphicsScene.
 - 
						
QGraphicsPolygonItem: The QGraphicsPolygonItem class provides a polygon item that you can add to a QGraphicsScene.
 - 
						
QGraphicsProxyWidget: The QGraphicsProxyWidget class provides a proxy layer for embedding a QWidget in a QGraphicsScene.
 - 
						
QGraphicsRectItem: The QGraphicsRectItem class provides a rectangle item that you can add to a QGraphicsScene.
 - 
						
QGraphicsScene: The QGraphicsScene class provides a surface for managing a large number of 2D graphical items.
 - 
						
QGraphicsSceneContextMenuEvent: The QGraphicsSceneContextMenuEvent class provides context menu events in the graphics view framework.
 - 
						
QGraphicsSceneDragDropEvent: The QGraphicsSceneDragDropEvent class provides events for drag and drop in the graphics view framework.
 - 
						
QGraphicsSceneEvent: The QGraphicsSceneEvent class provides a base class for all graphics view related events.
 - 
						
QGraphicsSceneHelpEvent: The QGraphicsSceneHelpEvent class provides events when a tooltip is requested.
 - 
						
QGraphicsSceneHoverEvent: The QGraphicsSceneHoverEvent class provides hover events in the graphics view framework.
 - 
						
QGraphicsSceneMouseEvent: The QGraphicsSceneMouseEvent class provides mouse events in the graphics view framework.
 - 
						
QGraphicsSceneMoveEvent: The QGraphicsSceneMoveEvent class provides events for widget moving in the graphics view framework.
 - 
						
QGraphicsSceneResizeEvent: The QGraphicsSceneResizeEvent class provides events for widget resizing in the graphics view framework.
 - 
						
QGraphicsSceneWheelEvent: The QGraphicsSceneWheelEvent class provides wheel events in the graphics view framework.
 - 
						
QGraphicsSimpleTextItem: The QGraphicsSimpleTextItem class provides a simple text path item that you can add to a QGraphicsScene.
 - 
						
QGraphicsTextItem: The QGraphicsTextItem class provides a text item that you can add to a QGraphicsScene to display formatted text.
 - 
						
QGraphicsTransform: The QGraphicsTransform class is an abstract base class for building advanced transformations on QGraphicsItems.
 - 
						
QGraphicsView: The QGraphicsView class provides a widget for displaying the contents of a QGraphicsScene.
 - 
						
QGraphicsWidget: The QGraphicsWidget class is the base class for all widget items in a QGraphicsScene.
 - 
						
QStyleOptionGraphicsItem: The QStyleOptionGraphicsItem class is used to describe the parameters needed to draw a QGraphicsItem.
 
Model/View Classes▲
- 
						
QAbstractItemDelegate: The QAbstractItemDelegate class is used to display and edit data items from a model.
 - 
						
QAbstractItemModel: The QAbstractItemModel class provides the abstract interface for item model classes.
 - 
						
QAbstractItemView: The QAbstractItemView class provides the basic functionality for item view classes.
 - 
						
QAbstractListModel: The QAbstractListModel class provides an abstract model that can be subclassed to create one-dimensional list models.
 - 
						
QAbstractProxyModel: The QAbstractProxyModel class provides a base class for proxy item models that can do sorting, filtering or other data processing tasks.
 - 
						
QAbstractTableModel: The QAbstractTableModel class provides an abstract model that can be subclassed to create table models.
 - 
						
QColumnView: The QColumnView class provides a model/view implementation of a column view.
 - 
						
QConcatenateTablesProxyModel: The QConcatenateTablesProxyModel class proxies multiple source models, concatenating their rows.
 - 
						
QDataWidgetMapper: The QDataWidgetMapper class provides mapping between a section of a data model to widgets.
 - 
						
QFileSystemModel: The QFileSystemModel class provides a data model for the local filesystem.
 - 
						
QHeaderView: The QHeaderView class provides a header row or header column for item views.
 - 
						
QIdentityProxyModel: The QIdentityProxyModel class proxies its source model unmodified.
 - 
						
QItemDelegate: The QItemDelegate class provides display and editing facilities for data items from a model.
 - 
						
QItemEditorCreator: The QItemEditorCreator class makes it possible to create item editor creator bases without subclassing QItemEditorCreatorBase.
 - 
						
QItemEditorCreatorBase: The QItemEditorCreatorBase class provides an abstract base class that must be subclassed when implementing new item editor creators.
 - 
						
QItemEditorFactory: The QItemEditorFactory class provides widgets for editing item data in views and delegates.
 - 
						
QItemSelection: The QItemSelection class manages information about selected items in a model.
 - 
						
QItemSelectionModel: The QItemSelectionModel class keeps track of a view's selected items.
 - 
						
QItemSelectionRange: The QItemSelectionRange class manages information about a range of selected items in a model.
 - 
						
QListView: The QListView class provides a list or icon view onto a model.
 - 
						
QListWidget: The QListWidget class provides an item-based list widget.
 - 
						
QListWidgetItem: The QListWidgetItem class provides an item for use with the QListWidget item view class.
 - 
						
QModelIndex: The QModelIndex class is used to locate data in a data model.
 - 
						
QModelRoleData: The QModelRoleData class holds a role and the data associated to that role.
 - 
						
QModelRoleDataSpan: The QModelRoleDataSpan class provides a span over QModelRoleData objects.
 - 
						
QPersistentModelIndex: The QPersistentModelIndex class is used to locate data in a data model.
 - 
						
QSortFilterProxyModel: The QSortFilterProxyModel class provides support for sorting and filtering data passed between another model and a view.
 - 
						
QStandardItem: The QStandardItem class provides an item for use with the QStandardItemModel class.
 - 
						
QStandardItemEditorCreator: The QStandardItemEditorCreator class provides the possibility to register widgets without having to subclass QItemEditorCreatorBase.
 - 
						
QStandardItemModel: The QStandardItemModel class provides a generic model for storing custom data.
 - 
						
QStringListModel: The QStringListModel class provides a model that supplies strings to views.
 - 
						
QStyledItemDelegate: The QStyledItemDelegate class provides display and editing facilities for data items from a model.
 - 
						
QTableView: The QTableView class provides a default model/view implementation of a table view.
 - 
						
QTableWidget: The QTableWidget class provides an item-based table view with a default model.
 - 
						
QTableWidgetItem: The QTableWidgetItem class provides an item for use with the QTableWidget class.
 - 
						
QTableWidgetSelectionRange: The QTableWidgetSelectionRange class provides a way to interact with selection in a model without using model indexes and a selection model.
 - 
						
QTreeView: The QTreeView class provides a default model/view implementation of a tree view.
 - 
						
QTreeWidget: The QTreeWidget class provides a tree view that uses a predefined tree model.
 - 
						
QTreeWidgetItem: The QTreeWidgetItem class provides an item for use with the QTreeWidget convenience class.
 - 
						
QTreeWidgetItemIterator: The QTreeWidgetItemIterator class provides a way to iterate over the items in a QTreeWidget instance.
 
Main Window and Related Classes▲
Widget Appearance and Style-Related Classes▲
- 
						
QColor: The QColor class provides colors based on RGB, HSV or CMYK values.
 - 
						
QColorSpace: The QColorSpace class provides a color space abstraction.
 - 
						
QColorTransform: The QColorTransform class is a transformation between color spaces.
 - 
						
QCommonStyle: The QCommonStyle class encapsulates the common Look and Feel of a GUI.
 - 
						
QCursor: The QCursor class provides a mouse cursor with an arbitrary shape.
 - 
						
QFont: The QFont class specifies a query for a font used for drawing text.
 - 
						
QFontDatabase: The QFontDatabase class provides information about the fonts available in the underlying window system.
 - 
						
QFontInfo: The QFontInfo class provides general information about fonts.
 - 
						
QGraphicsAnchor: The QGraphicsAnchor class represents an anchor between two items in a QGraphicsAnchorLayout.
 - 
						
QGraphicsAnchorLayout: The QGraphicsAnchorLayout class provides a layout where one can anchor widgets together in Graphics View.
 - 
						
QPalette: The QPalette class contains color groups for each widget state.
 - 
						
QStyle: The QStyle class is an abstract base class that encapsulates the look and feel of a GUI.
 - 
						
QStyleFactory: The QStyleFactory class creates QStyle objects.
 - 
						
QStyleHintReturn: The QStyleHintReturn class provides style hints that return more than basic data types.
 - 
						
QStyleHintReturnMask: The QStyleHintReturnMask class provides style hints that return a QRegion.
 - 
						
QStyleHintReturnVariant: The QStyleHintReturnVariant class provides style hints that return a QVariant.
 - 
						
QStyleOption: The QStyleOption class stores the parameters used by QStyle functions.
 - 
						
QStylePainter: The QStylePainter class is a convenience class for drawing QStyle elements inside a widget.
 
Layout Classes▲
- 
						
QBoxLayout: The QBoxLayout class lines up child widgets horizontally or vertically.
 - 
						
QButtonGroup: The QButtonGroup class provides a container to organize groups of button widgets.
 - 
						
QFormLayout: The QFormLayout class manages forms of input widgets and their associated labels.
 - 
						
QGraphicsAnchor: The QGraphicsAnchor class represents an anchor between two items in a QGraphicsAnchorLayout.
 - 
						
QGraphicsAnchorLayout: The QGraphicsAnchorLayout class provides a layout where one can anchor widgets together in Graphics View.
 - 
						
QGridLayout: The QGridLayout class lays out widgets in a grid.
 - 
						
QGroupBox: The QGroupBox widget provides a group box frame with a title.
 - 
						
QHBoxLayout: The QHBoxLayout class lines up widgets horizontally.
 - 
						
QLayout: The QLayout class is the base class of geometry managers.
 - 
						
QLayoutItem: The QLayoutItem class provides an abstract item that a QLayout manipulates.
 - 
						
QSizePolicy: The QSizePolicy class is a layout attribute describing horizontal and vertical resizing policy.
 - 
						
QSpacerItem: The QSpacerItem class provides blank space in a layout.
 - 
						
QStackedLayout: The QStackedLayout class provides a stack of widgets where only one widget is visible at a time.
 - 
						
QStackedWidget: The QStackedWidget class provides a stack of widgets where only one widget is visible at a time.
 - 
						
QVBoxLayout: The QVBoxLayout class lines up widgets vertically.
 - 
						
QWidgetItem: The QWidgetItem class is a layout item that represents a widget.
 











