kmail

KMSearchRuleWidget Class Reference

A widget to edit a single KMSearchRule. More...

#include <kmsearchpatternedit.h>

Inheritance diagram for KMSearchRuleWidget:

List of all members.


Public Types

enum  {
  Message, Body, AnyHeader, Recipients,
  Size, AgeInDays, Status
}

Public Slots

void slotFunctionChanged ()
void slotValueChanged ()

Signals

void contentsChanged (const QString &)
void fieldChanged (const QString &)

Public Member Functions

 KMSearchRuleWidget (QWidget *parent=0, KMSearchRule *aRule=0, const char *name=0, bool headersOnly=false, bool absoluteDates=false)
void reset ()
KMSearchRulerule () const
void setHeadersOnly (bool headersOnly)
void setRule (KMSearchRule *aRule)

Static Public Member Functions

static int ruleFieldToId (const QString &i18nVal)

Protected Slots

void slotRuleFieldChanged (const QString &)

Protected Member Functions

int indexOfRuleField (const QCString &aName) const

Static Protected Member Functions

static QCString ruleFieldToEnglish (const QString &i18nVal)

Detailed Description

A widget to edit a single KMSearchRule.

It consists of an editable QComboBox for the field, a read-only QComboBox for the function and a QLineEdit for the content or the pattern (in case of regexps). It manages the i18n itself, so field name should be in it's english form.

To use, you essentially give it the reference to a KMSearchRule and it does the rest. It will never delete the rule itself, as it assumes that something outside of it manages this.

A widget to edit a single KMSearchRule.

Author:
Marc Mutz <Marc@Mutz.com>

Definition at line 40 of file kmsearchpatternedit.h.


Member Enumeration Documentation

anonymous enum

Enumerator:
Message 
Body 
AnyHeader 
Recipients 
Size 
AgeInDays 
Status 

Definition at line 48 of file kmsearchpatternedit.h.


Constructor & Destructor Documentation

KMSearchRuleWidget::KMSearchRuleWidget ( QWidget parent = 0,
KMSearchRule aRule = 0,
const char *  name = 0,
bool  headersOnly = false,
bool  absoluteDates = false 
)

Constructor.

You can give a KMSearchRule as parameter, which will be used to initialize the widget.

Definition at line 51 of file kmsearchpatternedit.cpp.


Member Function Documentation

void KMSearchRuleWidget::contentsChanged ( const QString  )  [signal]

This signal is emitted whenever the user alters the contents/value of the rule.

void KMSearchRuleWidget::fieldChanged ( const QString  )  [signal]

This signal is emitted whenever the user alters the field.

The pseudo-headers <...> are returned in their i18n form, but stored in their english form in the rule.

int KMSearchRuleWidget::indexOfRuleField ( const QCString aName  )  const [protected]

Used internally to find the corresponding index into the field ComboBox.

Returns the index if found or -1 if the search failed,

Definition at line 222 of file kmsearchpatternedit.cpp.

void KMSearchRuleWidget::reset (  ) 

Resets the rule currently worked on and updates the widget accordingly.

Definition at line 165 of file kmsearchpatternedit.cpp.

KMSearchRule * KMSearchRuleWidget::rule (  )  const

Return a reference to the currently-worked-on KMSearchRule.

Definition at line 153 of file kmsearchpatternedit.cpp.

QCString KMSearchRuleWidget::ruleFieldToEnglish ( const QString i18nVal  )  [static, protected]

Used internally to translate i18n-ized pseudo-headers back to english.

Definition at line 193 of file kmsearchpatternedit.cpp.

int KMSearchRuleWidget::ruleFieldToId ( const QString i18nVal  )  [static]

Definition at line 202 of file kmsearchpatternedit.cpp.

void KMSearchRuleWidget::setHeadersOnly ( bool  headersOnly  ) 

Set whether only header fields can be searched.

If is true only header fields can be searched otherwise <message> and <body> searches are available also.

Definition at line 69 of file kmsearchpatternedit.cpp.

void KMSearchRuleWidget::setRule ( KMSearchRule aRule  ) 

Set the rule.

The rule is accepted regardless of the return value of KMSearchRule::isEmpty. This widget makes a shallow copy of aRule and operates directly on it. If aRule is 0, resets itself, taks user input, but does essentially nothing. If you pass 0, you should probably disable it.

Definition at line 127 of file kmsearchpatternedit.cpp.

void KMSearchRuleWidget::slotFunctionChanged (  )  [slot]

Definition at line 175 of file kmsearchpatternedit.cpp.

void KMSearchRuleWidget::slotRuleFieldChanged ( const QString field  )  [protected, slot]

Definition at line 266 of file kmsearchpatternedit.cpp.

void KMSearchRuleWidget::slotValueChanged (  )  [slot]

Definition at line 183 of file kmsearchpatternedit.cpp.


The documentation for this class was generated from the following files: