QWebEngineExtensionManager Class
La clase QWebEngineExtensionManager permite a las aplicaciones instalar y cargar extensiones de Chrome desde el sistema de archivos. Más...
| Cabecera: | #include <QWebEngineExtensionManager> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Desde: | Qt 6.10 |
| Hereda: | QObject |
Propiedades
- extensions : QList<QWebEngineExtensionInfo>
- installPath : QString
Funciones públicas
| 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) |
Señales
| void | installFinished(const QWebEngineExtensionInfo &extension) |
| void | loadFinished(const QWebEngineExtensionInfo &extension) |
| void | uninstallFinished(const QWebEngineExtensionInfo &extension) |
| void | unloadFinished(const QWebEngineExtensionInfo &extension) |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *e) override |
Descripción Detallada
QWebEngineExtensionManager puede cargar o instalar extensiones de Chrome. Las extensiones se pueden cargar a través de loadExtension. Las extensiones cargadas de esta manera no son recordadas por el perfil asociado y tienen que ser cargadas manualmente en cada nueva sesión de navegación. Para conservar las extensiones entre sesiones de navegación, las aplicaciones pueden instalar extensiones comprimidas o descomprimidas a través de installExtension. En este caso, el gestor desempaquetará la extensión en el directorio del perfil y la cargará desde allí. Las extensiones instaladas se cargan siempre al inicio, una vez inicializado el perfil.
Puede acceder a las extensiones cargadas con extensions(), que proporciona una lista de QWebEngineExtensionInfo, o conectarse a las señales del gestor para recibir notificaciones sobre el estado de los procesos de carga o instalación.
Cada QWebEngineProfile tiene su propio QWebEngineExtensionManager, por lo que cada página que comparta el mismo perfil compartirá también las mismas extensiones. Las extensiones no pueden cargarse en perfiles off-the-record. Sin embargo, todos los perfiles, incluidos los off-the-record, contienen dos extensiones incorporadas y activadas por defecto: Google Hangouts y Chromium PDF. Estas pueden desactivarse y/o descargarse si se desea.
Nota: Sólo se admiten extensiones ManifestV3, otras versiones no se cargarán ni se instalarán.
Véase también QWebEngineProfile::extensionManager y QWebEngineExtensionInfo.
Documentación de propiedades
[read-only] extensions : QList<QWebEngineExtensionInfo>
Devuelve una lista de las extensiones cargadas.
Funciones de acceso:
| QList<QWebEngineExtensionInfo> | extensions() const |
Véase también QWebEngineExtensionInfo.
[read-only] installPath : QString
Devuelve la ruta del directorio donde están instaladas las extensiones.
Funciones de acceso:
| QString | installPath() const |
Véase también installExtension() y QWebEngineExtensionInfo::isInstalled().
Documentación de las funciones miembro
[override virtual protected] bool QWebEngineExtensionManager::event(QEvent *e)
Reimplementa: QObject::event(QEvent *e).
[invokable] void QWebEngineExtensionManager::installExtension(const QString &path)
Instala una extensión de path en el directorio del perfil y la carga.
La señal installFinished() se emite después de que se haya instalado una extensión o haya fallado la instalación. Si la instalación tuvo éxito QWebEngineExtensionInfo::isInstalled() devolverá true, de lo contrario QWebEngineExtensionInfo::error() contendrá información sobre cómo falló el proceso de instalación.
Las extensiones se cargan en estado desactivado después de que la instalación haya tenido éxito. Las extensiones instaladas se cargan automáticamente en cada inicio en estado desactivado. La ruta de instalación puede consultarse con installPath().
El instalador puede instalar extensiones comprimidas o descomprimidas. El parámetro path debe apuntar a un directorio o a un archivo zip que contenga el archivo de manifiesto de la extensión. Si falta el manifiesto en el directorio de nivel superior, el proceso de instalación se interrumpirá.
Si se instala una extensión ya cargada o instalada desde la misma ruta, se instalará una nueva extensión.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también QWebEngineExtensionInfo::isInstalled(), QWebEngineExtensionInfo::error(), y installPath().
[invokable] void QWebEngineExtensionManager::loadExtension(const QString &path)
Carga una extensión desempaquetada desde path.
La señal loadFinished() se emite cuando se carga una extensión o cuando la carga falla. Si la carga tuvo éxito QWebEngineExtensionInfo::isLoaded() devolverá true, de lo contrario QWebEngineExtensionInfo::error() contendrá información sobre el fallo en el proceso de carga.
Las extensiones siempre se cargan en estado deshabilitado, los usuarios tienen que habilitarlas manualmente. Si se carga una extensión ya cargada desde la misma ruta, se volverá a cargar la extensión.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
Véase también QWebEngineExtensionInfo::isLoaded() y 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)
Señales que se emiten cuando extension se carga, descarga, instala o desinstala.
[invokable] void QWebEngineExtensionManager::setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled)
Permite activar/desactivar extension en tiempo de ejecución.
El argumento enabled determina si la extensión debe activarse o desactivarse.
Nota: También es posible desactivar extensiones internas como Hangouts y PDF.
Nota: Esta función puede invocarse a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
Véase también QWebEngineExtensionInfo::isEnabled().
[invokable] void QWebEngineExtensionManager::uninstallExtension(const QWebEngineExtensionInfo &extension)
Desinstala la extensión extension.
Elimina los archivos de la extensión de la ruta de instalación y descarga la extensión. La señal uninstallFinished() se emite una vez finalizado el proceso.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también QWebEngineExtensionManager::installPath(), QWebEngineExtensionInfo::isInstalled(), y QWebEngineExtensionInfo::error().
[invokable] void QWebEngineExtensionManager::unloadExtension(const QWebEngineExtensionInfo &extension)
Descarga extension
Elimina todos los datos de la extensión de la memoria.
La señal unloadFinished() se emite una vez finalizado el proceso de descarga.
Nota: También es posible descargar extensiones internas como Hangouts y PDF, pero se cargarán en el siguiente inicio como otras extensiones instaladas.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
Véase también 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.
