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
|
/* ============================================================
*
* This file is a part of digiKam project
* https://www.digikam.org
*
* Date : 2011-03-22
* Description : a Iface C++ interface
*
* Copyright (C) 2011-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
* Copyright (C) 2011 by Ludovic Delfau <ludovicdelfau at gmail dot com>
*
* This program is free software; you can redistribute it
* and/or modify it under the terms of the GNU General
* Public License as published by the Free Software Foundation;
* either version 2, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* ============================================================ */
#ifndef DIGIKAM_MEDIAWIKI_QUERYIMAGES_H
#define DIGIKAM_MEDIAWIKI_QUERYIMAGES_H
// KDE includes
#include <kjob.h>
// Local includes
#include "mediawiki_job.h"
#include "mediawiki_image.h"
namespace MediaWiki
{
class Iface;
class QueryImagesPrivate;
/**
* @brief Query images job.
*
* Gets a list of all images used on pages.
*/
class QueryImages : public Job
{
Q_OBJECT
Q_DECLARE_PRIVATE(QueryImages)
public:
/**
* @brief Indicates all possible error conditions found during the processing of the job.
*/
enum
{
/**
* @brief A network error has occurred.
*/
NetworkError = KJob::UserDefinedError + 1,
/**
* @brief A XML error has occurred.
*/
XmlError
};
public:
/**
* @brief Constructs a query images job.
* @param MediaWiki the MediaWiki concerned by the job
* @param parent the QObject parent
*/
explicit QueryImages(Iface& MediaWiki, QObject* const parent = nullptr);
/**
* @brief Destroys a query images job.
*/
~QueryImages() override;
/**
* @brief Set the title.
* @param title the title of the page
*/
void setTitle(const QString& title);
/**
* @brief Set the limit.
* @param limit number of images returned by one signal #pages()
*/
void setLimit(unsigned int limit);
/**
* @brief Starts the job asynchronously.
*/
void start() override;
Q_SIGNALS:
/**
* @brief Provides a list of all images used on pages
*
* This signal can be emitted several times.
*
* @param pages list of all images used on pages
*/
void images(const QList<Image>& images);
private Q_SLOTS:
void doWorkSendRequest();
void doWorkProcessReply();
};
} // namespace MediaWiki
#endif // DIGIKAM_MEDIAWIKI_QUERYIMAGES_H
|
