QWebEngineFullScreenRequest 类

QWebEngineFullScreenRequest class enables accepting or rejecting requests for entering and exiting the fullscreen mode. 更多...

头: #include <QWebEngineFullScreenRequest>
qmake: QT += webenginewidgets
Since: Qt 5.6

特性

公共函数

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

详细描述

QWebEngineFullScreenRequest class enables accepting or rejecting requests for entering and exiting the fullscreen mode.

要允许元素 (如:视频) 以全屏模式展示,应用程序必须设置 QWebEngineSettings::FullScreenSupportEnabled 和连接到 QWebEnginePage::fullScreenRequested , which takes a QWebEngineFullScreenRequest instance as an argument.

如果网页元素请求以全屏模式展示, QWebEnginePage::fullScreenRequested will be emitted with an QWebEngineFullScreenRequest instance as an argument where toggleOn () 返回 true 。信号处理程序然后需要调用 accept () 或 reject ().

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

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

特性文档编制

origin : const QUrl

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

访问函数:

const QUrl & origin () const

toggleOn : const bool

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

访问函数:

bool toggleOn () const

成员函数文档编制

void QWebEngineFullScreenRequest:: accept ()

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

const QUrl &QWebEngineFullScreenRequest:: origin () const

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

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

void QWebEngineFullScreenRequest:: reject ()

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

bool QWebEngineFullScreenRequest:: toggleOn () const

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

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