LeechCraft  %{LEECHCRAFT_VERSION}
Modular cross-platform feature rich live environment.
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Pages
ipluginsmanager.h
Go to the documentation of this file.
1 /**********************************************************************
2  * LeechCraft - modular cross-platform feature rich internet client.
3  * Copyright (C) 2006-2013 Georg Rudoy
4  *
5  * Boost Software License - Version 1.0 - August 17th, 2003
6  *
7  * Permission is hereby granted, free of charge, to any person or organization
8  * obtaining a copy of the software and accompanying documentation covered by
9  * this license (the "Software") to use, reproduce, display, distribute,
10  * execute, and transmit the Software, and to prepare derivative works of the
11  * Software, and to permit third-parties to whom the Software is furnished to
12  * do so, all subject to the following:
13  *
14  * The copyright notices in the Software and this entire statement, including
15  * the above license grant, this restriction and the following disclaimer,
16  * must be included in all copies of the Software, in whole or in part, and
17  * all derivative works of the Software, unless such copies or derivative
18  * works are solely in the form of machine-executable object code generated by
19  * a source language processor.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
24  * SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
25  * FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27  * DEALINGS IN THE SOFTWARE.
28  **********************************************************************/
29 
30 #ifndef INTERFACES_CORE_IPLUGINSMANAGER_H
31 #define INTERFACES_CORE_IPLUGINSMANAGER_H
32 #include <QStringList>
33 #include <QObjectList>
34 
49 class Q_DECL_EXPORT IPluginsManager
50 {
51 public:
52  virtual ~IPluginsManager () {}
53 
58  virtual QObjectList GetAllPlugins () const = 0;
59 
69  template<typename T> QObjectList Filter (QObjectList source) const
70  {
71  QObjectList result;
72  Q_FOREACH (QObject *sp, source)
73  if (qobject_cast<T> (sp))
74  result << sp;
75  return result;
76  }
77 
87  template<typename T> QObjectList GetAllCastableRoots () const
88  {
89  return Filter<T> (GetAllPlugins ());
90  }
91 
103  template<typename T> QList<T> GetAllCastableTo () const
104  {
105  QObjectList roots = GetAllCastableRoots<T> ();
106  QList<T> result;
107  Q_FOREACH (QObject *root, roots)
108  result << qobject_cast<T> (root);
109  return result;
110  }
111 
120  virtual QObject* GetPluginByID (const QByteArray& id) const = 0;
121 
137  virtual QString GetPluginLibraryPath (const QObject* object) const = 0;
138 
150  virtual void InjectPlugin (QObject *object) = 0;
151 
167  virtual void ReleasePlugin (QObject *object) = 0;
168 
176  virtual QObject* GetQObject () = 0;
177 };
178 
179 Q_DECLARE_INTERFACE (IPluginsManager, "org.Deviant.LeechCraft.IPluginsManager/1.0");
180 
181 #endif
QList< T > GetAllCastableTo() const
Similar to GetAlLCastableRoots() and provided for convenience.
Q_DECLARE_INTERFACE(IColorThemeManager,"org.Deviant.LeechCraft.IColorThemeManager/1.0")
QObjectList GetAllCastableRoots() const
This is the same as Filter&lt;T&gt; (GetAllPlugins()).
This interface is used to represent LeechCraft&#39;s global plugin manager.
virtual ~IPluginsManager()
QObjectList Filter(QObjectList source) const
Filters the given list of plugins and returns only those that can be casted to the given template typ...