Класс QWebEnginePage

Класс QWebEnginePage предоставляет объект для просмотра и редактирования веб-документов. Подробнее...

• Список всех членов, включая наследуемые

Общедоступные типы

Свойства

• 1 свойство унаследовано от QObject

Общедоступные функции

Реализованные общедоступные функции

• 34 общедоступных функций унаследовано от QObject

Сигналы

• 2 сигнала унаследовано от QObject

Защищенные функции

• 9 защищенных функций унаследовано от QObject

Дополнительные унаследованные члены

• 1 общедоступный слот унаследован от QObject
• 1 общедоступная переменная унаследованная от QObject
• 10 статических общедоступных членов унаследованных от QObject
• 2 защищенные переменные унаследованные от QObject

Подробное описание

Класс QWebEnginePage предоставляет объект для просмотра и редактирования веб-документов.

Веб-страница движка содержит содержимое HTML-документа, историю просмотренных ссылок и действия.

API QWebEnginePage очень похож на QWebEngineView, так как вы по-прежнему получаете доступ к общим функциям, таким как action() (известная как pageAction() в QWebEngineView), triggerAction() и findText().

Страницу можно загрузить с помощью load() или setUrl(). В качестве альтернативы, если у вас есть HTML-содержимое, вы можете использовать setHtml(). Метод GET всегда используется для загрузки URL-адресов.

Класс QWebEnginePage также предлагает методы для извлечения как текущего URL-адреса, загруженного на странице (см. url()), так и URL-адреса, первоначально запрошенного для загрузки (см. requestedUrl()). Эти методы позволяют получить URL-адрес до и после разрешения DNS или перенаправления во время процесса загрузки. requestedUrl() также соответствует URL-адресу, добавленному в историю страницы (QWebEngineHistory), если загрузка выполнена успешно.

Заголовок HTML-страницы можно получить, используя свойство title(). Кроме того, страница может также указать значок, к которому можно получить доступ с помощью свойства icon() или его URL-адреса с помощью свойства iconUrl(). Если заголовок или значок изменяются, будут вызваны соответствующие сигналы titleChanged(), iconChanged() и iconUrlChanged(). Свойство zoomFactor() позволяет изменять масштаб содержимого веб-страницы с помощью коэффициента.

Сигнал loadStarted() генерируется, когда страница начинает загружаться, а сигнал loadProgress() — всякий раз, когда завершается загрузка элемента веб-страницы, такого как вставленное изображение или скрипт. Сигнал loadFinished() генерируется, когда содержимое страницы загружено полностью, независимо от выполнения скриптов или рендеринга страницы. Его аргумент, либо true, либо false, указывает, произошла ли успешная загрузка.

HTML-документ загружается в главную область веб-страницы. Если он ссылается на дочерние области (как определено элементами <frame> или <iframe>), они считаются частью содержимого. Доступ к дочерним областям индивидуально возможен только через JavaScript.

Веб-сайты определяют безопасный источник для безопасного доступа друг к другу к ресурсам для скриптов на стороне клиента или баз данных. Источник состоит из имени хоста, схемы и номера порта. Например, сайты http://www.example.com/my/page.html и http://www.example.com/my/overview.html могут совместно использовать одну базу данных или получать доступ друг к другу к документам при использовании в HTML-фреймсетах и JavaScript. В то же время http://www.malicious.com/evil.html запрещено получать доступ к ресурсам http://www.example.com/, потому что они имеют разные безопасные источники. По умолчанию локальные схемы, такие как file:// и qrc://, считаются в одном безопасном источнике и могут получать доступ к ресурсам друг друга. Локальные ресурсы по умолчанию ограничены в доступе к удалённому содержимому, что означает, что file:// не сможет получить доступ к http://domain.com/foo.html.

Скрипты могут быть выполнены на веб-странице с помощью runJavaScript(), либо в основной JavaScript-среде вместе с остальными JavaScript, поступающими от веб-содержимого, либо в собственной изолированной среде. Хотя к DOM страницы можно получить доступ из любой среды, JavaScript-переменные функции, определённой в одной среде, недоступны из другой. QWebEngineScript::ScriptWorldId предоставляет некоторые предопределённые идентификаторы для этой цели. Использование runJavaScript() версии без идентификатора среды эквивалентно запуску скрипта в MainWorld.

