blob: d6a550544863f06288696dae7c933a5c53adfed3 (
plain)
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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include "qplacecontentrequest_p.h"
#include "qplacecontentrequest.h"
#include "qgeocoordinate.h"
QT_BEGIN_NAMESPACE
QT_DEFINE_QSDP_SPECIALIZATION_DTOR(QPlaceContentRequestPrivate)
bool QPlaceContentRequestPrivate::operator==(const QPlaceContentRequestPrivate &other) const
{
return contentType == other.contentType
&& limit == other.limit;
}
void QPlaceContentRequestPrivate::clear()
{
contentType = QPlaceContent::NoType;
limit = -1;
}
/*!
\class QPlaceContentRequest
\inmodule QtLocation
\ingroup QtLocation-places
\ingroup QtLocation-places-requests
\since 5.6
\brief The QPlaceContentRequest class represents the parameters of a content request.
The QPlaceContentRequest class is used in conjunction with a QPlaceManager to
retrieve rich content like images and reviews in a paginated fashion.
The following code would request a set of 5 images from the 10th index:
\snippet places/requesthandler.h Content request
\dots
\dots
\snippet places/requesthandler.h Content handler
\sa QPlaceContentReply
*/
/*!
Constructs a new request object.
*/
QPlaceContentRequest::QPlaceContentRequest()
: d_ptr(new QPlaceContentRequestPrivate())
{
}
/*!
Constructs a copy of \a other.
*/
QPlaceContentRequest::QPlaceContentRequest(const QPlaceContentRequest &other) noexcept = default;
/*!
Destroys the request object
*/
QPlaceContentRequest::~QPlaceContentRequest() = default;
/*!
Assigns \a other to this content request and returns a reference
to this content request.
*/
QPlaceContentRequest &QPlaceContentRequest::operator=(const QPlaceContentRequest & other) noexcept
{
if (this == &other)
return *this;
d_ptr = other.d_ptr;
return *this;
}
/*!
\fn bool QPlaceContentRequest::operator==(const QPlaceContentRequest &lhs, const QPlaceContentRequest &rhs) noexcept
Returns true if \a lhs is equal to \a rhs, otherwise returns false.
*/
/*!
\fn bool QPlaceContentRequest::operator!=(const QPlaceContentRequest &lhs, const QPlaceContentRequest &rhs) noexcept
Returns true if \a lhs is not equal to \a rhs, otherwise returns false.
*/
bool QPlaceContentRequest::isEqual(const QPlaceContentRequest &other) const noexcept
{
Q_D(const QPlaceContentRequest);
return *d == *other.d_func();
}
/*!
Returns the type of content to be requested, for example reviews or images
*/
QPlaceContent::Type QPlaceContentRequest::contentType() const
{
Q_D(const QPlaceContentRequest);
return d->contentType;
}
/*!
Sets the \a type of content to be requested.
*/
void QPlaceContentRequest::setContentType(QPlaceContent::Type type)
{
Q_D(QPlaceContentRequest);
d->contentType = type;
}
/*!
Returns the identifier of the place content is to be fetched for.
*/
QString QPlaceContentRequest::placeId() const
{
Q_D(const QPlaceContentRequest);
return d->placeId;
}
/*!
Sets the identifier of the place to fetch content for to \a identifier.
*/
void QPlaceContentRequest::setPlaceId(const QString &identifier)
{
Q_D(QPlaceContentRequest);
d->placeId = identifier;
}
/*!
Returns backend specific additional content context associated with this place content request.
*/
QVariant QPlaceContentRequest::contentContext() const
{
Q_D(const QPlaceContentRequest);
return d->contentContext;
}
/*!
Sets the content context to \a context.
\note This method is intended to be used by geo service plugins when returning place content
results.
The content context is used by backends to store additional content context related to the
content request. Other relevant fields should also be filled in. For example, if the content
request is for image content the content type should also be set with \l setContentType(). The
content context allows additional context to be kept which is not directly accessible via the
Qt Location API.
The content context can be of any type storable in a QVariant. The value of the content context
is not intended to be used directly by applications.
*/
void QPlaceContentRequest::setContentContext(const QVariant &context)
{
Q_D(QPlaceContentRequest);
d->contentContext = context;
}
/*!
Returns the maximum number of content items to retrieve.
A negative value for limit means that it is undefined. It is left up to the backend
provider to choose an appropriate number of items to return.
The default limit is -1.
*/
int QPlaceContentRequest::limit() const
{
Q_D(const QPlaceContentRequest);
return d->limit;
}
/*!
Set the maximum number of content items to retrieve to
\a limit.
*/
void QPlaceContentRequest::setLimit(int limit)
{
Q_D(QPlaceContentRequest);
d->limit = limit;
}
/*!
Clears the content request.
*/
void QPlaceContentRequest::clear()
{
Q_D(QPlaceContentRequest);
d->clear();
}
inline QPlaceContentRequestPrivate *QPlaceContentRequest::d_func()
{
return static_cast<QPlaceContentRequestPrivate *>(d_ptr.data());
}
inline const QPlaceContentRequestPrivate *QPlaceContentRequest::d_func() const
{
return static_cast<const QPlaceContentRequestPrivate *>(d_ptr.constData());
}
QT_END_NAMESPACE
|
