Sur cette page

QWebEngineDesktopMediaRequest Class

Demande de remplissage d'une boîte de dialogue avec les sources disponibles pour la capture d'écran. Plus d'informations...

En-tête : #include <QWebEngineDesktopMediaRequest>
CMake : find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake : QT += webenginecore
Depuis : Qt 6.7
En QML : webEngineDesktopMediaRequest

Propriétés

Fonctions publiques

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

Description détaillée

Pour permettre aux applications web de capturer le contenu d'un écran, les applications doivent se connecter à QWebEnginePage::desktopMediaRequested, qui prend une instance de QWebEngineDesktopMediaRequest comme argument.

Si une application web demande l'accès au contenu d'un écran, QWebEnginePage::desktopMediaRequested sera émis avec une instance QWebEngineDesktopMediaRequest comme argument qui contient des références à QAbstractListModels pour les fenêtres et les écrans disponibles qui peuvent être capturés.

Le Qt::DisplayRole du modèle de données spécifie le nom de la source, qui est le titre d'une fenêtre ou le numéro de l'écran. Le modèle est mis à jour dynamiquement si la liste des sources disponibles a changé, par exemple lorsqu'une fenêtre est ouverte ou fermée.

Le gestionnaire de signal doit ensuite appeler selectScreen() ou selectWindow() pour accepter la demande et démarrer le partage d'écran.

Voir aussi QWebEnginePage::desktopMediaRequested().

Documentation sur les propriétés

[read-only] screensModel : QAbstractListModel*

Cette propriété contient un QAbstractListModel pour les écrans disponibles.

Fonctions d'accès :

QAbstractListModel *screensModel() const

Voir aussi windowsModel.

[read-only] windowsModel : QAbstractListModel*

Cette propriété contient une adresse QAbstractListModel pour les fenêtres disponibles.

Fonctions d'accès :

QAbstractListModel *windowsModel() const

Voir également screensModel.

Documentation sur les fonctions membres

[invokable] void QWebEngineDesktopMediaRequest::cancel() const

Rejette une demande. La capture d'écran est interrompue.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

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

Sélectionne l'écran à capturer à l'adresse index.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également QWebEngineDesktopMediaRequest::selectWindow().

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

Sélectionne la fenêtre à capturer sur le site index.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également 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.