The QLandmarkCategoryFetchRequest class allows a client to asynchronously request a list of categories from a landmark manager. More...
#include <QLandmarkCategoryFetchRequest>Inherits: QLandmarkAbstractRequest.
This class was introduced in Qt Mobility 1.1.
| QLandmarkCategoryFetchRequest ( QLandmarkManager * manager, QObject * parent = 0 ) | |
| ~QLandmarkCategoryFetchRequest () | |
| QList<QLandmarkCategory> | categories () const |
| int | limit () const |
| int | offset () const |
| void | setLimit ( int limit ) |
| void | setOffset ( int offset ) |
| void | setSorting ( const QLandmarkNameSort & nameSort ) |
| QLandmarkNameSort | sorting () const |
The QLandmarkCategoryFetchRequest class allows a client to asynchronously request a list of categories from a landmark manager.
For a QLandmarkCategoryFetchRequest, the resultsAvailable() signal will be emitted as resultant categories are found (these are retrievable by calling categories()), as well as if an overall operation error occurred(which may be retrieved by calling QLandmarkAbstractRequest::error()).
Please see the class documentation for QLandmarkAbstractRequest for more information about the usage of request classes and ownership semantics.
Creates a new category fetch request object with the given manager and parent.
Destroys the request object.
Returns the list of categories that have been found during the request.
This function was introduced in Qt Mobility 1.1.
Returns the maximum number of categories to be returned. By default the limit is -1 indicating that all categories should be retrieved.
This function was introduced in Qt Mobility 1.1.
See also setLimit().
Returns the index offset for the request. By default the offset is 0. The offset determines the first index which is retrieved, it is generally used in conjunction with limit() to facilitate paging.
For example, if there are 10 categories in the landmark store, setting the offset to 2 and limit to 5 will retrieve the 3rd to 7th categories inclusively. (The order of categories is specified by the sorting field).
This function was introduced in Qt Mobility 1.1.
See also setOffset().
Sets the maximum number of categories to be returned to limit. A limit of -1 will retrieve all categories.
(A limit of 0 will retrieve no categories.)
This function was introduced in Qt Mobility 1.1.
See also limit().
Sets the index offset for the request.
This function was introduced in Qt Mobility 1.1.
See also offset().
Sets nameSort to specify the sorting of the returned categories.
This function was introduced in Qt Mobility 1.1.
See also sorting().
Returns the sorting of the categories. By default the sorting is case insensitive and in ascending order according to the category name.
This function was introduced in Qt Mobility 1.1.
See also setSorting().