From 134d3592b7811a0b93f02447677e1379968e2f58 Mon Sep 17 00:00:00 2001
From: Volker Hilsheimer <volker.hilsheimer@qt.io>
Date: Mon, 23 Oct 2023 18:09:47 +0200
Subject: [PATCH] Convert tooltips example to snippets

The important bits from the example are ~10 lines of code, no need
for building a poor-man's version of a graphics or item view.

Change-Id: I7874c66765c5b46230c92846ee3de1ee83f47e45
Reviewed-by: Oliver Eftevaag <oliver.eftevaag@qt.io>
(cherry picked from commit ae39b1634556f82fe5d7505ed9b6ebb883d6f813)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
---
 doc/src/images/tooltips-example.png           | Bin 12479 -> 0 bytes
 examples/widgets/doc/src/tooltips.qdoc        | 375 ------------------
 examples/widgets/widgets/CMakeLists.txt       |   1 -
 .../widgets/widgets/tooltips/CMakeLists.txt   |  52 ---
 .../widgets/tooltips/images/circle.png        | Bin 165 -> 0 bytes
 .../widgets/tooltips/images/square.png        | Bin 94 -> 0 bytes
 .../widgets/tooltips/images/triangle.png      | Bin 170 -> 0 bytes
 examples/widgets/widgets/tooltips/main.cpp    |  14 -
 .../widgets/widgets/tooltips/shapeitem.cpp    |  60 ---
 examples/widgets/widgets/tooltips/shapeitem.h |  33 --
 .../widgets/widgets/tooltips/sortingbox.cpp   | 277 -------------
 .../widgets/widgets/tooltips/sortingbox.h     |  71 ----
 .../widgets/widgets/tooltips/tooltips.pro     |  12 -
 .../widgets/widgets/tooltips/tooltips.qrc     |   7 -
 examples/widgets/widgets/widgets.pro          |   1 -
 src/widgets/doc/snippets/tooltips/main.cpp    |  74 ++++
 src/widgets/kernel/qtooltip.cpp               |  19 +-
 17 files changed, 88 insertions(+), 908 deletions(-)
 delete mode 100644 doc/src/images/tooltips-example.png
 delete mode 100644 examples/widgets/doc/src/tooltips.qdoc
 delete mode 100644 examples/widgets/widgets/tooltips/CMakeLists.txt
 delete mode 100644 examples/widgets/widgets/tooltips/images/circle.png
 delete mode 100644 examples/widgets/widgets/tooltips/images/square.png
 delete mode 100644 examples/widgets/widgets/tooltips/images/triangle.png
 delete mode 100644 examples/widgets/widgets/tooltips/main.cpp
 delete mode 100644 examples/widgets/widgets/tooltips/shapeitem.cpp
 delete mode 100644 examples/widgets/widgets/tooltips/shapeitem.h
 delete mode 100644 examples/widgets/widgets/tooltips/sortingbox.cpp
 delete mode 100644 examples/widgets/widgets/tooltips/sortingbox.h
 delete mode 100644 examples/widgets/widgets/tooltips/tooltips.pro
 delete mode 100644 examples/widgets/widgets/tooltips/tooltips.qrc
 create mode 100644 src/widgets/doc/snippets/tooltips/main.cpp

diff --git a/doc/src/images/tooltips-example.png b/doc/src/images/tooltips-example.png
deleted file mode 100644
index f2236b43de4e06cc1101305a4cdb6315f77a87a7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 12479
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
O0;g>qPvNXDNB<vO80<Fy

