|
Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions | |
The QCategoryManager class provides a set of functions to create, modify, and remove categories. More...
#include <QCategoryManager>
Inherits QObject.
The QCategoryManager class provides a set of functions to create, modify, and remove categories.
See also Categories.
Constructs a QCategoryManager object with parent parent. It will only see categories in the global scope.
Constructs a QCategoryManager object with parent parent. If scope is null then only categories in the global scope will be seen. Otherwise both global categories and categories restricted to scope will be seen.
Destroys a QCategoryManager object.
Creates a new category with the user-supplied label trLabel and icon icon. The category is created in the scope of the QCategoryManager unless forceGlobal is true, when it will be created in the global scope.
Returns the id of the new category if the new category is successfully added. Otherwise returns the null string.
Note that this function is not suitable for applications wishing to create categories programmatically. Instead, a system category should be created, using the ensureSystemCategory() function.
See also User Categories and System Categories.
Returns the translated label for the set of all categories.
This signal is emitted when any changes are made to categories.
Returns the set of category ids that QCategoryManager can see.
Returns true if there is a category in the global scope or the scope of QCategoryManager with category id id. Otherwise returns false.
Returns true if there is a category in the global scope or the scope of QCategoryManager with text label. Otherwise returns false. Set forceGlobal to true to limit the search to categories in the global scope.
Note that this searches on the text stored which may not match what is returned by label() for system categories.
Creates a new system category with category id id, translatable label trLabel and icon icon in the scope of the QCategoryManager. If forceGlobal is true or the QCategoryManager has no scope the category will be created in the global scope.
Note that id must be unique. If the id already exists and the existing category does not match the arguments the existing category is removed and re-created using the arguments.
Returns true if the new category is successfully added or a matching system category already exists. Otherwise returns false.
Note that applications wishing to create categories on behalf of the user should use the add() function.
See also User Categories and System Categories.
Returns true if there is a category in any scope with category id id.
If there is a category id id in the scope of the QCategoryManager returns the icon for the category id. Otherwise returns a null icon.
See also setIcon().
If there is a category id id in the scope of the QCategoryManager returns the icon filename for the category id. Otherwise returns an empty string.
Returns the category id for a category with text label in the global scope or the scope of QCategoryManager. Otherwise returns an empty string.
Note that this searches on the text stored which may not match what is returned by label() for system categories.
Returns true if the category id id is in the global scope.
Returns true if the category identified by id is a system category. Otherwise returns false.
See also System Categories.
If there is a category id id in the scope of the QCategoryManager returns the display label for the category id. Otherwise returns a null string.
User categories have a display label set by the user. System categories have a string that is translated to obtain the display label.
See also setLabel(), User Categories, and System Categories.
Returns a list containing the translated label for each category id in the list l that is in the scope of the QCategoryManager. The list returned will have a count smaller than the list if id's l if one or more of the ids in the list l are not in the scope of the QCategoryManager.
See also label().
Returns a translated label for a set containing two or more categories.
Attempts to remove the category with category id id as long as the category is either global or in the scope of the QCategoryManager object. Returns true If the category is successfully removed. Otherwise returns false.
Note that this will always fail if id is a system category.
If there is a category id id in the scope of the QCategoryManger returns the ringtone filename for the category id. Otherwise returns an empty string.
See also setRingTone().
Sets the category with category id id to the global scope if global is true or to the scope of QCategoryManager otherwise. Returns true on success. Returns false if the category does not exist, if global is false and QCategoryManager does not have a scope or if there is a database failure.
See also isGlobal().
Attempts to set the icon for the category with category id id to icon. Returns true If the category icon is changed successfully. Otherwise returns false.
Note that this will always fail if id is a system category.
See also icon().
Attempts to rename the category with category id id to have the translated label trLabel. Returns true If the category is successfully renamed. Otherwise returns false.
Note that this will always fail if id is a system category.
See also label().
Attempts to set the ringtone for the category with category id id to fileName. Returns true if the category ringtone is changed successfully. Otherwise return false.
See also ringTone().
Returns the translated label for the empty set of categories. Also known as unfiled due to the set not yet having any categories assigned.
| Copyright © 2009 Trolltech | Trademarks | Qt Extended 4.4.3 |