summaryrefslogtreecommitdiffstats
path: root/src/declarative/qml/qmlmoduleplugin.cpp
blob: 342074a340faeb27319bece9078a7b84507ed433 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the QtDeclarative module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** 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.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/

#include "qmlmoduleplugin.h"
#include "qstringlist.h"

QT_BEGIN_NAMESPACE

/*!
    \class QmlModulePlugin
  \since 4.7
    \brief The QmlModulePlugin class provides an abstract base for custom QML module plugins.
    \reentrant
    \ingroup plugins

    The QML module plugin is a simple plugin interface that makes it
    easy to add custom QML modules that can be loaded dynamically
    into applications.

    Writing a QML module plugin is achieved by subclassing this base
    class, reimplementing the pure virtual function keys(), and
    exporting the class with the Q_EXPORT_PLUGIN2() macro. See \l{How
    to Create Qt Plugins} for details.

    The strings returned by keys() should be the list of URIs of modules
    that the plugin registers.

    The plugin should register QML types with qmlRegisterType() when the
    defineModule() method is called.

    See the example in \c{examples/declarative/plugins}.
*/

/*!
    Constructs a QML module plugin with the given \a parent. This is
    invoked automatically by the Q_EXPORT_PLUGIN2() macro.
*/
QmlModulePlugin::QmlModulePlugin(QObject *parent)
    : QObject(parent)
{
}

/*!
    Destroys the QML module plugin.

    You never have to call this explicitly. Qt destroys a plugin
    automatically when it is no longer used.
*/
QmlModulePlugin::~QmlModulePlugin()
{
}

/*!
    \fn void QmlModulePlugin::defineModule(const QString& uri)

    Subclasses must override this function to register types
    of the module \a uri, which will be one of the strings returned by keys().

    The plugin registers QML types with qmlRegisterType():

    \code
        qmlRegisterType<MyClass>("com.nokia.MyModule", 1, 0, "MyType", "MyClass");
    \endcode
*/

void QmlModulePlugin::defineModuleOnce(const QString& uri)
{ 
    if (!defined.contains(uri)) {
        defined += uri;
        defineModule(uri);
    }
}

QT_END_NAMESPACE