KMSearchRule Class Reference
Incoming mail is sent through the list of mail filter rules before it is placed in the associated mail folder (usually "inbox"). This class represents one search pattern rule. More...
#include <kmsearchpattern.h>
Inheritance diagram for KMSearchRule:

Public Types | |
enum | Function { FuncNone = -1, FuncContains = 0, FuncContainsNot, FuncEquals, FuncNotEqual, FuncRegExp, FuncNotRegExp, FuncIsGreater, FuncIsLessOrEqual, FuncIsLess, FuncIsGreaterOrEqual, FuncIsInAddressbook, FuncIsNotInAddressbook, FuncIsInCategory, FuncIsNotInCategory, FuncHasAttachment, FuncHasNoAttachment } |
Public Member Functions | |
KMSearchRule (const QCString &field=0, Function=FuncContains, const QString &contents=QString::null) | |
KMSearchRule (const KMSearchRule &other) | |
const KMSearchRule & | operator= (const KMSearchRule &other) |
virtual bool | matches (const KMMessage *msg) const =0 |
virtual bool | matches (const DwString &str, KMMessage &msg, const DwBoyerMoore *headerField=0, int headerLen=-1) const |
virtual bool | isEmpty () const =0 |
virtual bool | requiresBody () const |
void | writeConfig (KConfig *config, int aIdx) const |
Function | function () const |
void | setFunction (Function aFunction) |
QCString | field () const |
void | setField (const QCString &field) |
QString | contents () const |
void | setContents (const QString &aContents) |
const QString | asString () const |
Static Public Member Functions | |
KMSearchRule * | createInstance (const QCString &field=0, Function function=FuncContains, const QString &contents=QString::null) |
KMSearchRule * | createInstance (const QCString &field, const char *function, const QString &contents) |
KMSearchRule * | createInstance (const KMSearchRule &other) |
KMSearchRule * | createInstanceFromConfig (const KConfig *config, int aIdx) |
Detailed Description
Incoming mail is sent through the list of mail filter rules before it is placed in the associated mail folder (usually "inbox"). This class represents one search pattern rule.This class represents one mail filter rule. It is also used to represent a search rule as used by the search dialog and folders.
Definition at line 31 of file kmsearchpattern.h.
Member Enumeration Documentation
|
Operators for comparison of field and contents. If you change the order or contents of the enum: do not forget to change funcConfigNames[], sFilterFuncList and matches() in KMSearchRule, too. Also, it is assumed that these functions come in pairs of logical opposites (ie. "=" <-> "!=", ">" <-> "<=", etc.). Definition at line 41 of file kmsearchpattern.h. Referenced by createInstanceFromConfig(), and function(). |
Member Function Documentation
|
Create a search rule of a certain type by instantiating the appro- priate subclass depending on the Definition at line 71 of file kmsearchpattern.cpp. Referenced by KMFilterListBox::createFilter(), createInstanceFromConfig(), and KMSearchRuleWidget::rule(). |
|
Initialize the object from a given config file.
The group must be preset. References createInstance(), and Function. Referenced by KMSearchPattern::readConfig(). |
|
Tries to match the rule against the given KMMessage.
Implemented in KMSearchRuleString, and KMSearchRuleNumerical.
Referenced by matches(). |
|
Optimized version tries to match the rule against the given DwString.
Reimplemented in KMSearchRuleString. Definition at line 145 of file kmsearchpattern.cpp. References matches(). |
|
Determine whether the rule is worth considering. It isn't if either the field is not set or the contents is empty. KFilter should make sure that it's rule list contains only non-empty rules, as matches doesn't check this. Implemented in KMSearchRuleString, and KMSearchRuleNumerical.
Referenced by KMSearchPattern::readConfig(). |
|
Returns true if the rule depends on a complete message, otherwise returns false.
Reimplemented in KMSearchRuleString. Definition at line 99 of file kmsearchpattern.h. |
|
Save the object into a given config file.
The group must be preset. |
|
Return filter function. This can be any of the operators defined in Function. Definition at line 111 of file kmsearchpattern.h. References Function. Referenced by KMSearchRuleString::matches(), KMSearchRuleNumerical::matchesInternal(), and KMSearchRuleString::matchesInternal(). |
|
Set filter function. Definition at line 114 of file kmsearchpattern.h. |
|
Return message header field name (without the trailing ':'). There are also six pseudo-headers:
Referenced by KMSearchRuleString::isEmpty(), KMSearchRuleNumerical::matches(), KMSearchRuleString::matches(), KMSearchRuleString::requiresBody(), KMSearchRuleWidget::setHeadersOnly(), and KMSearchRuleWidget::setRule(). |
|
Set message header field name (make sure there's no trailing colon ':'). Definition at line 130 of file kmsearchpattern.h. |
|
Return the value. This can be either a substring to search for in or a regexp pattern to match against the header. Definition at line 134 of file kmsearchpattern.h. Referenced by KMSearchRuleNumerical::isEmpty(), KMSearchRuleString::isEmpty(), KMSearchRuleNumerical::matches(), KMSearchRuleNumerical::matchesInternal(), and KMSearchRuleString::matchesInternal(). |
|
Set the value. Definition at line 136 of file kmsearchpattern.h. |
|
Returns the rule as string. For debugging. Definition at line 155 of file kmsearchpattern.cpp. Referenced by KMSearchRuleNumerical::matches(), and KMSearchRuleString::matches(). |
The documentation for this class was generated from the following files: