/**************************************************************************** ** ** Copyright (C) 2015 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing/ ** ** This file is part of the Qt Messaging Framework. ** ** $QT_BEGIN_LICENSE:LGPL21$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see http://www.qt.io/terms-conditions. For further ** information use the contact form at http://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 or version 3 as published by the Free ** Software Foundation and appearing in the file LICENSE.LGPLv21 and ** LICENSE.LGPLv3 included in the packaging of this file. Please review the ** following information to ensure the GNU Lesser General Public License ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** As a special exception, The Qt Company gives you certain additional ** rights. These rights are described in The Qt Company LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QMAILMESSAGESET_H #define QMAILMESSAGESET_H #include "qprivateimplementation.h" #include "qmflist.h" #include #include #include #include #include "qmailaccountkey.h" #include "qmailfolderkey.h" #include "qmailmessagekey.h" class QMailMessageSet; class QMailMessageSetModel; class QMailStore; class QMailMessageSetContainerPrivate; class QMF_EXPORT QMailMessageSetContainer : public QPrivatelyNoncopyable { public: typedef QMailMessageSetContainerPrivate ImplementationType; virtual ~QMailMessageSetContainer(); int count() const; QMailMessageSet *at(int i) const; int indexOf(QMailMessageSet *child) const; virtual void append(QMailMessageSet *child); virtual void update(QMailMessageSet *child); virtual void remove(QMailMessageSet *child); virtual void remove(const QList &obsoleteChildren); virtual void removeDescendants(); QMailMessageSetContainer *parentContainer(); virtual QMailMessageSetModel *model() = 0; protected: template QMailMessageSetContainer(Subclass *p); virtual void resyncState(); private: friend class QMailMessageSet; virtual QObject *qObject() = 0; }; class QMailMessageSetPrivate; class QMF_EXPORT QMailMessageSet : public QObject, public QMailMessageSetContainer { Q_OBJECT public: typedef QMailMessageSetPrivate ImplementationType; QMailMessageSet(QMailMessageSetContainer *container); ~QMailMessageSet(); virtual QMailMessageKey messageKey() const = 0; virtual QMailMessageKey descendantsMessageKey() const; virtual QString displayName() const = 0; QVariant data(int role, int column = 0); QModelIndex modelIndex(int column = 0); QObject *qObject() override; QMailMessageSetModel *model() override; protected: friend class QMailMessageSetContainer; template QMailMessageSet(Subclass *p, QMailMessageSetContainer *container); virtual void init(); }; class QMailFolderMessageSetPrivate; class QMF_EXPORT QMailFolderMessageSet : public QMailMessageSet { Q_OBJECT public: typedef QMailFolderMessageSetPrivate ImplementationType; QMailFolderMessageSet(QMailMessageSetContainer *container, const QMailFolderId &folderId, bool hierarchical = true); QMailFolderId folderId() const; bool hierarchical() const; QMailMessageKey messageKey() const override; QMailMessageKey descendantsMessageKey() const override; QString displayName() const override; static QMailMessageKey contentKey(const QMailFolderId &id, bool descendants); protected Q_SLOTS: virtual void foldersAdded(const QMailFolderIdList &ids); virtual void foldersRemoved(const QMailFolderIdList &ids); virtual void foldersUpdated(const QMailFolderIdList &ids); virtual void folderContentsModified(const QMailFolderIdList &ids); protected: void init() override; virtual void synchronizeChildren(); virtual void createChild(const QMailFolderId &childId); void resyncState() override; QMailFolderKey folderKey() const; }; class QMailAccountMessageSetPrivate; class QMF_EXPORT QMailAccountMessageSet : public QMailMessageSet { Q_OBJECT public: typedef QMailAccountMessageSetPrivate ImplementationType; QMailAccountMessageSet(QMailMessageSetContainer *container, const QMailAccountId &accountId, bool hierarchical = true); QMailAccountId accountId() const; bool hierarchical() const; QMailMessageKey messageKey() const override; QMailMessageKey descendantsMessageKey() const override; QString displayName() const override; static QMailMessageKey contentKey(const QMailAccountId &id, bool descendants); protected Q_SLOTS: virtual void foldersAdded(const QMailFolderIdList &ids); virtual void foldersRemoved(const QMailFolderIdList &ids); virtual void foldersUpdated(const QMailFolderIdList &ids); virtual void accountsUpdated(const QMailAccountIdList &ids); virtual void accountContentsModified(const QMailAccountIdList &ids); protected: void init() override; virtual void synchronizeChildren(); virtual void createChild(const QMailFolderId &childId); void resyncState() override; QMailFolderKey rootFolderKey() const; }; class QMailFilterMessageSetPrivate; class QMF_EXPORT QMailFilterMessageSet : public QMailMessageSet { Q_OBJECT public: typedef QMailFilterMessageSetPrivate ImplementationType; QMailFilterMessageSet(QMailMessageSetContainer *container, const QMailMessageKey &key, const QString &name, bool minimalUpdates = true); QMailMessageKey messageKey() const override; virtual void setMessageKey(const QMailMessageKey &key); QString displayName() const override; virtual void setDisplayName(const QString &name); virtual bool updatesMinimized() const; virtual void setUpdatesMinimized(bool set); protected Q_SLOTS: virtual void messagesAdded(const QMailMessageIdList &ids); virtual void messagesRemoved(const QMailMessageIdList &ids); virtual void messagesUpdated(const QMailMessageIdList &ids); virtual void folderContentsModified(const QMailFolderIdList &ids); protected: void init() override; virtual void reset(); void resyncState() override; }; class QMailMessageSetModelPrivate; class QMF_EXPORT QMailMessageSetModel : public QAbstractItemModel, public QMailMessageSetContainer { Q_OBJECT public: typedef QMailMessageSetModelPrivate ImplementationType; enum Roles { DisplayNameRole = Qt::UserRole, MessageKeyRole, SubclassUserRole }; QMailMessageSetModel(QObject *parent = Q_NULLPTR); virtual ~QMailMessageSetModel(); int rowCount(const QModelIndex &parentIndex) const override; int columnCount(const QModelIndex &) const override; bool isEmpty() const; QModelIndex index(int row, int column, const QModelIndex &parentIndex) const override; QModelIndex parent(const QModelIndex &index) const override; QModelIndex indexFromAccountId(const QMailAccountId &id) const; QModelIndex indexFromFolderId(const QMailFolderId &id) const; QMailAccountId accountIdFromIndex(const QModelIndex &index) const; QMailFolderId folderIdFromIndex(const QModelIndex &index) const; QMailMessageSet *itemFromIndex(const QModelIndex &index) const; QModelIndex indexFromItem(QMailMessageSet *item) const; QVariant data(const QModelIndex &index, int role) const override; virtual QVariant data(QMailMessageSet *item, int role, int column) const; QMailMessageSetModel *model() override; bool ignoreMailStoreUpdates() const; void setIgnoreMailStoreUpdates(bool ignore); Q_SIGNALS: void accountsAdded(const QMailAccountIdList &ids); void accountsUpdated(const QMailAccountIdList &ids); void accountsRemoved(const QMailAccountIdList &ids); void accountContentsModified(const QMailAccountIdList &ids); void foldersAdded(const QMailFolderIdList &ids); void foldersRemoved(const QMailFolderIdList &ids); void foldersUpdated(const QMailFolderIdList &ids); void folderContentsModified(const QMailFolderIdList &ids); void messagesAdded(const QMailMessageIdList &ids); void messagesRemoved(const QMailMessageIdList &ids); void messagesUpdated(const QMailMessageIdList &ids); protected Q_SLOTS: void mailStoreAccountsAdded(const QMailAccountIdList &ids); void mailStoreAccountsUpdated(const QMailAccountIdList &ids); void mailStoreAccountsRemoved(const QMailAccountIdList &ids); void mailStoreAccountContentsModified(const QMailAccountIdList &ids); void mailStoreFoldersAdded(const QMailFolderIdList &ids); void mailStoreFoldersRemoved(const QMailFolderIdList &ids); void mailStoreFoldersUpdated(const QMailFolderIdList &ids); void mailStoreFolderContentsModified(const QMailFolderIdList &ids); void mailStoreMessagesAdded(const QMailMessageIdList &ids); void mailStoreMessagesRemoved(const QMailMessageIdList &ids); void mailStoreMessagesUpdated(const QMailMessageIdList &ids); void ceasePropagatingUpdates(); void delayedInit(); protected: QMailAccountId itemAccountId(QMailMessageSet *item) const; QMailFolderId itemFolderId(QMailMessageSet *item) const; virtual void appended(QMailMessageSet *child); virtual void removed(QMailMessageSet *child); virtual void updated(QMailMessageSet *child); private: friend class QMailMessageSetContainer; friend class QMailMessageSet; QObject *qObject() override; void beginAppend(QMailMessageSet *child); void endAppend(QMailMessageSet *child); void beginRemove(QMailMessageSet *child); void endRemove(QMailMessageSet *child); void doUpdate(QMailMessageSet *child); bool propagateUpdates() const; void testForResync(); QModelIndex index(QMailMessageSet *item, int column) const; QModelIndex parentIndex(QMailMessageSet *item, int column) const; }; #endif