From fd2acd57df7d62490a9a7c1f7b5b60ae50c51ce6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=BCri=20Valdmann?= Date: Thu, 21 Feb 2019 13:23:41 +0100 Subject: Clarify documentation of QWebEnginePage::title() MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Explain what happens when the HTML has no proper defined and clarify the meaning of 'by default': it refers to the state before load()/setUrl()/etc. Fixes: QTBUG-71799 Change-Id: Ib2669007573b3ea53e205d9228237bae392f6f78 Reviewed-by: Michael Brüning <michael.bruning@qt.io> Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> --- src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc | 6 ++++++ src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc | 4 ++-- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc index 035b45a6d..ef1166601 100644 --- a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc +++ b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc @@ -643,6 +643,12 @@ \property QWebEnginePage::title \brief the title of the page as defined by the HTML \c <title> element + If the page has no \c <title> element, then the URL is used instead. For \c + file:// URLs only the filename is used and not the full path. + + By default, before any content has been loaded, this property contains an + empty string. + \sa titleChanged() */ diff --git a/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc index 501959ab9..1c51a2a52 100644 --- a/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc +++ b/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc @@ -173,9 +173,9 @@ /*! \property QWebEngineView::title - \brief the title of the web page currently viewed + \brief the title of the page as defined by the HTML \c <title> element - By default, this property contains an empty string. + Equivalent to \l {QWebEnginePage::title()}. \sa titleChanged() */ -- cgit v1.2.3