Класс QWebEnginePage

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

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

Публичные типы

Свойства

Публичные функции

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

Сигналы

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

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

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

API QWebEnginePage очень похож на API 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 может быть использована для автоматического получения фокуса связанным с страницей представлением при выполнении операции навигации (например, при загрузке или перезагрузке страницы или навигации по истории).

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

Перечисление QWebEnginePage::Feature

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

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

Перечисление QWebEnginePage::FileSelectionMode

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

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

Перечисление QWebEnginePage::FindFlagФлаги QWebEnginePage::FindFlags

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

Тип FindFlags — это псевдоним для QFlags<FindFlag>. Он хранит комбинированное значение FindFlag по оператору OR.

Перечисление QWebEnginePage::JavaScriptConsoleMessageLevel

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

[since 5.14] Перечисление QWebEnginePage::LifecycleState

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

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

См. также lifecycleState, API жизненного цикла страницы и Пример жизненного цикла WebEngine.

Перечисление QWebEnginePage::NavigationType

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

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

enum QWebEnginePage::PermissionPolicy

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

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

[since 5.6] enum QWebEnginePage::RenderProcessTerminationStatus

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

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

enum QWebEnginePage::WebAction

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

Действия имеют эффект только при их применимости.

Доступность действий можно определить, проверив isEnabled() на действии, возвращённом action().

enum QWebEnginePage::WebWindowType

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

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

Выполняет JavaScript-код, содержащийся в scriptSource, без проверки, построена ли DOM-модель страницы. Если вам нужен больший контроль над выполнением скрипта, воспользуйтесь scripts().

Чтобы избежать конфликтов с другими скриптами, выполняемыми на странице, мир, в котором выполняется скрипт, определяется параметром worldId. Значения ID мира совпадают со значениями из QWebEngineScript::ScriptWorldId, и лежат в диапазоне от 0 до 256. Если вы опустите параметр world ID, скрипт выполнится в мире MainWorld.

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

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

В качестве результата из JavaScript могут возвращаться только примитивные данные. Поддерживаемые типы данных включают все типы данных JSON, а также, например, Date и ArrayBuffer. Неподдерживаемые типы данных включают, например, Function и Promise.

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

См. также scripts(), QWebEngineScript::ScriptWorldId и Вставка скриптов.

[since 5.5] QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = nullptr)

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

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

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

QWebEnginePage::QWebEnginePage(QObject *parent = nullptr)

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

[signal, since 5.7] void QWebEnginePage::audioMutedChanged(bool muted)

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

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

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

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

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

[signal] void QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

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

Параметр certificateError содержит информацию о сертификате и подробности ошибки, а также предоставляет способ проигнорировать ошибку и завершить запрос или остановить загрузку запроса.

См. также QWebEngineCertificateError.

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

[signal, since 5.14] void QWebEnginePage::findTextFinished(const QWebEngineFindTextResult &result)

Этот сигнал испускается, когда поиск строки на странице завершён. result содержит результат поиска строки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[signal] void QWebEnginePage::loadStarted()

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

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

[signal, since 6.2] void QWebEnginePage::loadingChanged(const QWebEngineLoadingInfo &loadingInfo)

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

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

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

[signal, since 6.2] void QWebEnginePage::navigationRequested(QWebEngineNavigationRequest &request)

Этот сигнал испускается при навигации вместе с вызовом acceptNavigationRequest(). Он может использоваться для принятия или игнорирования запроса request. По умолчанию запрос принимается.

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

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

[signal, since 6.2] void QWebEnginePage::newWindowRequested(QWebEngineNewWindowRequest &request)

Этот сигнал испускается, когда запрос request выдан для загрузки страницы в отдельном окне веб-движка. Это может произойти, либо потому, что текущая страница явно запросила это через вызов JavaScript к window.open, либо потому, что пользователь щелкнул по ссылке, удерживая Shift, Ctrl или встроенную комбинацию, которая запускает открытие страницы в новом окне.

