Тип QML WebEngineView

WebEngineView отображает веб-контент в приложении QML. Подробнее...

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

Свойства

• ErrorDomain : перечисление
• Feature : перечисление
• FindFlags : перечисление
• JavaScriptConsoleMessageLevel : перечисление
• LifecycleState : перечисление
• LoadStatus : перечисление
• NewViewDestination : перечисление
• PrintedPageOrientation : перечисление
• PrintedPageSizeId : перечисление
• RenderProcessTerminationStatus : перечисление
• WebAction : перечисление
• activeFocusOnPress : bool
• audioMuted : bool
• backgroundColor : bool
• canGoBack : bool
• canGoForward : bool
• contentsSize : размер
• devToolsView : WebEngineView
• icon : url
• inspectedView : WebEngineView
• isFullScreen : bool
• lifecycleState : LifecycleState
• loadProgress : int
• loading : bool
• navigationHistory : WebEngineHistory
• profile : WebEngineProfile
• recentlyAudible : bool
• recommendedState : LifecycleState
• renderProcessPid : qint64
• scrollPosition : точка
• settings : WebEngineSettings
• title : строка
• url : url
• userScripts : список<WebEngineScript>
• webChannel : QQmlWebChannel
• webChannelWorld : int
• zoomFactor : вещественное

Сигналы

• activeFocusOnPressChanged(bool activeFocusOnPress)
• audioMutedChanged(bool muted)
• authenticationDialogRequested(AuthenticationDialogRequest request)
• backgroundColorChanged()
• certificateError(WebEngineCertificateError error)
• colorDialogRequested(ColorDialogRequest request)
• contextMenuRequested(ContextMenuRequest request)
• featurePermissionRequested(url securityOrigin, Feature feature)
• fileDialogRequested(FileDialogRequest request)
• findTextFinished(FindTextResult result)
• fullScreenRequested(FullScreenRequest request)
• geometryChangeRequested(rect geometry, rect frameGeometry)
• javaScriptConsoleMessage(JavaScriptConsoleMessageLevel level, string message, int lineNumber, string sourceID)
• javaScriptDialogRequested(JavaScriptDialogRequest request)
• linkHovered(url hoveredUrl)
• loadingChanged(WebEngineLoadRequest loadRequest)
• navigationRequested(WebEngineNavigationRequest request)
• newViewRequested(WebEngineNewViewRequest request)
• pdfPrintingFinished(string filePath, bool success)
• printRequest()
• quotaRequested(QuotaRequest request)
• recentlyAudibleChanged(bool recentlyAudible)
• registerProtocolHandlerRequested(RegisterProtocolHandlerRequest request)
• renderProcessPidChanged(qint64 pid)
• renderProcessTerminated(RenderProcessTerminationStatus terminationStatus, int exitCode)
• selectClientCertificate(WebEngineClientCertificateSelection clientCertificateSelection)
• tooltipRequested(TooltipRequest request)
• wasRecentlyAudibleChanged(bool wasRecentlyAudible)
• windowCloseRequested()

Методы

• WebEngineAction действие(WebAction действие)
• void найтиТекст(string подстрока, FindFlags параметры, variant обратныйВызовРезультата)
• void найтиТекст(string подстрока, FindFlags параметры)
• void найтиТекст(string подстрока)
• void отменитьПолныйЭкран()
• void назад()
• void назадИлиВперед(int смещение)
• void вперед()
• void предоставитьРазрешениеНаФункцию(url securityOrigin, Feature функция, bool разрешено)
• void загрузитьHtml(string html, url базовыйUrl)
• void распечататьВPdf(variant обратныйВызовРезультата, PrintedPageSizeId размерСтраницы, PrintedPageOrientation ориентация)
• void распечататьВPdf(const string путьКФайлу, PrintedPageSizeId размерСтраницы, PrintedPageOrientation ориентация)
• void перезагрузить()
• void перезагрузитьИПропуститьКэш()
• void заменитьНеправильноНаписанноеСлово(const QString &замена)
• void выполнитьJavaScript(string скрипт, variant обратныйВызов)
• void установитьАктивныйФокусПриНажатии(bool арг)
• void остановить()
• void спровоцироватьДействиеВеб-приложения(WebAction действие)

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

