QPluginLoader Class

成员函数文档

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

用给定的parent 构建插件加载器。

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

使用给定的parent 构建插件加载器，加载fileName 指定的插件。

要实现可加载，文件的后缀必须是与平台相关的可加载库的有效后缀，例如，Unix 上为.so ，- macOS 和 iOS 上为.dylib ，Windows 上为.dll 。后缀可通过QLibrary::isLibrary() 验证。

另请参见 setFileName() 。

[virtual 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 格式指定的数据。

元数据可以在不实际加载插件的情况下以快速、低成本的方式进行查询。这样就可以存储插件的功能，并根据这些元数据决定是否加载插件。

[static] QObjectList QPluginLoader::staticInstances()

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

另请参见 staticPlugins()。

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

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

另请参见 staticInstances()。

bool QPluginLoader::unload()

卸载插件，如果插件可以卸载，则返回true ；否则返回false 。

卸载会在应用程序终止时自动进行，因此通常不需要调用此函数。

如果QPluginLoader 的其他实例正在使用同一个插件，则调用将失败，只有当每个实例都调用 unload() 后，才会卸载。

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

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