1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the Qt Mobility Components.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qlandmarkcategoryfetchrequest.h"
#include "qlandmarkrequests_p.h"
#include "qlandmarkcategory.h"
QTM_BEGIN_NAMESPACE
/*!
\class QLandmarkCategoryFetchRequest
\brief 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.
\inmodule QtLocation
\ingroup landmarks-request
*/
/*!
Creates a new category fetch request object with the given \a manager and \a parent.
*/
QLandmarkCategoryFetchRequest::QLandmarkCategoryFetchRequest(QLandmarkManager *manager, QObject *parent)
:QLandmarkAbstractRequest(new QLandmarkCategoryFetchRequestPrivate(manager), parent)
{
}
/*!
Destroys the request object.
*/
QLandmarkCategoryFetchRequest::~QLandmarkCategoryFetchRequest()
{
}
/*!
Returns the list of categories that have been found during the
request.
*/
QList<QLandmarkCategory> QLandmarkCategoryFetchRequest::categories() const
{
Q_D(const QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
return d->categories;
}
/*!
Returns the sorting of the categories.
By default the sorting is case insensitive and in ascending order
according to the category name.
*/
QLandmarkNameSort QLandmarkCategoryFetchRequest::sorting() const
{
Q_D(const QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
return d->sorting;
}
/*!
Sets \a nameSort to specify the sorting of the returned categories.
*/
void QLandmarkCategoryFetchRequest::setSorting(const QLandmarkNameSort &nameSort)
{
Q_D(QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
d->sorting = nameSort;
}
/*!
Returns the maximum number of categories to be returned. By default the limit
is -1 indicating that all categories should be retrieved.
*/
int QLandmarkCategoryFetchRequest::limit() const
{
Q_D(const QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
return d->limit;
}
/*!
Sets the maximum number of categories to be returned to \a limit.
A limit of -1 will retrieve all categories.
(A limit of 0 will retrieve no categories.)
*/
void QLandmarkCategoryFetchRequest::setLimit(int limit)
{
Q_D(QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
d->limit = limit;
}
/*!
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).
*/
int QLandmarkCategoryFetchRequest::offset() const
{
Q_D(const QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
return d->offset;
}
/*!
Sets the index \a offset for the request.
*/
void QLandmarkCategoryFetchRequest::setOffset(int offset) {
Q_D(QLandmarkCategoryFetchRequest);
QMutexLocker ml(&d->mutex);
d->offset = offset;
}
#include "moc_qlandmarkcategoryfetchrequest.cpp"
QTM_END_NAMESPACE
|