Тип WebEngineView позволяет приложениям QML отображать области динамического веб-контента. Он может совместно использовать экран с другими типами QML, такими как TabView, или заполнять весь экран, как указано в приложении QML.

Инициализация Web Engine

Для отображения веб-движка необходимо инициализировать его с помощью QtWebEngine::initialize в основном файле приложения, как показано в следующем фрагменте кода:

int main(int argc, char *argv[])
{
    QCoreApplication::setOrganizationName("QtExamples");
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QCoreApplication::setAttribute(Qt::AA_ShareOpenGLContexts);
    QtWebEngine::initialize();
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));

    return app.exec();
}

Загрузка веб-страниц

Приложение может загружать страницы в WebEngineView, используя свойство url или метод loadHtml и перемещаться по истории просмотра в представлении. Для загрузки URL всегда используется метод GET.

История представлена моделью данных WebEngineHistory, которая хранится в свойстве navigationHistory.

В следующем примере приложения QML загружается веб-страница, используя свойство url:

import QtQuick 2.0
import QtQuick.Window 2.0
import QtWebEngine 1.0

Window {
    width: 1024
    height: 750
    visible: true
    WebEngineView {
        anchors.fill: parent
        url: "https://www.qt.io"
    }
}

Свойство loading указывает, загружается ли в настоящее время страница HTML. Сигнал loadingChanged() генерируется, когда загрузка страницы начинается, заканчивается или завершается неудачно.

Заголовок страницы HTML можно получить с помощью свойства title. Кроме того, веб-страница может указать значок, который можно получить с помощью свойства icon. Свойство zoomFactor позволяет изменять масштаб содержимого веб-страницы.

Если при загрузке веб-страницы возникает ошибка сертификата, генерируется сигнал certificateError(). Ошибки сертификатов обрабатываются с помощью методов типа WebEngineCertificateError.

Взаимодействие

По умолчанию ссылки на другие страницы загружаются в том же объекте WebEngineView, но веб-сайты могут запросить их открытие в новой вкладке, окне или диалоговом окне. Сигнал newViewRequested() генерируется, когда поступает запрос на загрузку страницы в отдельное представление веб-движка. Свойство NewViewDestination описывает, как следует открыть новое представление. Кроме того, утилита типа WebEngineNewViewRequest может использоваться для загрузки веб-страниц в отдельные представления веб-движка.

Метод findText() можно использовать для поиска строки на веб-странице с использованием параметров, описанных в FindFlags.

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

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

Сигнал linkHovered() генерируется, когда указатель мыши проходит над ссылкой и, таким образом, соответствует событию DOM mouseover.

Действия, такие как выделение и редактирование содержимого, могут выполняться на веб-странице с помощью метода triggerWebAction(). Доступные действия описаны в свойстве WebAction.

Сигнал backgroundColorChanged() генерируется при изменении цвета фона веб-страницы.

Пользовательские скрипты

Во время загрузки страницы так называемые пользовательские скрипты могут быть внедрены в движок JavaScript в различных точках. Объекты скриптов, прикрепленные к представлению веб-движка, хранятся в свойстве userScripts и вводятся с помощью типа WebEngineScript. Скрипты также могут быть выполнены с помощью метода runJavaScript() в той же среде, что и другие скрипты, являющиеся частью загруженного сайта.

Свойство webChannel можно использовать для экспонирования экземпляра WebChannel в контексте JavaScript страницы, которую он отображает, как qt.webChannelTransport.

Режим полного экрана

Веб-страница может запросить через API JavaScript загрузку в полноэкранном режиме. Сигнал fullScreenRequested() генерируется, когда веб-страница выдает запрос. Утилита типа FullScreenRequest может использоваться для переключения запросов на полноэкранный режим. Метод fullScreenCancelled может использоваться для уведомления движка браузера, когда система оконного интерфейса вынуждает приложение покинуть полноэкранный режим.

