Add dialog requests to qml api

Introduce qml APIs to support custom dialogs:
 * http and proxy authentication
 * javascript dialogs
 * file pickers
 * color pickers
 * form validation messages

[ChangeLog][QtWebEngine][QML] Added ability to provide custom dialogs
for HTTP and proxy authentication, JavaScript alerts, file and color
picking, and form validation messages.

Task-number: QTBUG-51190
Change-Id: I559ca59264750feb36ba7d3dba0bf0647509306d
Reviewed-by: Kai Koehne <kai.koehne@qt.io>

1 files changed, 71 insertions, 0 deletions

diff --git a/src/webengine/doc/src/webengineview.qdoc b/src/webengine/doc/src/webengineview.qdoc
index d2c239341..eaf7936d2 100644
--- a/src/webengine/doc/src/webengineview.qdoc
+++ b/src/webengine/doc/src/webengineview.qdoc
@@ -1160,3 +1160,74 @@
 
     \sa viewSource()
 */
+
+/*!
+    \qmlsignal WebEngineView::authenticationDialogRequested(AuthenticationDialogRequest request)
+    \since QtWebEngine 1.4
+
+    This signal is emitted when an authentication dialog is requested.
+
+    The request can be handled by using the methods of the AuthenticationDialogRequest
+    type.
+
+    \note Signal handlers need to call \c{request.accepted = true} to prevent a
+    default dialog from showing up. Make sure to call either
+    AuthenticationDialogRequest::dialogAccept() or AuthenticationDialogRequest::dialogReject()
+    afterwards.
+*/
+
+/*!
+    \qmlsignal WebEngineView::javaScriptDialogRequested(JavaScriptDialogRequest request)
+    \since QtWebEngine 1.4
+
+    This signal is emitted when a JavaScript dialog is requested.
+
+    The request can be handled by using the methods of the JavaScriptDialogRequest
+    type.
+
+    \note Signal handlers need to call \c{request.accepted = true} to prevent a
+    default dialog from showing up. Make sure to call either
+    JavaScriptDialogRequest::dialogAccept() or JavaScriptDialogRequest::dialogReject()
+    afterwards.
+*/
+
+/*!
+    \qmlsignal WebEngineView::colorDialogRequested(ColorDialogRequest request)
+    \since QtWebEngine 1.4
+
+    This signal is emitted when a color picker dialog is requested.
+
+    The request can be handled by using the methods of the ColorDialogRequest
+    type.
+
+    \note Signal handlers need to call \c{request.accepted = true} to prevent a
+    default dialog from showing up. Make sure to call either
+    ColorDialogRequest::dialogAccept() or ColorDialogRequest::dialogReject() afterwards.
+*/
+
+/*!
+    \qmlsignal WebEngineView::fileDialogRequested(FileDialogRequest request)
+    \since QtWebEngine 1.4
+
+    This signal is emitted when a file picker dialog is requested.
+
+    The request error can be handled by using the methods of the FileDialogRequest
+    type.
+
+    \note Signal handlers need to call \c{request.accepted = true} to prevent a
+    default dialog from showing up. Make sure to call either FileDialogRequest::dialogAccept()
+    or FileDialogRequest::dialogReject() afterwards.
+*/
+
+/*!
+    \qmlsignal WebEngineView::formValidationMessageRequested(FormValidationMessageRequest request)
+    \since QtWebEngine 1.4
+
+    This signal is emitted when a validation message is requested.
+
+    The request can be handled by using the methods of the FormValidationMessageRequest
+    type.
+
+    \note Signal handlers need to call \c{request.accepted = true} to prevent a
+    default dialog from showing up.
+*/