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 combines a button with a dropdown 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. 




