-rw-r--r-- | libopie2/opieui/opluginconfig.h | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/libopie2/opieui/opluginconfig.h b/libopie2/opieui/opluginconfig.h index c4f7213..59b63ef 100644 --- a/libopie2/opieui/opluginconfig.h +++ b/libopie2/opieui/opluginconfig.h | |||
@@ -1,85 +1,86 @@ | |||
1 | /* | 1 | /* |
2 | * LGPLv2 zecke@handhelds.org | 2 | * LGPLv2 zecke@handhelds.org |
3 | */ | 3 | */ |
4 | #ifndef ODP_OPIE_UI_OPLUGIN_CONFIG_H | 4 | #ifndef ODP_OPIE_UI_OPLUGIN_CONFIG_H |
5 | #define ODP_OPIE_UI_OPLUGIN_CONFIG_H | 5 | #define ODP_OPIE_UI_OPLUGIN_CONFIG_H |
6 | 6 | ||
7 | #include <qwidget.h> | 7 | #include <qwidget.h> |
8 | 8 | ||
9 | namespace Opie { | 9 | namespace Opie { |
10 | namespace Core { | 10 | namespace Core { |
11 | class OPluginManager; | 11 | class OPluginManager; |
12 | class OGenericPluginLoader; | 12 | class OGenericPluginLoader; |
13 | } | 13 | } |
14 | namespace Ui { | 14 | namespace Ui { |
15 | /** | 15 | /** |
16 | * API IDEA - not usable this moment! | 16 | * API IDEA - not usable this moment! |
17 | * | 17 | * |
18 | * With this widget you can configure one or many PluginLoaders either | 18 | * With this widget you can configure one or many PluginLoaders either |
19 | * through an already existing Opie::Core::OPluginManager or Opie::Core::OGenericPluginLoader | 19 | * through an already existing Opie::Core::OPluginManager or Opie::Core::OGenericPluginLoader |
20 | * The sorted state will be read from the Loader. | 20 | * The sorted state will be read from the Loader. |
21 | * | 21 | * |
22 | * As with Opie::Ui::OKeyConfigWidget you can have two options. To either apply your changes | 22 | * As with Opie::Ui::OKeyConfigWidget you can have two options. To either apply your changes |
23 | * directly through Opie::Core::OPluginManager or to use Queued where you manually need to | 23 | * directly through Opie::Core::OPluginManager or to use Queued where you manually need to |
24 | * call save. | 24 | * call save. |
25 | * | 25 | * |
26 | * Internally we operate on Opie::Core::OPluginManager. You can insert any numbers of loaders | 26 | * Internally we operate on Opie::Core::OPluginManager. You can insert any numbers of loaders |
27 | * or pluginmanagers. But you need to call load() after you've inserted new items. | 27 | * or pluginmanagers. But you need to call load() after you've inserted new items. |
28 | * | 28 | * |
29 | * @see Opie::Ui::OKeyConfigWidget | 29 | * @see Opie::Ui::OKeyConfigWidget |
30 | * @see Opie::Core::OPluginLoader | 30 | * @see Opie::Core::OPluginLoader |
31 | * @see Opie::Core::OPluginManager | 31 | * @see Opie::Core::OPluginManager |
32 | * | 32 | * |
33 | * @author zecke | 33 | * @author zecke |
34 | * @since Opie 1.1.5 | 34 | * @since Opie 1.1.5 |
35 | * | 35 | * |
36 | */ | 36 | */ |
37 | class OPluginConfigWidget : public QWidget { | 37 | class OPluginConfigWidget : public QWidget { |
38 | Q_OBJECT | ||
38 | public: | 39 | public: |
39 | enum ChangeMode { Queued, Immediate }; | 40 | enum ChangeMode { Queued, Immediate }; |
40 | OPluginConfigWidget( QWidget* wid = 0, const char* name = 0, WFlags fl = 0); | 41 | OPluginConfigWidget( QWidget* wid = 0, const char* name = 0, WFlags fl = 0); |
41 | OPluginConfig( Opie::Core::OPluginManager* manager, QWidget* wid = 0, | 42 | OPluginConfig( Opie::Core::OPluginManager* manager, QWidget* wid = 0, |
42 | const char* name = 0, WFlags fl = 0); | 43 | const char* name = 0, WFlags fl = 0); |
43 | OPluginConfig( Opie::Core::OGenericPluginLoader* loader, QWidget* wid, const char* name, | 44 | OPluginConfig( Opie::Core::OGenericPluginLoader* loader, QWidget* wid, const char* name, |
44 | WFlags fl ); | 45 | WFlags fl ); |
45 | 46 | ||
46 | virtual ~OPluginConfig(); | 47 | virtual ~OPluginConfig(); |
47 | 48 | ||
48 | void setChangeMode( enum ChangeMode ); | 49 | void setChangeMode( enum ChangeMode ); |
49 | ChangeMode mode()const; | 50 | ChangeMode mode()const; |
50 | 51 | ||
51 | void insert( const QString&, const Opie::Core::OPluginManager* ); | 52 | void insert( const QString&, const Opie::Core::OPluginManager* ); |
52 | void insert( const QString&, const Opie::Core::OGenericPluginLoader* ); | 53 | void insert( const QString&, const Opie::Core::OGenericPluginLoader* ); |
53 | 54 | ||
54 | signals: | 55 | signals: |
55 | /** | 56 | /** |
56 | * A PluginItem was changed. This signal is only emitted if you're | 57 | * A PluginItem was changed. This signal is only emitted if you're |
57 | * in the immediate ChangeMode. | 58 | * in the immediate ChangeMode. |
58 | * This is emitted on any change ( disable,enable,pos) | 59 | * This is emitted on any change ( disable,enable,pos) |
59 | * | 60 | * |
60 | * @param item The OPluginItem that was changed. This is how it looks now | 61 | * @param item The OPluginItem that was changed. This is how it looks now |
61 | * @param old_state If it was enabled before | 62 | * @param old_state If it was enabled before |
62 | */ | 63 | */ |
63 | void pluginChanged ( const Opie::Core::OPluginItem& item, bool old_state); | 64 | void pluginChanged ( const Opie::Core::OPluginItem& item, bool old_state); |
64 | 65 | ||
65 | /** | 66 | /** |
66 | * emitted only if you're in Immediate when an Item was enabled | 67 | * emitted only if you're in Immediate when an Item was enabled |
67 | * | 68 | * |
68 | * @param item The Item that was enabled | 69 | * @param item The Item that was enabled |
69 | */ | 70 | */ |
70 | void pluginEnabled ( const Opie::Core::OPluginItem& item); | 71 | void pluginEnabled ( const Opie::Core::OPluginItem& item); |
71 | 72 | ||
72 | /** | 73 | /** |
73 | * emitted only if you're in Immediate when an Item was enabled | 74 | * emitted only if you're in Immediate when an Item was enabled |
74 | * | 75 | * |
75 | * @param item The Item was disabled | 76 | * @param item The Item was disabled |
76 | */ | 77 | */ |
77 | void pluginDisabled( const Opie::Core::OPluginItem& item); | 78 | void pluginDisabled( const Opie::Core::OPluginItem& item); |
78 | 79 | ||
79 | /** | 80 | /** |
80 | * Data was saved(). Normally this is emitted when save() is called | 81 | * Data was saved(). Normally this is emitted when save() is called |
81 | * @see changed | 82 | * @see changed |
82 | */ | 83 | */ |
83 | void changed(); | 84 | void changed(); |
84 | public: | 85 | public: |
85 | 86 | ||