En esta página

QWebEngineDesktopMediaRequest Class

Una petición para rellenar un diálogo con las fuentes disponibles para la captura de pantalla. Más...

Cabecera: #include <QWebEngineDesktopMediaRequest>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
Desde: Qt 6.7
En QML: webEngineDesktopMediaRequest

Propiedades

Funciones públicas

void cancel() const
QAbstractListModel *screensModel() const
void selectScreen(const QModelIndex &index) const
void selectWindow(const QModelIndex &index) const
QAbstractListModel *windowsModel() const

Descripción detallada

Para que las aplicaciones web puedan capturar el contenido de una pantalla, deben conectarse a QWebEnginePage::desktopMediaRequested, que toma como argumento una instancia de QWebEngineDesktopMediaRequest.

Si una aplicación web solicita acceso a los contenidos de una pantalla, se emitirá QWebEnginePage::desktopMediaRequested con una instancia QWebEngineDesktopMediaRequest como argumento, que contiene referencias a QAbstractListModels para las ventanas y pantallas disponibles que pueden capturarse.

El Qt::DisplayRole del modelo de datos especifica el nombre de la fuente que es el título de una ventana o el número de la pantalla. El modelo se actualiza dinámicamente si la lista de fuentes disponibles ha cambiado; por ejemplo, cuando se abre/cierra una ventana.

El responsable de la señal debe llamar a selectScreen() o selectWindow() para aceptar la solicitud e iniciar la compartición de pantallas.

Véase también QWebEnginePage::desktopMediaRequested().

Documentación de propiedades

[read-only] screensModel : QAbstractListModel*

Esta propiedad contiene un QAbstractListModel para las pantallas disponibles.

Funciones de acceso:

QAbstractListModel *screensModel() const

Véase también windowsModel.

[read-only] windowsModel : QAbstractListModel*

Esta propiedad contiene un QAbstractListModel para las ventanas disponibles.

Funciones de acceso:

QAbstractListModel *windowsModel() const

Véase también screensModel.

Documentación de las funciones miembro

[invokable] void QWebEngineDesktopMediaRequest::cancel() const

Rechaza una solicitud. La captura de pantalla será abortada.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QWebEngineDesktopMediaRequest::selectScreen(const QModelIndex &index) const

Selecciona la pantalla en index que se va a capturar.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también QWebEngineDesktopMediaRequest::selectWindow().

[invokable] void QWebEngineDesktopMediaRequest::selectWindow(const QModelIndex &index) const

Selecciona la ventana en index que se va a capturar.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también QWebEngineDesktopMediaRequest::selectScreen().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.