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
|
/**************************************************************************
* Copyright (C) 2009 Ben Cooksley <bcooksley@kde.org> *
* Copyright (C) 2007 Will Stephenson <wstephenson@kde.org> *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License *
* as published by the Free Software Foundation; either version 2 *
* of the License, or (at your option) any later version. *
* *
* 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 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 MENUPROXYMODEL_H
#define MENUPROXYMODEL_H
#include <KCategorizedSortFilterProxyModel>
#include "systemsettingsview_export.h"
/**
* @brief Provides a filter model for MenuModel
*
* Provides a standardised model to be used with views to filter a MenuModel.\n
* It automatically sorts the items appropriately depending on if it is categorised
* or not.
* Call setFilterRegExp(QString) with the desired text to filter to perform searching.
* Items that do not match the search parameters will be disabled, not hidden.
*
* @author Will Stephenson <wstephenson@kde.org>
* @author Ben Cooksley <bcooksley@kde.org>
*/
class SYSTEMSETTINGSVIEW_EXPORT MenuProxyModel : public KCategorizedSortFilterProxyModel
{
Q_OBJECT
Q_PROPERTY(QString filterRegExp READ filterRegExp WRITE setFilterRegExp NOTIFY filterRegExpChanged)
public:
/**
* Constructs a MenuProxyModel with the specified parent.
*
* @param parent The QObject to use as a parent.
*/
MenuProxyModel( QObject *parent = nullptr );
QHash<int, QByteArray> roleNames() const override;
/**
* Please see the Qt QSortFilterProxyModel documentation for further information.\n
* Provides information on whether or not the QModelIndex specified by left is below right.
*
* @param left the QModelIndex that is being used for comparing.
* @param right the QModelIndex to compare against.
* @returns true if the left is below the right.
*/
bool lessThan( const QModelIndex &left, const QModelIndex &right ) const override;
/**
* Please see the KDE KCategorizedSortFilterProxyModel documentation for further information.\n
* Provides information on whether or not the QModelIndex specified by left is below right.
*
* @param left the QModelIndex that is being used for comparing.
* @param right the QModelIndex to compare against.
* @returns true if the left is below the right.
*/
bool subSortLessThan( const QModelIndex &left, const QModelIndex &right ) const override;
/**
* Please see the Qt QSortFilterProxyModel documentation for futher information.\n
* Provides additional filtering of the MenuModel to only show categories which contain modules.
*
* @param source_column Please see QSortFilterProxyModel documentation.
* @param source_parent Please see QSortFilterProxyModel documentation.
* @returns true if the row should be displayed, false if it should not.
*/
bool filterAcceptsRow( int source_column, const QModelIndex &source_parent ) const override;
/**
* Please see Qt QAbstractItemModel documentation for more details.\n
* Provides the status flags for the QModelIndex specified.
* The item will be selectable and enabled for its status unless invalid or filtered by search terms.
*
* @returns The flags for the QModelIndex provided.
*/
Qt::ItemFlags flags( const QModelIndex &index ) const override;
/**
* Please see Qt QAbstractItemModel documentation for more details.\n
* Reimplemented for internal reasons.
*/
void setFilterRegExp ( const QRegExp & regExp );
/**
* Please see Qt QAbstractItemModel documentation for more details.\n
* Reimplemented for internal reasons.
*/
void setFilterRegExp ( const QString & pattern );
QString filterRegExp() const;
/**
* makes the filter highlight matching entries instead of hiding them
*/
void setFilterHighlightsEntries (bool highlight );
/**
* @returns the filter highlight matching entries instead of hiding them, default true
*/
bool filterHighlightsEntries() const;
Q_SIGNALS:
void filterRegExpChanged();
private:
bool m_filterHighlightsEntries : 1;
};
#endif
|
