Doc: Remove references to screenshots illustrating different styles

... from widget class descriptions.

Use one screenshot from Windows instead.

The styles change and the screenshots become outdated very fast, so
it is easier to update just one screenshot now and then. The styles
can still be seen in the style gallery topics.

The image files will be removed in a follow-up commit after all
references to them have been removed.

Change-Id: Id326c141f4884a2e4f67a4fe8681d8c65f8b24ba
Reviewed-by: Martin Smith <martin.smith@qt.io>
This commit is contained in:
Leena Miettinen 2017-05-31 10:32:39 +02:00
parent 96d6e03163
commit 22a52d1d64
22 changed files with 51 additions and 231 deletions

View File

@ -73,6 +73,8 @@ extern bool qt_sendSpontaneousEvent(QObject *receiver, QEvent *event);
\ingroup advanced \ingroup advanced
\inmodule QtWidgets \inmodule QtWidgets
\image windows-listview.png
A QListView presents items stored in a model, either as a simple A QListView presents items stored in a model, either as a simple
non-hierarchical list, or as a collection of icons. This class is used non-hierarchical list, or as a collection of icons. This class is used
to provide lists and icon views that were previously provided by the to provide lists and icon views that were previously provided by the
@ -111,15 +113,6 @@ extern bool qt_sendSpontaneousEvent(QObject *receiver, QEvent *event);
within a notional grid of size specified by gridSize(). The items can within a notional grid of size specified by gridSize(). The items can
be rendered as large or small icons depending on their iconSize(). be rendered as large or small icons depending on their iconSize().
\table 100%
\row \li \inlineimage windowsvista-listview.png Screenshot of a Windows Vista style list view
\li \inlineimage macintosh-listview.png Screenshot of a Macintosh style table view
\li \inlineimage fusion-listview.png Screenshot of a Fusion style table view
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} list view.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} list view.
\li A \l{Fusion Style Widget Gallery}{Fusion style} list view.
\endtable
\section1 Improving Performance \section1 Improving Performance
It is possible to give the view hints about the data it is handling in order It is possible to give the view hints about the data it is handling in order

View File

@ -1149,6 +1149,8 @@ void QListWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft,
\ingroup model-view \ingroup model-view
\inmodule QtWidgets \inmodule QtWidgets
\image windows-listview.png
QListWidget is a convenience class that provides a list view similar to the QListWidget is a convenience class that provides a list view similar to the
one supplied by QListView, but with a classic item-based interface for one supplied by QListView, but with a classic item-based interface for
adding and removing items. QListWidget uses an internal model to manage adding and removing items. QListWidget uses an internal model to manage
@ -1191,15 +1193,6 @@ void QListWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft,
current item changes, the currentItemChanged() signal is emitted with the current item changes, the currentItemChanged() signal is emitted with the
new current item and the item that was previously current. new current item and the item that was previously current.
\table 100%
\row \li \inlineimage windowsvista-listview.png Screenshot of a Windows Vista style list widget
\li \inlineimage macintosh-listview.png Screenshot of a Macintosh style table widget
\li \inlineimage fusion-listview.png Screenshot of a Fusion style table widget
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} list widget.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} list widget.
\li A \l{Fusion Style Widget Gallery}{Fusion style} list widget.
\endtable
\sa QListWidgetItem, QListView, QTreeView, {Model/View Programming}, \sa QListWidgetItem, QListView, QTreeView, {Model/View Programming},
{Config Dialog Example} {Config Dialog Example}
*/ */

View File

@ -988,6 +988,8 @@ int QTableViewPrivate::heightHintForIndex(const QModelIndex &index, int hint, QS
\ingroup advanced \ingroup advanced
\inmodule QtWidgets \inmodule QtWidgets
\image windows-tableview.png
A QTableView implements a table view that displays items from a A QTableView implements a table view that displays items from a
model. This class is used to provide standard tables that were model. This class is used to provide standard tables that were
previously provided by the QTable class, but using the more previously provided by the QTable class, but using the more
@ -1052,21 +1054,6 @@ int QTableViewPrivate::heightHintForIndex(const QModelIndex &index, int hint, QS
columnViewportPosition() functions provide the equivalent conversion columnViewportPosition() functions provide the equivalent conversion
operations between x-coordinates and column indexes. operations between x-coordinates and column indexes.
\section1 Styles
QTableView is styled appropriately for each platform. The following images show
how it looks on three different platforms. Go to the \l{Qt Widget Gallery} to see
its appearance in other styles.
\table 100%
\row \li \inlineimage windowsvista-tableview.png Screenshot of a Windows Vista style table view
\li \inlineimage macintosh-tableview.png Screenshot of a Macintosh style table view
\li \inlineimage fusion-tableview.png Screenshot of a Fusion style table view
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} table view.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} table view.
\li A \l{Fusion Style Widget Gallery}{Fusion style} table view.
\endtable
\sa QTableWidget, {View Classes}, QAbstractItemModel, QAbstractItemView, \sa QTableWidget, {View Classes}, QAbstractItemModel, QAbstractItemView,
{Chart Example}, {Pixelator Example}, {Table Model Example} {Chart Example}, {Pixelator Example}, {Table Model Example}
*/ */

View File

@ -1504,6 +1504,8 @@ QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
\ingroup model-view \ingroup model-view
\inmodule QtWidgets \inmodule QtWidgets
\image windows-tableview.png
Table widgets provide standard table display facilities for applications. Table widgets provide standard table display facilities for applications.
The items in a QTableWidget are provided by QTableWidgetItem. The items in a QTableWidget are provided by QTableWidgetItem.
@ -1545,15 +1547,6 @@ QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
number of columns with columnCount(). The table can be cleared with the number of columns with columnCount(). The table can be cleared with the
clear() function. clear() function.
\table 100%
\row \li \inlineimage windowsvista-tableview.png Screenshot of a Windows Vista style table widget
\li \inlineimage macintosh-tableview.png Screenshot of a Macintosh style table widget
\li \inlineimage fusion-tableview.png Screenshot of a Fusion style table widget
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} table widget.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} table widget.
\li A \l{Fusion Style Widget Gallery}{Fusion style} table widget.
\endtable
\sa QTableWidgetItem, QTableView, {Model/View Programming} \sa QTableWidgetItem, QTableView, {Model/View Programming}
*/ */

View File

@ -71,6 +71,8 @@ QT_BEGIN_NAMESPACE
\ingroup advanced \ingroup advanced
\inmodule QtWidgets \inmodule QtWidgets
\image windows-treeview.png
A QTreeView implements a tree representation of items from a A QTreeView implements a tree representation of items from a
model. This class is used to provide standard hierarchical lists that model. This class is used to provide standard hierarchical lists that
were previously provided by the \c QListView class, but using the more were previously provided by the \c QListView class, but using the more
@ -150,15 +152,6 @@ QT_BEGIN_NAMESPACE
Describe the expanding/collapsing concept if not covered elsewhere. Describe the expanding/collapsing concept if not covered elsewhere.
\endomit \endomit
\table 100%
\row \li \inlineimage windowsvista-treeview.png Screenshot of a Windows Vista style tree view
\li \inlineimage macintosh-treeview.png Screenshot of a Macintosh style tree view
\li \inlineimage fusion-treeview.png Screenshot of a Fusion style tree view
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} tree view.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} tree view.
\li A \l{Fusion Style Widget Gallery}{Fusion style} tree view.
\endtable
\section1 Improving Performance \section1 Improving Performance
It is possible to give the view hints about the data it is handling in order It is possible to give the view hints about the data it is handling in order

View File

