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
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
// SPDX-FileCopyrightText: 2010 Jeremy Lainé <jeremy.laine@m4x.org>
// SPDX-FileCopyrightText: 2019 Linus Jahn <lnj@kaidan.im>
//
// SPDX-License-Identifier: LGPL-2.1-or-later
#ifndef QXMPPDATAFORM_H
#define QXMPPDATAFORM_H
#include "QXmppStanza.h"
#if QXMPP_DEPRECATED_SINCE(1, 1)
#include <QPair>
#endif
#include <QVariant>
#include <QVector>
class QMimeType;
class QUrl;
class QXmppDataFormBase;
class QXmppDataFormPrivate;
class QXmppDataFormFieldPrivate;
class QXmppDataFormMediaPrivate;
class QXmppDataFormMediaSourcePrivate;
class QXMPP_EXPORT QXmppDataForm
{
public:
class QXMPP_EXPORT MediaSource
{
public:
MediaSource();
MediaSource(const QUrl &uri, const QMimeType &contentType);
MediaSource(const QXmppDataForm::MediaSource &);
MediaSource(QXmppDataForm::MediaSource &&);
~MediaSource();
MediaSource &operator=(const MediaSource &);
MediaSource &operator=(MediaSource &&);
QUrl uri() const;
void setUri(const QUrl &uri);
QMimeType contentType() const;
void setContentType(const QMimeType &contentType);
bool operator==(const MediaSource &other) const;
private:
QSharedDataPointer<QXmppDataFormMediaSourcePrivate> d;
};
#if QXMPP_DEPRECATED_SINCE(1, 1)
class QXMPP_EXPORT Media
{
public:
QT_DEPRECATED_X("Use QXmppDataForm::Field() instead")
Media();
QT_DEPRECATED_X("Use QXmppDataForm::Field() instead")
Media(const QXmppDataForm::Media &other);
~Media();
QXmppDataForm::Media &operator=(const QXmppDataForm::Media &other);
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSize().height() instead")
int height() const;
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSize().setHeight() instead")
void setHeight(int height);
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSize().width() instead")
int width() const;
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSize().setWidth() instead")
void setWidth(int width);
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSources() instead")
QList<QPair<QString, QString>> uris() const;
QT_DEPRECATED_X("Use QXmppDataForm::Field::setMediaSources() instead")
void setUris(const QList<QPair<QString, QString>> &uris);
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSources().isEmpty() instead")
bool isNull() const;
private:
QSharedDataPointer<QXmppDataFormMediaPrivate> d;
};
#endif
class QXMPP_EXPORT Field
{
public:
/// This enum is used to describe a field's type.
enum Type {
BooleanField,
FixedField,
HiddenField,
JidMultiField,
JidSingleField,
ListMultiField,
ListSingleField,
TextMultiField,
TextPrivateField,
TextSingleField
};
Field(Type type = TextSingleField,
const QString &key = {},
const QVariant &value = {},
bool isRequired = false,
const QString &label = {},
const QString &description = {},
const QList<QPair<QString, QString>> &options = {});
Field(const QXmppDataForm::Field &other);
Field(QXmppDataForm::Field &&);
~Field();
QXmppDataForm::Field &operator=(const QXmppDataForm::Field &other);
QXmppDataForm::Field &operator=(QXmppDataForm::Field &&);
QString description() const;
void setDescription(const QString &description);
QString key() const;
void setKey(const QString &key);
QString label() const;
void setLabel(const QString &label);
#if QXMPP_DEPRECATED_SINCE(1, 1)
QT_DEPRECATED_X("Use QXmppDataForm::Field::mediaSources() or QXmppDataForm::Field::mediaSize() instead")
Media media() const;
QT_DEPRECATED_X("Use QXmppDataForm::Field::setMediaSources() or QXmppDataForm::Field::setMediaSize() instead")
void setMedia(const Media &media);
#endif
QList<QPair<QString, QString>> options() const;
void setOptions(const QList<QPair<QString, QString>> &options);
bool isRequired() const;
void setRequired(bool required);
QXmppDataForm::Field::Type type() const;
void setType(QXmppDataForm::Field::Type type);
QVariant value() const;
void setValue(const QVariant &value);
QVector<QXmppDataForm::MediaSource> &mediaSources();
QVector<QXmppDataForm::MediaSource> mediaSources() const;
void setMediaSources(const QVector<QXmppDataForm::MediaSource> &mediaSources);
QSize mediaSize() const;
QSize &mediaSize();
void setMediaSize(const QSize &size);
bool operator==(const Field &other) const;
private:
QSharedDataPointer<QXmppDataFormFieldPrivate> d;
};
/// This enum is used to describe a form's type.
enum Type {
None, ///< Unknown form type
Form, ///< The form-processing entity is asking the form-submitting
///< entity to complete a form.
Submit, ///< The form-submitting entity is submitting data to the
///< form-processing entity.
Cancel, ///< The form-submitting entity has cancelled submission
///< of data to the form-processing entity.
Result ///< The form-processing entity is returning data
///< (e.g., search results) to the form-submitting entity,
///< or the data is a generic data set.
};
QXmppDataForm(Type type = None,
const QList<Field> &fields = {},
const QString &title = {},
const QString &instructions = {});
QXmppDataForm(const QXmppDataFormBase &based);
QXmppDataForm(const QXmppDataForm &other);
QXmppDataForm(QXmppDataForm &&);
~QXmppDataForm();
QXmppDataForm &operator=(const QXmppDataForm &other);
QXmppDataForm &operator=(QXmppDataForm &&);
QString instructions() const;
void setInstructions(const QString &instructions);
QList<Field> fields() const;
QList<Field> &fields();
void setFields(const QList<QXmppDataForm::Field> &fields);
QString title() const;
void setTitle(const QString &title);
QXmppDataForm::Type type() const;
void setType(QXmppDataForm::Type type);
QString formType() const;
bool isNull() const;
/// \cond
void parse(const QDomElement &element);
void toXml(QXmlStreamWriter *writer) const;
/// \endcond
private:
QSharedDataPointer<QXmppDataFormPrivate> d;
};
Q_DECLARE_METATYPE(QXmppDataForm)
#endif
|
