/* * Copyright (C) 2007 Ivan Cukic * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Library/Lesser General Public License * version 2, or (at your option) any later version, as published by the * Free Software Foundation * * 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 Library/Lesser General Public * License along with this program; if not, write to the * Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #ifndef KCATEGORIZEDITEMSVIEWMODELS_H_ #define KCATEGORIZEDITEMSVIEWMODELS_H_ #include #include #include #include namespace KCategorizedItemsViewModels { typedef QPair Filter; /** * Abstract class that needs to be implemented and used with the ItemModel */ class AbstractItem : public QStandardItem { public: /** * Returns a localized string - name of the item */ virtual QString name() const; /** * Returns a localized string - description of the item */ virtual QString description() const; /** * Returns if the item is flagged as favorite * Default implementation checks if the item passes the Filter("favorite", "1") filter */ virtual bool isFavorite() const; /** * Returns the item's number of running applets * Default implementation just returns 0 */ virtual int running() const; /** * Returns if the item contains string specified by pattern. * Default implementation checks whether name or description contain the * string (not needed to be exactly that string) */ virtual bool matches(const QString &pattern) const; /** * sets the favorite flag for the item */ virtual void setFavorite(bool favorite) = 0; /** * sets the number of running applets for the item */ virtual void setRunning(int count) = 0; /** * Returns if the item passes the filter specified */ virtual bool passesFiltering(const Filter &filter) const = 0; private: }; /** * The default implementation of the model containing filters */ class DefaultFilterModel : public QStandardItemModel { public: DefaultFilterModel(QObject *parent = 0); /** * Adds a filter to the model * @param caption The localized string to be displayed as a name of the filter * @param filter The filter structure */ void addFilter(const QString &caption, const Filter &filter, const KIcon &icon = KIcon()); /** * Adds a separator to the model * @param caption The localized string to be displayed as a name of the separator */ void addSeparator(const QString &caption); }; /** * Default filter proxy model. */ class DefaultItemFilterProxyModel : public QSortFilterProxyModel { Q_OBJECT public: DefaultItemFilterProxyModel(QObject *parent = 0); bool filterAcceptsRow(int sourceRow, const QModelIndex &sourceParent) const; bool lessThan(const QModelIndex &left, const QModelIndex &right) const; void setSearch(const QString &pattern); void setFilter(const Filter &filter); void setSourceModel(QAbstractItemModel *sourceModel); QStandardItemModel *sourceModel() const; int columnCount(const QModelIndex &index) const; QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const; Q_SIGNALS: void searchTermChanged(const QString &term); private: class InnerProxyModel : public QAbstractItemModel { public: InnerProxyModel(QObject *parent = 0); Qt::ItemFlags flags(const QModelIndex &index) const; QVariant data(const QModelIndex &index, bool favoriteColumn, int role = Qt::DisplayRole) const; QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const; bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole); QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const; bool setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole); int rowCount(const QModelIndex &parent = QModelIndex()) const; int columnCount(const QModelIndex &index) const; QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const; QModelIndex parent(const QModelIndex &index) const; QMimeData *mimeData(const QModelIndexList &indexes) const; void setSourceModel(QStandardItemModel *sourceModel); QStandardItemModel *sourceModel() const; private: QStandardItemModel *m_sourceModel; }; Filter m_filter; QString m_searchPattern; InnerProxyModel m_innerModel; }; /** * The default implementation of the model containing items. It /is/ QStandardItemModel */ class DefaultItemModel : public QStandardItemModel { public: DefaultItemModel(QObject *parent = 0); }; } Q_DECLARE_METATYPE(KCategorizedItemsViewModels::Filter) #endif /*KCATEGORIZEDITEMSVIEWMODELS_H_*/