QWebEngineExtensionManager Class
Die Klasse QWebEngineExtensionManager ermöglicht Anwendungen die Installation und das Laden von Chrome-Erweiterungen aus dem Dateisystem. Mehr...
| Kopfzeile: | #include <QWebEngineExtensionManager> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Seit: | Qt 6.10 |
| Vererbt: | QObject |
Eigenschaften
- extensions : const QList<QWebEngineExtensionInfo>
- installPath : const QString
Öffentliche Funktionen
| QList<QWebEngineExtensionInfo> | extensions() const |
| void | installExtension(const QString &path) |
| QString | installPath() const |
| void | loadExtension(const QString &path) |
| void | setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled) |
| void | uninstallExtension(const QWebEngineExtensionInfo &extension) |
| void | unloadExtension(const QWebEngineExtensionInfo &extension) |
Reimplementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
Detaillierte Beschreibung
QWebEngineExtensionManager kann Chrome-Erweiterungen laden oder installieren. Erweiterungen können über loadExtension geladen werden. Erweiterungen, die auf diese Weise geladen werden, werden nicht vom zugehörigen Profil gespeichert und müssen bei jeder neuen Browsing-Sitzung manuell geladen werden. Um Erweiterungen zwischen Browsing-Sitzungen zu erhalten, können Anwendungen gezippte oder entpackte Erweiterungen über installExtension installieren. In diesem Fall entpackt der Manager die Erweiterung in das Verzeichnis des Profils und lädt sie von dort. Installierte Erweiterungen werden immer beim Starten geladen, nachdem das Profil initialisiert wurde.
Sie können auf die geladenen Erweiterungen mit extensions() zugreifen, das eine Liste von QWebEngineExtensionInfo bereitstellt, oder sich mit den Signalen des Managers verbinden, um über den Status der Lade- oder Installationsprozesse informiert zu werden.
Jede QWebEngineProfile hat ihre eigene QWebEngineExtensionManager, so dass jede Seite, die das gleiche Profil verwendet, auch die gleichen Erweiterungen verwendet. Erweiterungen können nicht in Off-the-Record-Profile geladen werden.
Hinweis: Es werden nur ManifestV3-Erweiterungen unterstützt, andere Versionen werden weder geladen noch installiert.
Siehe auch QWebEngineProfile::extensionManager und QWebEngineExtensionInfo.
Dokumentation der Eigenschaften
[read-only] extensions : const QList<QWebEngineExtensionInfo>
Gibt eine Liste der geladenen Erweiterungen zurück.
Zugriffsfunktionen:
| QList<QWebEngineExtensionInfo> | extensions() const |
Siehe auch QWebEngineExtensionInfo.
[read-only] installPath : const QString
Gibt den Pfad des Verzeichnisses zurück, in dem die Erweiterungen installiert sind.
Zugriffsfunktionen:
| QString | installPath() const |
Siehe auch installExtension() und QWebEngineExtensionInfo::isInstalled().
Dokumentation der Mitgliedsfunktionen
[override virtual protected] bool QWebEngineExtensionManager::event(QEvent *e)
Reimplements: QObject::event(QEvent *e).
[invokable] void QWebEngineExtensionManager::installExtension(const QString &path)
Installiert eine Erweiterung von path in das Verzeichnis des Profils und lädt sie
Das Signal QWebEngineExtensionManager::installFinished wird ausgegeben, nachdem eine Erweiterung installiert wurde oder die Installation fehlgeschlagen ist. Wenn die Installation erfolgreich war, gibt QWebEngineExtensionInfo::isInstalled() den Wert true zurück, andernfalls enthält QWebEngineExtensionInfo::error() die Information, dass der Installationsprozess fehlgeschlagen ist.
Erweiterungen werden im deaktivierten Zustand geladen, nachdem die Installation erfolgreich war. Installierte Erweiterungen werden bei jedem Neustart automatisch im deaktivierten Zustand geladen. Der Installationspfad kann mit installPath() abgefragt werden.
Der Installer ist in der Lage, gepackte oder ungepackte Erweiterungen zu installieren. Der Parameter path sollte auf ein Verzeichnis oder eine Zip-Datei verweisen, die die Manifestdatei der Erweiterung enthält. Wenn das Manifest im obersten Verzeichnis fehlt, wird der Installationsprozess abgebrochen.
Wird eine bereits geladene oder installierte Erweiterung aus dem gleichen Pfad installiert, wird eine neue Erweiterung installiert.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWebEngineExtensionInfo::isInstalled(), QWebEngineExtensionInfo::error(), und installPath().
[invokable] void QWebEngineExtensionManager::loadExtension(const QString &path)
Lädt eine entpackte Erweiterung von path
Das Signal QWebEngineExtensionManager::loadFinished wird ausgegeben, wenn eine Erweiterung geladen wurde oder der Ladevorgang fehlgeschlagen ist. Wenn das Laden erfolgreich war, gibt QWebEngineExtensionInfo::isLoaded() true zurück, andernfalls enthält QWebEngineExtensionInfo::error() die Information, dass der Ladevorgang fehlgeschlagen ist.
Erweiterungen werden immer im deaktivierten Zustand geladen, der Benutzer muss sie manuell aktivieren. Das Laden einer bereits geladenen Erweiterung aus dem gleichen Pfad lädt die Erweiterung erneut.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWebEngineExtensionInfo::isLoaded() und QWebEngineExtensionInfo::error().
[invokable] void QWebEngineExtensionManager::setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled)
Ermöglicht die Aktivierung/Deaktivierung von extension zur Laufzeit.
Das Argument enabled bestimmt, ob die Erweiterung aktiviert oder deaktiviert werden soll.
Hinweis: Es ist auch möglich, interne Erweiterungen wie Hangouts und PDF zu deaktivieren.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWebEngineExtensionInfo::isEnabled().
[invokable] void QWebEngineExtensionManager::uninstallExtension(const QWebEngineExtensionInfo &extension)
Deinstalliert die extension
Entfernt die Dateien der Erweiterung aus dem Installationspfad und entlädt die Erweiterung. Das Signal QWebEngineExtensionManager::uninstallFinished wird nach Abschluss des Prozesses ausgegeben.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWebEngineExtensionManager::installPath(), QWebEngineExtensionInfo::isInstalled(), und QWebEngineExtensionInfo::error().
[invokable] void QWebEngineExtensionManager::unloadExtension(const QWebEngineExtensionInfo &extension)
Entlädt die extension
Entfernt alle Daten der Erweiterung aus dem Speicher.
Das Signal QWebEngineExtensionManager::unloadFinished wird ausgegeben, nachdem der Entladevorgang abgeschlossen ist.
Hinweis: Es ist auch möglich, interne Erweiterungen wie Hangouts und PDF zu entladen, aber sie werden beim nächsten Start wie andere installierte Erweiterungen geladen.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch QWebEngineExtensionInfo::isLoaded().
© 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.