diff --git a/examples/widgets/doc/src/tooltips.qdoc b/examples/widgets/doc/src/tooltips.qdoc
deleted file mode 100644
index 6dc0d2fbaed..00000000000
--- a/examples/widgets/doc/src/tooltips.qdoc
+++ /dev/null
@@ -1,375 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
-
-/*!
-    \example widgets/tooltips
-    \title Tool Tips Example
-    \examplecategory {User Interface Components}
-    \ingroup examples-widgets
-    \brief The Tool Tips example shows how to provide static and dynamic tool
-    tips for an application's widgets.
-
-    The simplest and most common way to set a widget's tool tip is by
-    calling its QWidget::setToolTip() function (static tool
-    tips). Then the tool tip is shown whenever the cursor points at
-    the widget. We show how to do this with our application's tool
-    buttons. But it is also possible to show different tool tips
-    depending on the cursor's position (dynamic tooltips). This
-    approach uses mouse tracking and event handling to determine what
-    widgets are located under the cursor at any point in time, and
-    displays their tool tips. The tool tips for the shape items in our
-    application are implemented using the latter approach.
-
-    \image tooltips-example.png
-
-    With the \c Tooltips application the user can create new shape
-    items with the provided tool buttons, and move the items around
-    using the mouse. Tooltips are provided whenever the cursor is
-    pointing to a shape item or one of the buttons.
-
-    The Tooltips example consists of two classes:
-
-    \list
-    \li \c ShapeItem is a custom widget representing one single shape item.
-    \li \c SortingBox inherits from QWidget and is the application's main
-        widget.
-    \endlist
-
-    First we will review the \c SortingBox class, then we will take a
-    look at the \c ShapeItem class.
-
-    \section1 SortingBox Class Definition
-
-    \snippet widgets/tooltips/sortingbox.h 0
-
-    The \c SortingBox class inherits QWidget, and it is the Tooltips
-    application's main widget. We reimplement several of the event
-    handlers.
-
-    The \c event() function provides tooltips, the \c resize()
-    function makes sure the application appears consistently when the
-    user resizes the main widget, and the \c paintEvent() function
-    displays the shape items within the \c SortingBox widget. The
-    mouse event handlers are reimplemented to make the user able to
-    move the items around.
-
-    In addition we need three private slots to make the user able to
-    create new shape items.
-
-    \snippet widgets/tooltips/sortingbox.h 1
-
-    We also create several private functions: We use the \c
-    initialItemPosition(), \c initialItemColor() and \c
-    createToolButton() functions when we are constructing the widget,
-    and we use the \c updateButtonGeometry() function whenever the
-    user is resizing the application's main widget.
-
-    The \c itemAt() function determines if there is a shape item at a
-    particular position, and the \c moveItemTo() function moves an
-    item to a new position. We use the \c createShapeItem(), \c
-    randomItemPosition() and \c randomItemColor() functions to create
-    new shape items.
-
-    \snippet widgets/tooltips/sortingbox.h 2
-
-    We keep all the shape items in a QList, and we keep three
-    QPainterPath objects holding the shapes of a circle, a square and
-    a triangle. We also need to have a pointer to an item when it is
-    moving, and we need to know its previous position.
-
-    \section1 SortingBox Class Implementation
-
-    \snippet widgets/tooltips/sortingbox.cpp 0
-
-    In the constructor, we first set the Qt::WA_StaticContents
-    attribute on the widget. This attribute indicates that the widget
-    contents are north-west aligned and static. On resize, such a
-    widget will receive paint events only for the newly visible part
-    of itself.
-
-    \snippet widgets/tooltips/sortingbox.cpp 1
-
-    To be able to show the appropriate tooltips while the user is
-    moving the cursor around, we need to enable mouse tracking for the
-    widget.
-
-    If mouse tracking is disabled (the default), the widget only
-    receives mouse move events when at least one mouse button is
-    pressed while the mouse is being moved. If mouse tracking is
-    enabled, the widget receives mouse move events even if no buttons
-    are pressed.
-
-    \snippet widgets/tooltips/sortingbox.cpp 2
-
-    A widget's background role defines the brush from the widget's
-    palette that is used to render the background, and QPalette::Base
-    is typically white.
-
-    \snippet widgets/tooltips/sortingbox.cpp 3
-
-    After creating the application's tool buttons using the private \c
-    createToolButton() function, we construct the shapes of a circle,
-    a square and a triangle using QPainterPath.
-
-    The QPainterPath class provides a container for painting
-    operations, enabling graphical shapes to be constructed and
-    reused. The main advantage of painter paths over normal drawing
-    operations is that complex shapes only need to be created once,
-    but they can be drawn many times using only calls to
-    QPainter::drawPath().
-
-    \snippet widgets/tooltips/sortingbox.cpp 4
-
-    Then we set the window title, resize the widget to a suitable
-    size, and finally create three initial shape items using the
-    private \c createShapeItem(), \c initialItemPosition() and \c
-    initialItemColor() functions.
-
-    \snippet widgets/tooltips/sortingbox.cpp 27
-
-    In the destructor, we delete all shape items.
-
-    \snippet widgets/tooltips/sortingbox.cpp 5
-
-    QWidget::event() is the main event handler and receives all the
-    widget's events. Normally, we recommend reimplementing one of the
-    specialized event handlers instead of this function. But here we
-    want to catch the QEvent::ToolTip events, and since these are
-    rather rare, there exists no specific event handler. For that
-    reason we reimplement the main event handler, and the first thing
-    we need to do is to determine the event's type:
-
-    \snippet widgets/tooltips/sortingbox.cpp 6
-
-    If the type is QEvent::ToolTip, we cast the event to a QHelpEvent,
-    otherwise we propagate the event using the QWidget::event()
-    function.
-
-    The QHelpEvent class provides an event that is used to request
-    helpful information about a particular point in a widget.
-
-    For example, the QHelpEvent::pos() function returns the event's
-    position relative to the widget to which the event is dispatched.
-    Here we use this information to determine if the position of the
-    event is contained within the area of any of the shape items. If
-    it is, we display the shape item's tooltip at the position of the
-    event. If not, we hide the tooltip and explicitly ignore the event.
-    This makes sure that the calling code does not start any tooltip
-    specific modes as a result of the event. Note that the
-    QToolTip::showText() function needs the event's position in global
-    coordinates provided by QHelpEvent::globalPos().
-
-    \snippet widgets/tooltips/sortingbox.cpp 7
-
-    The \c resizeEvent() function is reimplemented to receive the
-    resize events dispatched to the widget. It makes sure that the
-    tool buttons keep their position relative to the main widget when
-    the widget is resized. We want the buttons to always be vertically
-    aligned in the application's bottom right corner, so each time the
-    main widget is resized we update the buttons geometry.
-
-    \snippet widgets/tooltips/sortingbox.cpp 8
-
-    The \c paintEvent() function is reimplemented to receive paint
-    events for the widget. We create a QPainter for the \c SortingBox
-    widget, and run through the list of created shape items, drawing
-    each item at its defined position.
-
-    \snippet widgets/tooltips/sortingbox.cpp 9
-
-    The painter will by default draw all the shape items at position
-    (0,0) in the \c SortingBox widget. The QPainter::translate()
-    function translates the coordinate system by the given offset,
-    making each shape item appear at its defined position. But
-    remember to translate the coordinate system back when the item is
-    drawn, otherwise the next shape item will appear at a position
-    relative to the item drawn last.
-
-    \snippet widgets/tooltips/sortingbox.cpp 10
-
-    The QPainter::setBrush() function sets the current brush used by
-    the painter. When the provided argument is a QColor, the function
-    calls the appropriate QBrush constructor which creates a brush with
-    the specified color and Qt::SolidPattern style. The
-    QPainter::drawPath() function draws the given path using the
-    current pen for outline and the current brush for filling.
-
-    \snippet widgets/tooltips/sortingbox.cpp 11
-
-    The \c mousePressEvent() function is reimplemented to receive the
-    mouse press events dispatched to the widget. It determines if an
-    event's position is contained within the area of any of the shape
-    items, using the private \c itemAt() function.
-
-    If an item covers the position, we store a pointer to that item
-    and the event's position. If several of the shape items cover the
-    position, we store the pointer to the uppermost item. Finally, we
-    move the shape item's pointer to the end of the list, and make
-    a call to the QWidget::update() function to make the item appear
-    on top.
-
-    The QWidget::update() function does not cause an immediate
-    repaint; instead it schedules a paint event for processing when Qt
-    returns to the main event loop.
-
-    \snippet widgets/tooltips/sortingbox.cpp 12
-
-    The \c mouseMoveEvent() function is reimplemented to receive mouse
-    move events for the widget. If the left mouse button is pressed
-    and there exists a shape item in motion, we use the private \c
-    moveItemTo() function to move the item with an offset
-    corresponding to the offset between the positions of the current
-    mouse event and the previous one.
-
-    \snippet widgets/tooltips/sortingbox.cpp 13
-
-    The \c mouseReleaseEvent() function is reimplemented to receive
-    the mouse release events dispatched to the widget. If the left
-    mouse button is pressed and there exists a shape item in motion,
-    we use the private \c moveItemTo() function to move the item like
-    we did in \c mouseMoveEvent(). But then we remove the pointer to
-    the item in motion, making the shape item's position final for
-    now. To move the item further, the user will need to press the
-    left mouse button again.
-
-    \snippet widgets/tooltips/sortingbox.cpp 14
-    \codeline
-    \snippet widgets/tooltips/sortingbox.cpp 15
-    \codeline
-    \snippet widgets/tooltips/sortingbox.cpp 16
-
-    The \c createNewCircle(), \c createNewSquare() and \c
-    createNewTriangle() slots simply create new shape items, using the
-    private \c createShapeItem(), \c randomItemPosition() and \c
-    randomItemColor() functions.
-
-    \snippet widgets/tooltips/sortingbox.cpp 17
-
-    In the \c itemAt() function, we run through the list of created
-    shape items to check if the given position is contained within the
-    area of any of the shape items.
-
-    For each shape item we use the QPainterPath::contains() function
-    to find out if the item's painter path contains the position. If
-    it does we return the index of the item, otherwise we return
-    -1. We run through the list backwards to get the index of the
-    uppermost shape item in case several items cover the position.
-
-    \snippet widgets/tooltips/sortingbox.cpp 18
-
-    The \c moveItemTo() function moves the shape item in motion, and
-    the parameter \c pos is the position of a mouse event. First we
-    calculate the offset between the parameter \c pos and the previous
-    mouse event position. Then we add the offset to the current
-    position of the item in motion.
-
-    It is tempting to simply set the position of the item to be the
-    parameter \c pos. But an item's position defines the top left
-    corner of the item's bounding rectangle, and the parameter \c pos
-    can be any point; The suggested shortcut would cause the item to
-    jump to a position where the cursor is pointing to the bounding
-    rectangle's top left corner, regardless of the item's previous
-    position.
-
-    \snippet widgets/tooltips/sortingbox.cpp 19
-
-    Finally, we update the previous mouse event position, and make a
-    call to the QWidget::update() function to make the item appear at
-    its new position.
-
-    \snippet widgets/tooltips/sortingbox.cpp 20
-
-    In the \c updateButtonGeometry() function we set the geometry for
-    the given button. The parameter coordinates define the bottom
-    right corner of the button. We use these coordinates and the
-    button's size hint to determine the position of the upper left
-    corner. This position, and the button's width and height, are the
-    arguments required by the QWidget::setGeometry() function.
-
-    In the end, we calculate and return the y-coordinate of the bottom
-    right corner of the next button. We use the QWidget::style()
-    function to retrieve the widget's GUI style, and then
-    QStyle::pixelMetric() to determine the widget's preferred default
-    spacing between its child widgets.
-
-    \snippet widgets/tooltips/sortingbox.cpp 21
-
-    The \c createShapeItem() function creates a single shape item. It
-    sets the path, tooltip, position and color, using the item's own
-    functions. In the end, the function appends the new item's pointer
-    to the list of shape items, and calls QWidget::update() to make
-    it appear with the other items within the \c SortingBox widget.
-
-    \snippet widgets/tooltips/sortingbox.cpp 22
-
-    The \c createToolButton() function is called from the \c
-    SortingBox constructor. We create a tool button with the given
-    tooltip and icon. The button's parent is the \c SortingBox widget,
-    and its size is 32 x 32 pixels. Before we return the button, we
-    connect it to the given slot.
-
-    \snippet widgets/tooltips/sortingbox.cpp 23
-
-    The \c initialItemPosition() function is also called from the
-    constructor. We want the three first items to initially be
-    centered in the middle of the \c SortingBox widget, and we use
-    this function to calculate their positions.
-
-    \snippet widgets/tooltips/sortingbox.cpp 24
-
-    Whenever the user creates a new shape item, we want the new item
-    to appear at a random position, and we use the \c
-    randomItemPosition() function to calculate such a position. We
-    make sure that the item appears within the visible area of the
-    \c SortingBox widget, using the widget's current width and height
-    when calculating the random coordinates.
-
-    \snippet widgets/tooltips/sortingbox.cpp 25
-
-    As with \c initialItemPosition(), the \c initialItemColor()
-    function is called from the constructor. The purposes of both
-    functions are purely cosmetic: We want to control the initial
-    position and color of the three first items.
-
-    \snippet widgets/tooltips/sortingbox.cpp 26
-
-    Finally the \c randomItemColor() function is implemented to give
-    the shape items the user creates, a random color.
-
-    \section1 ShapeItem Class Definition
-
-    \snippet widgets/tooltips/shapeitem.h 0
-
-    The \c ShapeItem class is a custom widget representing one single
-    shape item. The widget has a path, a position, a color and a
-    tooltip. We need functions to set or modify these objects, as well
-    as functions that return them. We make the latter functions \c
-    const to prohibit any modifications of the objects,
-    i.e. prohibiting unauthorized manipulation of the shape items
-    appearance.
-
-    \section1 ShapeItem Class Implementation
-
-    \snippet widgets/tooltips/shapeitem.cpp 0
-    \codeline
-    \snippet widgets/tooltips/shapeitem.cpp 1
-    \codeline
-    \snippet widgets/tooltips/shapeitem.cpp 2
-    \codeline
-    \snippet widgets/tooltips/shapeitem.cpp 3
-
-    This first group of functions simply return the objects that are
-    requested. The objects are returned as constants, i.e. they cannot
-    be modified.
-
-    \snippet widgets/tooltips/shapeitem.cpp 4
-    \codeline
-    \snippet widgets/tooltips/shapeitem.cpp 5
-    \codeline
-    \snippet widgets/tooltips/shapeitem.cpp 6
-    \codeline
-    \snippet widgets/tooltips/shapeitem.cpp 7
-
-    The last group of functions set or modify the shape item's path,
-    position, color and tooltip, respectively.
-*/
diff --git a/examples/widgets/widgets/CMakeLists.txt b/examples/widgets/widgets/CMakeLists.txt
index 6b6a7760b70..6ea7a98f983 100644
--- a/examples/widgets/widgets/CMakeLists.txt
+++ b/examples/widgets/widgets/CMakeLists.txt
@@ -12,5 +12,4 @@ qt_internal_add_example(shortcuteditor)
 qt_internal_add_example(sliders)
 qt_internal_add_example(spinboxes)
 qt_internal_add_example(tablet)
