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
|
/* This file is part of the KDE libraries
Copyright (C) Stephan Kulow <coolo@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef KFILEFILTERCOMBO_H
#define KFILEFILTERCOMBO_H
#include <kfile_export.h>
#include <QtCore/QStringList>
#include <kcombobox.h>
class KFILE_EXPORT KFileFilterCombo : public KComboBox
{
Q_OBJECT
public:
/**
* Creates a new filter combo box.
*
* @param parent The parent widget.
*/
KFileFilterCombo(QWidget *parent=0);
/**
* Destroys the filter combo box.
*/
~KFileFilterCombo();
/**
* Sets the @p filter string.
*/
void setFilter(const QString& filter);
/**
* @returns the current filter, either something like "*.cpp *.h"
* or the current mimetype, like "text/html", or a list of those, like
" "text/html text/plain image/png", all separated with one space.
*/
QString currentFilter() const;
/**
* Sets the current filter. Filter must match one of the filter items
* passed before to this widget.
*/
void setCurrentFilter( const QString& filter );
/**
* Sets a list of mimetypes.
* If @p defaultType is set, it will be set as the current item.
* Otherwise, a first item showing all the mimetypes will be created.
*/
void setMimeFilter( const QStringList& types, const QString& defaultType );
/**
* @return true if the filter's first item is the list of all mimetypes
*/
bool showsAllTypes() const;
/**
* This method allows you to set a default-filter, that is used when an
* empty filter is set. Make sure you call this before calling
* setFilter().
*
* By default, this is set to i18n("*|All Files")
* @see defaultFilter
*/
void setDefaultFilter( const QString& filter );
/**
* @return the default filter, used when an empty filter is set.
* @see setDefaultFilter
*/
QString defaultFilter() const;
/**
* @return all filters (this can be a list of patterns or a list of mimetypes)
*/
QStringList filters() const;
/**
* Returns true if the filter has been set using setMimeFilter().
* @since 4.6.1
*/
bool isMimeFilter() const;
protected:
virtual bool eventFilter( QObject*, QEvent* );
Q_SIGNALS:
/**
* This signal is emitted whenever the filter has been changed.
*/
void filterChanged();
private:
class Private;
Private* const d;
Q_PRIVATE_SLOT( d, void _k_slotFilterChanged() )
};
#endif
|