@ -2354,6 +2354,8 @@ void QTreeWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft,
\ingroup model-view \ingroup model-view
\inmodule QtWidgets \inmodule QtWidgets
\image windows-treeview.png
The QTreeWidget class is a convenience class that provides a standard The QTreeWidget class is a convenience class that provides a standard
tree widget with a classic item-based interface similar to that used by tree widget with a classic item-based interface similar to that used by
the QListView class in Qt 3. the QListView class in Qt 3.
@ -2387,15 +2389,6 @@ void QTreeWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft,
\l{QTreeView::isSortingEnabled()}{isSortingEnabled()} function indicates \l{QTreeView::isSortingEnabled()}{isSortingEnabled()} function indicates
whether sorting is enabled. whether sorting is enabled.
\table 100%
\row \li \inlineimage windowsvista-treeview.png Screenshot of a Windows Vista style tree widget
\li \inlineimage macintosh-treeview.png Screenshot of a Macintosh style tree widget
\li \inlineimage fusion-treeview.png Screenshot of a Fusion style tree widget
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} tree widget.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} tree widget.
\li A \l{Fusion Style Widget Gallery}{Fusion style} tree widget.
\endtable
\sa QTreeWidgetItem, QTreeWidgetItemIterator, QTreeView, \sa QTreeWidgetItem, QTreeWidgetItemIterator, QTreeView,
{Model/View Programming}, {Settings Editor Example} {Model/View Programming}, {Settings Editor Example}
*/ */

View File

@ -73,6 +73,8 @@ public:
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-checkbox.png
A QCheckBox is an option button that can be switched on (checked) or off A QCheckBox is an option button that can be switched on (checked) or off
(unchecked). Checkboxes are typically used to represent features in an (unchecked). Checkboxes are typically used to represent features in an
application that can be enabled or disabled without affecting others. application that can be enabled or disabled without affecting others.
@ -117,18 +119,6 @@ public:
setAutoRepeat(), toggle(), pressed(), released(), clicked(), toggled(), setAutoRepeat(), toggle(), pressed(), released(), clicked(), toggled(),
checkState(), and stateChanged(). checkState(), and stateChanged().
\table 100%
\row
\li \inlineimage macintosh-checkbox.png Screenshot of a Macintosh style checkbox
\li A checkbox shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row
\li \inlineimage windowsvista-checkbox.png Screenshot of a Windows Vista style checkbox
\li A checkbox shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row
\li \inlineimage fusion-checkbox.png Screenshot of a Fusion style checkbox
\li A checkbox shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QAbstractButton, QRadioButton, {fowler}{GUI Design Handbook: Check Box} \sa QAbstractButton, QRadioButton, {fowler}{GUI Design Handbook: Check Box}
*/ */

View File

@ -900,6 +900,8 @@ QComboBox::QComboBox(QComboBoxPrivate &dd, QWidget *parent)
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-combobox.png
A QComboBox provides a means of presenting a list of options to the user A QComboBox provides a means of presenting a list of options to the user
in a way that takes up the minimum amount of screen space. in a way that takes up the minimum amount of screen space.
@ -960,8 +962,6 @@ QComboBox::QComboBox(QComboBoxPrivate &dd, QWidget *parent)
of the view(), e.g., by using of the view(), e.g., by using
\l{QAbstractItemView::}{setSelectionMode()}. \l{QAbstractItemView::}{setSelectionMode()}.
\image qstyle-comboboxes.png Comboboxes in the different built-in styles.
\sa QLineEdit, QSpinBox, QRadioButton, QButtonGroup, \sa QLineEdit, QSpinBox, QRadioButton, QButtonGroup,
{fowler}{GUI Design Handbook: Combo Box, Drop-Down List Box} {fowler}{GUI Design Handbook: Combo Box, Drop-Down List Box}
*/ */

View File