Настройка FocusOnNavigationEnabled может быть использована для автоматического получения фокуса связанным представлением страницы при выполнении операции навигации (например, загрузка или перезагрузка страницы или навигация по истории).

Документация по типам членов

enum QWebEnginePage::Feature

Этот перечисление описывает категории доступа к платформам, доступ к которым пользователь может быть попрошен предоставить или запретить:

См. также featurePermissionRequested(), featurePermissionRequestCanceled(), setFeaturePermission(), и PermissionPolicy.

enum QWebEnginePage::FileSelectionMode

Это перечисление указывает, должна ли реализация функции chooseFiles() возвращать только один файл или может возвращать несколько файлов:

См. также chooseFiles().

enum QWebEnginePage::FindFlagflags QWebEnginePage::FindFlags

Это перечисление описывает доступные опции для функции findText(). Опции могут быть объединены с помощью операции OR из следующего списка:

Тип FindFlags является псевдонимом для QFlags<FindFlag>. Он хранит комбинацию FindFlag-значений с помощью операции OR.

enum QWebEnginePage::JavaScriptConsoleMessageLevel

Это перечисление описывает различные уровни серьёзности сообщений консоли JavaScript:

enum QWebEnginePage::NavigationType

Это перечисление описывает тип запроса навигации:

См. также acceptNavigationRequest().

enum QWebEnginePage::PermissionPolicy

Это перечисление описывает политики разрешений, которые пользователь может установить для доступа к данным или устройствам:

См. также featurePermissionRequested(), featurePermissionRequestCanceled(), setFeaturePermission(), и Feature.

enum QWebEnginePage::RenderProcessTerminationStatus

Это перечисление описывает состояние завершения процесса рендеринга:

Этот перечисление был введён или изменён в Qt 5.6.

enum QWebEnginePage::WebAction

Это перечисление описывает типы действий, которые могут быть выполнены на веб-странице.

Действия имеют эффект только применимые. Доступность действий можно определить, проверив isEnabled() на действии, возвращаемом action().

перечисление QWebEnginePage::WebWindowType

Это перечисление описывает типы окон, которые могут быть созданы функцией createWindow():

Документация по членам-функциям

Выполняет JavaScript-код, содержащийся в scriptSource, в заданном мире worldId. Значения идентификаторов миров совпадают с теми, что предоставляются QWebEngineScript::ScriptWorldId, и находятся в диапазоне от 0 до 256. Использование версий runJavaScript() без идентификатора мира эквивалентно запуску скрипта в MainWorld.

После выполнения скрипта, resultCallback вызывается с результатом последнего выполненного оператора. resultCallback может быть указателем на функцию, функтором или лямбда-выражением и ожидает параметр типа QVariant. Например:

page.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

Предупреждение: Не выполняйте длительные операции в функции обратного вызова, так как это может заблокировать отрисовку страницы веб-движка.

См. scripts() для альтернативного API вставки скриптов.

Данная документация была добавлена в Qt 5.7.

См. также QWebEngineScript::ScriptWorldId.

QWebEnginePage::QWebEnginePage(QObject *parent = Q_NULLPTR)

Создаёт пустую страницу QWebEnginePage с родителем parent.

QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = Q_NULLPTR)

Создаёт пустую страницу веб-движка в профиле profile с родителем parent.

Если профиль не является профилем по умолчанию, вызывающая сторона должна гарантировать, что профиль остаётся активным до тех пор, пока страница не будет уничтожена.

Данная функция была добавлена в Qt 5.5.

[virtual] QWebEnginePage::~QWebEnginePage()

Уничтожает веб-страницу.

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)

Данная функция вызывается при получении запроса на перенаправление на указанную url с указанным типом навигации type. isMainFrame указывает, соответствует ли запрос главному или дочернему фрейму. Если функция возвращает true, запрос на навигацию принимается и url загружается. По умолчанию все запросы на навигацию принимаются.

Данная функция вызывается для абсолютных URL-адресов, которые начинаются с http:// или https://, а также для неизвестных схем, таких как mailto:, которые будут обрабатываться QDesktopServices, если приняты. Чтобы функция вызывалась также при получении запросов на навигацию к локальным URL-адресам, добавьте префикс http:// к URL-адресам.

