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 .
返迴要在全屏模式下打開的 URL。
注意: getter 函數對於特性 origin。
[invokable]
void
QWebEngineFullScreenRequest::
reject
()
拒絕進入或退齣全屏模式的請求。
注意: 此函數可以被援引,通過元對象係統和從 QML。見 Q_INVOKABLE .
返迴
true
若網頁有發齣進入全屏模式的請求,否則返迴
false
.
注意: getter 函數對於特性 toggleOn。