kaddressbook
Filter Class Reference
#include <filter.h>
Detailed Description
Filter for AddressBook related objects (Addressees).
- Todo:
- This class should be switched to use shared data.
Definition at line 39 of file filter.h.
Public Types | |
enum | MatchRule { Matching = 0, NotMatching = 1 } |
typedef QValueList< Filter > | List |
Public Member Functions | |
Filter () | |
Filter (const QString &name) | |
~Filter () | |
void | setName (const QString &name) |
const QString & | name () const |
bool | isInternal () const |
void | apply (KABC::Addressee::List &addresseeList) |
bool | filterAddressee (const KABC::Addressee &a) const |
void | setEnabled (bool on) |
bool | isEnabled () const |
void | setCategories (const QStringList &list) |
const QStringList & | categories () const |
void | save (KConfig *config) |
void | restore (KConfig *config) |
void | setMatchRule (MatchRule rule) |
MatchRule | matchRule () const |
bool | isEmpty () const |
Static Public Member Functions | |
static void | save (KConfig *config, const QString &baseGroup, Filter::List &list) |
static Filter::List | restore (KConfig *config, const QString &baseGroup) |
Member Function Documentation
void Filter::setName | ( | const QString & | name | ) |
const QString & Filter::name | ( | ) | const |
bool Filter::isInternal | ( | ) | const |
void Filter::apply | ( | KABC::Addressee::List & | addresseeList | ) |
Apply the filter to the addressee list.
All addressees not passing the filter criterias will be removed from the list.
If the MatchRule is NotMatch, then all the addressees matching the filter will be removed from the list.
Definition at line 64 of file filter.cpp.
bool Filter::filterAddressee | ( | const KABC::Addressee & | a | ) | const |
Apply the filter to the addressee.
- Returns:
- True if the addressee passes the criteria, false otherwise. The return values are opposite if the MatchRule is NotMatch.
Definition at line 75 of file filter.cpp.
void Filter::setEnabled | ( | bool | on | ) |
bool Filter::isEnabled | ( | ) | const |
void Filter::setCategories | ( | const QStringList & | list | ) |
Set the list of categories.
This list is used to filter addressees.
Definition at line 112 of file filter.cpp.
const QStringList & Filter::categories | ( | ) | const |
void Filter::save | ( | KConfig * | config | ) |
Saves the filter to the config file.
The group should already be set.
Definition at line 124 of file filter.cpp.
void Filter::restore | ( | KConfig * | config | ) |
Loads the filter from the config file.
The group should already be set.
Definition at line 132 of file filter.cpp.
void Filter::save | ( | KConfig * | config, | |
const QString & | baseGroup, | |||
Filter::List & | list | |||
) | [static] |
Saves a list of filters to the config file.
- Parameters:
-
config The config file to use baseGroup The base groupname to use. The number of filters will be written to this group, then a _1, _2, etc will be append for each filter saved. list The list of filters to be saved.
Definition at line 142 of file filter.cpp.
Filter::List Filter::restore | ( | KConfig * | config, | |
const QString & | baseGroup | |||
) | [static] |
Restores a list of filters from a config file.
- Parameters:
-
config The config file to read from. baseGroup The base group name to be used to find the filters
- Returns:
- The list of filters.
Definition at line 169 of file filter.cpp.
void Filter::setMatchRule | ( | MatchRule | rule | ) |
Sets the filter rule.
If the rule is Filter::Matching (default), then the filter will return true on items that match the filter. If the rule is Filter::NotMatching, then the filter will return true on items that do not match the filter.
Definition at line 204 of file filter.cpp.
Filter::MatchRule Filter::matchRule | ( | ) | const |
bool Filter::isEmpty | ( | ) | const |
The documentation for this class was generated from the following files: