QWebEngineExtensionManager Class
La classe QWebEngineExtensionManager permet aux applications d'installer et de charger des extensions Chrome à partir du système de fichiers. Plus d'informations...
| En-tête : | #include <QWebEngineExtensionManager> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake : | QT += webenginecore |
| Depuis : | Qt 6.10 |
| Hérite : | QObject |
Propriétés
- extensions : QList<QWebEngineExtensionInfo>
- installPath : QString
Fonctions publiques
| 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) |
Signaux
| void | installFinished(const QWebEngineExtensionInfo &extension) |
| void | loadFinished(const QWebEngineExtensionInfo &extension) |
| void | uninstallFinished(const QWebEngineExtensionInfo &extension) |
| void | unloadFinished(const QWebEngineExtensionInfo &extension) |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *e) override |
Description détaillée
QWebEngineExtensionManager permet de charger ou d'installer des extensions Chrome. Les extensions peuvent être chargées via loadExtension. Les extensions chargées de cette manière ne sont pas mémorisées par le profil associé et doivent être chargées manuellement à chaque nouvelle session de navigation. Pour préserver les extensions entre les sessions de navigation, les applications peuvent installer des extensions zippées ou décompressées via installExtension. Dans ce cas, le gestionnaire décompressera l'extension dans le répertoire du profil et la chargera à partir de là. Les extensions installées sont toujours chargées au démarrage, après l'initialisation du profil.
Vous pouvez accéder aux extensions chargées avec extensions() qui fournit une liste de QWebEngineExtensionInfo, ou vous connecter aux signaux du gestionnaire pour être informé de l'état des processus de chargement ou d'installation.
Chaque QWebEngineProfile a son propre QWebEngineExtensionManager, donc chaque page qui partage le même profil partagera aussi les mêmes extensions. Les extensions ne peuvent pas être chargées dans des profils non enregistrés. Cependant, tous les profils, y compris ceux qui ne sont pas enregistrés, contiennent deux extensions intégrées et activées par défaut : Google Hangouts et Chromium PDF. Celles-ci peuvent être désactivées et/ou déchargées si vous le souhaitez.
Note : Seules les extensions ManifestV3 sont prises en charge, les autres versions ne seront ni chargées ni installées.
Voir aussi QWebEngineProfile::extensionManager et QWebEngineExtensionInfo.
Documentation sur les propriétés
[read-only] extensions : QList<QWebEngineExtensionInfo>
Renvoie une liste des extensions chargées.
Fonctions d'accès :
| QList<QWebEngineExtensionInfo> | extensions() const |
Voir aussi QWebEngineExtensionInfo.
[read-only] installPath : QString
Renvoie le chemin du répertoire où les extensions sont installées.
Fonctions d'accès :
| QString | installPath() const |
Voir aussi installExtension() et QWebEngineExtensionInfo::isInstalled().
Documentation des fonctions membres
[override virtual protected] bool QWebEngineExtensionManager::event(QEvent *e)
Réimplémente : QObject::event(QEvent *e).
[invokable] void QWebEngineExtensionManager::installExtension(const QString &path)
Installe une extension de path dans le répertoire du profil et la charge.
Le signal installFinished() est émis après l'installation d'une extension ou après l'échec de l'installation. Si l'installation a réussi, QWebEngineExtensionInfo::isInstalled() renvoie true, sinon QWebEngineExtensionInfo::error() contient des informations sur l'échec du processus d'installation.
Les extensions sont chargées dans un état désactivé après que l'installation a réussi. Les extensions installées sont automatiquement chargées à chaque démarrage en mode désactivé. Le chemin d'installation peut être demandé avec installPath().
Le programme d'installation est capable d'installer des extensions zippées ou décompressées. Le paramètre path doit pointer vers un répertoire ou un fichier zip contenant le fichier manifeste de l'extension. Si le manifeste n'est pas présent dans le répertoire de premier niveau, le processus d'installation est interrompu.
L'installation d'une extension déjà chargée ou installée à partir du même chemin entraînera l'installation d'une nouvelle extension.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QWebEngineExtensionInfo::isInstalled(), QWebEngineExtensionInfo::error() et installPath().
[invokable] void QWebEngineExtensionManager::loadExtension(const QString &path)
Charge une extension décompressée à partir de path.
Le signal loadFinished() est émis lorsqu'une extension est chargée ou lorsque le chargement a échoué. Si le chargement a réussi, QWebEngineExtensionInfo::isLoaded() renvoie true, sinon QWebEngineExtensionInfo::error() contient des informations sur l'échec du processus de chargement.
Les extensions sont toujours chargées dans un état désactivé, les utilisateurs doivent les activer manuellement. Le chargement d'une extension déjà chargée à partir du même chemin entraînera le rechargement de l'extension.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QWebEngineExtensionInfo::isLoaded() et QWebEngineExtensionInfo::error().
[signal] void QWebEngineExtensionManager::loadFinished(const QWebEngineExtensionInfo &extension)
[signal] void QWebEngineExtensionManager::installFinished(const QWebEngineExtensionInfo &extension)
[signal] void QWebEngineExtensionManager::unloadFinished(const QWebEngineExtensionInfo &extension)
[signal] void QWebEngineExtensionManager::uninstallFinished(const QWebEngineExtensionInfo &extension)
Signaux émis lorsque extension est chargé, déchargé, installé ou désinstallé.
[invokable] void QWebEngineExtensionManager::setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled)
Permet d'activer ou de désactiver l'extension extension au moment de l'exécution.
L'argument enabled détermine si l'extension doit être activée ou désactivée.
Remarque : il est également possible de désactiver des extensions internes telles que Hangouts et PDF.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QWebEngineExtensionInfo::isEnabled().
[invokable] void QWebEngineExtensionManager::uninstallExtension(const QWebEngineExtensionInfo &extension)
Désinstalle le site extension.
Supprime les fichiers de l'extension du chemin d'installation et décharge l'extension. Le signal uninstallFinished() est émis lorsque le processus est terminé.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QWebEngineExtensionManager::installPath(), QWebEngineExtensionInfo::isInstalled() et QWebEngineExtensionInfo::error().
[invokable] void QWebEngineExtensionManager::unloadExtension(const QWebEngineExtensionInfo &extension)
Décharge l'extension extension
Supprime toutes les données de l'extension de la mémoire.
Le signal unloadFinished() est émis une fois le processus de déchargement terminé.
Remarque : il est également possible de décharger des extensions internes telles que Hangouts et PDF, mais elles seront chargées au prochain démarrage comme les autres extensions installées.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QWebEngineExtensionInfo::isLoaded().
© 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.
