QWebEngineFullScreenRequest 類

QWebEngineFullScreenRequest 類允許接受或拒絕進入和退齣全屏幕模式的請求。 更多...

頭: #include <QWebEngineFullScreenRequest>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
在 QML: 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。