QWebEngineFullScreenRequest 类

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

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

该类在 Qt 5.6 引入。

特性

公共函数

void accept ()
const 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 () 请求。若接受,应用程序需要确保还原全局窗口状态。

特性文档编制

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。