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
|
/****************************************************************************
**
** 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
\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
|
