QWebEngineFullScreenRequest 类

The 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

静态公共成员

const QMetaObject staticMetaObject

详细描述

The 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 ()

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

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

const QUrl &QWebEngineFullScreenRequest:: origin () const

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

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

void QWebEngineFullScreenRequest:: reject ()

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

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

bool QWebEngineFullScreenRequest:: toggleOn () const

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

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