Sur cette page

QWebEngineFullScreenRequest Class

La classe QWebEngineFullScreenRequest permet d'accepter ou de rejeter les demandes d'entrée et de sortie du mode plein écran. Plus d'informations...

En-tête : #include <QWebEngineFullScreenRequest>
CMake : find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake : QT += webenginecore
En QML : fullScreenRequest

Propriétés

Fonctions publiques

void accept()
QUrl origin() const
void reject()
bool toggleOn() const

Description détaillée

Pour permettre à des éléments tels que des vidéos d'être affichés en mode plein écran, les applications doivent définir QWebEngineSettings::FullScreenSupportEnabled et se connecter à QWebEnginePage::fullScreenRequested, qui prend une instance QWebEngineFullScreenRequest comme argument.

Si un élément d'une page web demande à être affiché en mode plein écran, QWebEnginePage::fullScreenRequested sera émis avec une instance QWebEngineFullScreenRequest comme argument, où toggleOn() renvoie true. Le gestionnaire de signal doit alors appeler accept() ou reject().

Si la demande d'accès au mode plein écran est acceptée, l'élément demandant le mode plein écran remplira la fenêtre d'affichage, mais c'est à l'application de rendre l'affichage plein écran ou de déplacer la page vers un affichage en mode plein écran.

De même, un message QWebEnginePage::fullScreenRequested sera émis lorsque l'utilisateur voudra quitter le mode plein écran (c'est-à-dire par l'intermédiaire de l'action du menu contextuel QWebEnginePage::ExitFullScreen ). Dans ce cas, toggleOn() renvoie false, et le gestionnaire de signal doit à nouveau accept() ou reject() la demande. Si elle est acceptée, l'application doit s'assurer que l'état global de la fenêtre est rétabli.

Documentation sur les propriétés

[read-only] origin : const QUrl

Cette propriété contient l'URL à ouvrir en mode plein écran.

Fonctions d'accès :

QUrl origin() const

[read-only] toggleOn : const bool

Cette propriété indique si la page web a émis une demande d'entrée en mode plein écran.

Fonctions d'accès :

bool toggleOn() const

Documentation des fonctions membres

[invokable] void QWebEngineFullScreenRequest::accept()

Accepte la demande d'entrée ou de sortie du mode plein écran.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

QUrl QWebEngineFullScreenRequest::origin() const

Renvoie l'URL à ouvrir en mode plein écran.

Remarque : fonction Getter pour la propriété origin.

[invokable] void QWebEngineFullScreenRequest::reject()

Rejette une demande d'entrée ou de sortie du mode plein écran.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

bool QWebEngineFullScreenRequest::toggleOn() const

Renvoie true si la page web a émis une demande d'entrée en mode plein écran, sinon renvoie false.

Remarque : fonction Getter pour la propriété toggleOn.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.