author | zecke <zecke> | 2003-08-25 15:06:32 (UTC) |
---|---|---|
committer | zecke <zecke> | 2003-08-25 15:06:32 (UTC) |
commit | 44b9e62c1e5071fc6e5f8e80204b9974dbc704b6 (patch) (unidiff) | |
tree | 2ed47cff84f9b9cfb94fd38f6931ba69316f32aa /library/backend/categories.h | |
parent | bf3c4abb9dff716e098f05852d9a3d8ac8cbcb44 (diff) | |
download | opie-44b9e62c1e5071fc6e5f8e80204b9974dbc704b6.zip opie-44b9e62c1e5071fc6e5f8e80204b9974dbc704b6.tar.gz opie-44b9e62c1e5071fc6e5f8e80204b9974dbc704b6.tar.bz2 |
add a qtopia method we need for the new launcher
Diffstat (limited to 'library/backend/categories.h') (more/less context) (ignore whitespace changes)
-rw-r--r-- | library/backend/categories.h | 3 |
1 files changed, 3 insertions, 0 deletions
diff --git a/library/backend/categories.h b/library/backend/categories.h index d5b3669..91c93e7 100644 --- a/library/backend/categories.h +++ b/library/backend/categories.h | |||
@@ -106,96 +106,99 @@ public: | |||
106 | * locally or globally. Return UID if added, 0 if conflicts | 106 | * locally or globally. Return UID if added, 0 if conflicts |
107 | * (error). | 107 | * (error). |
108 | */ | 108 | */ |
109 | int addCategory( const QString &appname, const QString &catname); | 109 | int addCategory( const QString &appname, const QString &catname); |
110 | /** Add the category name as long as it doesn't already exist | 110 | /** Add the category name as long as it doesn't already exist |
111 | * locally or globally. Return UID if added, 0 if conflicts | 111 | * locally or globally. Return UID if added, 0 if conflicts |
112 | * (error). | 112 | * (error). |
113 | */ | 113 | */ |
114 | int addCategory( const QString &appname, const QString &catname, int uid); | 114 | int addCategory( const QString &appname, const QString &catname, int uid); |
115 | /** Add the global category just checking that it doesn't | 115 | /** Add the global category just checking that it doesn't |
116 | * already exist globally. Return UID if added, 0 if conflicts. | 116 | * already exist globally. Return UID if added, 0 if conflicts. |
117 | */ | 117 | */ |
118 | int addGlobalCategory( const QString &catname ); | 118 | int addGlobalCategory( const QString &catname ); |
119 | /** Add the global category just checking that it doesn't | 119 | /** Add the global category just checking that it doesn't |
120 | * already exist globally. Return UID if added, 0 if conflicts. | 120 | * already exist globally. Return UID if added, 0 if conflicts. |
121 | */ | 121 | */ |
122 | int addGlobalCategory( const QString &catname, int uid ); | 122 | int addGlobalCategory( const QString &catname, int uid ); |
123 | /** Removes the category from the application; if it is not found | 123 | /** Removes the category from the application; if it is not found |
124 | * in the application, then it removes it from the global list | 124 | * in the application, then it removes it from the global list |
125 | */ | 125 | */ |
126 | bool removeCategory( const QString &appName, const QString &catName, | 126 | bool removeCategory( const QString &appName, const QString &catName, |
127 | bool checkGlobal = TRUE); | 127 | bool checkGlobal = TRUE); |
128 | bool removeCategory( const QString &appName, int uid ); | 128 | bool removeCategory( const QString &appName, int uid ); |
129 | bool removeGlobalCategory( const QString &catName ); | 129 | bool removeGlobalCategory( const QString &catName ); |
130 | bool removeGlobalCategory( int uid ); | 130 | bool removeGlobalCategory( int uid ); |
131 | 131 | ||
132 | QArray<int> ids( const QString &app, const QStringList &labels) const; | 132 | QArray<int> ids( const QString &app, const QStringList &labels) const; |
133 | 133 | ||
134 | /** Returns the id associated with the app */ | 134 | /** Returns the id associated with the app */ |
135 | int id( const QString &app, const QString &cat ) const; | 135 | int id( const QString &app, const QString &cat ) const; |
136 | /** Returns the label associated with the id */ | 136 | /** Returns the label associated with the id */ |
137 | QString label( const QString &app, int id ) const; | 137 | QString label( const QString &app, int id ) const; |
138 | 138 | ||
139 | enum ExtraLabels { NoExtra, AllUnfiled, AllLabel, UnfiledLabel }; | 139 | enum ExtraLabels { NoExtra, AllUnfiled, AllLabel, UnfiledLabel }; |
140 | /** Returns the sorted list of all categories that are | 140 | /** Returns the sorted list of all categories that are |
141 | * associated with the app. | 141 | * associated with the app. |
142 | * If includeGlobal parameter is TRUE then the returned | 142 | * If includeGlobal parameter is TRUE then the returned |
143 | * categories will include the global category items. | 143 | * categories will include the global category items. |
144 | * If extra = NoExtra, then | 144 | * If extra = NoExtra, then |
145 | * If extra = AllUnfiled, then All and Unfiled will be prepended to | 145 | * If extra = AllUnfiled, then All and Unfiled will be prepended to |
146 | * the list | 146 | * the list |
147 | * If extra = AllLabel, then All is prepended | 147 | * If extra = AllLabel, then All is prepended |
148 | * If extra = UnfiledLabel, then Unfiled is prepended | 148 | * If extra = UnfiledLabel, then Unfiled is prepended |
149 | */ | 149 | */ |
150 | QStringList labels( const QString &app, | 150 | QStringList labels( const QString &app, |
151 | bool includeGlobal = TRUE, | 151 | bool includeGlobal = TRUE, |
152 | ExtraLabels extra = NoExtra ) const; | 152 | ExtraLabels extra = NoExtra ) const; |
153 | 153 | ||
154 | QStringList labels( const QString &app, | ||
155 | const QArray<int> &catids ) const; | ||
156 | |||
154 | enum DisplaySingle { ShowMulti, ShowAll, ShowFirst }; | 157 | enum DisplaySingle { ShowMulti, ShowAll, ShowFirst }; |
155 | 158 | ||
156 | /** Returns a single string associated with the cat ids for display in | 159 | /** Returns a single string associated with the cat ids for display in |
157 | * a combobox or any area that requires one string. If catids are empty | 160 | * a combobox or any area that requires one string. If catids are empty |
158 | * then "Unfiled" will be returned. If multiple categories are assigned | 161 | * then "Unfiled" will be returned. If multiple categories are assigned |
159 | * then the behavior depends on the DisplaySingle type. | 162 | * then the behavior depends on the DisplaySingle type. |
160 | * If /a display is set to ShowMulti then " (multi)" appended to the | 163 | * If /a display is set to ShowMulti then " (multi)" appended to the |
161 | * first string. If /a display is set to ShowAll, then a space seperated | 164 | * first string. If /a display is set to ShowAll, then a space seperated |
162 | * string is returned with all categories. If ShowFirst is returned, | 165 | * string is returned with all categories. If ShowFirst is returned, |
163 | * the just the first string is returned. | 166 | * the just the first string is returned. |
164 | */ | 167 | */ |
165 | QString displaySingle( const QString &app, | 168 | QString displaySingle( const QString &app, |
166 | const QArray<int> &catids, | 169 | const QArray<int> &catids, |
167 | DisplaySingle display ) const; | 170 | DisplaySingle display ) const; |
168 | 171 | ||
169 | QStringList globalCategories() const { return mGlobalCats.labels();} | 172 | QStringList globalCategories() const { return mGlobalCats.labels();} |
170 | 173 | ||
171 | bool renameCategory( const QString &appname, | 174 | bool renameCategory( const QString &appname, |
172 | const QString &oldName, | 175 | const QString &oldName, |
173 | const QString &newName ); | 176 | const QString &newName ); |
174 | bool renameGlobalCategory( const QString &oldName, | 177 | bool renameGlobalCategory( const QString &oldName, |
175 | const QString &newName ); | 178 | const QString &newName ); |
176 | 179 | ||
177 | void setGlobal( const QString &appname, const QString &catname, | 180 | void setGlobal( const QString &appname, const QString &catname, |
178 | bool value ); | 181 | bool value ); |
179 | bool isGlobal( const QString &catname ) const; | 182 | bool isGlobal( const QString &catname ) const; |
180 | 183 | ||
181 | 184 | ||
182 | /** Returns true if the catname is associated with any application | 185 | /** Returns true if the catname is associated with any application |
183 | */ | 186 | */ |
184 | bool exists( const QString &catname ) const; | 187 | bool exists( const QString &catname ) const; |
185 | bool exists( const QString &appname, const QString &catname) const; | 188 | bool exists( const QString &appname, const QString &catname) const; |
186 | 189 | ||
187 | bool save( const QString &fname ) const; | 190 | bool save( const QString &fname ) const; |
188 | bool load( const QString &fname ); | 191 | bool load( const QString &fname ); |
189 | 192 | ||
190 | // for debugging | 193 | // for debugging |
191 | void dump() const; | 194 | void dump() const; |
192 | 195 | ||
193 | const QMap<QString, CategoryGroup> &appGroupMap() const{ return mAppCats; } | 196 | const QMap<QString, CategoryGroup> &appGroupMap() const{ return mAppCats; } |
194 | const CategoryGroup &globalGroup() const { return mGlobalCats; } | 197 | const CategoryGroup &globalGroup() const { return mGlobalCats; } |
195 | 198 | ||
196 | signals: | 199 | signals: |
197 | /** emitted if added a category; | 200 | /** emitted if added a category; |
198 | * the second param is the application the category was added to | 201 | * the second param is the application the category was added to |
199 | * or null if global | 202 | * or null if global |
200 | * the third param is the uid of the newly added category | 203 | * the third param is the uid of the newly added category |
201 | */ | 204 | */ |