QPluginLoader Class Reference

[QtCore module]

该QPluginLoader类加载插件在运行时。More…

继承QObject。

Methods

  • __init__ (self, QObject parent = None)
  • __init__ (self, QString fileName, QObject parent = None)
  • QString errorString (self)
  • QString fileName (self)
  • QObject instance (self)
  • bool isLoaded (self)
  • bool load (self)
  • QLibrary.LoadHints loadHints (self)
  • setFileName (self, QString fileName)
  • setLoadHints (self, QLibrary.LoadHints loadHints)
  • bool unload (self)

Static Methods

  • list-of-QObject staticInstances ()

Detailed Description

该QPluginLoader类加载插件在运行时。

QPluginLoader提供了访问Qt plugin。一个Qt的插件存储在一个共享库（一个DLL ），并在共享库提供这些好处利用访问QLibrary：

  • QPluginLoader checks that a plugin is linked against the same version of Qt as the application.
  • QPluginLoader provides direct access to a root component object (instance()), instead of forcing you to resolve a C function manually.

一个QPluginLoader对象的一个实例运行在一个单一的共享库文件，我们称之为一个插件。它提供了一个与平台无关的方式获得在插件的功能。要指定哪些插件加载，无论是在构造函数中传递一个文件名或将其设置setFileName（ ） 。

最重要的功能是load（ ）动态加载的插件文件，isLoaded（）来检查装载是否成功，并instance（ ）来访问插件的根组件。该instance（ ）函数隐式地尝试加载该插件，如果它没有被加载。 QPluginLoader的多个实例可以被用于访问同一物理插件。

一旦加载，插件保留在内存中，直到QPluginLoader的所有实例已被卸载，或直到应用程序终止。你可以尝试使用卸载插件unload（ ） ，但如果QPluginLoader的其他实例都使用相同的库，则调用将失败，并卸载当每一个实例都调用才会发生unload（ ） 。权利之前卸载发生，根组件也将被删除。

为了加快加载和插件验证，某些被装载过程中收集的信息被缓存在持久性存储器（通过QSettings） 。举例来说，一个负荷运算的结果（例如，成功或失败）被存储在高速缓存中，这样，后续的加载操作不尝试加载一个无效的插件。但是，如果一个插件的“最后修改”时间戳已经改变，该插件的缓存项失效，并不管值的插件重新加载缓存中的条目。缓存条目，然后更新了负载运行的新的结果。

这也意味着，时间戳必须在插件或任何依赖资源（如共享库）被更新，每次更新，因为依赖的资源可能会影响加载插件的结果。

See How to Create Qt Plugins关于如何通过插件使你的应用程序扩展的信息。

请注意， QPluginLoader不能使用，如果你的应用程序是针对Qt的静态链接。在这种情况下，你也将有静态链接到插件。您可以使用QLibrary如果你需要在一个静态链接的应用程序加载动态库。

Note:在Symbian插件存根文件，必须使用时的路径插件是必要的。对于加载的插件的目的，存根可被认为具有相同的名称作为实际插件二进制文件。在实践中，他们有“ 。 QTPLUGIN ”扩展名，而不是“ DLL” ，但这种差异是由QPluginLoader透明处理和QLibrary避免需要特殊的Symbian处理插件，在大多数Qt应用程序。需要插件的存根，因为Symbian平台安全性拒绝所有访问在实际的插件二进制文件所在的目录。

Method Documentation

  1. QPluginLoader.__init__ (self, QObject parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个插件加载给定的parent。

  1. QPluginLoader.__init__ (self, QString fileName, QObject parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个插件加载给定的parent可以加载指定的插件fileName。

要加载，文件的后缀必须是一个可加载的库的有效后缀按照平台，如.so在Unix上， - .dylib在Mac OS X ，和.dll在Windows上。后缀可以与验证QLibrary.isLibrary（ ） 。

注：在Symbian的fileName必须指向插件存根文件。

See also setFileName（ ） 。

  1. QString QPluginLoader.errorString (self)

返回与上次发生错误的描述文本字符串。

这个函数中引入了Qt 4.2中。

  1. QString QPluginLoader.fileName (self)
  1. QObject QPluginLoader.instance (self)

[

返回插件的根组件对象。如有必要，该插件被加载。该函数返回0，如果插件无法加载或如果根组件对象不能被实例化。

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

]($docs-qobject.html)

根组件，该函数的返回，不会被删除时，QPluginLoader被破坏。如果你想确保根组件被删除，你应该调用unload（ ）只要您不必再访问核心组件。当库最后卸载，根组件将被自动删除。

该组件对象是QObject。使用qobject_cast（ ）来访问您感兴趣的接口

See also load（ ） 。

  1. bool QPluginLoader.isLoaded (self)

返回True如果该插件被加载，否则返回False 。

See also load（ ） 。

  1. bool QPluginLoader.load (self)

加载插件，如果已成功加载的插件返回True，否则返回False 。自instance（ ）解决，没有必要显式调用它的任何符号前总是调用这个函数。在某些情况下，您可能想预先加载的插件，你会在这种情况下使用此功能。

See also unload（ ） 。

  1. QLibrary.LoadHints QPluginLoader.loadHints (self)

[

  1. QPluginLoader.setFileName (self, QString fileName)
  1. QPluginLoader.setLoadHints (self, QLibrary.LoadHints loadHints)
  1. list-of-QObject QPluginLoader.staticInstances ()

返回静态插件实例（根组件）本插件加载持有的一份名单。

  1. bool QPluginLoader.unload (self)

卸载插件，如果插件可以卸载返回True，否则返回False 。

出现这种情况自动终止应用程序，所以你通常不应需要调用这个函数。

]($docs-index.htm)

如果其它实例QPluginLoader使用相同的插件，则调用将失败，并卸载只会发生在每一个实例都调用unload （ ） 。

不要试图删除根组件。而不是依赖于卸载（ ）在需要时会自动将其删除。

See also instance（）和load（ ） 。