src/kitemviews/private/kfileitemmodelfilter.h

   1 /*
   2  * SPDX-FileCopyrightText: 2011 Janardhan Reddy <annapareddyjanardhanreddy@gmail.com>
   3  *
   4  * SPDX-License-Identifier: GPL-2.0-or-later
   5  */
   6
   7 #ifndef KFILEITEMMODELFILTER_H
   8 #define KFILEITEMMODELFILTER_H
   9
  10 #include "dolphin_export.h"
  11
  12 #include <QStringList>
  13
  14 class KFileItem;
  15 class QRegularExpression;
  16
  17 /**
  18  * @brief Allows to check whether an item of the KFileItemModel
  19  *        matches with a set filter-string.
  20  *
  21  * Currently the filter is only checked for the KFileItem::text()
  22  * property of the KFileItem, but this might get extended in
  23  * future.
  24  */
  25 class DOLPHIN_EXPORT KFileItemModelFilter
  26 {
  27 public:
  28     KFileItemModelFilter();
  29     virtual ~KFileItemModelFilter();
  30
  31     /**
  32      * Sets the pattern that is used for a comparison with the item
  33      * in KFileItemModelFilter::matches(). Per default the pattern
  34      * defines a sub-string. As soon as the pattern contains at least
  35      * a '*', '?' or '[' the pattern represents a regular expression.
  36      */
  37     void setPattern(const QString &pattern);
  38     QString pattern() const;
  39
  40     /**
  41      * Set the list of mimetypes that are used for comparison with the
  42      * item in KFileItemModelFilter::matchesMimeType.
  43      */
  44     void setMimeTypes(const QStringList &types);
  45     QStringList mimeTypes() const;
  46
  47     /**
  48      * @return True if either the pattern or mimetype filters has been set.
  49      */
  50     bool hasSetFilters() const;
  51
  52     /**
  53      * @return True if the item matches with the pattern defined by
  54      *         @ref setPattern() or @ref setMimeTypes
  55      */
  56     bool matches(const KFileItem &item) const;
  57
  58 private:
  59     /**
  60      * @return True if item matches pattern set by @ref setPattern.
  61      */
  62     bool matchesPattern(const KFileItem &item) const;
  63
  64     /**
  65      * @return True if item matches mimetypes set by @ref setMimeTypes.
  66      */
  67     bool matchesType(const KFileItem &item) const;
  68
  69     bool m_useRegExp; // If true, m_regExp is used for filtering,
  70                       // otherwise m_lowerCaseFilter is used.
  71     QRegularExpression *m_regExp;
  72     QString m_lowerCasePattern; // Lowercase version of m_filter for
  73                                 // faster comparison in matches().
  74     QString m_pattern; // Property set by setPattern().
  75     QStringList m_mimeTypes; // Property set by setMimeTypes()
  76 };
  77 #endif