Профили

Представления веб-движка могут быть изолированы друг от друга с помощью типа WebEngineProfile. Профиль содержит настройки, скрипты и список посещенных ссылок, общих для всех представлений, которые принадлежат профилю. Например, для режима инкогнито можно создать отдельный профиль. Текущий профиль для представления хранится в свойстве profile, а текущие настройки хранятся в свойстве settings. Настройки задаются с помощью типа WebEngineSettings.

Функции платформы

Веб-страницы могут запросить доступ к функциям платформы, таким как геолокация или устройства захвата аудио и видео. Сигнал featurePermissionRequested() генерируется, когда веб-страница запрашивает использование ресурса. Поддерживаемые функции платформы описаны в свойстве Feature. Если пользователи предоставят разрешение, метод grantFeaturePermission() используется для установки значения разрешено.

Отображение на поверхность OpenGL

При использовании QQuickRenderControl для отображения пользовательского интерфейса Qt Quick на поверхности OpenGL, тип WebEngineView отображается неправильно. Представление веб-движка пытается использовать глобальный контекст OpenGL, созданный функцией QtWebEngine::initialize, но нет публичного API для доступа к этому контексту, чтобы можно было его использовать вместе с контекстом QQuickRenderControl.

Чтобы правильно отобразить представление веб-движка, можно вручную создать новый контекст вне экрана, который будет совместно использоваться с контекстом QQuickRenderControl и вызвать непубличную функцию qt_gl_set_global_share_context(), а не initialize(). Если initialize() будет вызвана после установки глобального контекста, она ничего не сделает.

Документация свойств

ErrorDomain : перечисление

Описывает различные типы ошибок высокого уровня:

Feature : перечисление

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

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

FindFlags : перечисление

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

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

JavaScriptConsoleMessageLevel : перечисление

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

LifecycleState : перечисление

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

Это свойство было введено в QtWebEngine 1.10.

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

LoadStatus : перечисление

Отражает состояние загрузки страницы:

NewViewDestination : перечисление

Описывает способ открытия нового представления:

См. также WebEngineNewViewRequest.destination.

PrintedPageOrientation : перечисление

Описывает ориентацию PDF-документа, созданного из содержимого WebEngineView. Значения перечисления отображаются и должны совпадать с QPageLayout::Orientation.

Это свойство было введено в QtWebEngine 1.3.

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

PrintedPageSizeId : перечисление

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

Значения перечисления отображаются и должны совпадать с QPageSize::PageSizeId. Они также дублируются в QPagedPaintDevice и QPrinter.

Определенные размеры:

Это свойство было введено в QtWebEngine 1.3.

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

RenderProcessTerminationStatus : перечисление

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

Это свойство было введено в QtWebEngine 1.2.

WebAction : перечисление

Описывает типы действий, которые можно выполнить на веб-странице:

Это свойство было введено в QtWebEngine 1.2.

activeFocusOnPress : bool

Указывает, нужно ли элементу получить активный фокус при нажатии. Значение по умолчанию - true.

Это свойство было введено в QtWebEngine 1.2.

audioMuted : bool

Состояние, в котором находится звук текущей страницы.

Это свойство было введено в QtWebEngine 1.3.

См. также recentlyAudible.

backgroundColor : bool

Изменяет цвет фона WebEngineView за телом документа. Может быть установлено в "transparent" или в полупрозрачный цвет, чтобы видеть сквозь документ или соответствовать веб-содержимому в гибридном приложении, чтобы предотвратить появление белых вспышек при загрузке.

Значение по умолчанию - белый.

Это свойство было введено в QtWebEngine 1.2.

[только для чтения] canGoBack : bool

Возвращает true если существуют предыдущие записи истории сеанса, false в противном случае.

[только для чтения] canGoForward : bool

Возвращает true если существуют последующие записи истории сеанса, false в противном случае.

contentsSize : размер

Размер содержимого страницы.

Это свойство было добавлено в QtWebEngine 1.3.

devToolsView : WebEngineView

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

Это свойство было добавлено в QtWebEngine 1.7.