Запросы на навигацию могут быть делегированы приложению Qt вместо обработки их движком HTML-обработчика путём переопределения этой функции. Это необходимо, когда HTML-документ используется как часть пользовательского интерфейса, а не для отображения внешних данных, например, при отображении списка результатов.

Класс QWebEngineUrlRequestInterceptor предоставляет дополнительные возможности для перехвата и изменения запросов.

Данная функция была добавлена в Qt 5.5.

QAction *QWebEnginePage::action(QWebEnginePage::WebAction action) const

Возвращает QAction для указанного WebAction action.

Действие принадлежит QWebEnginePage, но его вид можно настроить, изменив его свойства.

QWebEnginePage также отвечает за выполнение действия, так что при запуске соответствующего действия выполняется действие на странице.

См. также triggerAction().

[signal] void QWebEnginePage::audioMutedChanged(bool muted)

Этот сигнал излучается при изменении состояния muted страницы.

Примечание: Не следует путать с отключением звука для конкретного HTML5 элемента аудио или видео.

Данная функция была добавлена в Qt 5.7.

Примечание: Сигнал оповещения для свойства audioMuted.

[signal] void QWebEnginePage::authenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator)

Этот сигнал излучается, когда доступ к requestUrl требует аутентификации. authenticator должен использоваться для передачи имени пользователя и пароля для подключения.

[virtual protected] bool QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

Эта функция вызывается, когда возникает ошибка недействительного сертификата во время загрузки запроса.

Параметр certificateError содержит информацию о сертификате и подробности ошибки.

Возврат true игнорирует ошибку и завершает запрос. Возврат false останавливает загрузку запроса.

См. также QWebEngineCertificateError.

[virtual protected] QStringList QWebEnginePage::chooseFiles(QWebEnginePage::FileSelectionMode mode, const QStringList &oldFiles, const QStringList &acceptedMimeTypes)

Эта функция вызывается, когда веб-контент запрашивает имя файла, например, в результате нажатия пользователем кнопки загрузки файла в HTML-форме.

mode указывает, ожидается ли возврат только одного файла или нескольких файлов.

Предлагаемое имя файла может быть предоставлено как первый элемент в oldFiles. acceptedMimeTypes игнорируется по умолчанию, но может использоваться при переопределении.

const QWebEngineContextMenuData &QWebEnginePage::contextMenuData() const

Возвращает дополнительные данные о текущем контекстном меню. Гарантируется, что оно будет валидно только во время вызова обработчика QWebEngineView::contextMenuEvent() связанного QWebEngineView.

Данная функция была добавлена в Qt 5.7.

См. также createStandardContextMenu().

QMenu *QWebEnginePage::createStandardContextMenu()

Создаёт стандартное контекстное меню, которое отображается, когда пользователь нажимает правую кнопку мыши на веб-странице. Вызывается из обработчика по умолчанию contextMenuEvent(). Владение созданным меню передаётся вызывающей стороне.

Возвращает nullptr, если данные контекстного меню не инициализированы, например, когда оно вызывается, когда на самом деле не запрашивается контекстное меню.

[virtual protected] QWebEnginePage *QWebEnginePage::createWindow(QWebEnginePage::WebWindowType type)

Эта функция вызывается для создания нового окна указанного типа type. Например, когда JavaScript-программа запрашивает открыть документ в новом окне.

Если новое окно может быть создано, возвращается QWebEnginePage нового окна; в противном случае возвращается нулевой указатель.

Если представление, связанное с веб-страницей, является объектом QWebEngineView, то реализация по умолчанию перенаправляет запрос на QWebEngineView::createWindow; в противном случае возвращается нулевой указатель.

Примечание: В случаях, когда создание окна инициируется JavaScript, помимо переопределения этого метода приложение также должно установить QWebEngineSettings::JavascriptCanOpenWindows в true, чтобы метод был вызван.

См. также QWebEngineView::createWindow().

QWebEnginePage *QWebEnginePage::devToolsPage() const

Возвращает страницу, на которой размещены инструменты разработчика этой страницы, если они есть.

Возвращает nullptr, если страница инструментов разработчика не задана.

Данная функция была добавлена в Qt 5.11.

См. также setDevToolsPage() и inspectedPage().

void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

Загружает ресурс из местоположения, заданного url, в локальный файл.

