/usr/include/KF5/KActivitiesStats/kactivitiesstats/resultwatcher.h is in libkf5activitiesstats-dev 5.44.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
* Copyright (C) 2015, 2016 Ivan Cukic <ivan.cukic(at)kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) version 3, or any
* later version accepted by the membership of KDE e.V. (or its
* successor approved by the membership of KDE e.V.), which shall
* act as a proxy defined in Section 6 of version 3 of the license.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library.
* If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef KACTIVITIES_STATS_RESULTWATCHER
#define KACTIVITIES_STATS_RESULTWATCHER
#include <QObject>
#include "query.h"
#include "resultset.h"
namespace KActivities {
namespace Stats {
class ResultWatcherPrivate;
/**
* A very thin class that sends signals when new resources matching
* a predefined query are available.
*/
class KACTIVITIESSTATS_EXPORT ResultWatcher: public QObject {
Q_OBJECT
public:
ResultWatcher(Query query, QObject *parent = nullptr);
~ResultWatcher();
Q_SIGNALS:
/**
* Emitted when a result has been added or updated. This either means
* a new resource has appeared in the result set, or that
* a previously existing one has some of the attributes changed.
* @param result new data for the resource defined by result.resource
*/
void resultScoreUpdated(const QString &resource, double score,
uint lastUpdate, uint firstUpdate);
/**
* Emitted when a result has been added or updated. This either means
* a new resource has appeared in the result set, or that
* a previously existing one has some of the attributes changed.
* @param result new data for the resource defined by result.resource
*/
void resultRemoved(const QString &resource);
/**
* Emitted when a result has been linked to the activity
*/
void resultLinked(const QString &resource);
/**
* Emitted when a result has been linked to the activity
*/
void resultUnlinked(const QString &resource);
/**
* Emitted when the title of a resource has been changed.
* @param resource URL of the resource that has a new title
* @param title new title of the resource
* @note This signal will be emitted even for the resources that
* do not match the specified query. This is because the class is
* lightweight, and it does not keep track of which resources match
* the query to be able to filter this signal.
*/
void resourceTitleChanged(const QString &resource, const QString &title);
/**
* Emitted when the mimetype of a resource has been changed.
* @param resource URL of the resource that has a new mimetype
* @param mimetype new mimetype of the resource
* @note This signal will be emitted even for the resources that
* do not match the specified query. This is because the class is
* lightweight, and it does not keep track of which resources match
* the query to be able to filter this signal.
*/
void resourceMimetypeChanged(const QString &resource, const QString &mimetype);
/**
* Emitted when the client should forget about all the results it
* knew about and reload them. This can happen when the user clears
* the history, or when there are more significant changes to the data.
*/
void resultsInvalidated();
public:
void linkToActivity(const QUrl &resource,
const Terms::Activity &activity
= Terms::Activity(QStringList()),
const Terms::Agent &agent
= Terms::Agent(QStringList()));
void unlinkFromActivity(const QUrl &resource,
const Terms::Activity &activity
= Terms::Activity(QStringList()),
const Terms::Agent &agent
= Terms::Agent(QStringList()));
private:
ResultWatcherPrivate *const d;
};
} // namespace Stats
} // namespace KActivities
#endif // KACTIVITIES_STATS_RESULTWATCHER
|