Класс QWebEngineFullScreenRequest
Класс QWebEngineFullScreenRequest позволяет принимать или отклонять запросы на вход и выход из полноэкранного режима. Подробнее...
| Заголовок: | #include <QWebEngineFullScreenRequest> |
| CMake: | find_package(Qt6 COMPONENTS WebEngineCore REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| С тех пор: | Qt 5.6 |
| Инициализируется: | FullScreenRequest |
Свойства
Открытые функции
| void | accept() |
| QUrl | origin() const |
| void | reject() |
| bool | toggleOn() const |
Подробное описание
Для разрешения отображения элементов, таких как видео, в полноэкранном режиме, приложения должны установить QWebEngineSettings::FullScreenSupportEnabled и подключиться к QWebEnginePage::fullScreenRequested, который принимает экземпляр QWebEngineFullScreenRequest в качестве аргумента.
Если элемент веб-страницы запрашивает отображение в полноэкранном режиме, QWebEnginePage::fullScreenRequested будет испущен с экземпляром QWebEngineFullScreenRequest в качестве аргумента, где toggleOn() возвращает true. Обработчик сигнала должен затем вызвать либо accept(), либо reject().
Если запрос на вход в полноэкранный режим принят, элемент, запрашивающий полноэкранный режим, заполнит область просмотра, но приложение должно обеспечить переключение на полноэкранный режим или переместить страницу в область просмотра, которая находится в полноэкранном режиме.
Аналогично, QWebEnginePage::fullScreenRequested будет испущен, когда пользователь хочет выйти из полноэкранного режима (то есть через действие контекстного меню QWebEnginePage::ExitFullScreen). В этом случае toggleOn() вернет false, и обработчик сигнала снова должен accept() или reject() запрос. Если он принят, приложение должно убедиться, что глобальное состояние окна восстановлено.
Документация по свойствам
[read-only] origin : const QUrl
Это свойство содержит URL-адрес, который нужно открыть в полноэкранном режиме.
Функции доступа:
| QUrl | origin() const |
[read-only] toggleOn : const bool
Это свойство содержит значение, указывающее, запросил ли веб-сайт переход в полноэкранный режим.
Функции доступа:
| bool | toggleOn() const |
Документация по членам-функциям
[invokable] void QWebEngineFullScreenRequest::accept()
Принимает запрос на вход или выход из полноэкранного режима.
Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.
QUrl QWebEngineFullScreenRequest::origin() const
Возвращает URL-адрес, который нужно открыть в полноэкранном режиме.
Примечание: Функция-получатель для свойства origin.
[invokable] void QWebEngineFullScreenRequest::reject()
Отклоняет запрос на вход или выход из полноэкранного режима.
Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.
bool QWebEngineFullScreenRequest::toggleOn() const
Возвращает true , если веб-страница запросила вход в полноэкранный режим, в противном случае возвращает false.
Примечание: Функция-получатель для свойства toggleOn.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qwebenginefullscreenrequest.html