Если filename задано, оно используется в качестве предложенного имени файла. Если оно относительное, файл сохраняется в стандартном месте для загрузок с указанным именем. Если это нулевая или пустая QString, используется имя файла по умолчанию.

Этот сигнал испускается после начала загрузки QWebEngineProfile::downloadRequested().

Данная функция была введена в Qt 5.10.

[virtual] bool QWebEnginePage::event(QEvent *e)

Переопределено из QObject::event().

[signal] void QWebEnginePage::featurePermissionRequestCanceled(const QUrl &securityOrigin, QWebEnginePage::Feature feature)

Этот сигнал испускается, когда веб-сайт, идентифицированный по securityOrigin, отменяет ранее выданный запрос на использование feature.

См. также featurePermissionRequested() и setFeaturePermission().

[signal] void QWebEnginePage::featurePermissionRequested(const QUrl &securityOrigin, QWebEnginePage::Feature feature)

Этот сигнал испускается, когда веб-сайт, идентифицированный по securityOrigin, запрашивает использование ресурса или устройства, идентифицированного по feature.

См. также featurePermissionRequestCanceled() и setFeaturePermission().

void QWebEnginePage::findText(const QString &subString, QWebEnginePage::FindFlags options = ..., const QWebEngineCallback<bool> &resultCallback = ...)

Ищет указанную строку subString на странице с заданными options.

Для отмены выделения результата поиска передайте пустую строку.

resultCallback должен принимать булевый параметр. Он будет вызван со значением true если subString найдена; в противном случае значение callback будет false.

Например:

    m_view->page()->findText(QStringLiteral("Qt"), QWebEnginePage::FindFlags(), [this](bool found) {
        if (!found) QMessageBox::information(m_view, QString(), QStringLiteral("No occurrences found"));
    });

[signal] void QWebEnginePage::fullScreenRequested(QWebEngineFullScreenRequest fullScreenRequest)

Этот сигнал испускается, когда веб-страница инициирует запрос на переход в полноэкранный режим для веб-элемента, обычно видеоэлемента.

Объект запроса fullScreenRequest может быть использован для принятия или отклонения запроса.

Если запрос принят, запрашивающий полноэкранный режим элемент заполнит область просмотра, но приложение отвечает за переход в полноэкранный режим или перемещение страницы в полноэкранный режим просмотра.

См. также QWebEngineSettings::FullScreenSupportEnabled.

[signal] void QWebEnginePage::geometryChangeRequested(const QRect &geom)

Этот сигнал испускается всякий раз, когда документ хочет изменить положение и размер страницы на geom. Это может произойти, например, через JavaScript.

Примечание: setGeometry() ожидает размер, исключая декор окна, в то время как geom включает его. Вам необходимо удалить размер полей рамки из geom, чтобы правильно обработать этот сигнал.

window->setGeometry(geom.marginsRemoved(window->frameMargins()));

QWebEngineHistory *QWebEnginePage::history() const

Возвращает указатель на историю просмотренных веб-страниц.

[signal] void QWebEnginePage::iconChanged(const QIcon &icon)

Этот сигнал испускается, когда значок ("favicon") связанный со страницей, изменяется. Новый значок задан в icon.

Данная функция была введена в Qt 5.7.

Примечание: Сигнал-уведомление для свойства icon.

См. также icon(), iconUrl(), и iconUrlChanged().

[signal] void QWebEnginePage::iconUrlChanged(const QUrl &url)

Этот сигнал испускается, когда URL значка ("favicon") связанного со страницей изменяется. Новый URL задан в url.

Примечание: Сигнал-уведомление для свойства iconUrl.

См. также iconUrl(), icon(), и iconChanged().

QWebEnginePage *QWebEnginePage::inspectedPage() const

Возвращает страницу, которую эта страница инспектирует, если таковая имеется.

Возвращает nullptr если эта страница не является страницей инструментов разработчика.

Данная функция была введена в Qt 5.11.

См. также setInspectedPage() и devToolsPage().

[virtual protected] void QWebEnginePage::javaScriptAlert(const QUrl &securityOrigin, const QString &msg)

Вызывается всякий раз, когда JavaScript-программа, выполняемая в фрейме, связанном с securityOrigin, вызывает функцию alert() с сообщением msg.

