/usr/include/kpeople/allcontactsmonitor.h is in libkpeople-dev 0.3.0-2.
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 | /*
* Copyright 2013 David Edmundson <d.edmundson@lboro.ac.uk>
*
* 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 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 14 of version 3 of the license.
*
* 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.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
#ifndef ALLCONTACTSMONITOR_H
#define ALLCONTACTSMONITOR_H
#include <QObject>
#include "kpeople_export.h"
#include <KABC/Addressee>
namespace KPeople {
class AllContactsMonitorPrivate;
/**
* This class should be subclassed by each datasource and return a list of
* all contacts that the datasource knows about.
*
* Subclasses are expected to be asynchronous
*
*/
class KPEOPLE_EXPORT AllContactsMonitor : public QObject
{
Q_OBJECT
public:
explicit AllContactsMonitor(); //TODO make protected? this isn't useful unless subclassed
virtual ~AllContactsMonitor();
/**
* Returns all currently loaded contacts
*/
virtual KABC::Addressee::Map contacts();
//TODO redo as a state enum - InitialLoad, Fail, Loaded
bool isInitialFetchComplete() const;
bool initialFetchSuccess() const;
Q_SIGNALS:
/**
* DataSources should emit this whenever a known contact changes
*/
void contactChanged(const QString &contactId, const KABC::Addressee &contact);
/**
* DataSources should emit this whenever a contact is added
*/
void contactAdded(const QString &contactId, const KABC::Addressee &contact);
/**
* DataSources should emit this whenever a contact is removed and they are no longer able to supply up-to-date data on a contact
*/
void contactRemoved(const QString &contactId);
/**
* Notifies that the DataSource has completed it's initial fetch.
*
* @warning DataSources should use emitInitialFetchComplete() instead of emitting this signal
* directly.
*
* @param success True when the fetch was successful, False when an error occurred.
*/
void initialFetchComplete( bool success );
protected Q_SLOTS:
/**
* DataSources should call this once they have finished initial retrieval of all contacts from their
* storage.
*
* This will emit initialFetchComplete() signal
*
* @p success Whether the fetch was successful.
*/
void emitInitialFetchComplete( bool success );
private:
Q_DISABLE_COPY(AllContactsMonitor)
Q_DECLARE_PRIVATE(AllContactsMonitor)
AllContactsMonitorPrivate *d_ptr;
};
}
typedef QSharedPointer<KPeople::AllContactsMonitor> AllContactsMonitorPtr;
#endif // ALLCONTACTSMONITOR_H
|