QPluginLoader Class

Documentación de funciones miembro

[explicit] QPluginLoader::QPluginLoader(QObject *parent = nullptr)

Construye un cargador de complementos con la dirección parent.

[explicit] QPluginLoader::QPluginLoader(const QString &fileName, QObject *parent = nullptr)

Construye un cargador de complementos con el parent dado que cargará el complemento especificado por fileName.

Para ser cargable, el sufijo del archivo debe ser un sufijo válido para una biblioteca cargable de acuerdo con la plataforma, por ejemplo .so en Unix, - .dylib en macOS e iOS, y .dll en Windows. El sufijo puede verificarse con QLibrary::isLibrary().

Véase también setFileName().

[virtual noexcept] QPluginLoader::~QPluginLoader()

Destruye el objeto QPluginLoader.

A menos que se haya llamado explícitamente a unload(), el complemento permanecerá en memoria hasta que finalice la aplicación.

Véase también isLoaded() y unload().

QString QPluginLoader::errorString() const

Devuelve una cadena de texto con la descripción del último error que se ha producido.

QObject *QPluginLoader::instance()

Devuelve el objeto componente raíz del plugin. El complemento se carga si es necesario. La función devuelve nullptr si no se ha podido cargar el complemento o si no se ha podido instanciar el objeto componente raíz.

Si el objeto componente raíz fue destruido, al llamar a esta función se crea una nueva instancia.

El componente raíz, devuelto por esta función, no se elimina cuando se destruye QPluginLoader. Si desea asegurarse de que el componente raíz se elimina, debe llamar a unload() en cuanto ya no necesite acceder al componente raíz. Cuando la biblioteca se descargue finalmente, el componente raíz se borrará automáticamente.

El objeto componente es un QObject. Utilice qobject_cast() para acceder a las interfaces que le interesen.

Véase también load().

bool QPluginLoader::isLoaded() const

Devuelve true si el plugin está cargado; en caso contrario devuelve false.

Véase también load().

bool QPluginLoader::load()

Carga el complemento y devuelve true si el complemento se ha cargado correctamente; en caso contrario devuelve false. Dado que instance() siempre llama a esta función antes de resolver cualquier símbolo, no es necesario llamarla explícitamente. En algunas situaciones puede que quieras que el plugin se cargue por adelantado, en cuyo caso utilizarías esta función.

Véase también unload().

QJsonObject QPluginLoader::metaData() const

Devuelve los metadatos de este complemento. Los metadatos son datos especificados en formato json utilizando la macro Q_PLUGIN_METADATA() al compilar el complemento.

Los metadatos pueden consultarse de forma rápida y económica sin necesidad de cargar el complemento. Esto hace posible, por ejemplo, almacenar las capacidades del complemento, y hacer que la decisión de cargar o no el complemento dependa de estos metadatos.

[static] QObjectList QPluginLoader::staticInstances()

Devuelve una lista de instancias de plugins estáticos (componentes raíz) mantenidos por el cargador de plugins.

Véase también staticPlugins().

[static] QList<QStaticPlugin> QPluginLoader::staticPlugins()

Devuelve una lista de QStaticPlugins mantenidos por el cargador de plugins. La función es similar a staticInstances() con el añadido de que QStaticPlugin también contiene información de metadatos.

Véase también staticInstances().

bool QPluginLoader::unload()

Descarga el complemento y devuelve true si el complemento pudo ser descargado; en caso contrario devuelve false.

Esto ocurre automáticamente al finalizar la aplicación, por lo que normalmente no debería ser necesario llamar a esta función.

Si otras instancias de QPluginLoader están utilizando el mismo plugin, la llamada fallará, y la descarga sólo se producirá cuando todas las instancias hayan llamado a unload().

No intentes borrar el componente raíz. En su lugar confía en que unload() lo borrará automáticamente cuando sea necesario.

Véase también instance() y load().