По умолчанию отображает сообщение msg с помощью QMessageBox::information.

[virtual protected] bool QWebEnginePage::javaScriptConfirm(const QUrl &securityOrigin, const QString &msg)

Вызывается всякий раз, когда JavaScript-программа, выполняемая в фрейме, связанном с securityOrigin, вызывает функцию confirm() с сообщением msg. Возвращает true если пользователь подтверждает сообщение; в противном случае возвращает false.

Также вызывается, когда обработчик onbeforeunload запрашивает подтверждение перед выходом со страницы.

По умолчанию выполняет запрос с использованием QMessageBox::information с кнопками QMessageBox::Ok и QMessageBox::Cancel.

[virtual protected] void QWebEnginePage::javaScriptConsoleMessage(QWebEnginePage::JavaScriptConsoleMessageLevel level, const QString &message, int lineNumber, const QString &sourceID)

Эта функция вызывается, когда JavaScript-программа пытается вывести message в консоль веб-браузера.

Например, в случае ошибок оценки исходный URL может быть предоставлен в sourceID, а также lineNumber.

level указывает серьезность события, которое вызвало сообщение. То есть, вызвало ли его ошибка или менее серьезное событие.

Начиная с Qt 5.6, по умолчанию реализация записывает сообщения в js категорию регистрации.

См. также Консольная регистрация.

[virtual protected] bool QWebEnginePage::javaScriptPrompt(const QUrl &securityOrigin, const QString &msg, const QString &defaultValue, QString *result)

Эта функция вызывается всякий раз, когда JavaScript-программа, выполняемая в фрейме, связанном с securityOrigin, пытается запросить у пользователя ввод. Программа может предоставить необязательное сообщение msg, а также значение по умолчанию для ввода в defaultValue.

Если пользователь отменил запрос, реализация должна вернуть false; в противном случае результат должен быть записан в result и должно быть возвращено значение true. Если пользователь не отменил запрос, реализация должна вернуть true, и строка результата не должна быть null.

По умолчанию используется QInputDialog::getText().

[signal] void QWebEnginePage::linkHovered(const QString &url)

Этот сигнал испускается, когда курсор мыши наводится на ссылку. url содержит целевой URL ссылки.

void QWebEnginePage::load(const QUrl &url)

Загружает url на эту страницу.

Примечание: Вид остается прежним, пока не будет получено достаточно данных для отображения нового URL.

См. также setUrl(), setHtml() и setContent().

void QWebEnginePage::load(const QWebEngineHttpRequest &request)

Выполняет указанный request и загружает ответ.

Эта функция была добавлена в Qt 5.9.

См. также load(), setUrl(), url(), urlChanged() и QUrl::fromUserInput().

[signal] void QWebEnginePage::loadFinished(bool ok)

Этот сигнал излучается, когда страница завершает загрузку содержимого. Этот сигнал независим от выполнения скриптов или рендеринга страницы. ok указывает, была ли загрузка успешной или произошла ошибка.

См. также loadStarted().

[signal] void QWebEnginePage::loadProgress(int progress)

Этот сигнал излучается при изменении глобального статуса прогресса. Текущее значение предоставляет progress и масштабируется от 0 до 100, что является стандартным диапазоном для QProgressBar. Он аккумулирует изменения из всех дочерних фреймов.

[signal] void QWebEnginePage::loadStarted()

Этот сигнал излучается, когда страница начинает загрузку содержимого.

См. также loadFinished().

[signal] void QWebEnginePage::pdfPrintingFinished(const QString &filePath, bool success)

Этот сигнал излучается, когда завершается печать веб-страницы в файл PDF. filePath содержит путь, по которому был запрошен файл, а success будет true если файл был успешно создан и false в противном случае.

Эта функция была добавлена в Qt 5.9.

См. также printToPdf().

void QWebEnginePage::print(QPrinter *printer, const QWebEngineCallback<bool> &resultCallback)

Рендерит текущее содержимое страницы в временный PDF-документ, а затем печатает его с помощью printer.

Настройки для создания и печати PDF-документа будут взяты из объекта printer. Пользователь несет ответственность за обеспечение того, чтобы printer оставался валидным до вызова resultCallback.

