/usr/include/akonadi/specialcollections.h is in kdepimlibs5-dev 4:4.14.10-1ubuntu7.
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 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 | /*
Copyright (c) 2009 Constantin Berzan <exit3219@gmail.com>
This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Library General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
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 Library General Public
License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
*/
#ifndef AKONADI_SPECIALCOLLECTIONS_H
#define AKONADI_SPECIALCOLLECTIONS_H
#include "akonadi_export.h"
#include <QtCore/QObject>
#include "akonadi/collection.h"
#include <akonadi/item.h>
class KCoreConfigSkeleton;
class KJob;
namespace Akonadi {
class AgentInstance;
class SpecialCollectionsPrivate;
/**
@short An interface to special collections.
This class is the central interface to special collections like inbox or
outbox in a mail resource or recent contacts in a contacts resource.
The class is not meant to be used directly, but to inherit the a type
specific special collections class from it (e.g. SpecialMailCollections).
To check whether a special collection is available, simply use the hasCollection() and
hasDefaultCollection() methods. Available special collections are accessible through
the collection() and defaultCollection() methods.
To create a special collection, use a SpecialCollectionsRequestJob.
This will create the special collections you request and automatically
register them with SpecialCollections, so that it now knows they are available.
This class monitors all special collections known to it, and removes it
from the known list if they are deleted. Note that this class does not
automatically rebuild the collections that disappeared.
The defaultCollectionsChanged() and collectionsChanged() signals are emitted when
the special collections for a resource change (i.e. some became available or some
become unavailable).
@author Constantin Berzan <exit3219@gmail.com>
@since 4.4
*/
class AKONADI_EXPORT SpecialCollections : public QObject
{
Q_OBJECT
public:
/**
* Destroys the special collections object.
*/
~SpecialCollections();
/**
* Returns whether the given agent @p instance has a special collection of
* the given @p type.
*/
bool hasCollection(const QByteArray &type, const AgentInstance &instance) const;
/**
* Returns the special collection of the given @p type in the given agent
* @p instance, or an invalid collection if such a collection is unknown.
*/
Akonadi::Collection collection(const QByteArray &type, const AgentInstance &instance) const;
/**
* Registers the given @p collection as a special collection
* with the given @p type.
* @param type the special type of @c collection
* @param collection the given collection to register
* The collection must be owned by a valid resource.
* Registering a new collection of a previously registered type forgets the
* old collection.
*/
bool registerCollection(const QByteArray &type, const Akonadi::Collection &collection);
/**
* Unregisters the given @p collection as a spec ial collection.
* @param type the special type of @c collection
* @since 4.12
*/
bool unregisterCollection(const Collection &collection);
/**
* unsets the special collection attribute which marks @p collection as being a special
* collection.
* @since 4.12
*/
static void unsetSpecialCollection(const Akonadi::Collection &collection);
/**
* Sets the special collection attribute which marks @p collection as being a special
* collection of type @p type.
* This is typically used by configuration dialog for resources, when the user can choose
* a specific special collection (ex: IMAP trash).
*
* @since 4.11
*/
static void setSpecialCollectionType(const QByteArray &type, const Akonadi::Collection &collection);
/**
* Returns whether the default resource has a special collection of
* the given @p type.
*/
bool hasDefaultCollection(const QByteArray &type) const;
/**
* Returns the special collection of given @p type in the default
* resource, or an invalid collection if such a collection is unknown.
*/
Akonadi::Collection defaultCollection(const QByteArray &type) const;
Q_SIGNALS:
/**
* Emitted when the special collections for a resource have been changed
* (for example, some become available, or some become unavailable).
*
* @param instance The instance of the resource the collection belongs to.
*/
void collectionsChanged(const Akonadi::AgentInstance &instance);
/**
* Emitted when the special collections for the default resource have
* been changed (for example, some become available, or some become unavailable).
*/
void defaultCollectionsChanged();
protected:
/**
* Creates a new special collections object.
*
* @param config The configuration skeleton that provides the default resource id.
* @param parent The parent object.
*/
explicit SpecialCollections(KCoreConfigSkeleton *config, QObject *parent = 0);
private:
//@cond PRIVATE
friend class SpecialCollectionsRequestJob;
friend class SpecialCollectionsRequestJobPrivate;
friend class SpecialCollectionsPrivate;
#if 1 // TODO do this only if building tests:
friend class SpecialMailCollectionsTesting;
friend class LocalFoldersTest;
#endif
SpecialCollectionsPrivate *const d;
Q_PRIVATE_SLOT(d, void collectionRemoved(const Akonadi::Collection &))
Q_PRIVATE_SLOT(d, void collectionStatisticsChanged(Akonadi::Collection::Id, const Akonadi::CollectionStatistics &))
Q_PRIVATE_SLOT(d, void collectionFetchJobFinished(KJob *))
//@endcond
};
} // namespace Akonadi
#endif // AKONADI_SPECIALCOLLECTIONS_H
|