@ -76,6 +76,8 @@ QT_BEGIN_NAMESPACE
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-datetimeedit.png
QDateTimeEdit allows the user to edit dates by using the keyboard or QDateTimeEdit allows the user to edit dates by using the keyboard or
the arrow keys to increase and decrease date and time values. The the arrow keys to increase and decrease date and time values. The
arrow keys can be used to move from section to section within the arrow keys can be used to move from section to section within the
@ -103,15 +105,6 @@ QT_BEGIN_NAMESPACE
calendar pop-up by calling the setCalendarWidget() function. The existing calendar pop-up by calling the setCalendarWidget() function. The existing
calendar widget can be retrieved with calendarWidget(). calendar widget can be retrieved with calendarWidget().
\table 100%
\row \li \inlineimage windowsvista-datetimeedit.png Screenshot of a Windows Vista style date time editing widget
\li A date time editing widget shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage macintosh-datetimeedit.png Screenshot of a Macintosh style date time editing widget
\li A date time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \li \inlineimage fusion-datetimeedit.png Screenshot of a Fusion style date time editing widget
\li A date time editing widget shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QDateEdit, QTimeEdit, QDate, QTime \sa QDateEdit, QTimeEdit, QDate, QTime
*/ */
@ -1505,6 +1498,8 @@ void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-timeedit.png
Many of the properties and functions provided by QTimeEdit are implemented in Many of the properties and functions provided by QTimeEdit are implemented in
QDateTimeEdit. These are the relevant properties of this class: QDateTimeEdit. These are the relevant properties of this class:
@ -1518,15 +1513,6 @@ void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
to format the time displayed in the widget. to format the time displayed in the widget.
\endlist \endlist
\table 100%
\row \li \inlineimage windowsvista-timeedit.png Screenshot of a Windows Vista style time editing widget
\li A time editing widget shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage macintosh-timeedit.png Screenshot of a Macintosh style time editing widget
\li A time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \li \inlineimage fusion-timeedit.png Screenshot of a Fusion style time editing widget
\li A time editing widget shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QDateEdit, QDateTimeEdit \sa QDateEdit, QDateTimeEdit
*/ */
@ -1582,6 +1568,8 @@ QTimeEdit::~QTimeEdit()
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-dateedit.png
Many of the properties and functions provided by QDateEdit are implemented in Many of the properties and functions provided by QDateEdit are implemented in
QDateTimeEdit. These are the relevant properties of this class: QDateTimeEdit. These are the relevant properties of this class:
@ -1595,15 +1583,6 @@ QTimeEdit::~QTimeEdit()
to format the date displayed in the widget. to format the date displayed in the widget.
\endlist \endlist
\table 100%
\row \li \inlineimage windowsvista-dateedit.png Screenshot of a Windows Vista style date editing widget
\li A date editing widget shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage macintosh-dateedit.png Screenshot of a Macintosh style date editing widget
\li A date editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \li \inlineimage fusion-dateedit.png Screenshot of a Fusion style date editing widget
\li A date editing widget shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QTimeEdit, QDateTimeEdit \sa QTimeEdit, QDateTimeEdit
*/ */

View File

@ -179,6 +179,8 @@ int QDialPrivate::valueFromPoint(const QPoint &p) const
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-dial.png
QDial is used when the user needs to control a value within a QDial is used when the user needs to control a value within a
program-definable range, and the range either wraps around program-definable range, and the range either wraps around
(for example, with angles measured from 0 to 359 degrees) or the (for example, with angles measured from 0 to 359 degrees) or the
@ -226,16 +228,6 @@ int QDialPrivate::valueFromPoint(const QPoint &p) const
by \l {QAbstractSlider::singleStep} {singleStep}, and by \l {QAbstractSlider::singleStep} {singleStep}, and
\l {QAbstractSlider::pageStep} {pageStep}. \l {QAbstractSlider::pageStep} {pageStep}.
\table
\row \li \inlineimage fusion-dial.png Screenshot of a dial in the Fusion widget style
\li \inlineimage windowsvista-dial.png Screenshot of a dial in the Windows Vista widget style
\li \inlineimage macintosh-dial.png Screenshot of a dial in the Macintosh widget style
\row \li {3,1} Dials shown in various widget styles (from left to right):
\l{Fusion Style Widget Gallery}{Fusion},
\l{Windows Vista Style Widget Gallery}{Windows Vista},
\l{Macintosh Style Widget Gallery}{Macintosh}.
\endtable
\sa QScrollBar, QSpinBox, QSlider, {fowler}{GUI Design Handbook: Slider}, {Sliders Example} \sa QScrollBar, QSpinBox, QSlider, {fowler}{GUI Design Handbook: Slider}, {Sliders Example}
*/ */

View File

@ -145,6 +145,8 @@ void QGroupBoxPrivate::click()
\ingroup geomanagement \ingroup geomanagement
\inmodule QtWidgets \inmodule QtWidgets
\image windows-groupbox.png
A group box provides a frame, a title on top, a keyboard shortcut, and A group box provides a frame, a title on top, a keyboard shortcut, and
displays various other widgets inside itself. The keyboard shortcut moves displays various other widgets inside itself. The keyboard shortcut moves
keyboard focus to one of the group box's child widgets. keyboard focus to one of the group box's child widgets.
@ -166,15 +168,6 @@ void QGroupBoxPrivate::click()
\snippet widgets/groupbox/window.cpp 2 \snippet widgets/groupbox/window.cpp 2
\table 100%
\row \li \inlineimage windowsvista-groupbox.png Screenshot of a Windows Vista style group box
\li \inlineimage macintosh-groupbox.png Screenshot of a Macintosh style group box
\li \inlineimage fusion-groupbox.png Screenshot of a Fusion style group box
\row \li A \l{Windows Vista Style Widget Gallery}{Windows Vista style} group box.
\li A \l{Macintosh Style Widget Gallery}{Macintosh style} group box.
\li A \l{Fusion Style Widget Gallery}{Fusion style} group box.
\endtable
\sa QButtonGroup, {Group Box Example} \sa QButtonGroup, {Group Box Example}
*/ */

View File

@ -116,6 +116,8 @@ QLabelPrivate::~QLabelPrivate()
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-label.png
QLabel is used for displaying text or an image. No user QLabel is used for displaying text or an image. No user
interaction functionality is provided. The visual appearance of interaction functionality is provided. The visual appearance of
the label can be configured in various ways, and it can be used the label can be configured in various ways, and it can be used
@ -181,18 +183,6 @@ QLabelPrivate::~QLabelPrivate()
was a button (inheriting from QAbstractButton), triggering the was a button (inheriting from QAbstractButton), triggering the
mnemonic would emulate a button click. mnemonic would emulate a button click.
\table 100%
\row
\li \inlineimage macintosh-label.png Screenshot of a Macintosh style label
\li A label shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row
\li \inlineimage fusion-label.png Screenshot of a Fusion style label
\li A label shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\row
\li \inlineimage windowsvista-label.png Screenshot of a Windows Vista style label
\li A label shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\endtable
\sa QLineEdit, QTextEdit, QPixmap, QMovie, \sa QLineEdit, QTextEdit, QPixmap, QMovie,
{fowler}{GUI Design Handbook: Label} {fowler}{GUI Design Handbook: Label}
*/ */

View File

@ -74,6 +74,8 @@ public:
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-lcdnumber.png
It can display a number in just about any size. It can display It can display a number in just about any size. It can display
decimal, hexadecimal, octal or binary numbers. It is easy to decimal, hexadecimal, octal or binary numbers. It is easy to
connect to data sources using the display() slot, which is connect to data sources using the display() slot, which is
@ -103,17 +105,6 @@ public:
Incidentally, QLCDNumber is the very oldest part of Qt, tracing Incidentally, QLCDNumber is the very oldest part of Qt, tracing
its roots back to a BASIC program on the \l{Sinclair Spectrum}{Sinclair Spectrum}. its roots back to a BASIC program on the \l{Sinclair Spectrum}{Sinclair Spectrum}.
\table
\row \li
\inlineimage windows-lcdnumber.png Screenshot of a Windows style LCD number widget
\inlineimage windowsvista-lcdnumber.png Screenshot of a Windows Vista style LCD number widget
\inlineimage macintosh-lcdnumber.png Screenshot of a Macintosh style LCD number widget
\inlineimage fusion-lcdnumber.png Screenshot of a Fusion style LCD number widget
\row \li LCD number widgets shown in various widget styles (from left to right):
\l{Windows Style Widget Gallery}{Windows}, \l{Windows Vista Style Widget Gallery}{Windows Vista},
\l{Macintosh Style Widget Gallery}{Macintosh}, \l{Fusion Style Widget Gallery}{Fusion}.
\endtable
\sa QLabel, QFrame, {Digital Clock Example}, {Tetrix Example} \sa QLabel, QFrame, {Digital Clock Example}, {Tetrix Example}
*/ */

View File

@ -128,6 +128,8 @@ void QLineEdit::initStyleOption(QStyleOptionFrame *option) const
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-lineedit.png
A line edit allows the user to enter and edit a single line of A line edit allows the user to enter and edit a single line of
plain text with a useful collection of editing functions, plain text with a useful collection of editing functions,
including undo and redo, cut and paste, and drag and drop (see including undo and redo, cut and paste, and drag and drop (see
@ -142,7 +144,6 @@ void QLineEdit::initStyleOption(QStyleOptionFrame *option) const
on the same line edit, it is best to clear the validator or input mask to on the same line edit, it is best to clear the validator or input mask to
prevent undefined behavior. prevent undefined behavior.
A related class is QTextEdit which allows multi-line, rich text A related class is QTextEdit which allows multi-line, rich text
editing. editing.
@ -202,15 +203,6 @@ void QLineEdit::initStyleOption(QStyleOptionFrame *option) const
Any other key sequence that represents a valid character, will Any other key sequence that represents a valid character, will
cause the character to be inserted into the line edit. cause the character to be inserted into the line edit.
\table 100%
\row \li \inlineimage macintosh-lineedit.png Screenshot of a Macintosh style line edit
\li A line edit shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \li \inlineimage windowsvista-lineedit.png Screenshot of a Windows Vista style line edit
\li A line edit shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage fusion-lineedit.png Screenshot of a Fusion style line edit
\li A line edit shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QTextEdit, QLabel, QComboBox, {fowler}{GUI Design Handbook: Field, Entry}, {Line Edits Example} \sa QTextEdit, QLabel, QComboBox, {fowler}{GUI Design Handbook: Field, Entry}, {Line Edits Example}
*/ */

View File

@ -1534,6 +1534,8 @@ void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action)
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image fusion-menu.png
A menu widget is a selection menu. It can be either a pull-down A menu widget is a selection menu. It can be either a pull-down
menu in a menu bar or a standalone context menu. Pull-down menus menu in a menu bar or a standalone context menu. Pull-down menus
are shown by the menu bar when the user clicks on the respective are shown by the menu bar when the user clicks on the respective
@ -1545,16 +1547,6 @@ void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action)
response to button presses; these are just like context menus response to button presses; these are just like context menus
except for how they are invoked. except for how they are invoked.
\table 100%
\row
\li \inlineimage fusion-menu.png
\li \inlineimage windowsxp-menu.png
\li \inlineimage macintosh-menu.png
\endtable
\caption Fig. A menu shown in \l{Fusion Style Widget Gallery}{Fusion widget style},
\l{Windows XP Style Widget Gallery}{Windows XP widget style},
and \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\section1 Actions \section1 Actions
A menu consists of a list of action items. Actions are added with A menu consists of a list of action items. Actions are added with

View File

@ -177,6 +177,8 @@ bool QProgressBarPrivate::repaintRequired() const
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-progressbar.png
A progress bar is used to give the user an indication of the A progress bar is used to give the user an indication of the
progress of an operation and to reassure them that the application progress of an operation and to reassure them that the application
is still running. is still running.
@ -198,15 +200,6 @@ bool QProgressBarPrivate::repaintRequired() const
example, when using QNetworkAccessManager to download items when example, when using QNetworkAccessManager to download items when
they are unable to determine the size of the item being downloaded. they are unable to determine the size of the item being downloaded.
\table
\row \li \inlineimage macintosh-progressbar.png Screenshot of a Macintosh style progress bar
\li A progress bar shown in the Macintosh widget style.
\row \li \inlineimage windowsvista-progressbar.png Screenshot of a Windows Vista style progress bar
\li A progress bar shown in the Windows Vista widget style.
\row \li \inlineimage fusion-progressbar.png Screenshot of a Fusion style progress bar
\li A progress bar shown in the Fusion widget style.
\endtable
\sa QProgressDialog, {fowler}{GUI Design Handbook: Progress Indicator} \sa QProgressDialog, {fowler}{GUI Design Handbook: Progress Indicator}
*/ */

View File

