Add example for QQuickWebEngineTooltipRequest

Implement an example usage in customdialogs application and extend
the documentation.

Change-Id: Ibc240cf94ac939335455f4eac3d52ffec2ba7ff6
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Allan Sandfeld Jensen <allan.jensen@qt.io>

1 files changed, 32 insertions, 0 deletions

diff --git a/examples/webengine/customdialogs/doc/src/customdialogs.qdoc b/examples/webengine/customdialogs/doc/src/customdialogs.qdoc
index 5c550ed5e..6319ce53b 100644
--- a/examples/webengine/customdialogs/doc/src/customdialogs.qdoc
+++ b/examples/webengine/customdialogs/doc/src/customdialogs.qdoc
@@ -140,6 +140,38 @@
     To keep things simple, we do not provide any logic on component completion,
     and we simply close the form on any action.
 
+    \section2 Tooltip Requests
+
+    \l [QML]{TooltipRequest} is a request object that is passed as a
+    parameter of the WebEngineView::tooltipRequested signal. We use the
+    \c onTooltipRequested signal handler to handle requests for
+    custom tooltip menus at specific positions:
+
+    \quotefromfile webengine/customdialogs/WebView.qml
+    \skipto WebEngineView
+    \printuntil {
+    \dots 4
+    \skipto onTooltipRequested
+    \printuntil }
+    \printuntil }
+    \printuntil }
+    \dots 4
+    \skipuntil onFileDialogRequested
+    \skipuntil }});
+    \skipuntil }
+    \skipto }
+    \printline }
+
+    The second text field from the top on our page triggers the request. Next,
+    we check whether we should use the default menu. If not, we accept the
+    request and show a custom QML element as tooltip:
+
+    \image customdialogs-tooltip.png
+
+    \quotefromfile webengine/customdialogs/WebView.qml
+    \skipto Rectangle
+    \printuntil }
+
     \section2  Authentication Dialog Requests
 
     \image customdialogs-auth1.png