См. также inspectedView.

[только для чтения] иконка : url

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

Следующий фрагмент использует свойство icon для построения компонента Image.

Image {
    id: appIcon
    sourceSize: Qt.size(32, 32)
    source: webView.icon != "" ? webView.icon : "fallbackFavicon.png";
    // ...
}

Указание свойства sourceSize элемента Image информирует поставщика значков Qt WebEngine о запрошенном размере. Поставщик значков пытается найти наилучшее соответствие среди кандидатов на значки веб-страницы. Если свойство sourceSize не указано, поставщик предоставляет значок с наибольшим разрешением.

inspectedView : WebEngineView

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

Рекомендуется сбросить это свойство, когда инструменты разработчика не видны; в противном случае некоторые отладочные данные могут появиться в проверяемом WebEngineView.

Это свойство было добавлено в QtWebEngine 1.7.

См. также devToolsView.

[только для чтения] полноэкранный режим : bool

Возвращает true, если веб-просмотр находится в полноэкранном режиме, false в противном случае.

Это свойство было добавлено в QtWebEngine 1.1.

См. также fullScreenRequested() и fullScreenCancelled().

состояние жизненного цикла : LifecycleState

Текущее состояние жизненного цикла страницы.

Следующие ограничения накладываются установщиком:

• Видимая страница должна оставаться в состоянии Active.
• Если страница проверяется devToolsView, то обе страницы должны оставаться в состояниях Active.
• Страница в состоянии Discarded может перейти только в состояние Active. Это вызовет перезагрузку страницы.

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

Это свойство было добавлено в QtWebEngine 1.10.

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

[только для чтения] прогресс загрузки : int

Количество данных со страницы, загруженное, выраженное целым процентом в диапазоне от 0 до 100.

[только для чтения] загрузка : bool

Возвращает true, если страница HTML в данный момент загружается, false в противном случае.

[только для чтения] история навигации : WebEngineHistory

История навигации текущего просмотра.

Это свойство было добавлено в QtWebEngine 1.1.

См. также WebEngineHistory.

профиль : WebEngineProfile

Текущий профиль, используемый для просмотра.

Это свойство было добавлено в QtWebEngine 1.1.

См. также WebEngineProfile.

[только для чтения] недавно звуковой : bool

Возвращает текущее состояние воспроизведения звука страницы (звук недавно воспроизводился или нет).

Это свойство было добавлено в QtWebEngine 1.3.

См. также audioMuted и recentlyAudibleChanged.

рекомендуемое состояние : LifecycleState

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

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

Это свойство было добавлено в QtWebEngine 1.10.

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

[только для чтения] renderProcessPid : qint64

Возвращает идентификатор процесса (PID) процесса рендеринга, назначенного главному фрейму текущей страницы.

Если процесс рендеринга еще не доступен, возвращается 0.

Это свойство было добавлено в QtWebEngine 1.11.

См. также renderProcessPidChanged.

scrollPosition : точка

Положение скролла содержимого страницы.

Это свойство было добавлено в QtWebEngine 1.3.

[только для чтения] настройки : WebEngineSettings

Настройки, используемые этим просмотром.

Это свойство было добавлено в QtWebEngine 1.1.

См. также WebEngineSettings.

[только для чтения] заголовок : строка

Заголовок текущей отображаемой HTML-страницы. Это значение только для чтения, отражающее содержимое тега <title>.

url : url

Расположение текущей отображаемой HTML-страницы. Это изменяемое свойство предоставляет основной интерфейс для загрузки страницы в веб-просмотр. Оно работает так же, как свойство window.location DOM.

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

[только для чтения] пользовательские скрипты : список<WebEngineScript>

Список объектов скриптов, присоединённых к просмотру.

Это свойство было добавлено в QtWebEngine 1.1.

См. также WebEngineScript.

webChannel : QQmlWebChannel

