QWebEngineFullScreenRequest 类
QWebEngineFullScreenRequest 类允许接收或拒绝进入和退出全屏模式的请求。 更多...
头文件 | #include <QWebEngineFullScreenRequest> |
CMake | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
qmake | QT += webenginecore |
由以下实例化 | FullScreenRequest |
属性
公共函数
详细描述
为了允许视频等元素在全屏模式下显示,应用程序必须设置 QWebEngineSettings::FullScreenSupportEnabled 并连接到 QWebEnginePage::fullScreenRequested,它将 QWebEngineFullScreenRequest 实例作为参数。
如果网页中的某个元素请求在全屏模式下显示,将带有一个 QWebEngineFullScreenRequest 实例作为参数的 QWebEnginePage::fullScreenRequested 将被触发,其中 toggleOn() 返回 true
。信号处理程序需要调用 accept() 或 reject()。
如果接受进入全屏模式的请求,请求全屏模式的元素将填充视口,但由应用程序决定是否使视图全屏或移动页面到一个全屏模式的视图中。
同样,当用户想要退出全屏模式时(通过 QWebEnginePage::ExitFullScreen 的上下文菜单操作),将触发一个 QWebEnginePage::fullScreenRequested。在这种情况下,toggleOn() 将返回 false
,信号处理程序再次需要 accept() 或 reject() 请求。如果它被接受,应用程序需要确保全局窗口状态已恢复。
属性文档
[只读]
origin : const QUrl
此属性持有在全屏模式下要打开的URL。
访问函数
QUrl | origin() const |
[只读]
toggleOn : const bool
此属性表示网页是否已发出请求进入全屏模式。
访问函数
bool | toggleOn() const |
成员函数文档
[可调用的]
void QWebEngineFullScreenRequest::accept()
接受进入或退出全屏模式的请求。
注意:此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。
QUrl QWebEngineFullScreenRequest::origin() const
返回要在全屏模式下打开的URL。
注意:origin属性的获取器函数。
[可调用的]
void QWebEngineFullScreenRequest::reject()
拒绝进入或退出全屏模式的请求。
注意:此函数可以通过元对象系统和QML调用。请参阅Q_INVOKABLE。
bool QWebEngineFullScreenRequest::toggleOn() const
如果网页已发出请求进入全屏模式,则返回true
,否则返回false
。
注意:toggleOn属性的获取器函数。
© 2024 Qt公司有限公司。本文件中的文档贡献版权属于各自的拥有者。本文件提供的文档根据Free Software Foundation发布的GNU自由文档许可证第1.3版许可。Qt及其相关标志是世界各地芬兰和/或其他地区的Qt公司注册商标。所有其他商标均为其各自所有者的财产。