Примечание: Рендеринг текущего содержимого в временный PDF-документ является асинхронным и не блокирует основной поток. Однако последующий рендеринг PDF в printer выполняется в основном потоке и, следовательно, блокирует цикл обработки событий. Кроме того, печать выполняется в процессе браузера, который по умолчанию не защищен от вмешательства.

resultCallback должен принимать булево значение в качестве параметра. Если печать прошла успешно, это булево значение будет true, в противном случае false.

Эта функция была добавлена в Qt 5.8.

void QWebEnginePage::printToPdf(const QString &filePath, const QPageLayout &pageLayout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()))

Рендерит текущего содержимого страницы в PDF-документ и сохраняет его в указанном в filePath месте. Размер страницы и ориентация создаваемого PDF-документа берутся из значений, указанных в pageLayout.

Этот метод вызывает асинхронный запрос на печать веб-страницы в PDF и возвращается немедленно. Чтобы получить информацию о результате запроса, подключитесь к сигналу pdfPrintingFinished().

Если файл с указанным путем уже существует, он будет перезаписан.

Эта функция была добавлена в Qt 5.7.

См. также pdfPrintingFinished().

void QWebEnginePage::printToPdf(const QWebEngineCallback<const QByteArray &> &resultCallback, const QPageLayout &pageLayout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()))

Рендерит текущего содержимого страницы в PDF-документ и возвращает массив байтов, содержащий данные PDF, в качестве параметра для resultCallback. Размер страницы и ориентация создаваемого PDF-документа берутся из значений, указанных в pageLayout.

resultCallback должен принимать константную ссылку на QByteArray в качестве параметра. Если печать прошла успешно, этот массив байтов будет содержать данные PDF, в противном случае он будет пустым.

Эта функция была добавлена в Qt 5.7.

QWebEngineProfile *QWebEnginePage::profile() const

Возвращает профиль движка веб-браузера, к которому принадлежит страница.

Эта функция была добавлена в Qt 5.5.

[signal] void QWebEnginePage::proxyAuthenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator, const QString &proxyHost)

Этот сигнал излучается, когда доступ к requestUrl через proxyHost требует аутентификации для прокси. authenticator должен быть использован для передачи имени пользователя и пароля для подключения.

[signal] void QWebEnginePage::quotaRequested(QWebEngineQuotaRequest quotaRequest)

Этот сигнал излучается, когда веб-страница запрашивает больше постоянного хранилища, чем текущее выделение приложения в API файловой системы. Значение квоты по умолчанию равно 0 байтам.

Объект запроса quotaRequest может быть использован для принятия или отклонения запроса.

Эта функция была добавлена в Qt 5.11.

[signal] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

Этот сигнал излучается, когда состояние страницы в отношении звукового сопровождения (recentlyAudible) изменяется, из-за воспроизведения или остановки звука.

Примечание: Сигнал также излучается при вызове метода setAudioMuted(). Кроме того, если звук приостановлен, этот сигнал излучается примерно с двухсекундной задержкой от момента приостановки звука.

Эта функция была добавлена в Qt 5.7.

Примечание: Сигнал уведомления для свойства recentlyAudible.

[signal] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

Этот сигнал излучается, когда веб-страница пытается зарегистрировать пользовательский протокол, используя API registerProtocolHandler.

Объект запроса request может быть использован для принятия или отклонения запроса:

void WebPage::handleRegisterProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(
        view()->window(),
        tr("Permission Request"),
        tr("Allow %1 to open all %2 links?")
        .arg(request.origin().host())
        .arg(request.scheme()));
    if (answer == QMessageBox::Yes)
        request.accept();
    else
        request.reject();
}

Эта функция была добавлена в Qt 5.11.

[signal] void QWebEnginePage::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

Этот сигнал излучается, когда процесс рендеринга завершается с ненулевым кодом выхода. terminationStatus - статус завершения процесса, а exitCode - код состояния, с которым завершился процесс.

Эта функция была добавлена в Qt 5.6.

void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

Заменяет текущее неправильно написанное слово на replacement.

Текущее неправильно написанное слово можно найти в QWebEngineContextMenuData::misspelledWord(), а предложенные замены в QWebEngineContextMenuData::spellCheckerSuggestions().

Эта функция была добавлена в Qt 5.8.

См. также contextMenuData().

void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadItem::SavePageFormat format = QWebEngineDownloadItem::MimeHtmlSaveFormat) const

