QWebEngineFullScreenRequest 类允许接受或拒绝进入和退出全屏幕模式的请求。 更多...
头: | #include <QWebEngineFullScreenRequest> |
CMake: |
find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
qmake: | QT += webenginecore |
实例化: | 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。