/**************************************************************************** ** ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). ** Contact: Qt Software Information (qt-info@nokia.com) ** ** This file is part of the documentation of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial Usage ** Licensees holding valid Qt Commercial licenses may use this file in ** accordance with the Qt Commercial License Agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Nokia. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain ** additional rights. These rights are described in the Nokia Qt LGPL ** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this ** package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** If you are unsure which license is appropriate for your use, please ** contact the sales department at qt-sales@nokia.com. ** $QT_END_LICENSE$ ** ****************************************************************************/ /*! \headerfile \title Macros for Defining Plugins \brief The header files defines macros for defining plugins. \sa {How to Create Qt Plugins} */ /*! \macro Q_DECLARE_INTERFACE(ClassName, Identifier) \relates This macro associates the given \a Identifier (a string literal) to the interface class called \a ClassName. The \a Identifier must be unique. For example: \snippet examples/tools/plugandpaint/interfaces.h 3 This macro is normally used right after the class definition for \a ClassName, in a header file. See the \l{tools/plugandpaint}{Plug & Paint} example for details. If you want to use Q_DECLARE_INTERFACE with interface classes declared in a namespace then you have to make sure the Q_DECLARE_INTERFACE is not inside a namespace though. For example: \snippet doc/src/snippets/code/doc_src_qplugin.qdoc 0 \sa Q_INTERFACES(), Q_EXPORT_PLUGIN2(), {How to Create Qt Plugins} */ /*! \macro Q_EXPORT_PLUGIN(ClassName) \relates \obsolete Use Q_EXPORT_PLUGIN2() instead. This macro is equivalent to Q_EXPORT_PLUGIN2(\a ClassName, \a ClassName). */ /*! \macro Q_EXPORT_PLUGIN2(PluginName, ClassName) \relates \since 4.1 \keyword Q_EXPORT_PLUGIN2 This macro exports the plugin class \a ClassName for the plugin specified by \a PluginName. The value of \a PluginName should correspond to the \l{qmake Variable Reference#TARGET}{TARGET} specified in the plugin's project file. There should be exactly one occurrence of this macro in the source code for a Qt plugin, and it should be used where the implementation is written rather than in a header file. Example: \snippet doc/src/snippets/code/doc_src_qplugin.qdoc 1 See the \l{tools/plugandpaint}{Plug & Paint} example for details. \sa Q_DECLARE_INTERFACE(), {How to Create Qt Plugins} */ /*! \macro Q_IMPORT_PLUGIN(PluginName) \relates This macro imports the plugin named \a PluginName, corresponding to the \l{qmake Variable Reference#TARGET}{TARGET} specified in the plugin's project file. Inserting this macro into your application's source code will allow you to make use of a static plugin. Example: \snippet doc/src/snippets/code/doc_src_qplugin.qdoc 2 Static plugins must also be included by the linker when your application is built. For Qt's predefined plugins, you can use the \c QTPLUGIN to add the required plugins to your build. For example: \snippet doc/src/snippets/code/doc_src_qplugin.qdoc 3 \sa {Static Plugins}, {How to Create Qt Plugins}, {Using qmake} */ /*! \macro Q_EXPORT_STATIC_PLUGIN(ClassName) \relates \internal */