Класс 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.