-qt_internal_add_example(tooltips)
 qt_internal_add_example(windowflags)
diff --git a/examples/widgets/widgets/tooltips/CMakeLists.txt b/examples/widgets/widgets/tooltips/CMakeLists.txt
deleted file mode 100644
index f3d00a70569..00000000000
--- a/examples/widgets/widgets/tooltips/CMakeLists.txt
+++ /dev/null
@@ -1,52 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-cmake_minimum_required(VERSION 3.16)
-project(tooltips LANGUAGES CXX)
-
-if(NOT DEFINED INSTALL_EXAMPLESDIR)
-    set(INSTALL_EXAMPLESDIR "examples")
-endif()
-
-set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/widgets/widgets/tooltips")
-
-find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
-
-qt_standard_project_setup()
-
-qt_add_executable(tooltips
-    main.cpp
-    shapeitem.cpp shapeitem.h
-    sortingbox.cpp sortingbox.h
-)
-
-set_target_properties(tooltips PROPERTIES
-    WIN32_EXECUTABLE TRUE
-    MACOSX_BUNDLE TRUE
-)
-
-target_link_libraries(tooltips PRIVATE
-    Qt6::Core
-    Qt6::Gui
-    Qt6::Widgets
-)
-
-# Resources:
-set(tooltips_resource_files
-    "images/circle.png"
-    "images/square.png"
-    "images/triangle.png"
-)
-
-qt_add_resources(tooltips "tooltips"
-    PREFIX
-        "/"
-    FILES
-        ${tooltips_resource_files}
-)
-
-install(TARGETS tooltips
-    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
-    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
-    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
-)
diff --git a/examples/widgets/widgets/tooltips/images/circle.png b/examples/widgets/widgets/tooltips/images/circle.png
deleted file mode 100644
index dc392cb3f7597883c7902bd310b21cfda6e92622..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 165
zcmeAS@N?(olHy`uVBq!ia0vp^3LwnE1|*BCs=ffJ98VX=kch)?uSfGS2=KTBp5EfJ
zJB3;9s)Vee(EaZ<7ngl`v2t>E|FfWW@y19uUWxiU!g3BtkK&G8{GrDrv|VXIA-9r9
zfvTPJAKo2O?-f}D92jg}L>Ow1iwFxI_3<zi4SvHaGF$Ly9>?82X^{}g&kL1rUj^FB
N;OXk;vd$@?2>@XMHh=&C

