The QScriptExtensionPlugin class provides an abstract base for custom QScript extension plugins. More...
#include <QScriptExtensionPlugin>
Inherits: QObject.
This class was introduced in Qt 4.3.
QScriptExtensionPlugin ( QObject * parent = 0 ) | |
~QScriptExtensionPlugin () | |
QScriptValue | setupPackage ( const QString & key, QScriptEngine * engine ) const |
virtual void | initialize ( const QString & key, QScriptEngine * engine ) = 0 |
virtual QStringList | keys () const = 0 |
The QScriptExtensionPlugin class provides an abstract base for custom QScript extension plugins.
QScriptExtensionPlugin is a plugin interface that makes it possible to offer extensions that can be loaded dynamically into applications using the QScriptEngine class.
Writing a script extension plugin is achieved by subclassing this base class, reimplementing the pure virtual keys() and initialize() functions, and exporting the class using the Q_EXPORT_PLUGIN2() macro. See How to Create Qt Plugins for details.
See also QScriptEngine::importExtension() and Creating QtScript Extensions.
Constructs a script extension plugin with the given parent.
Note that this constructor is invoked automatically by the Q_EXPORT_PLUGIN2() macro, so there is no need for calling it explicitly.
Destroys the script extension plugin.
Note that Qt destroys a plugin automatically when it is no longer used, so there is no need for calling the destructor explicitly.
Initializes the extension specified by key in the given engine. The key must come from the set of keys().
See also keys().
Returns the list of keys this plugin supports.
These keys are usually the names of the "modules" or "packages" that are implemented in the plugin (e.g. com.mycompany.MyProduct).
See also initialize().
This function is provided for convenience when reimplementing initialize(). It splits the given key on '.' (dot), and ensures that there's a corresponding path of objects in the environment of the given engine, creating new objects to complete the path if necessary. E.g. if the key is "com.trolltech", after the call to setupPackage() the script expression com.trolltech will evaluate to an object. More specifically, the engine's Global Object will have a property called "com", which in turn has a property called "trolltech".
Use this function to avoid global namespace pollution when installing your extensions in the engine.
See also initialize().
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document 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.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.