Сохраняет текущую загруженную веб-страницу на диск.

Веб-страница сохраняется в filePath в указанном format.

Это сокращение следующих действий:

• Вызвать действие сохранения веб-страницы.
• Принять следующий элемент загружаемого файла и установить указанный путь к файлу и формат сохранения.

Функция вызывает асинхронный запрос загрузки веб-страницы и возвращается немедленно.

Эта функция была добавлена в Qt 5.8.

См. также QWebEngineDownloadItem::SavePageFormat.

QWebEngineScriptCollection &QWebEnginePage::scripts()

Возвращает коллекцию скриптов, которые внедрены на странице.

Кроме того, страница может также выполнять скрипты, добавленные через QWebEngineProfile::scripts().

См. также QWebEngineScriptCollection и QWebEngineScript.

[signal] void QWebEnginePage::selectionChanged()

Этот сигнал испускается всякий раз, когда изменяется выделение, как интерактивно, так и программно. Например, вызвав triggerAction() с действием выбора.

Примечание: При использовании мыши для выделения текста щелчком левой кнопкой и перетаскиванием, сигнал будет испускаться для каждого нового выбранного символа, а не при отпускании левой кнопки мыши.

См. также selectedText().

void QWebEnginePage::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

Устанавливает содержимое веб-страницы на data. Если аргумент mimeType пустой, предполагается, что содержимое text/plain,charset=US-ASCII.

Внешние объекты, упомянутые в содержимом, располагаются относительно baseUrl.

Данные data загружаются немедленно; внешние объекты загружаются асинхронно.

Примечание: Этот метод не повлияет на сеансовую или глобальную историю для страницы.

Предупреждение: Содержимое будет закодировано по процентам перед отправкой в рендерер через IPC. Это может увеличить его размер. Максимальный размер закодированного по процентам содержимого составляет 2 мегабайта минус 6 байтов плюс длина строки типа MIME.

См. также toHtml() и setHtml().

void QWebEnginePage::setDevToolsPage(QWebEnginePage *devToolsPage)

Привязывает devToolsPage в качестве разработчика инструментов для этой страницы. Вызывает devToolsPage для перехода на внутренний URL с инструментами разработчика.

Это эквивалентно вызову setInspectedPage() на devToolsPage с this в качестве аргумента.

Эта функция была добавлена в Qt 5.11.

См. также devToolsPage() и setInspectedPage().

void QWebEnginePage::setFeaturePermission(const QUrl &securityOrigin, QWebEnginePage::Feature feature, QWebEnginePage::PermissionPolicy policy)

Устанавливает разрешение для веб-сайта, идентифицированного securityOrigin, использовать feature с policy.

Примечание: Вызывайте этот метод в сигнале featurePermissionRequested(), так как он предназначен только для обработки ожидающих запросов на разрешение функций. Установка разрешений на функции до запроса не оказывает никакого эффекта.

См. также featurePermissionRequested() и featurePermissionRequestCanceled().

void QWebEnginePage::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

Устанавливает содержимое этой страницы на html. baseUrl необязательно и используется для разрешения относительных URL-адресов в документе, таких как ссылки на изображения или стили.

html загружается немедленно; внешние объекты загружаются асинхронно.

Если скрипт в html выполняется дольше, чем стандартный таймаут выполнения скрипта (в настоящее время 10 секунд), например, из-за блокировки модальным диалоговым окном JavaScript alert, этот метод вернётся как можно быстрее после таймаута, и любое последующее html будет загружено асинхронно.

При использовании этого метода веб-движок предполагает, что внешние ресурсы, такие как JavaScript-программы или стили, закодированы в UTF-8, если не указано иное. Например, кодировка внешнего скрипта может быть указана через атрибут charset тега HTML script. Кодировка также может быть указана веб-сервером.

Это удобная функция, эквивалентная setContent(html, "text/html", baseUrl).

Примечание: Этот метод не повлияет на сеансовую или глобальную историю для страницы.

Предупреждение: Эта функция работает только для HTML, для других типов MIME (таких как XHTML и SVG) следует использовать setContent().

Предупреждение: Содержимое будет закодировано по процентам перед отправкой в рендерер через IPC. Это может увеличить его размер. Максимальный размер закодированного по процентам содержимого составляет 2 мегабайта минус 30 байтов.

