Move styles example to manual test

Pick-to: 6.5 6.6
Change-Id: I5738932c0c498ce2075a399274e3b80a04ad9211
Reviewed-by: Volker Hilsheimer <[email protected]>

15 files changed, 1 insertions, 526 deletions

diff --git a/examples/widgets/doc/src/styles.qdoc b/examples/widgets/doc/src/styles.qdoc
deleted file mode 100644
index 19ac0ee4526..00000000000
--- a/examples/widgets/doc/src/styles.qdoc
+++ /dev/null
@@ -1,448 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
-
-/*!
-    \example widgets/styles
-    \title Styles Example
-    \ingroup examples-widgets
-    \brief The Styles example illustrates how to create custom widget
-    drawing styles using Qt, and demonstrates Qt's predefined styles.
-
-    \borderedimage styles-enabledwood.png
-    \caption Screenshot of the Styles example
-
-    A style in Qt is a subclass of QStyle or of one of its
-    subclasses. Styles perform drawing on behalf of widgets. Qt
-    provides a whole range of predefined styles, either built into
-    the Qt Widgets module or found in plugins. Styles are usually
-    customized by subclassing QProxyStyle and reimplementing a few
-    virtual functions. While QProxyStyle provides a transparent way
-    to customize either a specific style or the appropriate platform's
-    default style, Qt also provides QCommonStyle as a convenient base
-    for full custom style implementations.
-
-    In this example, the custom style is called \c NorwegianWoodStyle
-    and derives from QProxyStyle. Its main features are the wooden
-    textures used for filling most of the widgets and its round
-    buttons and comboboxes.
-
-    To implement the style, we use some advanced features provided by
-    QPainter, such as \l{QPainter::Antialiasing}{antialiasing} (to
-    obtain smoother button edges), \l{QColor::alpha()}{alpha blending}
-    (to make the buttons appeared raised or sunken), and
-    \l{QPainterPath}{painter paths} (to fill the buttons and draw the
-    outline). We also use many features of QBrush and QPalette.
-
-    The example consists of the following classes:
-
-    \list
-    \li \c NorwegianWoodStyle inherits from QProxyStyle and implements
-        the Norwegian Wood style.
-    \li \c WidgetGallery is a \c QDialog subclass that shows the most
-       common widgets and allows the user to switch style
-       dynamically.
-    \endlist
-
-    \section1 NorwegianWoodStyle Class Definition
-
-    Here's the definition of the \c NorwegianWoodStyle class:
-
-    \snippet widgets/styles/norwegianwoodstyle.h 0
-
-    The public functions are all declared in QStyle (QProxyStyle's
-    grandparent class) and reimplemented here to override the Windows
-    look and feel. The private functions are helper functions.
-
-    \section1 NorwegianWoodStyle Class Implementation
-
-    We will now review the implementation of the \c
-    NorwegianWoodStyle class.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 0
-
-    The \c standardPalette() function is reimplemented from QStyle.
-    It returns a QPalette with the style's preferred colors and textures.
-    Most styles don't need to reimplement that function. The
-    Norwegian Wood style reimplements it to set a "wooden" palette.
-
-    We start by defining a few \l{QColor}s that we'll need. Then we
-    load two PNG images. The \c : prefix in the file path indicates
-    that the PNG files are \l{The Qt Resource System}{embedded
-    resources}.
-
-    \table
-    \row \li \inlineimage widgets/styles/images/woodbackground.png
-
-         \li \b{woodbackground.png}
-
-            This texture is used as the background of most widgets.
-            The wood pattern is horizontal.
-
-    \row \li \inlineimage widgets/styles/images/woodbutton.png
-
-         \li \b{woodbutton.png}
-
-            This texture is used for filling push buttons and
-            comboboxes. The wood pattern is vertical and more reddish
-            than the texture used for the background.
-    \endtable
-
-    The \c midImage variable is initialized to be the same as \c
-    buttonImage, but then we use a QPainter and fill it with a 25%
-    opaque black color (a black with an \l{QColor::alpha()}{alpha
-    channel} of 63). The result is a somewhat darker image than \c
-    buttonImage. This image will be used for filling buttons that the
-    user is holding down.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 1
-
-    We initialize the palette. Palettes have various
-    \l{QPalette::ColorRole}{color roles}, such as QPalette::Base
-    (used for filling text editors, item views, etc.), QPalette::Text
-    (used for foreground text), and QPalette::Window (used for
-    the background of most widgets). Each role has its own QBrush,
-    which usually is a plain color but can also be a brush pattern or
-    even a texture (a QPixmap).
-
-    In addition to the roles, palettes have several
-    \l{QPalette::ColorGroup}{color groups}: active, disabled, and
-    inactive. The active color group is used for painting widgets in
-    the active window. The disabled group is used for disabled
-    widgets. The inactive group is used for all other widgets. Most
-    palettes have identical active and inactive groups, while the
-    disabled group uses darker shades.
-
-    We initialize the QPalette object with a brown color. Qt
-    automatically derivates all color roles for all color groups from
-    that single color. We then override some of the default values. For
-    example, we use Qt::darkGreen instead of the default
-    (Qt::darkBlue) for the QPalette::Highlight role. The
-    QPalette::setBrush() overload that we use here sets the same
-    color or brush for all three color groups.
-
-    The \c setTexture() function is a private function that sets the
-    texture for a certain color role, while preserving the existing
-    color in the QBrush. A QBrush can hold both a solid color and a
-    texture at the same time. The solid color is used for drawing
-    text and other graphical elements where textures don't look good.
-
-    At the end, we set the brush for the disabled color group of the
-    palette. We use \c woodbackground.png as the texture for all
-    disabled widgets, including buttons, and use a darker color to
-    accompany the texture.
-
-    \image styles-disabledwood.png The Norwegian Wood style with disabled widgets
-
-    Let's move on to the other functions reimplemented from
-    QProxyStyle:
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 3
-    \snippet widgets/styles/norwegianwoodstyle.cpp 4
-
-    This QStyle::polish() overload is called once on every widget
-    drawn using the style. We reimplement it to set the Qt::WA_Hover
-    attribute on \l{QPushButton}s and \l{QComboBox}es. When this
-    attribute is set, Qt generates paint events when the mouse
-    pointer enters or leaves the widget. This makes it possible to
-    render push buttons and comboboxes differently when the mouse
-    pointer is over them.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 5
-    \snippet widgets/styles/norwegianwoodstyle.cpp 6
-
-    This QStyle::unpolish() overload is called to undo any
-    modification done to the widget in \c polish(). For simplicity,
-    we assume that the flag wasn't set before \c polish() was called.
-    In an ideal world, we would remember the original state for each
-    widgets (e.g., using a QMap<QWidget *, bool>) and restore it in
-    \c unpolish().
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 7
-    \snippet widgets/styles/norwegianwoodstyle.cpp 8
-
-    The \l{QStyle::pixelMetric()}{pixelMetric()} function returns the
-    size in pixels for a certain user interface element. By
-    reimplementing this function, we can affect the way certain
-    widgets are drawn and their size hint. Here, we return 8 as the
-    width around a shown in a QComboBox, ensuring that there is
-    enough place around the text and the arrow for the Norwegian Wood
-    round corners. The default value for this setting in the Windows
-    style is 2.
-
-    We also change the extent of \l{QScrollBar}s, i.e., the height
-    for a horizontal scroll bar and the width for a vertical scroll
-    bar, to be 4 pixels more than in the Windows style. This makes the
-    style a bit more distinctive.
-
-    For all other QStyle::PixelMetric elements, we use the Windows
-    settings.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 9
-    \snippet widgets/styles/norwegianwoodstyle.cpp 10
-
-    The \l{QStyle::styleHint()}{styleHint()} function returns some
-    hints to widgets or to the base style (in our case QProxyStyle)
-    about how to draw the widgets. The Windows style returns \c true
-    for the QStyle::SH_DitherDisabledText hint, resulting in a most
-    unpleasing visual effect. We override this behavior and return \c
-    false instead. We also return \c true for the
-    QStyle::SH_EtchDisabledText hint, meaning that disabled text is
-    rendered with an embossed look.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 11
-    \snippet widgets/styles/norwegianwoodstyle.cpp 12
-
-    The \l{QStyle::drawPrimitive()}{drawPrimitive()} function is
-    called by Qt widgets to draw various fundamental graphical
-    elements. Here we reimplement it to draw QPushButton and
-    QComboBox with round corners. The button part of these widgets is
-    drawn using the QStyle::PE_PanelButtonCommand primitive element.
-
-    The \c option parameter, of type QStyleOption, contains
-    everything we need to know about the widget we want to draw on.
-    In particular, \c option->rect gives the rectangle within which
-    to draw the primitive element. The \c painter parameter is a
-    QPainter object that we can use to draw on the widget.
-
-    The \c widget parameter is the widget itself. Normally, all the
-    information we need is available in \c option and \c painter, so
-    we don't need \c widget. We can use it to perform special
-    effects; for example, QMacStyle uses it to animate default
-    buttons. If you use it, be aware that the caller is allowed to
-    pass a null pointer.
-
-    We start by defining three \l{QColor}s that we'll need later on.
-    We also put the x, y, width, and height components of the
-    widget's rectangle in local variables. The value used for the \c
-    semiTransparentWhite and for the \c semiTransparentBlack color's
-    alpha channel depends on whether the mouse cursor is over the
-    widget or not. Since we set the Qt::WA_Hover attribute on
-    \l{QPushButton}s and \l{QComboBox}es, we can rely on the
-    QStyle::State_MouseOver flag to be set when the mouse is over the
-    widget.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 13
-    \snippet widgets/styles/norwegianwoodstyle.cpp 14
-
-    The \c roundRect variable is a QPainterPath. A QPainterPath is
-    a vectorial specification of a shape. Any shape (rectangle,
-    ellipse, spline, etc.) or combination of shapes can be expressed
-    as a path. We will use \c roundRect both for filling the button
-    background with a wooden texture and for drawing the outline. The
-    \c roundRectPath() function is a private function; we will come
-    back to it later.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 15
-    \snippet widgets/styles/norwegianwoodstyle.cpp 16
-    \snippet widgets/styles/norwegianwoodstyle.cpp 17
-    \snippet widgets/styles/norwegianwoodstyle.cpp 18
-
-    We define two variables, \c brush and \c darker, and initialize
-    them based on the state of the button:
-
-    \list
-    \li If the button is a \l{QPushButton::flat}{flat button}, we use
-       the \l{QPalette::Window}{Window} brush. We set \c
-       darker to \c true if the button is
-       \l{QAbstractButton::down}{down} or
-       \l{QAbstractButton::checked}{checked}.
-    \li If the button is currently held down by the user or in the
-       \l{QAbstractButton::checked}{checked} state, we use the
-       \l{QPalette::Mid}{Mid} component of the palette. We set
-       \c darker to \c true if the button is
-       \l{QAbstractButton::checked}{checked}.
-    \li Otherwise, we use the \l{QPalette::Button}{Button} component
-       of the palette.
-    \endlist
-
-    The screenshot below illustrates how \l{QPushButton}s are
-    rendered based on their state:
-
-    \image styles-woodbuttons.png Norwegian Wood buttons in different states
-
-    To discover whether the button is flat or not, we need to cast
-    the \c option parameter to QStyleOptionButton and check if the
-    \l{QStyleOptionButton::features}{features} member specifies the
-    QStyleOptionButton::Flat flag. The qstyleoption_cast() function
-    performs a dynamic cast; if \c option is not a
-    QStyleOptionButton, qstyleoption_cast() returns a null pointer.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 19
-    \snippet widgets/styles/norwegianwoodstyle.cpp 20
-    \snippet widgets/styles/norwegianwoodstyle.cpp 21
-    \snippet widgets/styles/norwegianwoodstyle.cpp 22
-    \snippet widgets/styles/norwegianwoodstyle.cpp 23
-
-    We turn on antialiasing on QPainter. Antialiasing is a technique
-    that reduces the visual distortion that occurs when the edges of
-    a shape are converted into pixels. For the Norwegian Wood style,
-    we use it to obtain smoother edges for the round buttons.
-
-    \image styles-aliasing.png Norwegian wood buttons with and without antialiasing
-
-    The first call to QPainter::fillPath() draws the background of
-    the button with a wooden texture. The second call to
-    \l{QPainter::fillPath()}{fillPath()} paints the same area with a
-    semi-transparent black color (a black color with an alpha channel
-    of 63) to make the area darker if \c darker is true.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 24
-    \snippet widgets/styles/norwegianwoodstyle.cpp 25
-
-    Next, we draw the outline. The top-left half of the outline and
-    the bottom-right half of the outline are drawn using different
-    \l{QPen}s to produce a 3D effect. Normally, the top-left half of
-    the outline is drawn lighter whereas the bottom-right half is
-    drawn darker, but if the button is
-    \l{QAbstractButton::down}{down} or
-    \l{QAbstractButton::checked}{checked}, we invert the two
-    \l{QPen}s to give a sunken look to the button.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 26
-
-    We draw the top-left part of the outline by calling
-    QPainter::drawPath() with an appropriate
-    \l{QPainter::setClipRegion()}{clip region}. If the
-    \l{QStyleOption::direction}{layout direction} is right-to-left
-    instead of left-to-right, we swap the \c x1, \c x2, \c x3, and \c
-    x4 variables to obtain correct results. On right-to-left desktop,
-    the "light" comes from the top-right corner of the screen instead
-    of the top-left corner; raised and sunken widgets must be drawn
-    accordingly.
-
-    The diagram below illustrates how 3D effects are drawn according
-    to the layout direction. The area in red on the diagram
-    corresponds to the \c topHalf polygon:
-
-    \image styles-3d.png
-
-    An easy way to test how a style looks in right-to-left mode is to
-    pass the \c -reverse command-line option to the application. This
-    option is recognized by the QApplication constructor.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 32
-    \snippet widgets/styles/norwegianwoodstyle.cpp 33
-    \snippet widgets/styles/norwegianwoodstyle.cpp 34
-
-    The bottom-right part of the outline is drawn in a similar
-    fashion. Then we draw a one-pixel wide outline around the entire
-    button, using the \l{QPalette::WindowText}{WindowText} component
-    of the QPalette.
-
-    This completes the QStyle::PE_PanelButtonCommand case of the \c
-    switch statement. Other primitive elements are handled by the
-    base style. Let's now turn to the other \c NorwegianWoodStyle
-    member functions:
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 35
-    \snippet widgets/styles/norwegianwoodstyle.cpp 36
-
-    We reimplement QStyle::drawControl() to draw the text on a
-    QPushButton in a bright color when the button is
-    \l{QAbstractButton::down}{down} or
-    \l{QAbstractButton::checked}{checked}.
-
-    If the \c option parameter points to a QStyleOptionButton object
-    (it normally should), we take a copy of the object and modify its
-    \l{QStyleOption::palette}{palette} member to make the
-    QPalette::ButtonText be the same as the QPalette::BrightText
-    component (unless the widget is disabled).
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 37
-    \snippet widgets/styles/norwegianwoodstyle.cpp 38
-
-    The \c setTexture() function is a private function that sets the
-    \l{QBrush::texture()}{texture} component of the \l{QBrush}es for
-    a certain \l{QPalette::ColorRole}{color role}, for all three
-    \l{QPalette::ColorGroup}{color groups} (active, disabled,
-    inactive). We used it to initialize the Norwegian Wood palette in
-    \c standardPalette.
-
-    \snippet widgets/styles/norwegianwoodstyle.cpp 39
-    \snippet widgets/styles/norwegianwoodstyle.cpp 40
-
-    The \c roundRectPath() function is a private function that
-    constructs a QPainterPath object for round buttons. The path
-    consists of eight segments: four arc segments for the corners and
-    four lines for the sides.
-
-    With around 250 lines of code, we have a fully functional custom
-    style based on one of the predefined styles. Custom styles can be
-    used to provide a distinct look to an application or family of
-    applications.
-
-    \section1 WidgetGallery Class
-
-    For completeness, we will quickly review the \c WidgetGallery
-    class, which contains the most common Qt widgets and allows the
-    user to change style dynamically. Here's the class definition:
-
-    \snippet widgets/styles/widgetgallery.h 0
-    \dots
-    \snippet widgets/styles/widgetgallery.h 1
-
-    Here's the \c WidgetGallery constructor:
-
-    \snippet widgets/styles/widgetgallery.cpp 0
-
-    We start by creating child widgets. The \uicontrol Style combobox is
-    initialized with all the styles known to QStyleFactory, in
-    addition to \c NorwegianWood. The \c create...() functions are
-    private functions that set up the various parts of the \c
-    WidgetGallery.
-
-    \snippet widgets/styles/widgetgallery.cpp 1
-    \snippet widgets/styles/widgetgallery.cpp 2
-
-    We connect the \uicontrol Style combobox to the \c changeStyle()
-    private slot, the \uicontrol{Use style's standard palette} check box to
-    the \c changePalette() slot, and the \uicontrol{Disable widgets} check
-    box to the child widgets'
-    \l{QWidget::setDisabled()}{setDisabled()} slot.
-
-    \snippet widgets/styles/widgetgallery.cpp 3
-    \snippet widgets/styles/widgetgallery.cpp 4
-
-    Finally, we put the child widgets in layouts.
-
-    \snippet widgets/styles/widgetgallery.cpp 5
-    \snippet widgets/styles/widgetgallery.cpp 6
-
-    When the user changes the style in the combobox, we call
-    QApplication::setStyle() to dynamically change the style of the
-    application.
-
-    \snippet widgets/styles/widgetgallery.cpp 7
-    \snippet widgets/styles/widgetgallery.cpp 8
-
-    If the user turns the \uicontrol{Use style's standard palette} on, the
-    current style's \l{QStyle::standardPalette()}{standard palette}
-    is used; otherwise, the system's default palette is honored.
-
-    \snippet widgets/styles/widgetgallery.cpp 9
-    \snippet widgets/styles/widgetgallery.cpp 10
-
-    The \c advanceProgressBar() slot is called at regular intervals
-    to advance the progress bar. Since we don't know how long the
-    user will keep the Styles application running, we use a
-    logarithmic formula: The closer the progress bar gets to 100%,
-    the slower it advances.
-
-    We will review \c createProgressBar() in a moment.
-
-    \snippet widgets/styles/widgetgallery.cpp 11
-    \snippet widgets/styles/widgetgallery.cpp 12
-
-    The \c createTopLeftGroupBox() function creates the QGroupBox
-    that occupies the top-left corner of the \c WidgetGallery. We
-    skip the \c createTopRightGroupBox(), \c
-    createBottomLeftTabWidget(), and \c createBottomRightGroupBox()
-    functions, which are very similar.
-
-    \snippet widgets/styles/widgetgallery.cpp 13
-
-    In \c createProgressBar(), we create a QProgressBar at the bottom
-    of the \c WidgetGallery and connect its
-    \l{QTimer::timeout()}{timeout()} signal to the \c
-    advanceProgressBar() slot.
-*/
diff --git a/examples/widgets/widgets/CMakeLists.txt b/examples/widgets/widgets/CMakeLists.txt
index 43d03bdea25..d548c63ff8c 100644
--- a/examples/widgets/widgets/CMakeLists.txt
+++ b/examples/widgets/widgets/CMakeLists.txt
@@ -11,7 +11,6 @@ qt_internal_add_example(shapedclock)
 qt_internal_add_example(shortcuteditor)
 qt_internal_add_example(sliders)
 qt_internal_add_example(spinboxes)
