qxplugin.h

浏览该文件的文档.

 
#ifndef QXPLUGIN_H
#define QXPLUGIN_H
 
#include "qxplugin_global.h"
 
#include <QtCore/QObject>
 
QX_PLUGIN_BEGIN_NAMESPACE
 
class QxPluginContext;
 
class QX_PLUGIN_EXPORT QxPlugin : public QObject
{
    Q_OBJECT
    friend class QxPluginManager;
public:
    explicit QxPlugin(QObject *parent = Q_NULLPTR);
    ~QxPlugin() override;
 
    virtual bool initialize(QxPluginContext *context, QString *errorString) = 0;
 
    virtual void extensionsInitialized();
 
    virtual void shutdown();
 
    virtual int interfaceVersion() const;
 
    QxPluginContext *context() const;
protected:
    QxPluginContext *m_context = Q_NULLPTR;
};
 
QX_PLUGIN_END_NAMESPACE
 
// No Q_DECLARE_INTERFACE here, deliberately: QxPlugin is a QObject subclass, not
// a pure interface, so qobject_cast falls back to the meta-object chain and works
// at any inheritance depth. Declaring it as a Qt interface would instead route
// qobject_cast through qt_metacast(IID), which only succeeds for a class that
// lists Q_INTERFACES(QxPlugin) itself - and moc does not inherit that list, so
// every plugin written the documented way would load but never cast. What ties
// a plugin to this library is the IID in its Q_PLUGIN_METADATA, which is what
// QPluginLoader and the manager check.
 
#endif   // QXPLUGIN_H