QWebEngineDesktopMediaRequest Class

Eine Aufforderung zum Ausfüllen eines Dialogs mit verfügbaren Quellen für Bildschirmaufnahmen. Mehr...

Kopfzeile: #include <QWebEngineDesktopMediaRequest>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
Seit: Qt 6.7
In QML: WebEngineDesktopMediaRequest

Öffentliche Funktionen

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

Detaillierte Beschreibung

Damit Webanwendungen den Inhalt eines Bildschirms erfassen können, müssen sich Anwendungen mit QWebEnginePage::desktopMediaRequested verbinden, das eine QWebEngineDesktopMediaRequest-Instanz als Argument entgegennimmt.

Wenn eine Webanwendung den Zugriff auf den Inhalt eines Bildschirms anfordert, wird QWebEnginePage::desktopMediaRequested mit einer QWebEngineDesktopMediaRequest-Instanz als Argument ausgegeben, die Referenzen auf QAbstractListModels für verfügbare Fenster und Bildschirme enthält, die erfasst werden können.

Die Qt::DisplayRole des Datenmodells spezifiziert den Namen der Quelle, der der Titel eines Fensters oder die Nummer der Anzeige ist. Das Modell wird dynamisch aktualisiert, wenn sich die Liste der verfügbaren Quellen geändert hat, z.B. wenn ein Fenster geöffnet/geschlossen wird.

Der Signalhandler muss dann entweder selectScreen() oder selectWindow() aufrufen, um die Anforderung anzunehmen und die Bildschirmfreigabe zu starten.

Siehe auch QWebEnginePage::desktopMediaRequested().

Dokumentation der Mitgliedsfunktionen

[invokable] void QWebEngineDesktopMediaRequest::cancel() const

Lehnt eine Anfrage ab. Die Bildschirmerfassung wird abgebrochen.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

QAbstractListModel *QWebEngineDesktopMediaRequest::screensModel() const

Gibt eine QAbstractListModel für die verfügbaren Bildschirme zurück.

Hinweis: Getter-Funktion für die Eigenschaft screensModel.

Siehe auch windowsModel().

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

Wählt den zu erfassenden Bildschirm auf index aus.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch QWebEngineDesktopMediaRequest::selectWindow().

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

Wählt das zu erfassende Fenster auf index aus.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch QWebEngineDesktopMediaRequest::selectScreen().

QAbstractListModel *QWebEngineDesktopMediaRequest::windowsModel() const

Gibt eine QAbstractListModel für die verfügbaren Fenster zurück.

Hinweis: Getter-Funktion für die Eigenschaft windowsModel.

Siehe auch screensModel().

© 2025 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.