См. также toHtml(), setContent() и load().

void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

Перенаправляет эту страницу на внутренний URL, который представляет собой инструменты разработчика страницы page.

Это эквивалентно вызову setDevToolsPage() на page с this в качестве аргумента.

Эта функция была добавлена в Qt 5.11.

См. также inspectedPage() и setDevToolsPage().

void QWebEnginePage::setView(QWidget *view)

Устанавливает view, связанный с веб-страницей.

См. также view().

void QWebEnginePage::setWebChannel(QWebChannel *channel, uint worldId)

Устанавливает экземпляр веб-канала, используемого этой страницей, на channel и подключает его к транспортному средству веб-движка с помощью сообщений Chromium IPC. Транспорт доступен в мире JavaScript worldId как qt.webChannelTransport, который следует использовать при использовании Qt WebChannel JavaScript API.

Примечание: Страница не принимает владения объектом канала.

Примечание: Только один веб-канал может быть установлен на страницу, установка его даже в другом мире JavaScript отменяет любые уже установленные веб-каналы.

Эта функция была добавлена в Qt 5.7.

См. также webChannel() и QWebEngineScript::ScriptWorldId.

void QWebEnginePage::setWebChannel(QWebChannel *channel)

Это перегруженная функция.

Устанавливает экземпляр веб-канала, используемого этой страницей, на channel и устанавливает его в главном мире JavaScript.

С помощью этого метода к веб-содержимому страницы можно получить доступ. Если содержимое не под вашим контролем и может быть вредоносным, это может быть проблемой безопасности, и вы должны рассмотреть возможность его установки в частном мире JavaScript.

Эта функция была добавлена в Qt 5.5.

См. также QWebEngineScript::MainWorld.

QWebEngineSettings *QWebEnginePage::settings() const

Возвращает указатель на объект настроек страницы.

См. также QWebEngineSettings::globalSettings().

[signal] void QWebEnginePage::titleChanged(const QString &title)

Этот сигнал испускается всякий раз, когда заголовок страницы изменяется. Строка title определяет новый заголовок.

См. также title().

void QWebEnginePage::toHtml(const QWebEngineCallback<const QString &> &resultCallback) const

Асинхронный метод получения содержимого страницы в формате HTML, заключенного в теги HTML и BODY. При успешном выполнении resultCallback вызывается с содержимым страницы.

Примечание: resultCallback может быть любым из указателя на функцию, функтора или лямбды, и ожидается, что она примет параметр QString.

См. также setHtml() и toPlainText().

void QWebEnginePage::toPlainText(const QWebEngineCallback<const QString &> &resultCallback) const

Асинхронный метод получения содержимого страницы, преобразованного в обычный текст, полностью лишённый форматирования HTML. При успешном выполнении resultCallback вызывается с содержимым страницы.

Примечание: resultCallback может быть любым из указателя на функцию, функтора или лямбды, и ожидается, что она примет параметр QString.

См. также toHtml().

[virtual] void QWebEnginePage::triggerAction(QWebEnginePage::WebAction action, bool checked = ...)

Этот метод можно вызвать, чтобы активировать указанное action. Также вызывается Qt WebEngine, если пользователь активирует действие, например, через пункт контекстного меню.

Если action является действием с возможностью выбора, то checked указывает, включено ли действие или нет.

См. также action().

[signal] void QWebEnginePage::urlChanged(const QUrl &url)

Этот сигнал испускается с URL-адресом страницы, когда получен заголовок страницы. Новый URL указан в url.

См. также url().

QWidget *QWebEnginePage::view() const

Возвращает виджет представления, связанный с веб-страницей.

См. также setView().

QWebChannel *QWebEnginePage::webChannel() const

Возвращает указатель на экземпляр канала веб-связи, используемый этой страницей, или нулевой указатель, если он не был установлен. Этот канал автоматически использует внутренний механизм транспорта веб-движка через Chromium IPC, который доступен в контексте JavaScript этой страницы как qt.webChannelTransport.

Эта функция была добавлена в Qt 5.5.

См. также setWebChannel().

[signal] void QWebEnginePage::windowCloseRequested()

Этот сигнал излучается всякий раз, когда страница запрашивает закрытие окна веб-браузера, например, через вызов JavaScript window.close().

См. также RequestClose.