summaryrefslogtreecommitdiffstats
path: root/src/webenginewidgets
diff options
context:
space:
mode:
authorAllan Sandfeld Jensen <allan.jensen@qt.io>2019-04-09 13:50:17 +0200
committerAllan Sandfeld Jensen <allan.jensen@qt.io>2019-04-09 13:50:17 +0200
commitc9a64fda178c32ac924977ac93bf83d7e47767fe (patch)
treebeaf8671ccbce36b3d4018ce57fe9de29d40d87f /src/webenginewidgets
parent10611866af8736a397371a38d6b5486ee8d28c62 (diff)
parent44303861fd116b3a279d26300147e89a0bf8121c (diff)
Merge branch '5.12' into 5.13
Conflicts: src/3rdparty src/core/renderer/user_resource_controller.cpp src/core/web_contents_adapter.cpp src/webengine/doc/src/qtwebengine-overview.qdoc Change-Id: I46be9d33b3b65d61dfa099ee72a3509afb9bd6a4
Diffstat (limited to 'src/webenginewidgets')
-rw-r--r--src/webenginewidgets/api/qwebenginedownloaditem.cpp4
-rw-r--r--src/webenginewidgets/doc/src/qtwebenginewidgets-examples.qdoc4
-rw-r--r--src/webenginewidgets/doc/src/qtwebenginewidgets-index.qdoc2
-rw-r--r--src/webenginewidgets/doc/src/qtwebenginewidgets-module.qdoc2
-rw-r--r--src/webenginewidgets/doc/src/qtwebkitportingguide.qdoc72
-rw-r--r--src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc2
-rw-r--r--src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc4
7 files changed, 45 insertions, 45 deletions
diff --git a/src/webenginewidgets/api/qwebenginedownloaditem.cpp b/src/webenginewidgets/api/qwebenginedownloaditem.cpp
index deb92bfd3..4575f2929 100644
--- a/src/webenginewidgets/api/qwebenginedownloaditem.cpp
+++ b/src/webenginewidgets/api/qwebenginedownloaditem.cpp
@@ -117,7 +117,7 @@ static inline QWebEngineDownloadItem::DownloadInterruptReason toDownloadInterrup
\l{QWebEngineProfile::downloadRequested}{downloadRequested} signal together
with a newly created QWebEngineDownloadItem. The application can then
examine this item and decide whether to accept it or not. A signal handler
- must explicitly call accept() on the item for Qt WebEngine to actually start
+ must explicitly call accept() on the item for \QWE to actually start
downloading and writing data to disk. If no signal handler calls accept(),
then the download request will be automatically rejected and nothing will be
written to disk.
@@ -147,7 +147,7 @@ static inline QWebEngineDownloadItem::DownloadInterruptReason toDownloadInterrup
\section2 Web Page Downloads
In addition to normal file downloads, which consist simply of retrieving
- some raw bytes from the network and writing them to disk, Qt WebEngine also
+ some raw bytes from the network and writing them to disk, \QWE also
supports saving complete web pages, which involves parsing the page's HTML,
downloading any dependent resources, and potentially packaging everything
into a special file format (\l savePageFormat). To check if a download is
diff --git a/src/webenginewidgets/doc/src/qtwebenginewidgets-examples.qdoc b/src/webenginewidgets/doc/src/qtwebenginewidgets-examples.qdoc
index b6c5cb497..a9e0e69ea 100644
--- a/src/webenginewidgets/doc/src/qtwebenginewidgets-examples.qdoc
+++ b/src/webenginewidgets/doc/src/qtwebenginewidgets-examples.qdoc
@@ -28,13 +28,13 @@
/*!
\group webengine-widgetexamples
\title Qt WebEngine Widgets Examples
- \brief Examples demonstrating the Qt WebEngine Widgets usage.
+ \brief Examples demonstrating the \QWE Widgets usage.
\ingroup all-examples
Qt provides an integrated Web browser component based on Chromium, the popular
open source browser engine.
- These examples and demonstrations show a range of different uses for Qt WebEngine,
+ These examples and demonstrations show a range of different uses for \QWE,
from displaying Web pages within a Qt user interface to an implementation of
a basic function Web browser.
*/
diff --git a/src/webenginewidgets/doc/src/qtwebenginewidgets-index.qdoc b/src/webenginewidgets/doc/src/qtwebenginewidgets-index.qdoc
index abfd17ce3..b93bc86f2 100644
--- a/src/webenginewidgets/doc/src/qtwebenginewidgets-index.qdoc
+++ b/src/webenginewidgets/doc/src/qtwebenginewidgets-index.qdoc
@@ -67,7 +67,7 @@
This is a snapshot of the integration of Chromium into Qt.
Qt Commercial Edition licensees that wish to distribute applications that
- use the Qt WebEngine module need to be aware of their obligations under the
+ use the \QWE module need to be aware of their obligations under the
GNU Library General Public License (LGPLv2).
Developers using the Open Source Edition can choose to redistribute
diff --git a/src/webenginewidgets/doc/src/qtwebenginewidgets-module.qdoc b/src/webenginewidgets/doc/src/qtwebenginewidgets-module.qdoc
index 35fed802c..6f3eac5ad 100644
--- a/src/webenginewidgets/doc/src/qtwebenginewidgets-module.qdoc
+++ b/src/webenginewidgets/doc/src/qtwebenginewidgets-module.qdoc
@@ -33,7 +33,7 @@
\ingroup qtwebengine-modules
\qtvariable webenginewidgets
- The Qt WebEngineWidgets module provides a web browser engine as well as C++ classes to render
+ The \QWEWidgets module provides a web browser engine as well as C++ classes to render
and interact with web content.
To include the definitions of the module's classes, use the
diff --git a/src/webenginewidgets/doc/src/qtwebkitportingguide.qdoc b/src/webenginewidgets/doc/src/qtwebkitportingguide.qdoc
index 7bc7ff48d..e3fdc4ff1 100644
--- a/src/webenginewidgets/doc/src/qtwebkitportingguide.qdoc
+++ b/src/webenginewidgets/doc/src/qtwebkitportingguide.qdoc
@@ -28,7 +28,7 @@
/*!
\page qtwebenginewidgets-qtwebkitportingguide.html
\title Porting from Qt WebKit to Qt WebEngine
- \brief Overview of the differences between the Qt WebKit and Qt WebEngine API.
+ \brief Overview of the differences between the Qt \WebKit and \QWE API.
The following sections contain information about porting an application that uses the
\l{http://doc.qt.io/archives/qt-5.3/qtwebkit-index.html}{Qt WebKit}
@@ -37,17 +37,17 @@
\section1 Architecture
- Chromium provides its own network and painting engines, which Qt WebEngine uses. This, among
- other things, allows Qt WebEngine to provide better and more reliable support for the latest
- HTML5 specification than Qt WebKit. However, Qt WebEngine is thus also heavier than Qt WebKit
+ Chromium provides its own network and painting engines, which \QWE uses. This, among
+ other things, allows \QWE to provide better and more reliable support for the latest
+ HTML5 specification than Qt \WebKit. However, \QWE is thus also heavier than Qt \WebKit
and does not provide direct access to the network stack and the HTML document through C++ APIs.
\section1 Class Names
- The Qt WebEngine equivalent of Qt WebKit C++ classes are prefixed by
+ The \QWE equivalent of Qt \WebKit C++ classes are prefixed by
"\e QWebEngine" instead of "\e QWeb".
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
#include <QWebHistory>
#include <QWebHistoryItem>
@@ -59,7 +59,7 @@
QWebPage
QWebView
\endcode
- \b {Qt WebEngine}
+ \b {\QWE}
\code
#include <QWebEngineHistory>
#include <QWebEngineHistoryItem>
@@ -77,23 +77,23 @@
\section2 In qmake Project Files
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
QT += webkitwidgets
\endcode
- \b {Qt WebEngine}
+ \b {\QWE}
\code
QT += webenginewidgets
\endcode
\section2 Including the Module in Source Files
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
#include <QtWebKit/QtWebKit>
#include <QtWebKitWidgets/QtWebKitWidgets> // With Qt >= 4.8
\endcode
- \b {Qt WebEngine}
+ \b {\QWE}
\code
#include <QtWebEngineWidgets/QtWebEngineWidgets>
\endcode
@@ -104,22 +104,22 @@
HTML frames can be used to divide web pages into several areas where the content can be
represented individually.
- In Qt WebKit, QWebFrame represents a frame inside a web page. Each QWebPage object contains at
+ In Qt \WebKit, QWebFrame represents a frame inside a web page. Each QWebPage object contains at
least one frame, the main frame, obtained using QWebPage::mainFrame(). Additional frames will
be created for the HTML \c <frame> element, which defines the appearance and contents of a
single frame, or the \c <iframe> element, which inserts a frame within a block of text.
- In Qt WebEngine, frame handling has been merged into the QWebEnginePage class. All child frames
+ In \QWE, frame handling has been merged into the QWebEnginePage class. All child frames
are now considered part of the content, and only accessible through JavaScript. Methods of the
QWebFrame class, such as \c load() are now available directly through the QWebEnginePage itself.
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
QWebPage page;
connect(page.mainFrame(), SIGNAL(urlChanged(const QUrl&)), SLOT(mySlotName()));
page.mainFrame()->load(url);
\endcode
- \b {Qt WebEngine}
+ \b {\QWE}
\code
QWebEnginePage page;
connect(&page, SIGNAL(urlChanged(const QUrl&)), SLOT(mySlotName()));
@@ -129,12 +129,12 @@
\section1 Some Methods Now Return Their Result Asynchronously
- Because Qt WebEngine uses a multi-process architecture, calls to some methods from applications
+ Because \QWE uses a multi-process architecture, calls to some methods from applications
will return immediately, while the results should be received asynchronously via a callback
mechanism. A function pointer, a functor, or a lambda expression must be provided to handle the
results when they become available.
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
QWebPage *page = new QWebPage;
QTextEdit *textEdit = new QTextEdit;
@@ -142,7 +142,7 @@
textEdit->setPlainText(page->toHtml());
textEdit->setPlainText(page->toPlainText());
\endcode
- \b {Qt WebEngine (with a lambda function in C++11)}
+ \b {\QWE (with a lambda function in C++11)}
\code
QWebEnginePage *page = new QWebEnginePage;
QTextEdit *textEdit = new QTextEdit;
@@ -150,7 +150,7 @@
page->toHtml([textEdit](const QString &result){ textEdit->setPlainText(result); });
page->toPlainText([textEdit](const QString &result){ textEdit->setPlainText(result); });
\endcode
- \b {Qt WebEngine (with a functor template wrapping a member function)}
+ \b {\QWE (with a functor template wrapping a member function)}
\code
template<typename Arg, typename R, typename C>
struct InvokeWrapper {
@@ -174,7 +174,7 @@
page->toHtml(invoke(textEdit, &QTextEdit::setPlainText));
page->toPlainText(invoke(textEdit, &QTextEdit::setPlainText));
\endcode
- \b {Qt WebEngine (with a regular functor)}
+ \b {\QWE (with a regular functor)}
\code
struct SetPlainTextFunctor {
QTextEdit *textEdit;
@@ -192,29 +192,29 @@
\endcode
- \section1 Qt WebEngine Does Not Interact with QNetworkAccessManager
+ \section1 \QWE Does Not Interact with QNetworkAccessManager
Some classes of Qt Network such as QAuthenticator were reused for their interface
- but, unlike Qt WebKit, Qt WebEngine has its own HTTP implementation and cannot
+ but, unlike Qt \WebKit, \QWE has its own HTTP implementation and cannot
go through a QNetworkAccessManager.
The signals and methods of QNetworkAccessManager that are still supported were
moved to the QWebEnginePage class.
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
QNetworkAccessManager qnam;
QWebPage page;
page.setNetworkAccessManager(&qnam);
connect(&qnam, SIGNAL(authenticationRequired(QNetworkReply*,QAuthenticator*)), this, SLOT(authenticate(QNetworkReply*,QAuthenticator*)));
\endcode
- \b {Qt WebEngine}
+ \b {\QWE}
\code
QWebEnginePage page;
connect(&page, SIGNAL(authenticationRequired(QNetworkReply*,QAuthenticator*)), this, SLOT(authenticate(QNetworkReply*,QAuthenticator*)));
\endcode
- \note In Qt WebEngine, the QAuthenticator must be explicitly set to null to
+ \note In \QWE, the QAuthenticator must be explicitly set to null to
cancel authentication:
\code
@@ -233,12 +233,12 @@
It is currently only possible to run JavaScript on the main frame of a page and the
result is returned asynchronously to the provided functor.
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
QWebPage *page = new QWebPage;
qDebug() << page->mainFrame()->evaluateJavaScript("'Java' + 'Script'");
\endcode
- \b {Qt WebEngine (with lambda expressions in C++11)}
+ \b {\QWE (with lambda expressions in C++11)}
\code
QWebEnginePage *page = new QWebEnginePage;
page->runJavaScript("'Java' + 'Script'", [](const QVariant &result){ qDebug() << result; });
@@ -255,12 +255,12 @@
the contentEditable attribute in the latest HTML standard. Therefore, QWebEnginePage::runJavaScript
is all that is needed.
- \b {Qt WebKit}
+ \b {Qt \WebKit}
\code
QWebPage page;
page.setContentEditable(true);
\endcode
- \b {Qt WebEngine}
+ \b {\QWE}
\code
QWebEnginePage page;
page.runJavaScript("document.documentElement.contentEditable = true");
@@ -269,35 +269,35 @@
\section1 Unavailable Qt WebKit API
- The Qt WebKit classes and methods in this list will not be available in Qt WebEngine.
+ The Qt \WebKit classes and methods in this list will not be available in \QWE.
\table
\row
\li QGraphicsWebView
- \li Qt WebEngine is designed for being used with hardware acceleration. Because we could not
+ \li \QWE is designed for being used with hardware acceleration. Because we could not
support a web view class in a QGraphicsView unless it would be attached to a QGLWidget
viewport, this feature is out of scope.
\row
\li QWebElement
- \li Qt WebEngine uses a multi-process architecture and this means that
+ \li \QWE uses a multi-process architecture and this means that
any access to the internal structure of the page has to be done
asynchronously, any query result must be returned through callbacks.
The QWebElement API was designed for synchronous access and this
would require a complete redesign.
\row
\li QWebDatabase
- \li The Web SQL Database feature that this API was wrapping in Qt WebKit
+ \li The Web SQL Database feature that this API was wrapping in Qt \WebKit
was dropped from the HTML5 standard.
\row
\li QWebPluginDatabase, QWebPluginFactory, QWebPluginInfo, QWebPage::setPalette,
QWebView::setRenderHints
- \li Qt WebEngine renders web pages using Skia and is not using QPainter
+ \li \QWE renders web pages using Skia and is not using QPainter
or Qt for this purpose. The HTML5 standard also now offers much
better alternatives that were not available when native controls
- plugins were introduced in Qt WebKit.
+ plugins were introduced in Qt \WebKit.
\row
\li QWebHistoryInterface
- \li Visited links are persisted automatically by Qt WebEngine.
+ \li Visited links are persisted automatically by \QWE.
\row
\li QWebPage::setContentEditable
\li In the latest HTML standard, any document element can be made editable through the
diff --git a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc
index f9ab710d1..c451344d2 100644
--- a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc
+++ b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc
@@ -440,7 +440,7 @@
/*!
\fn void QWebEnginePage::triggerAction(WebAction action, bool checked = false)
This function can be called to trigger the specified \a action.
- It is also called by Qt WebEngine if the user triggers the action, for example
+ It is also called by \QWE if the user triggers the action, for example
through a context menu item.
If \a action is a checkable action, then \a checked specifies whether the action
diff --git a/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc
index 568e7a63a..fce1e8d8f 100644
--- a/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc
+++ b/src/webenginewidgets/doc/src/qwebengineview_lgpl.qdoc
@@ -33,7 +33,7 @@
\inmodule QtWebEngineWidgets
- A \e {web view} is the main widget component of the Qt WebEngine web browsing module.
+ A \e {web view} is the main widget component of the \QWE web browsing module.
It can be used in various applications to display web content live from the
Internet.
@@ -129,7 +129,7 @@
The HTML document is loaded immediately, whereas external objects are loaded asynchronously.
- When using this method, Qt WebEngine assumes that external resources, such as
+ When using this method, \QWE assumes that external resources, such as
JavaScript programs or style sheets, are encoded in UTF-8 unless otherwise
specified. For example, the encoding of an external script can be specified
through the \c charset attribute of the HTML script tag. Alternatively, the