/usr/include/KF5/akonadi/kmime/specialmailcollections.h is in libkf5akonadimime-dev 4:15.12.3-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 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 | /*
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_SPECIALMAILCOLLECTIONS_H
#define AKONADI_SPECIALMAILCOLLECTIONS_H
#include "akonadi-mime_export.h"
#include <specialcollections.h>
namespace Akonadi
{
class SpecialMailCollectionsPrivate;
/**
@short Interface to special mail collections such as inbox, outbox etc.
This class is the central interface to the local mail folders. These folders
can either be in the default resource (stored in ~/.local/share/local-mail)
or in any number of custom resources. Special collections of the following types
are supported: inbox, outbox, sent-mail, trash, drafts, templates and spam.
To check whether a special mail collection is available, simply use the hasCollection() and
hasDefaultCollection() methods. Available special mail collections are accessible through
the collection() and defaultCollection() methods.
To create a special mail collection, use a SpecialMailCollectionsRequestJob.
This will create the special mail collections you request and automatically
register them with SpecialMailCollections, so that it now knows they are available.
This class monitors all special mail 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 mail collections for a resource change (i.e. some became available or some
become unavailable).
@code
if ( SpecialMailCollections::self()->hasDefaultCollection( SpecialMailCollections::Outbox ) ) {
const Collection col = SpecialMailCollections::self()->defaultCollection( SpecialMailCollections::Outbox );
// ...
} else {
// ... use SpecialMailCollectionsRequestJob to request the collection...
}
@endcode
@author Constantin Berzan <exit3219@gmail.com>
@since 4.4
*/
class AKONADI_MIME_EXPORT SpecialMailCollections : public SpecialCollections
{
Q_OBJECT
public:
/**
* Describes the possible types of special mail collections.
*
* Generally, there may not be two special mail collections of
* the same type in the same resource.
*/
enum Type {
Invalid = -1, ///< An invalid special collection.
Root = 0, ///< The root collection containing the local folders.
Inbox, ///< The inbox collection.
Outbox, ///< The outbox collection.
SentMail, ///< The sent-mail collection.
Trash, ///< The trash collection.
Drafts, ///< The drafts collection.
Templates, ///< The templates collection.
LastType ///< @internal marker
};
/**
* Returns the global SpecialMailCollections instance.
*/
static SpecialMailCollections *self();
/**
* Returns whether the given agent @p instance has a special collection of
* the given @p type.
*/
bool hasCollection(Type type, const AgentInstance &instance) const;
/**
* Returns the special mail 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(Type type, const AgentInstance &instance) const;
/**
* Returns the special collection type for a given collection, or empty if the collection
* doesn't have a special type.
* @since 4.11
*/
static Type specialCollectionType(const Akonadi::Collection &collection);
/**
* Registers the given @p collection as a special mail collection
* with the given @p type.
* @param type the type of collection
* @param collection the 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(Type type, const Akonadi::Collection &collection);
/**
* Unregisters the given @p collection as a special mail collection
* @param collection the collection to unregister
* The collection must be owned by a valid resource.
* @since 4.12
*/
bool unregisterCollection(const Collection &collection);
/**
* Returns whether the default resource has a special mail collection of
* the given @p type.
*/
bool hasDefaultCollection(Type type) const;
/**
* Returns the special mail collection of given @p type in the default
* resource, or an invalid collection if such a collection is unknown.
*/
Akonadi::Collection defaultCollection(Type type) const;
void verifyI18nDefaultCollection(Type type);
private Q_SLOTS:
void slotCollectionModified(KJob *job);
private:
//@cond PRIVATE
friend class SpecialMailCollectionsPrivate;
#if 1 // TODO do this only if building tests:
friend class SpecialMailCollectionsTesting;
friend class LocalFoldersTest;
#endif
SpecialMailCollections(SpecialMailCollectionsPrivate *dd);
SpecialMailCollectionsPrivate *const d;
//@endcond
};
} // namespace Akonadi
#endif // AKONADI_SPECIALMAILCOLLECTIONS_H
|