@ -81,6 +81,8 @@ QT_BEGIN_NAMESPACE
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-pushbutton.jpg
The push button, or command button, is perhaps the most commonly The push button, or command button, is perhaps the most commonly
used widget in any graphical user interface. Push (click) a button used widget in any graphical user interface. Push (click) a button
to command the computer to perform some action, or to answer a to command the computer to perform some action, or to answer a
@ -152,6 +154,11 @@ QT_BEGIN_NAMESPACE
button is probably not what you want. When in doubt, use a tool button is probably not what you want. When in doubt, use a tool
button. button.
\note On \macos when a push button's width becomes smaller than 50 or
its height becomes smaller than 30, the button's corners are
changed from round to square. Use the setMinimumSize()
function to prevent this behavior.
A variation of a command button is a menu button. These provide A variation of a command button is a menu button. These provide
not just one command, but several, since when they are clicked not just one command, but several, since when they are clicked
they pop up a menu of options. Use the method setMenu() to they pop up a menu of options. Use the method setMenu() to
@ -160,20 +167,6 @@ QT_BEGIN_NAMESPACE
Other classes of buttons are option buttons (see QRadioButton) and Other classes of buttons are option buttons (see QRadioButton) and
check boxes (see QCheckBox). check boxes (see QCheckBox).
\table 100%
\row \li \inlineimage macintosh-pushbutton.png Screenshot of a Macintosh style push button
\li A push button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
Note that when a button's width becomes smaller than 50 or
its height becomes smaller than 30, the button's corners are
changed from round to square. Use the setMinimumSize()
function to prevent this behavior.
\row \li \inlineimage windowsvista-pushbutton.png Screenshot of a Windows Vista style push button
\li A push button shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage fusion-pushbutton.png Screenshot of a Fusion style push button
\li A push button shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
In Qt, the QAbstractButton base class provides most of the modes In Qt, the QAbstractButton base class provides most of the modes
and other API, and QPushButton provides GUI logic. and other API, and QPushButton provides GUI logic.

View File

@ -80,6 +80,8 @@ void QRadioButtonPrivate::init()
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-radiobutton.png
A QRadioButton is an option button that can be switched on (checked) or A QRadioButton is an option button that can be switched on (checked) or
off (unchecked). Radio buttons typically present the user with a "one off (unchecked). Radio buttons typically present the user with a "one
of many" choice. In a group of radio buttons, only one radio button at of many" choice. In a group of radio buttons, only one radio button at
@ -113,15 +115,6 @@ void QRadioButtonPrivate::init()
setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(), setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(),
toggle(), pressed(), released(), clicked(), and toggled(). toggle(), pressed(), released(), clicked(), and toggled().
\table 100%
\row \li \inlineimage fusion-radiobutton.png Screenshot of a Fusion radio button
\li A radio button shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\row \li \inlineimage windowsvista-radiobutton.png Screenshot of a Windows Vista radio button
\li A radio button shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage macintosh-radiobutton.png Screenshot of a Macintosh radio button
\li A radio button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\endtable
\sa QPushButton, QToolButton, QCheckBox, {fowler}{GUI Design Handbook: Radio Button}, \sa QPushButton, QToolButton, QCheckBox, {fowler}{GUI Design Handbook: Radio Button},
{Group Box Example} {Group Box Example}
*/ */

View File

@ -187,15 +187,6 @@ QT_BEGIN_NAMESPACE
Most GUI styles use the pageStep() value to calculate the size of the Most GUI styles use the pageStep() value to calculate the size of the
slider. slider.
\table 100%
\row \li \inlineimage macintosh-horizontalscrollbar.png Screenshot of a Macintosh style scroll bar
\li A scroll bar shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \li \inlineimage windowsvista-horizontalscrollbar.png Screenshot of a Windows Vista style scroll bar
\li A scroll bar shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage fusion-horizontalscrollbar.png Screenshot of a Fusion style scroll bar
\li A scroll bar shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QScrollArea, QSlider, QDial, QSpinBox, {fowler}{GUI Design Handbook: Scroll Bar}, {Sliders Example} \sa QScrollArea, QSlider, QDial, QSpinBox, {fowler}{GUI Design Handbook: Scroll Bar}, {Sliders Example}
*/ */