-qt_internal_add_example(styles)
 qt_internal_add_example(tablet)
 qt_internal_add_example(tetrix)
 qt_internal_add_example(tooltips)
diff --git a/examples/widgets/widgets/widgets.pro b/examples/widgets/widgets/widgets.pro
index 45d9e662dff..dbfffab4c4d 100644
--- a/examples/widgets/widgets/widgets.pro
+++ b/examples/widgets/widgets/widgets.pro
@@ -8,7 +8,6 @@ SUBDIRS       = analogclock \
                 shapedclock \
                 sliders \
                 spinboxes \
-                styles \
                 tablet \
                 tetrix \
                 tooltips \
diff --git a/src/widgets/styles/qstyle.cpp b/src/widgets/styles/qstyle.cpp
index 73524524873..13199152013 100644
--- a/src/widgets/styles/qstyle.cpp
+++ b/src/widgets/styles/qstyle.cpp
@@ -249,9 +249,6 @@ static int unpackControlTypes(QSizePolicy::ControlTypes controls, QSizePolicy::C
     widget is a QSpinBox just because the enum value is called
     PE_IndicatorSpinUp or PE_IndicatorSpinDown.
 
-    The documentation for the \l{widgets/styles}{Styles} example
-    covers this topic in more detail.
-
     \warning Qt style sheets are currently not supported for custom QStyle
     subclasses. We plan to address this in some future release.
 
@@ -352,7 +349,7 @@ static int unpackControlTypes(QSizePolicy::ControlTypes controls, QSizePolicy::C
     The drawing of item view headers is also done by the style, giving
     control over size of header items and row and column sizes.
 
-    \sa QStyleOption, QStylePainter, {Styles Example},
+    \sa QStyleOption, QStylePainter,
         {Styles and Style Aware Widgets}, QStyledItemDelegate, {Styling}
 */
 
diff --git a/src/widgets/styles/qstyleoption.cpp b/src/widgets/styles/qstyleoption.cpp
index 8afd3fe362d..23179de4eb1 100644
--- a/src/widgets/styles/qstyleoption.cpp
+++ b/src/widgets/styles/qstyleoption.cpp
@@ -50,9 +50,6 @@ QT_BEGIN_NAMESPACE
     The qstyleoption_cast() function will return 0 if the object to
     which \c option points is not of the correct type.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyle, QStylePainter
 */
 
@@ -329,9 +326,6 @@ QStyleOption &QStyleOption::operator=(const QStyleOption &other)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -428,9 +422,6 @@ QStyleOptionFocusRect::QStyleOptionFocusRect(int version)
     without breaking compatibility. If you use qstyleoption_cast(),
     you normally do not need to check it.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -555,9 +546,6 @@ QStyleOptionFrame::QStyleOptionFrame(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionComplex, QGroupBox
 */
 
@@ -688,9 +676,6 @@ QStyleOptionGroupBox::QStyleOptionGroupBox(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -915,9 +900,6 @@ QStyleOptionHeaderV2::QStyleOptionHeaderV2(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionToolButton
 */
 
@@ -1054,9 +1036,6 @@ QStyleOptionButton::QStyleOptionButton(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -1238,9 +1217,6 @@ QStyleOptionToolBar::QStyleOptionToolBar(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -1476,9 +1452,6 @@ QStyleOptionTab::QStyleOptionTab(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -1637,9 +1610,6 @@ QStyleOptionProgressBar::QStyleOptionProgressBar(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -1840,9 +1810,6 @@ QStyleOptionMenuItem::QStyleOptionMenuItem(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -1933,9 +1900,6 @@ QStyleOptionComplex::QStyleOptionComplex(int version, int type)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOptionComplex, QSlider, QScrollBar
 */
 
@@ -2130,9 +2094,6 @@ QStyleOptionSlider::QStyleOptionSlider(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionComplex
 */
 
@@ -2235,9 +2196,6 @@ QStyleOptionSpinBox::QStyleOptionSpinBox(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption
 */
 
@@ -2341,9 +2299,6 @@ QStyleOptionDockWidget::QStyleOptionDockWidget(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionComplex, QStyleOptionButton
 */
 
@@ -2505,9 +2460,6 @@ QStyleOptionToolButton::QStyleOptionToolButton(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionComplex, QComboBox
 */
 
@@ -2641,9 +2593,6 @@ QStyleOptionComboBox::QStyleOptionComboBox(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QToolBox
 */
 
@@ -2768,9 +2717,6 @@ QStyleOptionToolBox::QStyleOptionToolBox(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QRubberBand
 */
 
@@ -2860,9 +2806,6 @@ QStyleOptionRubberBand::QStyleOptionRubberBand(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionComplex, QMdiSubWindow
 */
 
@@ -2973,9 +2916,6 @@ QStyleOptionTitleBar::QStyleOptionTitleBar(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, {model-view-programming.html}{Model/View
     Programming}
 */
@@ -3236,9 +3176,6 @@ QStyleOptionViewItem::QStyleOptionViewItem(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QTabWidget
 */
 
@@ -3378,9 +3315,6 @@ QStyleOptionTabWidgetFrame::QStyleOptionTabWidgetFrame(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QTabBar::drawBase()
 */
 
@@ -3488,9 +3422,6 @@ QStyleOptionTabBarBase::QStyleOptionTabBarBase(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QStyleOptionComplex, QSizeGrip
 */
 
@@ -3568,9 +3499,6 @@ QStyleOptionSizeGrip::QStyleOptionSizeGrip(int version)
     and emphasizes that these are simply parameters used by the style
     functions.
 
-    For an example demonstrating how style options can be used, see
-    the \l {widgets/styles}{Styles} example.
-
     \sa QStyleOption, QGraphicsItem::paint()
 */
 
diff --git a/examples/widgets/widgets/styles/CMakeLists.txt b/tests/manual/examples/widgets/widgets/styles/CMakeLists.txt
index 9632f01a898..9632f01a898 100644
--- a/examples/widgets/widgets/styles/CMakeLists.txt
+++ b/tests/manual/examples/widgets/widgets/styles/CMakeLists.txt
diff --git a/examples/widgets/widgets/styles/images/woodbackground.png b/tests/manual/examples/widgets/widgets/styles/images/woodbackground.png
index 8be3366bb48..8be3366bb48 100644
--- a/examples/widgets/widgets/styles/images/woodbackground.png
+++ b/tests/manual/examples/widgets/widgets/styles/images/woodbackground.png
diff --git a/examples/widgets/widgets/styles/images/woodbutton.png b/tests/manual/examples/widgets/widgets/styles/images/woodbutton.png
index adb59ef6337..adb59ef6337 100644
--- a/examples/widgets/widgets/styles/images/woodbutton.png
+++ b/tests/manual/examples/widgets/widgets/styles/images/woodbutton.png
diff --git a/examples/widgets/widgets/styles/main.cpp b/tests/manual/examples/widgets/widgets/styles/main.cpp
index 5c33895ea45..5c33895ea45 100644
--- a/examples/widgets/widgets/styles/main.cpp
+++ b/tests/manual/examples/widgets/widgets/styles/main.cpp
diff --git a/examples/widgets/widgets/styles/norwegianwoodstyle.cpp b/tests/manual/examples/widgets/widgets/styles/norwegianwoodstyle.cpp
index a8969dfd54b..a8969dfd54b 100644
--- a/examples/widgets/widgets/styles/norwegianwoodstyle.cpp
+++ b/tests/manual/examples/widgets/widgets/styles/norwegianwoodstyle.cpp
diff --git a/examples/widgets/widgets/styles/norwegianwoodstyle.h b/tests/manual/examples/widgets/widgets/styles/norwegianwoodstyle.h
index 5af2171f357..5af2171f357 100644
--- a/examples/widgets/widgets/styles/norwegianwoodstyle.h
+++ b/tests/manual/examples/widgets/widgets/styles/norwegianwoodstyle.h
diff --git a/examples/widgets/widgets/styles/styles.pro b/tests/manual/examples/widgets/widgets/styles/styles.pro
index 87dee7e04c1..87dee7e04c1 100644
--- a/examples/widgets/widgets/styles/styles.pro
+++ b/tests/manual/examples/widgets/widgets/styles/styles.pro
diff --git a/examples/widgets/widgets/styles/styles.qrc b/tests/manual/examples/widgets/widgets/styles/styles.qrc
index 4fdad8d914a..4fdad8d914a 100644
--- a/examples/widgets/widgets/styles/styles.qrc
+++ b/tests/manual/examples/widgets/widgets/styles/styles.qrc
diff --git a/examples/widgets/widgets/styles/widgetgallery.cpp b/tests/manual/examples/widgets/widgets/styles/widgetgallery.cpp
index 83cb99a52c4..83cb99a52c4 100644
--- a/examples/widgets/widgets/styles/widgetgallery.cpp
+++ b/tests/manual/examples/widgets/widgets/styles/widgetgallery.cpp
diff --git a/examples/widgets/widgets/styles/widgetgallery.h b/tests/manual/examples/widgets/widgets/styles/widgetgallery.h
index f4c43e7b4f6..f4c43e7b4f6 100644
--- a/examples/widgets/widgets/styles/widgetgallery.h
+++ b/tests/manual/examples/widgets/widgets/styles/widgetgallery.h