QPluginLoader 类

成员函数文档

[显式] QPluginLoader::QPluginLoader(QObject *parent = nullptr)

使用给定的父对象构建一个插件加载器。

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

构造一个具有给定父对象的插件加载器，该插件加载器将加载由fileName指定的插件。

要加载，文件的扩展名必须符合平台中可加载库的有效扩展名，例如 Unix 上的 .so，macOS 和 iOS 上的 .dylib，以及 Windows 上的 .dll。可以使用 QLibrary::isLibrary() 验证扩展名。

另请参阅setFileName。

[虚函数 noexcept] QPluginLoader::~QPluginLoader()

销毁 QPluginLoader 对象。

除非显式调用unload()，否则插件将保持在内存中，直到应用程序终止。

另请参阅isLoaded() 和 unload。

QString QPluginLoader::errorString() const

返回最后发生的错误的描述性文本字符串。

QObject *QPluginLoader::instance()

返回插件的最大组件对象。如果需要，将加载插件。如果插件无法加载或根组件对象无法实例化，该函数返回 nullptr。

如果根组件对象已被销毁，调用此函数会创建一个新的实例。

由此函数返回的根组件在 QPluginLoader 销毁时不会被删除。如果想要确保根组件被删除，应该在不再需要访问核心组件之后立即调用 unload()。当库最终卸载时，根组件将自动被删除。

组件对象是一个 QObject。使用 qobject_cast() 访问您感兴趣的接口。

另请参阅 load

。

bool QPluginLoader::isLoaded() const

如果插件已加载，则返回 true；否则返回 false。

另请参阅 load

。

bool QPluginLoader::load()

加载插件并返回 true 表示插件已成功加载；否则返回 false。由于 instance() 总是在解析符号之前调用此函数，因此无需显式调用它。在某些情况下，您可能想要提前加载插件，在这种情况下，可以使用此函数。

另请参阅unload。

QJsonObject QPluginLoader::metaData() const

获取该插件的元数据。元数据是在编译插件时使用 Q_PLUGIN_METADATA() 宏指定的 json 格式数据。

可以快速且经济地查询元数据，而无需实际加载插件。这使得将插件的能力存储在其中，并根据这些元数据决定是否加载插件成为可能。

[静态] QObjectList QPluginLoader::staticInstances()

返回被插件加载器持有的静态插件实例（根组件）的列表。

另请参见 staticPlugins()。

[静态] QList<QStaticPlugin> QPluginLoader::staticPlugins()

返回插件加载器持有的 QStaticPlugins 列表。此函数与 staticInstances() 类似，但增加了 QStaticPlugin 还包含元数据信息的附加功能。

另请参见 staticInstances()。

bool QPluginLoader::unload()

卸载插件并返回 true（插件成功卸载）；否则返回 false。

在应用程序终止时会自动发生此操作，因此通常不需要调用此函数。

如果有其他实例的 QPluginLoader 使用相同的插件，将失败调用，只有在每个实例都调用电时卸载才会发生。

不要尝试删除根组件。相反，依靠 unload() 在需要时自动删除。

另请参见 instance() 和 load()。