Экземпляр канала веб-приложений, используемый этим просмотром. Этот канал автоматически использует внутренний механизм транспортировки QtWebEngine через Chromium IPC и экспонируется в контексте javascript страницы, которую он отображает, как qt.webChannelTransport. Этот объект транспорта используется при создании JavaScript-аналога QWebChannel с использованием Qt WebChannel JavaScript API.

Примечание: просмотр не берёт на себя ответственность за назначенный объект webChannel.

Это свойство было добавлено в QtWebEngine 1.1.

webChannelWorld : int

JavaScript мир, в котором установлен экземпляр канала веб-приложений, используемый этим просмотром. Мир должен быть числом от 0 до 256.

Это свойство было добавлено в QtWebEngine 1.3.

zoomFactor : вещественный

Коэффициент масштабирования для просмотра. Допустимые значения находятся в диапазоне от 0.25 до 5.0 Коэффициент по умолчанию 1.0.

Это свойство было добавлено в QtWebEngine 1.1.

Документация сигналов

activeFocusOnPressChanged(bool activeFocusOnPress)

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

Примечание: соответствующий обработчик - onActiveFocusOnPressChanged.

Этот сигнал был добавлен в QtWebEngine 1.2.

См. также activeFocusOnPress и setActiveFocusOnPress().

audioMutedChanged(bool muted)

Этот сигнал испускается, когда значение muted изменяется. Значение задаётся свойством audioMuted.

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

Примечание: Соответствующий обработчик — onAudioMutedChanged.

Этот сигнал был введён в QtWebEngine 1.3.

См. также audioMuted и recentlyAudibleChanged.

authenticationDialogRequested(AuthenticationDialogRequest request)

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

Обработать request можно с помощью методов типа AuthenticationDialogRequest.

Примечание: Обработчикам сигналов необходимо вызвать request.accepted = true для предотвращения отображения стандартного диалога. После этого необходимо вызвать либо AuthenticationDialogRequest::dialogAccept(), либо AuthenticationDialogRequest::dialogReject().

Примечание: Соответствующий обработчик — onAuthenticationDialogRequested.

Этот сигнал был введён в QtWebEngine 1.4.

backgroundColorChanged()

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

Примечание: Соответствующий обработчик — onBackgroundColorChanged.

Этот сигнал был введён в QtWebEngine 1.2.

certificateError(WebEngineCertificateError error)

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

Обработать ошибку сертификата можно с помощью методов типа WebEngineCertificateError.

Примечание: Соответствующий обработчик — onCertificateError.

Этот сигнал был введён в QtWebEngine 1.1.

colorDialogRequested(ColorDialogRequest request)

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

Обработать request можно с помощью методов типа ColorDialogRequest.

Примечание: Обработчикам сигналов необходимо вызвать request.accepted = true для предотвращения отображения стандартного диалога. После этого необходимо вызвать либо ColorDialogRequest::dialogAccept(), либо ColorDialogRequest::dialogReject().

Примечание: Соответствующий обработчик — onColorDialogRequested.

Этот сигнал был введён в QtWebEngine 1.4.

contextMenuRequested(ContextMenuRequest request)

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

Обработать request можно с помощью свойств типа ContextMenuRequest.

Примечание: Обработчикам сигналов необходимо вызвать request.accepted = true для предотвращения отображения стандартного контекстного меню.

Примечание: Соответствующий обработчик — onContextMenuRequested.

Этот сигнал был введён в QtWebEngine 1.4.

featurePermissionRequested(url securityOrigin, Feature feature)

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

Примечание: Соответствующий обработчик — onFeaturePermissionRequested.

Этот сигнал был введён в QtWebEngine 1.1.

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

fileDialogRequested(FileDialogRequest request)

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

Обработать request можно с помощью методов типа FileDialogRequest.

Примечание: Обработчикам сигналов необходимо вызвать request.accepted = true для предотвращения отображения стандартного диалога. После этого необходимо вызвать либо FileDialogRequest::dialogAccept(), либо FileDialogRequest::dialogReject().

Примечание: Соответствующий обработчик — onFileDialogRequested.

Этот сигнал был введён в QtWebEngine 1.4.

findTextFinished(FindTextResult result)

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

Примечание: Соответствующий обработчик — onFindTextFinished.

Этот сигнал был введён в QtWebEngine 1.10.

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

fullScreenRequested(FullScreenRequest request)

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

Примечание: Соответствующий обработчик — onFullScreenRequested.

Этот сигнал был введён в QtWebEngine 1.1.

См. также isFullScreen.

geometryChangeRequested(rect geometry, rect frameGeometry)

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

Хотя frameGeometry включает в себя отступы, geometry их не включает.

Примечание: Свойства QML Window, связанные с геометрией, ожидают размер без учета украшения окна. Для корректной обработки сигнала необходимо использовать geometry.

onGeometryChangeRequested: {
    window.x = geometry.x
    window.y = geometry.y
    window.width = geometry.width
    window.height = geometry.height
}

Примечание: Соответствующий обработчик — onGeometryChangeRequested.

Этот сигнал был введён в QtWebEngine 1.7.

javaScriptConsoleMessage(JavaScriptConsoleMessageLevel level, string message, int lineNumber, string sourceID)

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

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

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

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

Примечание: Соответствующий обработчик — onJavaScriptConsoleMessage.

См. также Ведение журнала консоли.

javaScriptDialogRequested(JavaScriptDialogRequest request)

Этот сигнал испускается, когда запрашивается JavaScript-диалог.

Обработать request можно с помощью методов типа JavaScriptDialogRequest.

Примечание: Обработчикам сигналов необходимо вызвать request.accepted = true для предотвращения отображения стандартного диалога. После этого необходимо вызвать либо JavaScriptDialogRequest::dialogAccept(), либо JavaScriptDialogRequest::dialogReject().

Примечание: Соответствующий обработчик — onJavaScriptDialogRequested.

Этот сигнал был введён в QtWebEngine 1.4.

linkHovered(url hoveredUrl)

В интерфейсе с управлением мышкой этот сигнал испускается, когда указатель мыши попадает на ссылку, что соответствует событию DOM mouseover. Это событие также может происходить в сенсорных интерфейсах для событий mouseover, которые не отменяются с помощью preventDefault(). hoveredUrl указывает местоположение ссылки.

Примечание: Соответствующий обработчик — onLinkHovered.

loadingChanged(WebEngineLoadRequest loadRequest)

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

При обработке сигнала с помощью onLoadingChanged, на WebEngineLoadRequest, указанном loadRequest, доступны различные параметры только для чтения.

Примечание: Соответствующий обработчик — onLoadingChanged.

См. также loading, LoadStatus и ErrorDomain.

navigationRequested(WebEngineNavigationRequest request)

Этот сигнал испускается при запросе навигации request.

Примечание: Соответствующий обработчик — onNavigationRequested.

newViewRequested(WebEngineNewViewRequest request)

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

Если этот сигнал не обработан, запрошенная загрузка завершится неудачей.

Пример реализации:

QtObject {
    id: windowParent
    // Create the initial browsing windows and open the startup page.
    Component.onCompleted: {
        var firstWindow = windowComponent.createObject(windowParent);
        firstWindow.webView.loadHtml('<input type="button" value="Click!" onclick="window.open(&quot;http://qt.io&quot;)">');
    }

    property Component windowComponent: Window {
        // Destroy on close to release the Window's QML resources.
        // Because it was created with a parent, it won't be garbage-collected.
        onClosing: destroy()
        visible: true

        property WebEngineView webView: webView_
        WebEngineView {
            id: webView_
            anchors.fill: parent

            // Handle the signal. Dynamically create the window and
            // use its WebEngineView as the destination of our request.
            onNewViewRequested: function(request) {
                var newWindow = windowComponent.createObject(windowParent);
                request.openIn(newWindow.webView);
            }
        }
    }
}

Примечание: Соответствующий обработчик — onNewViewRequested.

Этот сигнал был представлен в QtWebEngine 1.1.

См. также NewViewDestination и WebEngine Quick Nano Browser.

pdfPrintingFinished(string filePath, bool success)

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

Примечание: Соответствующий обработчик — onPdfPrintingFinished.