diff --git a/examples/widgets/widgets/tooltips/images/square.png b/examples/widgets/widgets/tooltips/images/square.png
deleted file mode 100644
index c0fd2d540abc41bc4b3a1d40c50280d9c4682667..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 94
zcmeAS@N?(olHy`uVBq!ia0vp^3LwnL3?x0byx0z;*aCb)T!D1NivK+#@~eR?VNVyw
o5RU7~2@H+D{{R2aYsbXG(CeF#eSSw@8&I0T)78&qol`;+0MUXOJOBUy

diff --git a/examples/widgets/widgets/tooltips/images/triangle.png b/examples/widgets/widgets/tooltips/images/triangle.png
deleted file mode 100644
index 2ee15f8f1f569b2eaf9405d7e6fa709728835b73..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 170
zcmeAS@N?(olHy`uVBq!ia0vp^3LwnE1|*BCs=ffJLQfaRkch)?&v|n-7znUjl)0>2
zby~1#M?lh~pI6hQs$$n~jXG<#^Zb$i;9s0agqI6wJP<zb!t*$iL&TuhT{+-Dkqy&E
z+3#)(7)tLjC-y}PY8=pA=emI5`wu=Poqb&nj1NEByF}HrI558aXzujj`i)rr{ON)n
T7Axg|mNR&|`njxgN@xNAp|CxI

diff --git a/examples/widgets/widgets/tooltips/main.cpp b/examples/widgets/widgets/tooltips/main.cpp
deleted file mode 100644
index 1cc7f435d59..00000000000
--- a/examples/widgets/widgets/tooltips/main.cpp
+++ /dev/null
@@ -1,14 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include <QApplication>
-
-#include "sortingbox.h"
-
-int main(int argc, char *argv[])
-{
-    QApplication app(argc, argv);
-    SortingBox sortingBox;
-    sortingBox.show();
-    return app.exec();
-}
diff --git a/examples/widgets/widgets/tooltips/shapeitem.cpp b/examples/widgets/widgets/tooltips/shapeitem.cpp
deleted file mode 100644
index c66c7ab958f..00000000000
--- a/examples/widgets/widgets/tooltips/shapeitem.cpp
+++ /dev/null
@@ -1,60 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include "shapeitem.h"
-
-//! [0]
-QPainterPath ShapeItem::path() const
-{
-    return myPath;
-}
-//! [0]
-
-//! [1]
-QPoint ShapeItem::position() const
-{
-    return myPosition;
-}
-//! [1]
-
-//! [2]
-QColor ShapeItem::color() const
-{
-    return myColor;
-}
-//! [2]
-
-//! [3]
-QString ShapeItem::toolTip() const
-{
-    return myToolTip;
-}
-//! [3]
-
-//! [4]
-void ShapeItem::setPath(const QPainterPath &path)
-{
-    myPath = path;
-}
-//! [4]
-
-//! [5]
-void ShapeItem::setToolTip(const QString &toolTip)
-{
-    myToolTip = toolTip;
-}
-//! [5]
-
-//! [6]
-void ShapeItem::setPosition(const QPoint &position)
-{
-    myPosition = position;
-}
-//! [6]
-
-//! [7]
-void ShapeItem::setColor(const QColor &color)
-{
-    myColor = color;
-}
-//! [7]
diff --git a/examples/widgets/widgets/tooltips/shapeitem.h b/examples/widgets/widgets/tooltips/shapeitem.h
deleted file mode 100644
index 6c0643fa89e..00000000000
--- a/examples/widgets/widgets/tooltips/shapeitem.h
+++ /dev/null
@@ -1,33 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#ifndef SHAPEITEM_H
-#define SHAPEITEM_H
-
-#include <QColor>
-#include <QPainterPath>
-#include <QPoint>
-
-//! [0]
-class ShapeItem
-{
-public:
-    void setPath(const QPainterPath &path);
-    void setToolTip(const QString &toolTip);
-    void setPosition(const QPoint &position);
-    void setColor(const QColor &color);
-
-    QPainterPath path() const;
-    QPoint position() const;
-    QColor color() const;
-    QString toolTip() const;
-
-private:
-    QPainterPath myPath;
-    QPoint myPosition;
-    QColor myColor;
-    QString myToolTip;
-};
-//! [0]
-
-#endif
diff --git a/examples/widgets/widgets/tooltips/sortingbox.cpp b/examples/widgets/widgets/tooltips/sortingbox.cpp
deleted file mode 100644
index ee588eea565..00000000000
--- a/examples/widgets/widgets/tooltips/sortingbox.cpp
+++ /dev/null
@@ -1,277 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include "sortingbox.h"
-
-#include <QMouseEvent>
-#include <QIcon>
-#include <QPainter>
-#include <QRandomGenerator>
-#include <QStyle>
-#include <QToolButton>
-#include <QToolTip>
-
-//! [0]
-SortingBox::SortingBox(QWidget *parent)
-    : QWidget(parent)
-{
-//! [0] //! [1]
-    setMouseTracking(true);
-//! [1] //! [2]
-    setBackgroundRole(QPalette::Base);
-//! [2]
-
-    itemInMotion = nullptr;
-
-//! [3]
-    newCircleButton = createToolButton(tr("New Circle"),
-                                       QIcon(":/images/circle.png"),
-                                       &SortingBox::createNewCircle);
-
-    newSquareButton = createToolButton(tr("New Square"),
-                                       QIcon(":/images/square.png"),
-                                       &SortingBox::createNewSquare);
-
-    newTriangleButton = createToolButton(tr("New Triangle"),
-                                         QIcon(":/images/triangle.png"),
-                                         &SortingBox::createNewTriangle);
-
-    circlePath.addEllipse(QRect(0, 0, 100, 100));
-    squarePath.addRect(QRect(0, 0, 100, 100));
-
-    qreal x = trianglePath.currentPosition().x();
-    qreal y = trianglePath.currentPosition().y();
-    trianglePath.moveTo(x + 120 / 2, y);
-    trianglePath.lineTo(0, 100);
-    trianglePath.lineTo(120, 100);
-    trianglePath.lineTo(x + 120 / 2, y);
-
-//! [3] //! [4]
-    setWindowTitle(tr("Tool Tips"));
-    resize(500, 300);
-
-    createShapeItem(circlePath, tr("Circle"), initialItemPosition(circlePath),
-                    initialItemColor());
-    createShapeItem(squarePath, tr("Square"), initialItemPosition(squarePath),
-                    initialItemColor());
-    createShapeItem(trianglePath, tr("Triangle"),
-                    initialItemPosition(trianglePath), initialItemColor());
-}
-//! [4]
-
-//! [27]
-SortingBox::~SortingBox()
-{
-    qDeleteAll(shapeItems);
-}
-//! [27]
-
-//! [5]
-bool SortingBox::event(QEvent *event)
-{
-//! [5] //! [6]
-    if (event->type() == QEvent::ToolTip) {
-        QHelpEvent *helpEvent = static_cast<QHelpEvent *>(event);
-        int index = itemAt(helpEvent->pos());
-        if (index != -1) {
-            QToolTip::showText(helpEvent->globalPos(), shapeItems[index]->toolTip());
-        } else {
-            QToolTip::hideText();
-            event->ignore();
-        }
-
-        return true;
-    }
-    return QWidget::event(event);
-}
-//! [6]
-
-//! [7]
-void SortingBox::resizeEvent(QResizeEvent * /* event */)
-{
-    int margin = style()->pixelMetric(QStyle::PM_LayoutTopMargin);
-    int x = width() - margin;
-    int y = height() - margin;
-
-    y = updateButtonGeometry(newCircleButton, x, y);
-    y = updateButtonGeometry(newSquareButton, x, y);
-    updateButtonGeometry(newTriangleButton, x, y);
-}
-//! [7]
-
-//! [8]
-void SortingBox::paintEvent(QPaintEvent * /* event */)
-{
-    QPainter painter(this);
-    painter.setRenderHint(QPainter::Antialiasing);
-    for (const ShapeItem *shapeItem : std::as_const(shapeItems)) {
-//! [8] //! [9]
-        painter.translate(shapeItem->position());
-//! [9] //! [10]
-        painter.setBrush(shapeItem->color());
-        painter.drawPath(shapeItem->path());
-        painter.translate(-shapeItem->position());
-    }
-}
-//! [10]
-
-//! [11]
-void SortingBox::mousePressEvent(QMouseEvent *event)
-{
-    if (event->button() == Qt::LeftButton) {
-        int index = itemAt(event->position().toPoint());
-        if (index != -1) {
-            itemInMotion = shapeItems[index];
-            previousPosition = event->position().toPoint();
-            shapeItems.move(index, shapeItems.size() - 1);
-            update();
-        }
-    }
-}
-//! [11]
-
-//! [12]
-void SortingBox::mouseMoveEvent(QMouseEvent *event)
-{
-    if ((event->buttons() & Qt::LeftButton) && itemInMotion)
-        moveItemTo(event->position().toPoint());
-}
-//! [12]
-
-//! [13]
-void SortingBox::mouseReleaseEvent(QMouseEvent *event)
-{
-    if (event->button() == Qt::LeftButton && itemInMotion) {
-        moveItemTo(event->position().toPoint());
-        itemInMotion = nullptr;
-    }
-}
-//! [13]
-
-//! [14]
-void SortingBox::createNewCircle()
-{
-    static int count = 1;
-    createShapeItem(circlePath, tr("Circle <%1>").arg(++count),
-                    randomItemPosition(), randomItemColor());
-}
-//! [14]
-
-//! [15]
-void SortingBox::createNewSquare()
-{
-    static int count = 1;
-    createShapeItem(squarePath, tr("Square <%1>").arg(++count),
-                    randomItemPosition(), randomItemColor());
-}
-//! [15]
-
-//! [16]
-void SortingBox::createNewTriangle()
-{
-    static int count = 1;
-    createShapeItem(trianglePath, tr("Triangle <%1>").arg(++count),
-                    randomItemPosition(), randomItemColor());
-}
-//! [16]
-
-//! [17]
-qsizetype SortingBox::itemAt(const QPoint &pos)
-{
-    for (qsizetype i = shapeItems.size() - 1; i >= 0; --i) {
-        const ShapeItem *item = shapeItems[i];
-        if (item->path().contains(pos - item->position()))
-            return i;
-    }
-    return -1;
-}
-//! [17]
-
-//! [18]
-void SortingBox::moveItemTo(const QPoint &pos)
-{
-    QPoint offset = pos - previousPosition;
-    itemInMotion->setPosition(itemInMotion->position() + offset);
-//! [18] //! [19]
-    previousPosition = pos;
-    update();
-}
-//! [19]
-
-//! [20]
-int SortingBox::updateButtonGeometry(QToolButton *button, int x, int y)
-{
-    QSize size = button->sizeHint();
-    button->setGeometry(x - size.rwidth(), y - size.rheight(),
-                        size.rwidth(), size.rheight());
-
-    return y - size.rheight()
-           - style()->pixelMetric(QStyle::PM_LayoutVerticalSpacing);
-}
-//! [20]
-
-//! [21]
-void SortingBox::createShapeItem(const QPainterPath &path,
-                                 const QString &toolTip, const QPoint &pos,
-                                 const QColor &color)
-{
-    ShapeItem *shapeItem = new ShapeItem;
-    shapeItem->setPath(path);
-    shapeItem->setToolTip(toolTip);
-    shapeItem->setPosition(pos);
-    shapeItem->setColor(color);
-    shapeItems.append(shapeItem);
-    update();
-}
-//! [21]
-
-//! [22]
-template<typename PointerToMemberFunction>
-QToolButton *SortingBox::createToolButton(const QString &toolTip,
-                                          const QIcon &icon, const PointerToMemberFunction &member)
-{
-    QToolButton *button = new QToolButton(this);
-    button->setToolTip(toolTip);
-    button->setIcon(icon);
-    button->setIconSize(QSize(32, 32));
-    connect(button, &QToolButton::clicked, this, member);
-
-    return button;
-}
-//! [22]
-
-//! [23]
-QPoint SortingBox::initialItemPosition(const QPainterPath &path)
-{
-    int x;
-    int y = (height() - qRound(path.controlPointRect().height()) / 2);
-    if (shapeItems.size() == 0)
-        x = ((3 * width()) / 2 - qRound(path.controlPointRect().width())) / 2;
-    else
-        x = (width() / shapeItems.size()
-             - qRound(path.controlPointRect().width())) / 2;
-
-    return QPoint(x, y);
-}
-//! [23]
-
-//! [24]
-QPoint SortingBox::randomItemPosition()
-{
-    return QPoint(QRandomGenerator::global()->bounded(width() - 120), QRandomGenerator::global()->bounded(height() - 120));
-}
-//! [24]
-
-//! [25]
-QColor SortingBox::initialItemColor()
-{
-    return QColor::fromHsv(((shapeItems.size() + 1) * 85) % 256, 255, 190);
-}
-//! [25]
-
-//! [26]
-QColor SortingBox::randomItemColor()
-{
-    return QColor::fromHsv(QRandomGenerator::global()->bounded(256), 255, 190);
-}
-//! [26]
diff --git a/examples/widgets/widgets/tooltips/sortingbox.h b/examples/widgets/widgets/tooltips/sortingbox.h
deleted file mode 100644
index 9f34cf7ada9..00000000000
--- a/examples/widgets/widgets/tooltips/sortingbox.h
+++ /dev/null
@@ -1,71 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#ifndef SORTINGBOX_H
-#define SORTINGBOX_H
-
-#include "shapeitem.h"
-
-#include <QWidget>
-
-QT_BEGIN_NAMESPACE
-class QAction;
-class QPoint;
-class QToolButton;
-QT_END_NAMESPACE
-
-//! [0]
-class SortingBox : public QWidget
-{
-    Q_OBJECT
-
-public:
-    SortingBox(QWidget *parent = nullptr);
-    ~SortingBox();
-
-protected:
-    bool event(QEvent *event) override;
-    void resizeEvent(QResizeEvent *event) override;
-    void paintEvent(QPaintEvent *event) override;
-    void mousePressEvent(QMouseEvent *event) override;
-    void mouseMoveEvent(QMouseEvent *event) override;
-    void mouseReleaseEvent(QMouseEvent *event) override;
-
-private slots:
-    void createNewCircle();
-    void createNewSquare();
-    void createNewTriangle();
-//! [0]
-
-//! [1]
-private:
-    int updateButtonGeometry(QToolButton *button, int x, int y);
-    void createShapeItem(const QPainterPath &path, const QString &toolTip,
-                         const QPoint &pos, const QColor &color);
-    qsizetype itemAt(const QPoint &pos);
-    void moveItemTo(const QPoint &pos);
-    QPoint initialItemPosition(const QPainterPath &path);
-    QPoint randomItemPosition();
-    QColor initialItemColor();
-    QColor randomItemColor();
-    template<typename PointerToMemberFunction>
-    QToolButton *createToolButton(const QString &toolTip, const QIcon &icon,
-//! [1]
-                                  const PointerToMemberFunction &member);
-
-//! [2]
-    QList<ShapeItem *> shapeItems;
-    QPainterPath circlePath;
-    QPainterPath squarePath;
-    QPainterPath trianglePath;
-
-    QPoint previousPosition;
-    ShapeItem *itemInMotion;
-
-    QToolButton *newCircleButton;
-    QToolButton *newSquareButton;
-    QToolButton *newTriangleButton;
-};
-//! [2]
-
-#endif
diff --git a/examples/widgets/widgets/tooltips/tooltips.pro b/examples/widgets/widgets/tooltips/tooltips.pro
deleted file mode 100644
index d14b8295ba1..00000000000
--- a/examples/widgets/widgets/tooltips/tooltips.pro
+++ /dev/null
@@ -1,12 +0,0 @@
-QT += widgets
-
-HEADERS       = shapeitem.h \
-                sortingbox.h
-SOURCES       = main.cpp \
-                shapeitem.cpp \
-                sortingbox.cpp
-RESOURCES     = tooltips.qrc
-
-# install
-target.path = $$[QT_INSTALL_EXAMPLES]/widgets/widgets/tooltips
-INSTALLS += target
diff --git a/examples/widgets/widgets/tooltips/tooltips.qrc b/examples/widgets/widgets/tooltips/tooltips.qrc
deleted file mode 100644
index dabc894e9bf..00000000000
--- a/examples/widgets/widgets/tooltips/tooltips.qrc
+++ /dev/null
@@ -1,7 +0,0 @@
-<!DOCTYPE RCC><RCC version="1.0">
-<qresource>
-   <file>images/circle.png</file>
-   <file>images/square.png</file>
-   <file>images/triangle.png</file>
-</qresource>
-</RCC>
diff --git a/examples/widgets/widgets/widgets.pro b/examples/widgets/widgets/widgets.pro
index 7384b69743c..9fe06d4d808 100644
--- a/examples/widgets/widgets/widgets.pro
+++ b/examples/widgets/widgets/widgets.pro
@@ -9,5 +9,4 @@ SUBDIRS       = analogclock \
                 sliders \
                 spinboxes \
                 tablet \
-                tooltips \
                 windowflags
diff --git a/src/widgets/doc/snippets/tooltips/main.cpp b/src/widgets/doc/snippets/tooltips/main.cpp
new file mode 100644
index 00000000000..94cc71f7118
--- /dev/null
+++ b/src/widgets/doc/snippets/tooltips/main.cpp
@@ -0,0 +1,74 @@
+// Copyright (C) 2023 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+#include <QtWidgets>
+
+using SearchBar = QWidget;
+using Element = QWidget;
+
+class Window : public QMainWindow
+{
+public:
+    Window(QWidget *parent = nullptr);
+
+protected:
+    bool event(QEvent *event) override;
+
+private:
+    Element *elementAt(QPoint pos) const {
+        return nullptr;
+    }
+
+    QToolBar *fileToolBar;
+    QMenu *fileMenu;
+
+    SearchBar *searchBar;
+};
+
+
+Window::Window(QWidget *parent)
+    : QMainWindow(parent)
+{
+//! [action_tooltip]
+    QAction *openAction = new QAction(tr("&Open..."));
+    openAction->setToolTip(tr("Open an existing file"));
+
+    fileMenu = menuBar()->addMenu(tr("&File"));
+    fileToolBar = addToolBar(tr("&File"));
+
+    fileMenu->addAction(openAction);
+    fileToolBar->addAction(openAction);
+//! [action_tooltip]
+
+//! [static_tooltip]
+    searchBar = new SearchBar;
+    searchBar->setToolTip(tr("Search in the current document"));
+//! [static_tooltip]
+
+    fileToolBar->addWidget(searchBar);
+}
+
+//! [dynamic_tooltip]
+bool Window::event(QEvent *event)
+{
+    if (event->type() == QEvent::ToolTip) {
+        QHelpEvent *helpEvent = static_cast<QHelpEvent *>(event);
+        if (Element *element = elementAt(helpEvent->pos())) {
+            QToolTip::showText(helpEvent->globalPos(), element->toolTip());
+        } else {
+            QToolTip::hideText();
+            event->ignore();
+        }
+
+        return true;
+    }
+    return QWidget::event(event);
+}
+//! [dynamic_tooltip]
+
+int main(int argc, char **argv)
+{
+    QApplication app(argc, argv);
+    Window w;
+    return 0;
+}
diff --git a/src/widgets/kernel/qtooltip.cpp b/src/widgets/kernel/qtooltip.cpp
index 2c68b029b01..2800f65ac62 100644
--- a/src/widgets/kernel/qtooltip.cpp
+++ b/src/widgets/kernel/qtooltip.cpp
@@ -45,15 +45,24 @@ using namespace Qt::StringLiterals;
     Rich text displayed in a tool tip is implicitly word-wrapped unless
     specified differently with \c{<p style='white-space:pre'>}.
 
-    The simplest and most common way to set a widget's tool tip is by
-    calling its QWidget::setToolTip() function.
+    UI elements that are created via \l{QAction} use the tooltip property
+    of the QAction, so for most interactive UI elements, setting that
+    property is the easiest way to provide tool tips.
+
+    \snippet tooltips/main.cpp action_tooltip
+
+    For any other widgets, the simplest and most common way to set
+    a widget's tool tip is by calling its QWidget::setToolTip() function.
+
+    \snippet tooltips/main.cpp static_tooltip
 
     It is also possible to show different tool tips for different
     regions of a widget, by using a QHelpEvent of type
     QEvent::ToolTip. Intercept the help event in your widget's \l
     {QWidget::}{event()} function and call QToolTip::showText() with
-    the text you want to display. The \l{widgets/tooltips}{Tooltips}
-    example illustrates this technique.
+    the text you want to display.
+
+    \snippet tooltips/main.cpp dynamic_tooltip
 
     If you are calling QToolTip::hideText(), or QToolTip::showText()
     with an empty string, as a result of a \l{QEvent::}{ToolTip}-event you
@@ -75,7 +84,7 @@ using namespace Qt::StringLiterals;
     \note Tool tips use the inactive color group of QPalette, because tool
     tips are not active windows.
 
-    \sa QWidget::toolTip, QAction::toolTip, {Tool Tips Example}
+    \sa QWidget::toolTip, QAction::toolTip
 */
 
 class QTipLabel : public QLabel