QPluginLoader Class

Documentation des fonctions membres

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

Crée un chargeur de plugins à partir de l'parent on fournie.

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

Crée un chargeur de plugin avec l'parent fournie, qui chargera le plugin spécifié par fileName.

Pour pouvoir être chargé, l’extension du fichier doit être une extension valide pour une bibliothèque chargeable, conformément à la plate-forme, par exemple .so sous Unix, - .dylib sous macOS et iOS, et .dll sous Windows. L’extension peut être vérifiée à l’aide de la fonction QLibrary::isLibrary().

Voir également setFileName().

[virtual noexcept] QPluginLoader::~QPluginLoader()

Supprime l'objet ` QPluginLoader `.

À moins que la fonction ` unload()` n'ait été appelée explicitement, le plugin reste en mémoire jusqu'à la fermeture de l'application.

Voir également isLoaded() et unload().

QString QPluginLoader::errorString() const

Renvoie une chaîne de caractères 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 de cette fonction crée une nouvelle instance.

Le composant racine, renvoyé par cette fonction, n’est pas supprimé lorsque l’ QPluginLoader est détruit. Si vous souhaitez 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 principal. Lorsque la bibliothèque est finalement déchargée, le composant racine sera automatiquement supprimé.

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

Voir également 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 chargement s'est déroulé avec succès ; sinon, renvoie ` false`. Étant donné que ` instance()` appelle toujours cette fonction avant de résoudre tout symbole, il n'est pas nécessaire de l'appeler explicitement. Dans certaines situations, vous pouvez souhaiter que le plugin soit chargé à l'avance ; dans ce cas, vous utiliserez cette fonction.

Voir également unload().

QJsonObject QPluginLoader::metaData() const

Renvoie les métadonnées de ce plugin. Ces métadonnées sont des données spécifiées au format JSON à l'aide de la macro Q_PLUGIN_METADATA() lors de la compilation du plugin.

Ces 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 décider, en fonction de ces métadonnées, s’il convient ou non de charger le plugin.

[static] QObjectList QPluginLoader::staticInstances()

Renvoie une liste des instances de plugins statiques (composants racines) gérées par le chargeur de plugins.

Voir aussi staticPlugins().

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

Renvoie une liste des objets `QStaticPlugins` gérés par le chargeur de plugins. Cette fonction est similaire à ` staticInstances()` à cette différence près qu’un objet ` QStaticPlugin ` contient également des métadonnées.

Voir également staticInstances().

bool QPluginLoader::unload()

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

Cette opération s'effectue automatiquement à la fermeture de l'application ; vous ne devriez donc 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 la fonction unload() le supprimera automatiquement lorsque cela sera nécessaire.

Voir également ` instance()` et ` load()`.