QWebEngineFullScreenRequest 类

QWebEngineFullScreenRequest 类允许接受或拒绝进入和退出全屏幕模式的请求。 更多...

头: #include <QWebEngineFullScreenRequest>
CMake: find_package(Qt6 COMPONENTS WebEngineCore REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
Since: Qt 5.6
实例化: FullScreenRequest

特性

公共函数

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

详细描述

要允许元素 (如:视频) 以全屏模式展示,应用程序必须设置 QWebEngineSettings::FullScreenSupportEnabled 和连接到 QWebEnginePage::fullScreenRequested 以 QWebEngineFullScreenRequest 实例作为自变量。

如果网页元素请求以全屏模式展示, QWebEnginePage::fullScreenRequested 会被发射采用 QWebEngineFullScreenRequest 实例作为自变量,其中 toggleOn () 返回 true 。信号处理程序然后需要调用 accept () 或 reject ().

若接受进入全屏模式请求,请求全屏模式的元素将填充视口,但直到应用程序使视图全屏 (或将页面移至全屏模式视图)。

同样, QWebEnginePage::fullScreenRequested 会被发射当用户希望离开全屏模式 (即:透过 QWebEnginePage::ExitFullScreen 上下文菜单动作)。在此情况下, toggleOn () 会返回 false ,和信号处理程序再次需要 accept () 或 reject () 请求。若接受,应用程序需要确保还原全局窗口状态。

特性文档编制

[read-only] origin : const QUrl

此特性保持要在全屏模式下打开的 URL。

访问函数:

QUrl origin () const

[read-only] toggleOn : const bool

此特性保持网页是否有发出进入全屏模式的请求。

访问函数:

bool toggleOn () const

成员函数文档编制

[invokable] void QWebEngineFullScreenRequest:: accept ()

接受进入或退出全屏模式的请求。

注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .

QUrl QWebEngineFullScreenRequest:: origin () const

返回要在全屏模式下打开的 URL。

注意: Getter 函数对于特性 origin。

[invokable] void QWebEngineFullScreenRequest:: reject ()

拒绝进入或退出全屏模式的请求。

注意: 此函数可以被援引,通过元对象系统和从 QML。见 Q_INVOKABLE .

bool QWebEngineFullScreenRequest:: toggleOn () const

返回 true 若网页有发出进入全屏模式的请求,否则返回 false .

注意: Getter 函数对于特性 toggleOn。