View File

@ -203,6 +203,8 @@ QStyle::SubControl QSliderPrivate::newHoverControl(const QPoint &pos)
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-slider.png
The slider is the classic widget for controlling a bounded value. The slider is the classic widget for controlling a bounded value.
It lets the user move a slider handle along a horizontal or vertical It lets the user move a slider handle along a horizontal or vertical
groove and translates the handle's position into an integer value groove and translates the handle's position into an integer value
@ -252,15 +254,6 @@ QStyle::SubControl QSliderPrivate::newHoverControl(const QPoint &pos)
\li End moves to the end (maximum). \li End moves to the end (maximum).
\endlist \endlist
\table 100%
\row \li \inlineimage macintosh-slider.png Screenshot of a Macintosh slider
\li A slider shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \li \inlineimage windowsvista-slider.png Screenshot of a Windows Vista slider
\li A slider shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage fusion-slider.png Screenshot of a Fusion slider
\li A slider shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\endtable
\sa QScrollBar, QSpinBox, QDial, {fowler}{GUI Design Handbook: Slider}, {Sliders Example} \sa QScrollBar, QSpinBox, QDial, {fowler}{GUI Design Handbook: Slider}, {Sliders Example}
*/ */

View File

@ -112,6 +112,8 @@ public:
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-spinbox.png
QSpinBox is designed to handle integers and discrete sets of QSpinBox is designed to handle integers and discrete sets of
values (e.g., month names); use QDoubleSpinBox for floating point values (e.g., month names); use QDoubleSpinBox for floating point
values. values.
@ -151,15 +153,6 @@ public:
choice in addition to the range of numeric values. See choice in addition to the range of numeric values. See
setSpecialValueText() for how to do this with QSpinBox. setSpecialValueText() for how to do this with QSpinBox.
\table 100%
\row \li \inlineimage windowsvista-spinbox.png Screenshot of a Windows Vista spin box
\li A spin box shown in the \l{Windows Vista Style Widget Gallery}{Windows Vista widget style}.
\row \li \inlineimage fusion-spinbox.png Screenshot of a Fusion spin box
\li A spin box shown in the \l{Fusion Style Widget Gallery}{Fusion widget style}.
\row \li \inlineimage macintosh-spinbox.png Screenshot of a Macintosh spin box
\li A spin box shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\endtable
\section1 Subclassing QSpinBox \section1 Subclassing QSpinBox
If using prefix(), suffix(), and specialValueText() don't provide If using prefix(), suffix(), and specialValueText() don't provide

View File

@ -64,6 +64,8 @@ QT_BEGIN_NAMESPACE
\ingroup basicwidgets \ingroup basicwidgets
\inmodule QtWidgets \inmodule QtWidgets
\image windows-tabwidget.png
A tab widget provides a tab bar (see QTabBar) and a "page area" A tab widget provides a tab bar (see QTabBar) and a "page area"
that is used to display pages related to each tab. By default, the that is used to display pages related to each tab. By default, the
tab bar is shown above the page area, but different configurations tab bar is shown above the page area, but different configurations
@ -117,15 +119,6 @@ QT_BEGIN_NAMESPACE
(at the top, providing the tabs) and a QStackedWidget (most of the (at the top, providing the tabs) and a QStackedWidget (most of the
area, organizing the individual pages). area, organizing the individual pages).
\table 100%
\row \li \inlineimage windowsvista-tabwidget.png Screenshot of a Windows Vista style tab widget
\li \inlineimage macintosh-tabwidget.png Screenshot of a Macintosh style tab widget
\li \inlineimage fusion-tabwidget.png Screenshot of a Fusion style tab widget
\row \li A Windows Vista style tab widget.
\li A Macintosh style tab widget.
\li A Fusion style tab widget.
\endtable
\sa QTabBar, QStackedWidget, QToolBox, {Tab Dialog Example} \sa QTabBar, QStackedWidget, QToolBox, {Tab Dialog Example}
*/ */