En esta página

QWebEngineFullScreenRequest Class

La clase QWebEngineFullScreenRequest permite aceptar o rechazar solicitudes para entrar y salir del modo de pantalla completa. Más...

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

Propiedades

Funciones públicas

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

Descripción detallada

Para permitir que elementos como los vídeos se muestren en el modo de pantalla completa, las aplicaciones deben configurar QWebEngineSettings::FullScreenSupportEnabled y conectarse a QWebEnginePage::fullScreenRequested, que toma como argumento una instancia de QWebEngineFullScreenRequest.

Si un elemento de una página web solicita mostrarse en modo de pantalla completa, se emitirá QWebEnginePage::fullScreenRequested con una instancia QWebEngineFullScreenRequest como argumento donde toggleOn() devuelve true. El responsable de la señal debe entonces llamar a accept() o a reject().

Si se acepta la petición de entrar en el modo de pantalla completa, el elemento que solicita el modo de pantalla completa llenará la ventana gráfica, pero depende de la aplicación hacer que la vista sea de pantalla completa o mover la página a una vista que esté en el modo de pantalla completa.

Del mismo modo, se emitirá un QWebEnginePage::fullScreenRequested cuando el usuario quiera salir del modo de pantalla completa (es decir, a través de la acción del menú contextual QWebEnginePage::ExitFullScreen ). En este caso, toggleOn() devolverá false, y el manejador de la señal necesita de nuevo accept() o reject() la petición. Si se acepta, la aplicación debe asegurarse de que se restablece el estado global de la ventana.

Documentación de propiedades

[read-only] origin : const QUrl

Esta propiedad contiene la URL que se abrirá en el modo de pantalla completa.

Funciones de acceso:

QUrl origin() const

[read-only] toggleOn : const bool

Esta propiedad indica si la página web ha emitido una petición para entrar en modo de pantalla completa.

Funciones de acceso:

bool toggleOn() const

Documentación de funciones miembro

[invokable] void QWebEngineFullScreenRequest::accept()

Acepta la petición de entrar o salir del modo de pantalla completa.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QUrl QWebEngineFullScreenRequest::origin() const

Devuelve la URL que se abrirá en el modo de pantalla completa.

Nota: Función Getter para la propiedad origin.

[invokable] void QWebEngineFullScreenRequest::reject()

Rechaza una solicitud para entrar o salir del modo de pantalla completa.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

bool QWebEngineFullScreenRequest::toggleOn() const

Devuelve true si la página web ha emitido una petición para entrar en el modo de pantalla completa, en caso contrario devuelve false.

Nota: Función Getter para la propiedad 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.