QWebEngineExtensionInfo Class

Die QWebEngineExtensionInfo liefert Informationen über eine Browsererweiterung. Mehr...

Kopfzeile: #include <QWebEngineExtensionInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
Seit: Qt 6.10

Eigenschaften

Öffentliche Funktionen

QUrl actionPopupUrl() const
QString description() const
QString error() const
QString id() const
bool isEnabled() const
bool isInstalled() const
bool isLoaded() const
QString name() const
QString path() const

Detaillierte Beschreibung

QWebEngineExtensionInfo liefert Informationen über eine in Qt WebEngine geladene Erweiterung. Erweiterungen können über die QWebEngineExtensionManager geladen werden. Über die Eigenschaft isLoaded() kann überprüft werden, ob die Erweiterung erfolgreich geladen wurde. Die Eigenschaft error() enthält Fehlermeldungen, wenn der Ladevorgang fehlgeschlagen ist. Erweiterungen werden immer im deaktivierten Zustand geladen. Um eine Erweiterung auszuführen, muss sie über QWebEngineExtensionManager::setExtensionEnabled() aktiviert werden.

Eine Erweiterung kann mit QWebEngineExtensionManager::unloadExtension() entfernt werden.

Sie können auf Erweiterungen mit QWebEngineExtensionManager::extensions() zugreifen, das eine Liste der geladenen Erweiterungen liefert, oder sich mit den Signalen des Managers verbinden, um benachrichtigt zu werden, wenn der Ladevorgang abgeschlossen ist.

Siehe auch QWebEngineExtensionManager und QWebEngineProfile::extensionManager().

Dokumentation der Eigenschaften

[read-only] actionPopupUrl : const QUrl

Gibt die URL des Popup-Menüs der Erweiterung zurück.

Entwickler von Erweiterungen bieten normalerweise ein Popup-Menü an, über das Benutzer ihre Erweiterung steuern können. Das Menü kann über diese URL aufgerufen werden.

Leer, wenn der Ladevorgang fehlgeschlagen ist.

Zugriffsfunktionen:

QUrl actionPopupUrl() const

[read-only] error : const QString

Beim Laden, Installieren oder Deinstallieren der Erweiterung sind Fehler aufgetreten.

Während des Ladevorgangs können mehrere Fehler auftreten, z. B. fehlendes Manifest, ungültiges Dateiformat oder ungültiger Pfad. Der Ladevorgang wird beim ersten Fehler abgebrochen.

Leer, wenn der Ladevorgang erfolgreich war.

Zugriffsfunktionen:

QString error() const

[read-only] id : const QString

Diese Eigenschaft enthält die ID der Erweiterung.

Sie wird zum Zeitpunkt des Ladens erzeugt. Mehrere QWebEngineExtensionInfo Objekte mit der gleichen ID repräsentieren die gleiche zugrunde liegende Erweiterung.

Die id wird aus dem Dateisystempfad, aus dem die Erweiterung geladen wurde, und der Manfiest-Datei der Erweiterung generiert. Wird dieselbe Erweiterung vom selben Pfad geladen, hat sie immer dieselbe id.

Leer, wenn das Laden fehlgeschlagen ist.

Zugriffsfunktionen:

QString id() const

[read-only] isEnabled : const bool

Diese Eigenschaft gibt an, ob die Erweiterung aktiviert ist.

Zugriffsfunktionen:

bool isEnabled() const

Siehe auch QWebEngineExtensionManager::setExtensionEnabled().

[read-only] isLoaded : const bool

Diese Eigenschaft gibt an, ob die Erweiterung geladen ist.

Wenn die Erweiterung erfolgreich geladen oder installiert wurde, gibt diese Eigenschaft true zurück. Gibt false zurück, wenn die Erweiterung entladen oder deinstalliert wurde oder der Ladevorgang fehlgeschlagen ist.

Zugriffsfunktionen:

bool isLoaded() const

Siehe auch QWebEngineExtensionManager::loadExtension() und QWebEngineExtensionManager::unloadExtension().

[read-only] name : const QString

Diese Eigenschaft enthält die Beschreibung der Erweiterung.

Sie wird aus der Beschreibungseigenschaft der Manifestdatei der Erweiterung entnommen.

Leer, wenn das Laden fehlgeschlagen ist.

Zugriffsfunktionen:

QString name() const

[read-only] path : const QString

Diese Eigenschaft enthält den Installationspfad der Erweiterung.

Der Dateisystempfad, aus dem die Erweiterung geladen wurde.

Zugriffsfunktionen:

QString path() const

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