diff options
author | Liang Qi <liang.qi@theqtcompany.com> | 2015-06-29 20:20:58 +0200 |
---|---|---|
committer | Liang Qi <liang.qi@theqtcompany.com> | 2015-06-29 20:20:58 +0200 |
commit | cba8f2605f34649e3ca2a767edc7ac9509e7fee9 (patch) | |
tree | c3fbf81bc0eee5db87c357366b22ffd62b9c3dcc /src | |
parent | 0c366eb741d8d925418c517d3954900c090aca3d (diff) | |
parent | 434ef539381bbc3c19f54f914d5bda83eafdc92b (diff) |
Merge remote-tracking branch 'origin/5.5' into dev
Conflicts:
.qmake.conf
src/webenginewidgets/api/qwebenginepage.cpp
Change-Id: Idb33c92bd53fab76eee8fedb542dbf5e4a10f9e6
Diffstat (limited to 'src')
m--------- | src/3rdparty | 0 | ||||
-rw-r--r-- | src/core/config/embedded_linux.pri | 1 | ||||
-rw-r--r-- | src/core/gyp_run.pro | 1 | ||||
-rw-r--r-- | src/core/web_contents_view_qt.cpp | 1 | ||||
-rw-r--r-- | src/webengine/api/qquickwebengineview.cpp | 9 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginedownloaditem.cpp | 28 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginedownloaditem.h | 14 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginepage.cpp | 13 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebengineprofile.cpp | 10 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebengineprofile.h | 2 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebengineprofile_p.h | 3 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginescript.cpp | 113 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginescriptcollection.cpp | 62 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginescriptcollection.h | 3 | ||||
-rw-r--r-- | src/webenginewidgets/api/qwebenginescriptcollection_p.h | 2 | ||||
-rw-r--r-- | src/webenginewidgets/doc/src/qtwebenginewidgets.qdoc | 17 |
16 files changed, 234 insertions, 45 deletions
diff --git a/src/3rdparty b/src/3rdparty -Subproject 0decf91700ad48612b885a549e79bb6252196d4 +Subproject 85827b2c3db3c4cb6308ce8a4c2069c0e403cd9 diff --git a/src/core/config/embedded_linux.pri b/src/core/config/embedded_linux.pri index 91b14003c..cc8c40f8e 100644 --- a/src/core/config/embedded_linux.pri +++ b/src/core/config/embedded_linux.pri @@ -43,6 +43,7 @@ GYP_CONFIG += \ use_openssl=1 \ use_ozone=1 \ use_pango=0 \ + use_system_fontconfig=1 \ use_system_icu=1 \ icu_use_data_file_flag=0 \ use_x11=0 \ diff --git a/src/core/gyp_run.pro b/src/core/gyp_run.pro index 4c6eb8c56..3f631302c 100644 --- a/src/core/gyp_run.pro +++ b/src/core/gyp_run.pro @@ -19,6 +19,7 @@ cross_compile { GYP_CONFIG += disable_glibcxx_debug=1 !webcore_debug: GYP_CONFIG += remove_webcore_debug_symbols=1 +!v8base_debug: GYP_CONFIG += remove_v8base_debug_symbols=1 linux:contains(QT_CONFIG, separate_debug_info): GYP_CONFIG += linux_dump_symbols=1 diff --git a/src/core/web_contents_view_qt.cpp b/src/core/web_contents_view_qt.cpp index e7764fbcb..340d7b33e 100644 --- a/src/core/web_contents_view_qt.cpp +++ b/src/core/web_contents_view_qt.cpp @@ -50,6 +50,7 @@ namespace QtWebEngineCore { void WebContentsViewQt::initialize(WebContentsAdapterClient* client) { m_client = client; + m_factoryClient = client; // Check if a RWHV was created before the initialization. if (m_webContents->GetRenderWidgetHostView()) diff --git a/src/webengine/api/qquickwebengineview.cpp b/src/webengine/api/qquickwebengineview.cpp index f5210a816..51dcb61eb 100644 --- a/src/webengine/api/qquickwebengineview.cpp +++ b/src/webengine/api/qquickwebengineview.cpp @@ -710,6 +710,15 @@ void QQuickWebEngineView::setProfile(QQuickWebEngineProfile *profile) Q_D(QQuickWebEngineView); d->setProfile(profile); } +/*! + * \qmlproperty WebEngineSettings QQuickWebEngineView::settings + * \readonly settings + * \since QtWebEngine 1.1 + * + * The \a settings property holds the settings used by this view. + * + * \sa WebEngineSettings + */ QQuickWebEngineSettings *QQuickWebEngineView::settings() const { diff --git a/src/webenginewidgets/api/qwebenginedownloaditem.cpp b/src/webenginewidgets/api/qwebenginedownloaditem.cpp index 703570587..7df044e66 100644 --- a/src/webenginewidgets/api/qwebenginedownloaditem.cpp +++ b/src/webenginewidgets/api/qwebenginedownloaditem.cpp @@ -156,9 +156,9 @@ void QWebEngineDownloadItem::cancel() Returns the download item's id. */ -quint32 QWebEngineDownloadItem::id() +quint32 QWebEngineDownloadItem::id() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->downloadId; } @@ -205,9 +205,9 @@ quint32 QWebEngineDownloadItem::id() \sa QWebEngineDownloadItem::DownloadState */ -QWebEngineDownloadItem::DownloadState QWebEngineDownloadItem::state() +QWebEngineDownloadItem::DownloadState QWebEngineDownloadItem::state() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->downloadState; } @@ -217,9 +217,9 @@ QWebEngineDownloadItem::DownloadState QWebEngineDownloadItem::state() -1 means the size is unknown. */ -qint64 QWebEngineDownloadItem::totalBytes() +qint64 QWebEngineDownloadItem::totalBytes() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->totalBytes; } @@ -229,9 +229,9 @@ qint64 QWebEngineDownloadItem::totalBytes() -1 means the size is unknown. */ -qint64 QWebEngineDownloadItem::receivedBytes() +qint64 QWebEngineDownloadItem::receivedBytes() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->receivedBytes; } @@ -239,9 +239,9 @@ qint64 QWebEngineDownloadItem::receivedBytes() Returns the download's origin url. */ -QUrl QWebEngineDownloadItem::url() +QUrl QWebEngineDownloadItem::url() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->downloadUrl; } @@ -252,9 +252,9 @@ QUrl QWebEngineDownloadItem::url() and file name is deduced not to overwrite already existing files. */ -QString QWebEngineDownloadItem::path() +QString QWebEngineDownloadItem::path() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->downloadPath; } @@ -282,9 +282,9 @@ void QWebEngineDownloadItem::setPath(QString path) \sa finished(), state(), */ -bool QWebEngineDownloadItem::isFinished() +bool QWebEngineDownloadItem::isFinished() const { - Q_D(QWebEngineDownloadItem); + Q_D(const QWebEngineDownloadItem); return d->downloadFinished; } diff --git a/src/webenginewidgets/api/qwebenginedownloaditem.h b/src/webenginewidgets/api/qwebenginedownloaditem.h index ee3ab221d..d362131f2 100644 --- a/src/webenginewidgets/api/qwebenginedownloaditem.h +++ b/src/webenginewidgets/api/qwebenginedownloaditem.h @@ -61,14 +61,14 @@ public: }; Q_ENUMS(DownloadState) - quint32 id(); - DownloadState state(); - qint64 totalBytes(); - qint64 receivedBytes(); - QUrl url(); - QString path(); + quint32 id() const; + DownloadState state() const; + qint64 totalBytes() const; + qint64 receivedBytes() const; + QUrl url() const; + QString path() const; void setPath(QString path); - bool isFinished(); + bool isFinished() const; public Q_SLOTS: void accept(); diff --git a/src/webenginewidgets/api/qwebenginepage.cpp b/src/webenginewidgets/api/qwebenginepage.cpp index bf5868925..f2941d952 100644 --- a/src/webenginewidgets/api/qwebenginepage.cpp +++ b/src/webenginewidgets/api/qwebenginepage.cpp @@ -1093,20 +1093,27 @@ QStringList QWebEnginePage::chooseFiles(FileSelectionMode mode, const QStringLis // can work with) and mimetypes ranging from text/plain or images/* to application/vnd.openxmlformats-officedocument.spreadsheetml.sheet Q_UNUSED(acceptedMimeTypes); QStringList ret; + QString str; switch (static_cast<FilePickerController::FileChooserMode>(mode)) { case FilePickerController::OpenMultiple: ret = QFileDialog::getOpenFileNames(view(), QString()); break; // Chromium extension, not exposed as part of the public API for now. case FilePickerController::UploadFolder: - ret << QFileDialog::getExistingDirectory(view(), tr("Select folder to upload")) + QLatin1Char('/'); + str = QFileDialog::getExistingDirectory(view(), tr("Select folder to upload")) + QLatin1Char('/'); + if (!str.isNull()) + ret << str; break; case FilePickerController::Save: - ret << QFileDialog::getSaveFileName(view(), QString(), (QStandardPaths::writableLocation(QStandardPaths::DownloadLocation) + oldFiles.first())); + str = QFileDialog::getSaveFileName(view(), QString(), (QStandardPaths::writableLocation(QStandardPaths::DownloadLocation) + oldFiles.first())); + if (!str.isNull()) + ret << str; break; default: case FilePickerController::Open: - ret << QFileDialog::getOpenFileName(view(), QString(), oldFiles.first()); + str = QFileDialog::getOpenFileName(view(), QString(), oldFiles.first()); + if (!str.isNull()) + ret << str; break; } return ret; diff --git a/src/webenginewidgets/api/qwebengineprofile.cpp b/src/webenginewidgets/api/qwebengineprofile.cpp index eda242102..afe2277f2 100644 --- a/src/webenginewidgets/api/qwebengineprofile.cpp +++ b/src/webenginewidgets/api/qwebengineprofile.cpp @@ -104,8 +104,8 @@ using QtWebEngineCore::BrowserContextAdapter; */ QWebEngineProfilePrivate::QWebEngineProfilePrivate(BrowserContextAdapter* browserContext) - : scriptCollection(new QWebEngineScriptCollectionPrivate(browserContext->userScriptController())) - , m_settings(new QWebEngineSettings()) + : m_settings(new QWebEngineSettings()) + , m_scriptCollection(new QWebEngineScriptCollection(new QWebEngineScriptCollectionPrivate(browserContext->userScriptController()))) , m_browserContextRef(browserContext) { m_browserContextRef->addClient(this); @@ -451,10 +451,10 @@ bool QWebEngineProfile::visitedLinksContainsUrl(const QUrl &url) const Returns the script collection used by this profile. \sa QWebEngineScriptCollection */ -QWebEngineScriptCollection &QWebEngineProfile::scripts() +QWebEngineScriptCollection *QWebEngineProfile::scripts() const { - Q_D(QWebEngineProfile); - return d->scriptCollection; + Q_D(const QWebEngineProfile); + return d->m_scriptCollection.data(); } /*! diff --git a/src/webenginewidgets/api/qwebengineprofile.h b/src/webenginewidgets/api/qwebengineprofile.h index ab36a7b16..b13f3d631 100644 --- a/src/webenginewidgets/api/qwebengineprofile.h +++ b/src/webenginewidgets/api/qwebengineprofile.h @@ -102,7 +102,7 @@ public: bool visitedLinksContainsUrl(const QUrl &url) const; QWebEngineSettings *settings() const; - QWebEngineScriptCollection &scripts(); + QWebEngineScriptCollection *scripts() const; static QWebEngineProfile *defaultProfile(); diff --git a/src/webenginewidgets/api/qwebengineprofile_p.h b/src/webenginewidgets/api/qwebengineprofile_p.h index b0bfc88b9..55941580d 100644 --- a/src/webenginewidgets/api/qwebengineprofile_p.h +++ b/src/webenginewidgets/api/qwebengineprofile_p.h @@ -43,6 +43,7 @@ #include "qwebenginescriptcollection.h" #include <QMap> #include <QPointer> +#include <QScopedPointer> namespace QtWebEngineCore { class BrowserContextAdapter; @@ -72,10 +73,10 @@ public: void removeUrlSchemeHandler(QWebEngineUrlSchemeHandler *); void clearUrlSchemeHandlers(); - QWebEngineScriptCollection scriptCollection; private: QWebEngineProfile *q_ptr; QWebEngineSettings *m_settings; + QScopedPointer<QWebEngineScriptCollection> m_scriptCollection; QExplicitlySharedDataPointer<QtWebEngineCore::BrowserContextAdapter> m_browserContextRef; QMap<quint32, QPointer<QWebEngineDownloadItem> > m_ongoingDownloads; QMap<QByteArray, QPointer<QWebEngineUrlSchemeHandler> > m_urlSchemeHandlers; diff --git a/src/webenginewidgets/api/qwebenginescript.cpp b/src/webenginewidgets/api/qwebenginescript.cpp index e2f267330..e834c5067 100644 --- a/src/webenginewidgets/api/qwebenginescript.cpp +++ b/src/webenginewidgets/api/qwebenginescript.cpp @@ -41,10 +41,63 @@ using QtWebEngineCore::UserScript; +/*! + \class QWebEngineScript + \inmodule QtWebEngineWidgets + \since 5.5 + \brief The QWebEngineScript class encapsulates a JavaScript program. + \preliminary + + QWebEngineScript allows the programatic injection of so called "user scripts" in the + javascript engine at different points, determined by injectionPoint(), during the loading of web contents. + + Scripts can be executed either in the main javascript world, along with the rest of the JavaScript coming + from the web contents, or in their own isolated world. While the DOM of the page can be accessed from any world, + JavaScript variables a function defined in one world are not accessible from a different one. + ScriptWorldId provides some predefined ids for this purpose. + +*/ +/*! + \enum QWebEngineScript::InjectionPoint + + This enum describes the timing for when the script injection should happen. + + \value DocumentCreation The script will be executed as soon as the document is created. This is not suitable for + any DOM operation. + \value DocumentReady The script will run as soon as the DOM is ready. This is equivalent to the DOMContentLoaded + event firing in JavaScript. + \value Deferred The script will run when the page load finishes, or 500ms after the document is ready, whichever + comes first. + +*/ +/*! + \enum QWebEngineScript::ScriptWorldId + + This enum provides pre defined world ids for isolating user scripts into different worlds. + + \value MainWorld The world used by the page's web contents. It can be useful in order to expose custom functionality + to web contents in certain scenarios. + \value ApplicationWorld The default isolated world used for application level functionality implemented in JavaScript. + \value UserWorld The first isolated world to be used by scripts set by users if the application is not making use + of more worlds. As a rule of thumbs, if that functionality is exposed to the application users, each individual script + should probably get its own isolated world. + +*/ + +/*! + * \brief QWebEngineScript::QWebEngineScript + * + * Constructs a null script. + */ + QWebEngineScript::QWebEngineScript() : d(new UserScript) { } +/*! + * \brief QWebEngineScript::isNull + * \return \c true is the script is null, \c false otherwise. + */ QWebEngineScript::QWebEngineScript(const QWebEngineScript &other) : d(other.d) @@ -66,11 +119,24 @@ bool QWebEngineScript::isNull() const return d->isNull(); } +/*! + * \brief QWebEngineScript::name + * \return The name of the script. Can be useful to retrieve a given script from a QWebEngineScriptCollection. + * + * \sa QWebEngineScriptCollection::findScript(), QWebEngineScriptCollection::findScripts() + */ + QString QWebEngineScript::name() const { return d->name(); } +/*! + * \brief QWebEngineScript::setName + * \param scriptName + * + * Sets the script name to \a scriptName. + */ void QWebEngineScript::setName(const QString &scriptName) { if (scriptName == name()) @@ -78,11 +144,20 @@ void QWebEngineScript::setName(const QString &scriptName) d->setName(scriptName); } +/*! + * \brief QWebEngineScript::sourceCode + * \return the source of the script. + */ QString QWebEngineScript::sourceCode() const { return d->sourceCode(); } +/*! + * \brief QWebEngineScript::setSourceCode + * \param scriptSource + * Sets the script source to \a scriptSource. + */ void QWebEngineScript::setSourceCode(const QString &scriptSource) { if (scriptSource == sourceCode()) @@ -94,11 +169,24 @@ ASSERT_ENUMS_MATCH(QWebEngineScript::Deferred, UserScript::AfterLoad) ASSERT_ENUMS_MATCH(QWebEngineScript::DocumentReady, UserScript::DocumentLoadFinished) ASSERT_ENUMS_MATCH(QWebEngineScript::DocumentCreation, UserScript::DocumentElementCreation) +/*! + * \brief QWebEngineScript::injectionPoint + * \return the point in the loading process at which the script will be executed. + * The default value is QWebEngineScript::Deferred. + * + * \sa setInjectionPoint + */ QWebEngineScript::InjectionPoint QWebEngineScript::injectionPoint() const { return static_cast<QWebEngineScript::InjectionPoint>(d->injectionPoint()); } - +/*! + * \brief QWebEngineScript::setInjectionPoint + * \param p + * Sets the point at which to execute the script to be \p. + * + * \sa QWebEngineScript::InjectionPoint + */ void QWebEngineScript::setInjectionPoint(QWebEngineScript::InjectionPoint p) { if (p == injectionPoint()) @@ -106,11 +194,20 @@ void QWebEngineScript::setInjectionPoint(QWebEngineScript::InjectionPoint p) d->setInjectionPoint(static_cast<UserScript::InjectionPoint>(p)); } +/*! + * \brief QWebEngineScript::worldId + * \return the world id defining which world the script is executed in. + */ quint32 QWebEngineScript::worldId() const { return d->worldId(); } +/*! + * \brief QWebEngineScript::setWorldId + * \param id + * Sets the world id of the isolated world to use when running this script. + */ void QWebEngineScript::setWorldId(quint32 id) { if (id == d->worldId()) @@ -118,11 +215,20 @@ void QWebEngineScript::setWorldId(quint32 id) d->setWorldId(id); } +/*! + * \brief QWebEngineScript::runsOnSubFrames + * \return \c true if the script is executed on every frame in the page, \c false if it is only ran for the main frame. + */ bool QWebEngineScript::runsOnSubFrames() const { return d->runsOnSubFrames(); } +/*! + * \brief QWebEngineScript::setRunsOnSubFrames + * \param on + * Sets whether or not the script is executed on sub frames in addition to the main frame. + */ void QWebEngineScript::setRunsOnSubFrames(bool on) { if (runsOnSubFrames() == on) @@ -130,6 +236,11 @@ void QWebEngineScript::setRunsOnSubFrames(bool on) d->setRunsOnSubFrames(on); } +/*! + * \brief QWebEngineScript::operator == + * \param other + * \return \c true if this QWebEngineScript is equal to \a other, otherwise returns \c false. + */ bool QWebEngineScript::operator==(const QWebEngineScript &other) const { return d == other.d || *d == *(other.d); diff --git a/src/webenginewidgets/api/qwebenginescriptcollection.cpp b/src/webenginewidgets/api/qwebenginescriptcollection.cpp index 2f1f31b0e..21cb0d05e 100644 --- a/src/webenginewidgets/api/qwebenginescriptcollection.cpp +++ b/src/webenginewidgets/api/qwebenginescriptcollection.cpp @@ -41,6 +41,14 @@ using QtWebEngineCore::UserScript; +/*! + \class QWebEngineScriptCollection + \inmodule QtWebEngineWidgets + \since 5.5 + \brief The QWebEngineScriptCollection class represents a collection of user scripts. + +*/ + QWebEngineScriptCollection::QWebEngineScriptCollection(QWebEngineScriptCollectionPrivate *collectionPrivate) :d(collectionPrivate) { @@ -50,31 +58,67 @@ QWebEngineScriptCollection::~QWebEngineScriptCollection() { } +/*! + * \brief QWebEngineScriptCollection::count + * \return the number of elements in the collection. + */ + int QWebEngineScriptCollection::count() const { return d->count(); } +/*! + * \brief QWebEngineScriptCollection::contains + * \param value + * \return \c true if the collection contains an occurrence of \a value; otherwise returns false. + */ + bool QWebEngineScriptCollection::contains(const QWebEngineScript &value) const { return d->contains(value); } +/*! + * \brief QWebEngineScriptCollection::findScript + * \param name + * \return the first script found in collection the name property of which is \a name, or a null QWebEngineScript if none was found. + * \note the order in which the script collection is traversed is undefined, which means this should be used when the unicity is + * guaranteed at the application level. + * \sa findScripts() + */ + QWebEngineScript QWebEngineScriptCollection::findScript(const QString &name) const { return d->find(name); } +/*! + * \brief QWebEngineScriptCollection::findScripts + * \param name + * \return the list of scripts in the collection the name property of which is \a name, or an empty list if none was found. + */ + QList<QWebEngineScript> QWebEngineScriptCollection::findScripts(const QString &name) const { return d->toList(name); } - +/*! + * \brief QWebEngineScriptCollection::insert + * \param s + * + * Inserts script \c s into the collection. + */ void QWebEngineScriptCollection::insert(const QWebEngineScript &s) { d->insert(s); } - +/*! + * \brief QWebEngineScriptCollection::insert + * \param list + * + * Inserts scripts \c list into the collection. + */ void QWebEngineScriptCollection::insert(const QList<QWebEngineScript> &list) { d->reserve(list.size()); @@ -82,16 +126,30 @@ void QWebEngineScriptCollection::insert(const QList<QWebEngineScript> &list) d->insert(s); } +/*! + * \brief QWebEngineScriptCollection::remove + * \param script + * Removes \a script from the collection, if it is present. + * \return \c true if the script was found and successfully removed from the collection, \c false otherwise. + */ bool QWebEngineScriptCollection::remove(const QWebEngineScript &script) { return d->remove(script); } +/*! + * \brief QWebEngineScriptCollection::clear + * Removes all scripts from this collection. + */ void QWebEngineScriptCollection::clear() { d->clear(); } +/*! + * \brief QWebEngineScriptCollection::toList + * \return a QList with the values of the scripts used in this collection. + */ QList<QWebEngineScript> QWebEngineScriptCollection::toList() const { return d->toList(); diff --git a/src/webenginewidgets/api/qwebenginescriptcollection.h b/src/webenginewidgets/api/qwebenginescriptcollection.h index 72cb5e813..fe3ce2861 100644 --- a/src/webenginewidgets/api/qwebenginescriptcollection.h +++ b/src/webenginewidgets/api/qwebenginescriptcollection.h @@ -37,7 +37,7 @@ #ifndef QWEBENGINESCRIPTCOLLECTION_H #define QWEBENGINESCRIPTCOLLECTION_H -#include "qtwebengineglobal.h" +#include "qtwebenginewidgetsglobal.h" #include "qwebenginescript.h" #include <QtCore/QScopedPointer> @@ -67,6 +67,7 @@ public: QList<QWebEngineScript> toList() const; private: + Q_DISABLE_COPY(QWebEngineScriptCollection) friend class QWebEnginePagePrivate; friend class QWebEngineProfilePrivate; QWebEngineScriptCollection(QWebEngineScriptCollectionPrivate *); diff --git a/src/webenginewidgets/api/qwebenginescriptcollection_p.h b/src/webenginewidgets/api/qwebenginescriptcollection_p.h index 9a3a425ba..76267c70c 100644 --- a/src/webenginewidgets/api/qwebenginescriptcollection_p.h +++ b/src/webenginewidgets/api/qwebenginescriptcollection_p.h @@ -37,7 +37,7 @@ #ifndef QWEBENGINESCRIPTCOLLECTION_P_H #define QWEBENGINESCRIPTCOLLECTION_P_H -#include "qtwebengineglobal.h" +#include "qtwebenginewidgetsglobal.h" #include "qwebenginescript.h" diff --git a/src/webenginewidgets/doc/src/qtwebenginewidgets.qdoc b/src/webenginewidgets/doc/src/qtwebenginewidgets.qdoc index 9b7de27e2..ed1f1a773 100644 --- a/src/webenginewidgets/doc/src/qtwebenginewidgets.qdoc +++ b/src/webenginewidgets/doc/src/qtwebenginewidgets.qdoc @@ -99,17 +99,16 @@ \section1 Architecture - The easiest way to render content is through the QWebEngineView class. As a - widget it can be embedded into your forms and it provides convenience functions - for downloading and rendering web sites. + Use the QWebEngineView class to display web pages in the simplest way. + Because it's a widget, you can embed QWebEngineView into your forms and use + its convenience functions to download and display web sites. \snippet snippets/simple/main.cpp Using QWebEngineView - QWebEngineView is used to view Web pages. An instance of QWebEngineView has one - QWebEnginePage. QWebEnginePage provides access to the page's navigation history, - allows to run JavaScript code in the context of the page's main frame and enables - customization of handlers for specific events such as showing custom authentication - dialogs. + An instance of QWebEngineView has one QWebEnginePage. QWebEnginePage + provides access to the page's navigation history, ability to run JavaScript + code in the context of the page's main frame, and enables customization of + handlers for specific events like showing custom authentication dialogs. \section1 Reference Documentation @@ -131,7 +130,7 @@ GNU Library General Public License (LGPLv2). Developers using the Open Source Edition can choose to redistribute - the module under the GNU LGPLv3. + the module under the GNU LGPLv3 or GPLv2 and up. \legalese |