diff options
author | Alexandru Croitor <alexandru.croitor@qt.io> | 2016-06-01 17:54:49 +0200 |
---|---|---|
committer | Alexandru Croitor <alexandru.croitor@qt.io> | 2016-08-09 06:29:08 +0000 |
commit | 6534b09073791398bad99863821740e986915bff (patch) | |
tree | 1d2476d387e75d691d112f71f74f9094b25cbd8a /src/webengine/doc/src/webengineview.qdoc | |
parent | 521c3f6c47e3e7e284eaaca40c1820fbcb1b56e0 (diff) |
Add focusOnNavigationEnabled setting
The focusOnNavigationEnabled setting allows changing the behavior of
whether a WebEngine view (widget or quick) will automatically get
focus, whenever a navigation action happens (load, reload, previous
history entry, etc).
The default behavior before this patch was to always grab the focus.
[ChangeLog][QtWebEngine][General] Add focusOnNavigationEnabled setting
which allows controlling whether a web view will receive focus on a
navigation request. Previously the view always received the focus.
Task-number: QTBUG-52999
Change-Id: I6d30d973a41b53011131f21dcecbf6ec4d652759
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
Diffstat (limited to 'src/webengine/doc/src/webengineview.qdoc')
-rw-r--r-- | src/webengine/doc/src/webengineview.qdoc | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/src/webengine/doc/src/webengineview.qdoc b/src/webengine/doc/src/webengineview.qdoc index 6fd9ba45b..938545d79 100644 --- a/src/webengine/doc/src/webengineview.qdoc +++ b/src/webengine/doc/src/webengineview.qdoc @@ -82,7 +82,11 @@ described by \l FindFlags. The \l setActiveFocusOnPress() method can be used to create a UI element that should not get - focus. This can be useful in a hybrid UI. + focus on press. This can be useful in a hybrid UI. + + The \l {WebEngineSettings::focusOnNavigationEnabled} {focusOnNavigationEnabled} setting can be + used to stop the view from automatically receiving focus when a navigation operation occurs + (like loading or reloading a page or navigating through history). The \l linkHovered() signal is emitted when a mouse pointer passes over a link and thus corresponds to the \c{mouseover} DOM event. @@ -481,7 +485,7 @@ a web engine view can be used to create a UI element that should not get focus. This can be useful in a hybrid UI. - \sa activeFocusOnPressChanged() + \sa activeFocusOnPressChanged, WebEngineSettings::focusOnNavigationEnabled */ /*! |