• Skip to content
  • Skip to link menu
KDE 4.2 API Reference
  • KDE API Reference
  • kdepim
  • Sitemap
  • Contact Us
 

kmail

KMFilterActionWithUrl Class Reference

#include <kmfilteraction.h>

Inheritance diagram for KMFilterActionWithUrl:

Inheritance graph
[legend]

List of all members.


Detailed Description

Abstract base class for KMail's filter actions that need a command line as parameter, e.g.

'forward to'. Can create a QLineEdit (are there better widgets in the depths of the kdelibs?) as parameter widget. A subclass of this must provide at least implementations for the following methods:

  • virtual KMFilterAction::ReturnCodes KMFilterAction::process
  • static KMFilterAction::newAction
The implementation of KMFilterAction::process should take the command line specified in mParameter, make all required modifications and stream the resulting command line into mProcess. Then you can start the command with mProcess.start().

Abstract base class for filter actions with a command line as parameter.

Author:
Marc Mutz <Marc@Mutz.com>, based upon work by Stefan Taferner <taferner@kde.org>
See also:
KMFilterActionWithString KMFilterAction KMFilter KProcess

Definition at line 512 of file kmfilteraction.h.


Public Member Functions

virtual void applyParamWidgetValue (QWidget *paramWidget)
virtual const QString argsAsString () const
virtual void argsFromString (const QString &argsStr)
virtual void clearParamWidget (QWidget *paramWidget) const
virtual QWidget * createParamWidget (QWidget *parent) const
virtual const QString displayString () const
virtual bool isEmpty () const
 KMFilterActionWithUrl (const char *aName, const QString &aLabel)
virtual void setParamWidgetValue (QWidget *paramWidget) const
 ~KMFilterActionWithUrl ()

Protected Attributes

QString mParameter

Constructor & Destructor Documentation

KMFilterActionWithUrl::KMFilterActionWithUrl ( const char *  aName,
const QString &  aLabel 
)

Initialize filter action with (english) name aName.

This is the name under which this action is known in the config file.

Definition at line 1858 of file kmfilteraction.cpp.

KMFilterActionWithUrl::~KMFilterActionWithUrl (  ) 

Definition at line 1863 of file kmfilteraction.cpp.


Member Function Documentation

void KMFilterActionWithUrl::applyParamWidgetValue ( QWidget *  paramWidget  )  [virtual]

The filter action shall set it's parameter from the widget's contents.

It is allowed that the value is read by the action before this function is called.

Reimplemented from KMFilterAction.

Reimplemented in KMFilterActionWithCommand.

Definition at line 1875 of file kmfilteraction.cpp.

const QString KMFilterActionWithUrl::argsAsString (  )  const [virtual]

Return extra arguments as string.

Must not contain newlines.

Implements KMFilterAction.

Definition at line 1895 of file kmfilteraction.cpp.

void KMFilterActionWithUrl::argsFromString ( const QString &  argsStr  )  [virtual]

Read extra arguments from given string.

Implements KMFilterAction.

Definition at line 1890 of file kmfilteraction.cpp.

void KMFilterActionWithUrl::clearParamWidget ( QWidget *  paramWidget  )  const [virtual]

The filter action shall clear it's parameter widget's contents.

Reimplemented from KMFilterAction.

Reimplemented in KMFilterActionWithCommand.

Definition at line 1885 of file kmfilteraction.cpp.

QWidget * KMFilterActionWithUrl::createParamWidget ( QWidget *  parent  )  const [virtual]

Creates a widget for setting the filter action parameter.

Also sets the value of the widget.

Reimplemented from KMFilterAction.

Reimplemented in KMFilterActionWithCommand.

Definition at line 1867 of file kmfilteraction.cpp.

const QString KMFilterActionWithUrl::displayString (  )  const [virtual]

Returns a translated string describing this filter for visualization purposes, e.g.

in the filter log.

Implements KMFilterAction.

Definition at line 1900 of file kmfilteraction.cpp.

virtual bool KMFilterActionWithUrl::isEmpty (  )  const [inline, virtual]

Determines whether this action is valid.

But this is just a quick test. Eg., actions that have a mail address as parameter shouldn't try real address validation, but only check if the string representation is empty.

Reimplemented from KMFilterAction.

Definition at line 523 of file kmfilteraction.h.

void KMFilterActionWithUrl::setParamWidgetValue ( QWidget *  paramWidget  )  const [virtual]

The filter action shall set it's widget's contents from it's parameter.

Reimplemented from KMFilterAction.

Reimplemented in KMFilterActionWithCommand.

Definition at line 1880 of file kmfilteraction.cpp.


Member Data Documentation

QString KMFilterActionWithUrl::mParameter [protected]

Definition at line 553 of file kmfilteraction.h.


The documentation for this class was generated from the following files:
  • kmfilteraction.h
  • kmfilteraction.cpp

kmail

Skip menu "kmail"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdepim

Skip menu "kdepim"
  • akonadi
  •   clients
  •   kabc
  •   kcal
  •   kcm
  • akregator
  • console
  •   kabcclient
  •   konsolekalendar
  • kaddressbook
  • kalarm
  •   lib
  • kdgantt
  • kdgantt1
  • kjots
  • kleopatra
  • kmail
  • kmobiletools
  • knode
  • knotes
  • kontact
  • kontactinterfaces
  • korganizer
  •   korgac
  • kpilot
  • ktimetracker
  • libkdepim
  • libkholidays
  • libkleo
  • libkpgp
  • maildir
Generated for kdepim by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal