Класс QWebEngineFullScreenRequest

Класс QWebEngineFullScreenRequest позволяет принимать или отклонять запросы на ввод и выход из полноэкранного режима. Подробнее...

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

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

Свойства

• origin : const QUrl
• toggleOn : const bool

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

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

Для того, чтобы элементы, такие как видео, отображались в полноэкранном режиме, приложения должны установить QWebEngineSettings::FullScreenSupportEnabled и подключиться к сигналу QWebEnginePage::fullScreenRequested, который принимает экземпляр QWebEngineFullScreenRequest в качестве аргумента.

Если элемент веб-страницы запросит отображение в полноэкранном режиме, сигнал QWebEnginePage::fullScreenRequested будет выпущен с экземпляром QWebEngineFullScreenRequest в качестве аргумента, где toggleOn() вернёт true. Обработчик сигнала должен затем вызвать accept() или reject().

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

Аналогичным образом, сигнал QWebEnginePage::fullScreenRequested будет выпущен, когда пользователь захочет выйти из полноэкранного режима (то есть через действие контекстного меню QWebEnginePage::ExitFullScreen). В этом случае toggleOn() вернёт false, и обработчик сигнала снова должен вызвать accept() или reject() запрос. Если он принят, приложение должно убедиться, что состояние глобального окна восстановлено.

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

void QWebEngineFullScreenRequest::accept()

Принимает запрос на ввод или выход из полноэкранного режима.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

const QUrl &QWebEngineFullScreenRequest::origin() const

Возвращает URL-адрес, который будет открыт в полноэкранном режиме.

Примечание: Функция-член для свойства origin.

void QWebEngineFullScreenRequest::reject()

Отклоняет запрос на ввод или выход из полноэкранного режима.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

bool QWebEngineFullScreenRequest::toggleOn() const

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

Примечание: Функция-член для свойства toggleOn.