File indexing completed on 2024-11-24 04:50:45

 // SPDX-FileCopyrightText: 2007-2009 Tobias Koenig <tokoe@kde.org>
 // SPDX-License-Identifier: LGPL-2.0-or-later
 
 #pragma once
 
 #include <Akonadi/Collection>
 #include <QSortFilterProxyModel>
 #include <memory>
 #include <qobjectdefs.h>
 
 namespace Akonadi
 {
 namespace Quick
 {
 class CollectionPickerModelPrivate;
 
 /**
  * @short The model for a Picker for selecting an Akonadi collection.
  *
  * This model provides a way easily select a collection
  * from the Akonadi storage.
  * The available collections can be filtered by mime type and
  * access rights.
  *
  * Example:
  *
  * @code{.qml}
  *
  * import QtQuick.Controls 2.15 as QQC2
  * import org.kde.akonadi 1.0 as Akonadi
  *
  * QQC2.Picker {
  *     model: AkonadiQuick.PickerModel {
  *         mimeTypeFilter: [Akonadi.MimeTypes.address, Akonadi.MimeTypes.contactGroup]
  *         accessRightsFilter: Akonadi.Collection.CanCreateItem
  *     }
  * }
  * @endcode
  *
  * @author Carl Schwan <carl@carlschwan.eu>
  */
 class CollectionPickerModel : public QSortFilterProxyModel
 {
     Q_OBJECT
     Q_PROPERTY(QStringList mimeTypeFilter READ mimeTypeFilter WRITE setMimeTypeFilter NOTIFY mimeTypeFilterChanged)
     Q_PROPERTY(Akonadi::Collection::Right accessRightsFilter READ accessRightsFilter WRITE setAccessRightsFilter NOTIFY accessRightsFilterChanged)
     Q_PROPERTY(bool excludeVirtualCollections READ excludeVirtualCollections WRITE setExcludeVirtualCollections NOTIFY excludeVirtualCollectionsChanged)
 
 public:
     explicit CollectionPickerModel(QObject *parent = nullptr);
     ~CollectionPickerModel() override;
 
     /**
      * Sets the content @p mimetypes the collections shall be filtered by.
      */
     void setMimeTypeFilter(const QStringList &mimetypes);
 
     /**
      * Returns the content mimetype the collections are filtered by.
      * Don't assume this list has the original order.
      */
     [[nodiscard]] QStringList mimeTypeFilter() const;
 
     /**
      * Sets the access @p rights the collections shall be filtered by.
      */
     void setAccessRightsFilter(Akonadi::Collection::Right rights);
 
     /**
      * Returns the access rights the collections are filtered by.
      */
     [[nodiscard]] Akonadi::Collection::Right accessRightsFilter() const;
 
     /**
      * Sets if the virtual collections are excluded.
      */
     void setExcludeVirtualCollections(bool b);
 
     /**
      * Returns if the virual exollections are excluded
      */
     [[nodiscard]] bool excludeVirtualCollections() const;
 
 Q_SIGNALS:
     void mimeTypeFilterChanged();
     void accessRightsFilterChanged();
     void excludeVirtualCollectionsChanged();
 
 private:
     std::unique_ptr<CollectionPickerModelPrivate> const d;
 };
 
 }
 }