QPluginLoader Class

Documentation des fonctions membres

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

Construit un chargeur de plugins avec l'adresse parent.

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

Construit un chargeur de plugin avec le fichier parent qui chargera le plugin spécifié par fileName.

Pour être chargeable, le suffixe du fichier doit être un suffixe valide pour une bibliothèque chargeable en fonction de la plateforme, par exemple .so sur Unix, - .dylib sur macOS et iOS, et .dll sur Windows. Le suffixe peut être vérifié avec QLibrary::isLibrary().

Voir également setFileName().

[virtual noexcept] QPluginLoader::~QPluginLoader()

Détruit l'objet QPluginLoader.

À moins que unload() n'ait été appelé explicitement, le plugin reste en mémoire jusqu'à ce que l'application se termine.

Voir aussi isLoaded() et unload().

QString QPluginLoader::errorString() const

Renvoie une chaîne de texte contenant la description de la dernière erreur survenue.

QObject *QPluginLoader::instance()

Renvoie l'objet composant racine du plugin. Le plugin est chargé si nécessaire. La fonction renvoie nullptr si le plugin n'a pas pu être chargé ou si l'objet composant racine n'a pas pu être instancié.

Si l'objet composant racine a été détruit, l'appel à cette fonction crée une nouvelle instance.

Le composant racine renvoyé par cette fonction n'est pas supprimé lorsque le site QPluginLoader est détruit. Si vous voulez vous assurer que le composant racine est supprimé, vous devez appeler unload() dès que vous n'avez plus besoin d'accéder au composant central. Lorsque la bibliothèque est finalement déchargée, le composant racine est automatiquement supprimé.

L'objet composant est un QObject. Utilisez qobject_cast() pour accéder aux interfaces qui vous intéressent.

Voir aussi load().

bool QPluginLoader::isLoaded() const

Renvoie true si le plugin est chargé, sinon renvoie false.

Voir aussi load().

bool QPluginLoader::load()

Charge le plugin et renvoie true si le plugin a été chargé avec succès ; sinon, renvoie false. Étant donné que instance() appelle toujours cette fonction avant de résoudre les symboles, il n'est pas nécessaire de l'appeler explicitement. Dans certaines situations, vous pouvez souhaiter que le plugin soit chargé à l'avance, auquel cas vous utiliserez cette fonction.

Voir aussi unload().

QJsonObject QPluginLoader::metaData() const

Renvoie les métadonnées de ce plugin. Les métadonnées sont des données spécifiées dans un format json en utilisant la macro Q_PLUGIN_METADATA() lors de la compilation du plugin.

Les métadonnées peuvent être interrogées de manière rapide et peu coûteuse sans avoir à charger le plugin. Cela permet, par exemple, d'y stocker les capacités du plugin et de faire dépendre la décision de charger ou non le plugin de ces métadonnées.

[static] QObjectList QPluginLoader::staticInstances()

Renvoie une liste d'instances statiques de plugins (composants racine) détenues par le chargeur de plugins.

Voir aussi staticPlugins().

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

Renvoie une liste de QStaticPlugins détenus par le chargeur de plugins. La fonction est similaire à staticInstances(), avec l'ajout qu'un QStaticPlugin contient également des informations sur les métadonnées.

Voir aussi staticInstances().

bool QPluginLoader::unload()

Décharge le plugin et renvoie true si le plugin a pu être déchargé ; sinon, renvoie false.

Cela se produit automatiquement à la fin de l'application, de sorte que vous ne devriez normalement pas avoir besoin d'appeler cette fonction.

Si d'autres instances de QPluginLoader utilisent le même plugin, l'appel échouera et le déchargement n'aura lieu que lorsque toutes les instances auront appelé unload().

N'essayez pas de supprimer le composant racine. Comptez plutôt sur le fait que unload() le supprimera automatiquement si nécessaire.

Voir aussi instance() et load().