author | Michael Krelin <hacker@klever.net> | 2007-07-04 11:23:42 (UTC) |
---|---|---|
committer | Michael Krelin <hacker@klever.net> | 2007-07-04 11:23:42 (UTC) |
commit | a08aff328d4393031d5ba7d622c2b05705a89d73 (patch) (unidiff) | |
tree | 8ee90d686081c52e7c69b5ce946e9b1a7d690001 /microkde/kresources/factory.h | |
parent | 11edc920afe4f274c0964436633aa632c8288a40 (diff) | |
download | kdepimpi-p1.zip kdepimpi-p1.tar.gz kdepimpi-p1.tar.bz2 |
initial public commit of qt4 portp1
Diffstat (limited to 'microkde/kresources/factory.h') (more/less context) (ignore whitespace changes)
-rw-r--r-- | microkde/kresources/factory.h | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/microkde/kresources/factory.h b/microkde/kresources/factory.h index ea01b23..709fde0 100644 --- a/microkde/kresources/factory.h +++ b/microkde/kresources/factory.h | |||
@@ -1,126 +1,126 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of libkresources. | 2 | This file is part of libkresources. |
3 | 3 | ||
4 | Copyright (c) 2002 Tobias Koenig <tokoe@kde.org> | 4 | Copyright (c) 2002 Tobias Koenig <tokoe@kde.org> |
5 | Copyright (c) 2002 Jan-Pascal van Best <janpascal@vanbest.org> | 5 | Copyright (c) 2002 Jan-Pascal van Best <janpascal@vanbest.org> |
6 | Copyright (c) 2003 Cornelius Schumacher <schumacher@kde.org> | 6 | Copyright (c) 2003 Cornelius Schumacher <schumacher@kde.org> |
7 | 7 | ||
8 | This library is free software; you can redistribute it and/or | 8 | This library is free software; you can redistribute it and/or |
9 | modify it under the terms of the GNU Library General Public | 9 | modify it under the terms of the GNU Library General Public |
10 | License as published by the Free Software Foundation; either | 10 | License as published by the Free Software Foundation; either |
11 | version 2 of the License, or (at your option) any later version. | 11 | version 2 of the License, or (at your option) any later version. |
12 | 12 | ||
13 | This library is distributed in the hope that it will be useful, | 13 | This library is distributed in the hope that it will be useful, |
14 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 14 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | 15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
16 | Library General Public License for more details. | 16 | Library General Public License for more details. |
17 | 17 | ||
18 | You should have received a copy of the GNU Library General Public License | 18 | You should have received a copy of the GNU Library General Public License |
19 | along with this library; see the file COPYING.LIB. If not, write to | 19 | along with this library; see the file COPYING.LIB. If not, write to |
20 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | 20 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
21 | Boston, MA 02111-1307, USA. | 21 | Boston, MA 02111-1307, USA. |
22 | */ | 22 | */ |
23 | 23 | ||
24 | #ifndef KRESOURCES_FACTORY_H | 24 | #ifndef KRESOURCES_FACTORY_H |
25 | #define KRESOURCES_FACTORY_H | 25 | #define KRESOURCES_FACTORY_H |
26 | 26 | ||
27 | #include <qdict.h> | 27 | #include <q3dict.h> |
28 | #include <qstring.h> | 28 | #include <qstring.h> |
29 | 29 | ||
30 | #include <kconfig.h> | 30 | #include <kconfig.h> |
31 | 31 | ||
32 | 32 | ||
33 | #include "resource.h" | 33 | #include "resource.h" |
34 | 34 | ||
35 | namespace KRES { | 35 | namespace KRES { |
36 | 36 | ||
37 | class ConfigWidget; | 37 | class ConfigWidget; |
38 | 38 | ||
39 | //US | 39 | //US |
40 | struct PluginInfo | 40 | struct PluginInfo |
41 | { | 41 | { |
42 | QString library; | 42 | QString library; |
43 | QString nameLabel; | 43 | QString nameLabel; |
44 | QString descriptionLabel; | 44 | QString descriptionLabel; |
45 | }; | 45 | }; |
46 | 46 | ||
47 | 47 | ||
48 | /** | 48 | /** |
49 | * Class for loading resource plugins. | 49 | * Class for loading resource plugins. |
50 | * Do not use this class directly. Use ResourceManager instead | 50 | * Do not use this class directly. Use ResourceManager instead |
51 | * | 51 | * |
52 | * Example: | 52 | * Example: |
53 | * | 53 | * |
54 | * <pre> | 54 | * <pre> |
55 | * KABC::Factory<Calendar> *factory = KABC::Factory<Calendar>::self(); | 55 | * KABC::Factory<Calendar> *factory = KABC::Factory<Calendar>::self(); |
56 | * | 56 | * |
57 | * QStringList list = factory->resources(); | 57 | * QStringList list = factory->resources(); |
58 | * QStringList::Iterator it; | 58 | * QStringList::Iterator it; |
59 | * for ( it = list.begin(); it != list.end(); ++it ) { | 59 | * for ( it = list.begin(); it != list.end(); ++it ) { |
60 | * Resource<Calendar> *resource = factory->resource( (*it), | 60 | * Resource<Calendar> *resource = factory->resource( (*it), |
61 | * KABC::StdAddressBook::self(), 0 ); | 61 | * KABC::StdAddressBook::self(), 0 ); |
62 | * // do something with resource | 62 | * // do something with resource |
63 | * } | 63 | * } |
64 | * </pre> | 64 | * </pre> |
65 | */ | 65 | */ |
66 | class Factory | 66 | class Factory |
67 | { | 67 | { |
68 | public: | 68 | public: |
69 | 69 | ||
70 | 70 | ||
71 | /** | 71 | /** |
72 | * Returns the global resource factory. | 72 | * Returns the global resource factory. |
73 | */ | 73 | */ |
74 | static Factory *self( const QString& resourceFamily ); | 74 | static Factory *self( const QString& resourceFamily ); |
75 | 75 | ||
76 | ~Factory(); | 76 | ~Factory(); |
77 | 77 | ||
78 | /** | 78 | /** |
79 | * Returns the config widget for the given resource type, | 79 | * Returns the config widget for the given resource type, |
80 | * or a null pointer if resource type doesn't exist. | 80 | * or a null pointer if resource type doesn't exist. |
81 | * | 81 | * |
82 | * @param type The type of the resource, returned by @ref resources() | 82 | * @param type The type of the resource, returned by @ref resources() |
83 | * @param resource The resource to be editted. | 83 | * @param resource The resource to be editted. |
84 | * @param parent The parent widget | 84 | * @param parent The parent widget |
85 | */ | 85 | */ |
86 | ConfigWidget *configWidget( const QString& type, QWidget *parent = 0 ); | 86 | ConfigWidget *configWidget( const QString& type, QWidget *parent = 0 ); |
87 | 87 | ||
88 | /** | 88 | /** |
89 | * Returns a pointer to a resource object or a null pointer | 89 | * Returns a pointer to a resource object or a null pointer |
90 | * if resource type doesn't exist. | 90 | * if resource type doesn't exist. |
91 | * | 91 | * |
92 | * @param type The type of the resource, returned by @ref resources() | 92 | * @param type The type of the resource, returned by @ref resources() |
93 | * @param ab The address book, the resource should belong to | 93 | * @param ab The address book, the resource should belong to |
94 | * @param config The config object where the resource get it settings from, or 0 if a new resource should be created. | 94 | * @param config The config object where the resource get it settings from, or 0 if a new resource should be created. |
95 | */ | 95 | */ |
96 | Resource *resource( const QString& type, const KConfig *config); | 96 | Resource *resource( const QString& type, const KConfig *config); |
97 | 97 | ||
98 | /** | 98 | /** |
99 | * Returns a list of all available resource types. | 99 | * Returns a list of all available resource types. |
100 | */ | 100 | */ |
101 | QStringList typeNames() const; | 101 | QStringList typeNames() const; |
102 | 102 | ||
103 | /** | 103 | /** |
104 | * Returns the name for a special type. | 104 | * Returns the name for a special type. |
105 | */ | 105 | */ |
106 | QString typeName( const QString &type ) const; | 106 | QString typeName( const QString &type ) const; |
107 | 107 | ||
108 | /** | 108 | /** |
109 | * Returns the description for a special type. | 109 | * Returns the description for a special type. |
110 | */ | 110 | */ |
111 | QString typeDescription( const QString &type ) const; | 111 | QString typeDescription( const QString &type ) const; |
112 | 112 | ||
113 | protected: | 113 | protected: |
114 | Factory( const QString& resourceFamily); | 114 | Factory( const QString& resourceFamily); |
115 | 115 | ||
116 | private: | 116 | private: |
117 | static QDict<Factory> *mSelves; | 117 | static Q3Dict<Factory> *mSelves; |
118 | 118 | ||
119 | QString mResourceFamily; | 119 | QString mResourceFamily; |
120 | //US QMap<QString, KService::Ptr> mTypeMap; | 120 | //US QMap<QString, KService::Ptr> mTypeMap; |
121 | //US lets store the pluginfo struct as value instead of a KService | 121 | //US lets store the pluginfo struct as value instead of a KService |
122 | QMap<QString, PluginInfo*> mTypeMap; | 122 | QMap<QString, PluginInfo*> mTypeMap; |
123 | }; | 123 | }; |
124 | 124 | ||
125 | } | 125 | } |
126 | #endif | 126 | #endif |