Класс QWebEnginePage

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

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

Открытые типы

Свойства

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

Открытые функции

Реализованные публичные функции

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

Сигналы

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

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

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

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

• 1 публичный слот унаследован от QObject
• 11 статических публичных членов унаследовано от 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().

enum QWebEnginePage::WebWindowType

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

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

QWebEnginePage::QWebEnginePage(QObject *parent = Q_NULLPTR)

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

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

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

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

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

QWebEnginePage::~QWebEnginePage()

Удаляет страницу веб-браузера.

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, 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(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(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(WebWindowType type)

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

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

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

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

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

[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, FindFlags options = FindFlags())

Ищет указанную строку subString на странице, используя заданные options.

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

void QWebEnginePage::findText(const QString &subString, FindFlags options, FunctorOrLambda resultCallback)

Ищет указанную строку subString на странице, используя заданные options.

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

resultCallback должен принимать булевый параметр. Он будет вызван со значением true, если subString найдена; в противном случае значение вызова будет 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 request)

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

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

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

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

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

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

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().

[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(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, и строка результата не должна быть пустой.

По умолчанию используется 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, FunctorOrLambda resultCallback)

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

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

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(FunctorOrLambda 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::recentlyAudibleChanged(bool recentlyAudible)

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

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

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

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

[signal] void QWebEnginePage::renderProcessTerminated(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::runJavaScript(const QString &scriptSource, quint32 worldId, FunctorOrLambda resultCallback)

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

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

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

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

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

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

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

void QWebEnginePage::runJavaScript(const QString &scriptSource, quint32 worldId)

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

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

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

void QWebEnginePage::runJavaScript(const QString &scriptSource, FunctorOrLambda resultCallback)

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

Выполняет JavaScript-код, содержащийся в scriptSource.

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

Когда скрипт был выполнен, resultCallback вызывается с результатом последнего выполненного оператора.

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

void QWebEnginePage::runJavaScript(const QString &scriptSource)

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

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

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

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::setFeaturePermission(const QUrl &securityOrigin, Feature feature, 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-скрипта. Также кодировка может быть указана веб-сервером.

Это вспомогательная функция, эквивалентная setContent(html, "text/html", baseUrl).

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

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

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

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

void QWebEnginePage::setView(QWidget *view)

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

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

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

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

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

Примечание: Только один веб-канал может быть установлен на страницу; установка его даже в другом мире 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(FunctorOrLambda resultCallback) const

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

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

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

void QWebEnginePage::toPlainText(FunctorOrLambda resultCallback) const

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

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

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

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

Эту функцию можно вызвать для запуска указанного действия 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.