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

詳細描述

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

接受進入或退齣全屏模式的請求。

const QUrl &QWebEngineFullScreenRequest:: origin () const

返迴要在全屏模式下打開的 URL。

注意: getter 函數對於特性 origin .

void QWebEngineFullScreenRequest:: reject ()

拒絕進入或退齣全屏模式的請求。

bool QWebEngineFullScreenRequest:: toggleOn () const

返迴 true 若網頁有發齣進入全屏模式的請求,否則返迴 false .

注意: getter 函數對於特性 toggleOn .