1 | /**************************************************************************** |
2 | ** |
3 | ** Copyright (C) 2015 The Qt Company Ltd. |
4 | ** Contact: http://www.qt.io/licensing/ |
5 | ** |
6 | ** This file is part of the QtOrganizer module of the Qt Toolkit. |
7 | ** |
8 | ** $QT_BEGIN_LICENSE:LGPL21$ |
9 | ** Commercial License Usage |
10 | ** Licensees holding valid commercial Qt licenses may use this file in |
11 | ** accordance with the commercial license agreement provided with the |
12 | ** Software or, alternatively, in accordance with the terms contained in |
13 | ** a written agreement between you and The Qt Company. For licensing terms |
14 | ** and conditions see http://www.qt.io/terms-conditions. For further |
15 | ** information use the contact form at http://www.qt.io/contact-us. |
16 | ** |
17 | ** GNU Lesser General Public License Usage |
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser |
19 | ** General Public License version 2.1 or version 3 as published by the Free |
20 | ** Software Foundation and appearing in the file LICENSE.LGPLv21 and |
21 | ** LICENSE.LGPLv3 included in the packaging of this file. Please review the |
22 | ** following information to ensure the GNU Lesser General Public License |
23 | ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and |
24 | ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
25 | ** |
26 | ** As a special exception, The Qt Company gives you certain additional |
27 | ** rights. These rights are described in The Qt Company LGPL Exception |
28 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
29 | ** |
30 | ** $QT_END_LICENSE$ |
31 | ** |
32 | ****************************************************************************/ |
33 | |
34 | #include "qorganizeritemintersectionfilter.h" |
35 | #include "qorganizeritemintersectionfilter_p.h" |
36 | |
37 | QT_BEGIN_NAMESPACE_ORGANIZER |
38 | |
39 | /*! |
40 | \class QOrganizerItemIntersectionFilter |
41 | \brief The QOrganizerItemIntersectionFilter class provides a filter which intersects the results |
42 | of other filters. |
43 | \inmodule QtOrganizer |
44 | \ingroup organizer-filters |
45 | |
46 | It may be used to select organizer items which match all of the filters in the intersection filter. |
47 | */ |
48 | |
49 | Q_IMPLEMENT_ORGANIZERITEMFILTER_PRIVATE(QOrganizerItemIntersectionFilter) |
50 | |
51 | /*! |
52 | \fn QOrganizerItemIntersectionFilter::QOrganizerItemIntersectionFilter(const QOrganizerItemFilter &other) |
53 | |
54 | Constructs a copy of \a other if possible, otherwise constructs a new intersection filter. |
55 | */ |
56 | |
57 | /*! |
58 | Constructs a new intersection filter. |
59 | */ |
60 | QOrganizerItemIntersectionFilter::QOrganizerItemIntersectionFilter() |
61 | : QOrganizerItemFilter(new QOrganizerItemIntersectionFilterPrivate) |
62 | { |
63 | } |
64 | |
65 | /*! |
66 | Sets the filters whose criteria will be intersected to \a filters. |
67 | |
68 | \sa filters(), clear() |
69 | */ |
70 | void QOrganizerItemIntersectionFilter::setFilters(const QList<QOrganizerItemFilter> &filters) |
71 | { |
72 | Q_D(QOrganizerItemIntersectionFilter); |
73 | d->m_filters = filters; |
74 | } |
75 | |
76 | /*! |
77 | Clears the list of filters. Note that an empty intersection filter will match no items. |
78 | |
79 | \sa filters(), setFilters() |
80 | */ |
81 | void QOrganizerItemIntersectionFilter::clear() |
82 | { |
83 | Q_D(QOrganizerItemIntersectionFilter); |
84 | d->m_filters.clear(); |
85 | } |
86 | |
87 | /*! |
88 | Prepends the given \a filter to the list of intersected filters. |
89 | |
90 | \sa append(), filters() |
91 | */ |
92 | void QOrganizerItemIntersectionFilter::prepend(const QOrganizerItemFilter &filter) |
93 | { |
94 | Q_D(QOrganizerItemIntersectionFilter); |
95 | d->m_filters.prepend(t: filter); |
96 | } |
97 | |
98 | /*! |
99 | Appends the given \a filter to the list of intersected filters. |
100 | |
101 | \sa operator<<(), prepend(), filters() |
102 | */ |
103 | void QOrganizerItemIntersectionFilter::append(const QOrganizerItemFilter &filter) |
104 | { |
105 | Q_D(QOrganizerItemIntersectionFilter); |
106 | d->m_filters.append(t: filter); |
107 | } |
108 | |
109 | /*! |
110 | Removes the given \a filter from the intersection list. |
111 | |
112 | \sa filters(), append(), prepend(), clear() |
113 | */ |
114 | void QOrganizerItemIntersectionFilter::remove(const QOrganizerItemFilter &filter) |
115 | { |
116 | Q_D(QOrganizerItemIntersectionFilter); |
117 | d->m_filters.removeAll(t: filter); |
118 | } |
119 | |
120 | /*! |
121 | Appends the given \a filter to the list of intersected filters. |
122 | |
123 | \sa append() |
124 | */ |
125 | QOrganizerItemIntersectionFilter &QOrganizerItemIntersectionFilter::operator<<(const QOrganizerItemFilter &filter) |
126 | { |
127 | Q_D(QOrganizerItemIntersectionFilter); |
128 | d->m_filters << filter; |
129 | return *this; |
130 | } |
131 | |
132 | /*! |
133 | Returns the list of filters which form the intersection filter. |
134 | |
135 | \sa setFilters(), prepend(), append(), remove() |
136 | */ |
137 | QList<QOrganizerItemFilter> QOrganizerItemIntersectionFilter::filters() const |
138 | { |
139 | Q_D(const QOrganizerItemIntersectionFilter); |
140 | return d->m_filters; |
141 | } |
142 | |
143 | QT_END_NAMESPACE_ORGANIZER |
144 | |