Сигнал обрабатывается вызовом openIn() с новой страницей по запросу. Если этот сигнал не обработан, запрошенная загрузка завершится ошибкой.

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

См. также createWindow() и QWebEngineNewWindowRequest::openIn().

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

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

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

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

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

[signal, since 5.11] void QWebEnginePage::quotaRequested(QWebEngineQuotaRequest quotaRequest)

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

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

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

[signal, since 5.7] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

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

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

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

[signal, since 5.11] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

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

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

void WebView::handleRegisterProtocolHandlerRequested(
        QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(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, since 5.15] void QWebEnginePage::renderProcessPidChanged(qint64 pid)

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

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

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

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

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

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

[signal, since 5.12] void QWebEnginePage::selectClientCertificate(QWebEngineClientCertificateSelection clientCertificateSelection)

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

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

Если сигнал не обрабатывается, clientCertificateSelection автоматически уничтожается, и загрузка продолжается без сертификата клиента.

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

См. также QWebEngineClientCertificateSelection.

[signal] void QWebEnginePage::selectionChanged()

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

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

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

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

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

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

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

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

[signal] void QWebEnginePage::windowCloseRequested()

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

См. также RequestClose.

[virtual] QWebEnginePage::~QWebEnginePage()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если этот вызов не реализован или не возвращает новую страницу, излучается newWindowRequested() для обработки запроса.

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

[since 5.11] QWebEnginePage *QWebEnginePage::devToolsPage() const

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

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

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

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

[since 5.10] void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

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

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

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

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

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

Переопределяет: QObject::event(QEvent *e).

void QWebEnginePage::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = ...)

Ищет указанную строку subString на странице, используя заданные options. Сигнал findTextFinished() генерируется при завершении поиска строк.

Чтобы очистить выделение поиска, просто передайте пустую строку.

resultCallback должен принимать параметр QWebEngineFindTextResult.

Например:

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

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

QWebEngineHistory *QWebEnginePage::history() const

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

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

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

void QWebEnginePage::load(const QUrl &url)

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

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

[since 5.9] void QWebEnginePage::load(const QWebEngineHttpRequest &request)

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

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

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

void QWebEnginePage::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Отображает текущее содержимое страницы в документ PDF и сохраняет его в указанном в filePath месте. Размер страницы и ориентация создаваемого документа PDF берутся из значений, указанных в layout, а диапазон печатаемых страниц берётся из ranges, по умолчанию печатаются все страницы.

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

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

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

void QWebEnginePage::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

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

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

[since 5.5] QWebEngineProfile *QWebEnginePage::profile() const

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

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

[since 5.8] void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

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

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

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

[since 5.8] void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format = QWebEngineDownloadRequest::MimeHtmlSaveFormat) const

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

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

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

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

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

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

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

QWebEngineScriptCollection &QWebEnginePage::scripts()

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

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

См. также QWebEngineScriptCollection, QWebEngineScript и Инжектирование скриптов.

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

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

Внешние объекты, на которые ссылается содержимое, находятся относительно baseUrl.

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

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

[since 5.11] 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() и 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).

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

[since 5.11] void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

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

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

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

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

[since 5.13] void QWebEnginePage::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Регистрирует перехватчик запросов interceptor для перехвата запросов URL.

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

Для отмены регистрации перехватчика запросов установите nullptr.

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

См. также QWebEngineUrlRequestInfo и QWebEngineProfile::setUrlRequestInterceptor().

[since 5.7] void QWebEnginePage::setWebChannel(QWebChannel *channel, quint32 worldId = 0)

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

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

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

QWebEngineSettings *QWebEnginePage::settings() const

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

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

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

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

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

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

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

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

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

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

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

[since 5.5] QWebChannel *QWebEnginePage::webChannel() const

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

Этот метод был добавлен в Qt 5.5.

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