Этот сигнал был представлен в QtWebEngine 1.5.

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

printRequest()

Этот сигнал излучается, когда вызывается JavaScript-метод window.print(). Как правило, обработчик сигнала может просто вызвать printToPdf().

Примечание: Соответствующий обработчик — onPrintRequest.

Этот сигнал был представлен в QtWebEngine 1.8.

См. также printToPdf.

quotaRequested(QuotaRequest request)

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

Примечание: Соответствующий обработчик — onQuotaRequested.

Этот сигнал был представлен в QtWebEngine 1.7.

См. также QuotaRequest.

recentlyAudibleChanged(bool recentlyAudible)

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

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

Этот сигнал также излучается для звука плагина Flash.

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

Также могут происходить ложные излучения сигналов. Например, когда звук останавливается, этот сигнал сначала излучается со значением true, а затем со значением false. Кроме того, когда воспроизведение звука начинается, сигнал излучается дважды со значением true.

Примечание: Соответствующий обработчик — onRecentlyAudibleChanged.

Этот сигнал был представлен в QtWebEngine 1.3.

См. также recentlyAudible.

registerProtocolHandlerRequested(RegisterProtocolHandlerRequest request)

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

Примечание: Соответствующий обработчик — onRegisterProtocolHandlerRequested.

Этот сигнал был представлен в QtWebEngine 1.7.

См. также RegisterProtocolHandlerRequest.

renderProcessPidChanged(qint64 pid)

Если процесс отрисовки еще недоступен, возвращается 0. Этот сигнал излучается, когда идентификатор процесса (PID) подлежащего процесса отрисовки страницы изменился.

Примечание: Соответствующий обработчик — onRenderProcessPidChanged.

Этот сигнал был представлен в QtWebEngine 1.11.

См. также renderProcessPid.

renderProcessTerminated(RenderProcessTerminationStatus terminationStatus, int exitCode)

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

Примечание: Соответствующий обработчик — onRenderProcessTerminated.

Этот сигнал был представлен в QtWebEngine 1.2.

См. также RenderProcessTerminationStatus.

selectClientCertificate(WebEngineClientCertificateSelection clientCertificateSelection)

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

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

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

Примечание: Соответствующий обработчик — onSelectClientCertificate.

Этот сигнал был представлен в QtWebEngine 1.9.

См. также WebEngineClientCertificateSelection.

tooltipRequested(TooltipRequest request)

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

Примечание: Обработчикам сигналов необходимо вызвать request.accepted = true , чтобы предотвратить отображение всплывающей подсказки по умолчанию.

Примечание: Соответствующий обработчик — onTooltipRequested.

Этот сигнал был представлен в QtWebEngine 1.10.

См. также TooltipRequest.

wasRecentlyAudibleChanged(bool wasRecentlyAudible)

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

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

Примечание: Соответствующий обработчик — onWasRecentlyAudibleChanged.

Этот сигнал был представлен в QtWebEngine 1.3.

windowCloseRequested()

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

Примечание: Соответствующий обработчик — onWindowCloseRequested.

Этот сигнал был представлен в QtWebEngine 1.2.

Методы

WebEngineAction action(WebAction action)

Возвращает WebEngineAction для указанного WebAction action. WebEngineView также позаботится об исполнении действия, так что при срабатывании соответствующее действие выполняется в представлении.

var copyAction = webEngineView.action(WebEngineView.Copy);

Этот метод был представлен в Qt 5.12.

См. также WebEngineAction.

void findText(string subString, FindFlags options, variant resultCallback)

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

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

resultCallback должен принимать целочисленный параметр. Он будет вызван с количеством найденных вхождений subString.

findText("Qt", WebEngineView.FindCaseSensitively, function(matchCount) {
    if (matchCount > 0)
        console.log("'Qt' tokens found:", matchCount);
});

Этот метод был представлен в QtWebEngine 1.1.

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

void findText(string subString, FindFlags options)

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

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

findText("Qt", WebEngineView.FindBackward | WebEngineView.FindCaseSensitively);

Этот метод был представлен в QtWebEngine 1.1.

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

void findText(string subString)

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

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

Этот метод был представлен в QtWebEngine 1.1.

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

void fullScreenCancelled()

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

ApplicationWindow {
    onVisibilityChanged: {
        if (webEngineView.isFullScreen && visibility != Window.FullScreen)
            webEngineView.fullScreenCancelled()
    }

    WebEngineView {
        id: webEngineView
        // ...
    }
}

Этот метод был представлен в QtWebEngine 1.1.

См. также isFullScreen и fullScreenRequested().

void goBack()

Переходит назад в истории сеанса браузера, если это возможно. Эта функция эквивалентна методу window.history.back() DOM.

См. также canGoBack.

void goBackOrForward(int offset)

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

Этот метод был представлен в QtWebEngine 1.1.

См. также goBack() и goForward().

void goForward()

Переходит вперёд в истории сеанса браузера, если это возможно. Эта функция эквивалентна методу window.history.forward() DOM.

void grantFeaturePermission(url securityOrigin, Feature feature, bool granted)

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

Этот метод был представлен в QtWebEngine 1.1.

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

void loadHtml(string html, url baseUrl)

Загружает указанный html как содержимое веб-представления.

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

Внешние объекты, такие как таблицы стилей или изображения, на которые ссылается HTML-документ, должны находиться относительно baseUrl. Для загрузки внешних объектов baseUrl не может быть пустой. Например, если html извлечён из http://www.example.com/documents/overview.html, которое является базовым URL-адресом, то изображение, на которое ссылается относительный URL diagram.png, должно быть по адресу http://www.example.com/documents/diagram.png.

См. также url.

void printToPdf(variant resultCallback, PrintedPageSizeId pageSizeId, PrintedPageOrientation orientation)

Печатает текущее содержимое WebEngineView в PDF-документ и возвращает его в виде массива байтов. Размер документа определяется значением pageSizeId, а ориентация — orientation.

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

Если вы опустите pageSizeId, он по умолчанию будет A4. Если вы опустите orientation, он по умолчанию будет Portrait.

Этот метод был представлен в QtWebEngine 1.3.

void printToPdf(const string filePath, PrintedPageSizeId pageSizeId, PrintedPageOrientation orientation)

Печатает текущее содержимое WebEngineView в PDF-документ и сохраняет его по пути filePath. Размер документа определяется значением pageSizeId, а ориентация — orientation.

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

Если вы опустите pageSizeId, он по умолчанию будет A4. Если вы опустите orientation, он по умолчанию будет Portrait.

Этот метод был представлен в QtWebEngine 1.3.

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

void reload()

Перезагружает текущую страницу. Эта функция эквивалентна методу window.location.reload() DOM.

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

void reloadAndBypassCache()

Перезагружает текущую страницу, игнорируя кэшированное содержимое.

Этот метод был представлен в QtWebEngine 1.1.

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

void replaceMisspelledWord(const QString &replacement)

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

Этот метод был представлен в QtWebEngine 1.3.

void runJavaScript(string script, variant callback)

Выполняет указанный script в содержимом веб-представления.

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

runJavaScript("document.title", function(result) { console.log(result); });

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

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

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

Для получения дополнительной информации об инъекции скриптов, см. Инъекция скриптов. Для альтернативного способа инъекции скриптов, см. WebEngineView::userScripts.

void setActiveFocusOnPress(bool arg)

Устанавливает активный фокус на нажатый элемент веб-представления, если arg имеет значение true. Установив его в значение false, можно использовать веб-представление для создания элемента пользовательского интерфейса, который не должен получать фокус. Это может быть полезно в гибридном пользовательском интерфейсе.

Этот метод был представлен в QtWebEngine 1.2.

См. также activeFocusOnPress, activeFocusOnPressChanged и WebEngineSettings::focusOnNavigationEnabled.

void stop()

Останавливает загрузку текущей страницы.

void triggerWebAction(WebAction action)

Вызывает веб-действие action.

Этот метод был представлен в QtWebEngine 1.2.

См. также WebAction.