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

mailcommon

  • sources
  • kde-4.12
  • kdepim
  • mailcommon
  • filter
filteractionaddheader.cpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 1996-1998 Stefan Taferner <taferner@kde.org>
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; either version 2 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  */
19 
20 #include "filteractionaddheader.h"
21 
22 #include <pimcommon/widgets/minimumcombobox.h>
23 
24 #include <KLineEdit>
25 #include <KLocale>
26 
27 #include <QComboBox>
28 #include <QHBoxLayout>
29 #include <QLabel>
30 #include <QTextDocument>
31 
32 using namespace MailCommon;
33 
34 FilterActionAddHeader::FilterActionAddHeader( QObject *parent )
35  : FilterActionWithStringList( QLatin1String("add header"), i18n( "Add Header" ), parent )
36 {
37  mParameterList << QLatin1String("")
38  << QLatin1String("Reply-To")
39  << QLatin1String("Delivered-To")
40  << QLatin1String("X-KDE-PR-Message")
41  << QLatin1String("X-KDE-PR-Package")
42  << QLatin1String("X-KDE-PR-Keywords");
43 
44  mParameter = mParameterList.at( 0 );
45 }
46 
47 FilterAction::ReturnCode FilterActionAddHeader::process(ItemContext &context , bool) const
48 {
49  if ( mParameter.isEmpty() )
50  return ErrorButGoOn;
51 
52  KMime::Message::Ptr msg = context.item().payload<KMime::Message::Ptr>();
53 
54  KMime::Headers::Base *header = KMime::Headers::createHeader( mParameter.toLatin1() );
55  if ( !header ) {
56  header = new KMime::Headers::Generic( mParameter.toLatin1(), msg.get(), mValue, "utf-8" );
57  } else {
58  header->fromUnicodeString( mValue, "utf-8" );
59  }
60 
61  msg->setHeader( header );
62  msg->assemble();
63 
64  context.setNeedsPayloadStore();
65 
66  return GoOn;
67 }
68 
69 QWidget* FilterActionAddHeader::createParamWidget( QWidget *parent ) const
70 {
71  QWidget *widget = new QWidget( parent );
72  QHBoxLayout *layout = new QHBoxLayout( widget );
73  layout->setSpacing( 4 );
74  layout->setMargin( 0 );
75 
76  PimCommon::MinimumComboBox *comboBox = new PimCommon::MinimumComboBox( widget );
77  comboBox->setObjectName( QLatin1String("combo") );
78  comboBox->setEditable( true );
79  comboBox->setInsertPolicy( QComboBox::InsertAtBottom );
80 
81  KCompletion *comp = comboBox->completionObject();
82  comp->setIgnoreCase(true);
83  comp->insertItems(mParameterList);
84  comp->setCompletionMode(KGlobalSettings::CompletionPopupAuto);
85 
86 
87  layout->addWidget( comboBox, 0 /* stretch */ );
88 
89  QLabel *label = new QLabel( i18n( "With value:" ), widget );
90  label->setFixedWidth( label->sizeHint().width() );
91  layout->addWidget( label, 0 );
92 
93  KLineEdit *lineEdit = new KLineEdit( widget );
94  lineEdit->setObjectName( QLatin1String("ledit") );
95  lineEdit->setTrapReturnKey(true);
96  lineEdit->setClearButtonShown( true );
97  layout->addWidget( lineEdit, 1 );
98 
99  setParamWidgetValue( widget );
100 
101  connect( comboBox, SIGNAL(currentIndexChanged(int)),
102  this, SIGNAL(filterActionModified()) );
103  connect( comboBox->lineEdit(), SIGNAL(textChanged(QString)),
104  this, SIGNAL(filterActionModified()) );
105  connect( lineEdit, SIGNAL(textChanged(QString)),
106  this, SIGNAL(filterActionModified()) );
107 
108  return widget;
109 }
110 
111 void FilterActionAddHeader::setParamWidgetValue( QWidget *paramWidget ) const
112 {
113  const int index = mParameterList.indexOf( mParameter );
114 
115  PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
116  Q_ASSERT( comboBox );
117  comboBox->clear();
118  comboBox->addItems( mParameterList );
119 
120  if ( index < 0 ) {
121  comboBox->addItem( mParameter );
122  comboBox->setCurrentIndex( comboBox->count() - 1 );
123  } else {
124  comboBox->setCurrentIndex( index );
125  }
126 
127  KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("ledit") );
128  Q_ASSERT( lineEdit );
129 
130  lineEdit->setText( mValue );
131 }
132 
133 void FilterActionAddHeader::applyParamWidgetValue( QWidget *paramWidget )
134 {
135  const PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
136  Q_ASSERT( comboBox );
137  mParameter = comboBox->currentText();
138 
139  const KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("ledit") );
140  Q_ASSERT( lineEdit );
141  mValue = lineEdit->text();
142 }
143 
144 void FilterActionAddHeader::clearParamWidget( QWidget *paramWidget ) const
145 {
146  PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
147  Q_ASSERT( comboBox );
148  comboBox->setCurrentIndex( 0 );
149 
150  KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("ledit") );
151  Q_ASSERT( lineEdit );
152  lineEdit->clear();
153 }
154 
155 SearchRule::RequiredPart FilterActionAddHeader::requiredPart() const
156 {
157  return SearchRule::CompleteMessage;
158 }
159 
160 
161 QString FilterActionAddHeader::argsAsString() const
162 {
163  QString result = mParameter;
164  result += QLatin1Char( '\t' );
165  result += mValue;
166 
167  return result;
168 }
169 
170 QString FilterActionAddHeader::displayString() const
171 {
172  return label() + QLatin1String( " \"" ) + Qt::escape( argsAsString() ) + QLatin1String( "\"" );
173 }
174 
175 void FilterActionAddHeader::argsFromString( const QString &argsStr )
176 {
177  const QStringList list = argsStr.split( QLatin1Char( '\t' ) );
178  QString result;
179  if ( list.count() < 2 ) {
180  result = list[ 0 ];
181  mValue.clear();
182  } else {
183  result = list[ 0 ];
184  mValue = list[ 1 ];
185  }
186 
187  int index = mParameterList.indexOf( result );
188  if ( index < 0 ) {
189  mParameterList.append( result );
190  index = mParameterList.count() - 1;
191  }
192 
193  mParameter = mParameterList.at( index );
194 }
195 
196 FilterAction* FilterActionAddHeader::newAction()
197 {
198  return new FilterActionAddHeader;
199 }
200 
201 QStringList FilterActionAddHeader::sieveRequires() const
202 {
203  return QStringList() <<QLatin1String("editheader");
204 }
205 
206 QString FilterActionAddHeader::sieveCode() const
207 {
208  return QString::fromLatin1("addheader \"%1\" \"%2\";").arg(mParameter).arg(mValue);
209 }
210 
211 
212 #include "filteractionaddheader.moc"
MailCommon::FilterAction::GoOn
Go on with applying filter actions.
Definition: filteraction.h:62
MailCommon::FilterActionAddHeader::process
ReturnCode process(ItemContext &context, bool applyOnOutbound) const
Execute action on given message (inside the item context).
Definition: filteractionaddheader.cpp:47
MailCommon::FilterActionAddHeader::requiredPart
SearchRule::RequiredPart requiredPart() const
Returns the required part from the item that is needed for the action to operate. ...
Definition: filteractionaddheader.cpp:155
MailCommon::FilterActionWithStringList
Abstract base class for filter actions with a fixed set of string parameters.
Definition: filteractionwithstringlist.h:49
MailCommon::FilterActionAddHeader::applyParamWidgetValue
void applyParamWidgetValue(QWidget *paramWidget)
The filter action shall set it's parameter from the widget's contents.
Definition: filteractionaddheader.cpp:133
MailCommon::FilterActionAddHeader::displayString
QString displayString() const
Returns a translated string describing this filter for visualization purposes, e.g.
Definition: filteractionaddheader.cpp:170
MailCommon::FilterActionAddHeader::clearParamWidget
void clearParamWidget(QWidget *paramWidget) const
The filter action shall clear it's parameter widget's contents.
Definition: filteractionaddheader.cpp:144
MailCommon::FilterActionAddHeader::createParamWidget
QWidget * createParamWidget(QWidget *parent) const
Creates a widget for setting the filter action parameter.
Definition: filteractionaddheader.cpp:69
QWidget
MailCommon::ItemContext::setNeedsPayloadStore
void setNeedsPayloadStore()
Marks that the item's payload has been changed and needs to be written back.
Definition: itemcontext.cpp:45
QObject
MailCommon::SearchRule::CompleteMessage
Definition: searchpattern.h:107
MailCommon::FilterAction
Abstract base class for mail filter actions.
Definition: filteraction.h:52
MailCommon::FilterActionWithStringList::mParameterList
QStringList mParameterList
Definition: filteractionwithstringlist.h:85
MailCommon::FilterAction::ErrorButGoOn
A non-critical error occurred.
Definition: filteraction.h:63
MailCommon::FilterActionAddHeader::setParamWidgetValue
void setParamWidgetValue(QWidget *paramWidget) const
The filter action shall set it's widget's contents from it's parameter.
Definition: filteractionaddheader.cpp:111
MailCommon::FilterActionAddHeader::FilterActionAddHeader
FilterActionAddHeader(QObject *parent=0)
Definition: filteractionaddheader.cpp:34
MailCommon::SearchRule::RequiredPart
RequiredPart
Definition: searchpattern.h:104
MailCommon::FilterAction::label
QString label() const
Returns i18n'd label, ie.
Definition: filteraction.cpp:45
MailCommon::FilterActionAddHeader::newAction
static FilterAction * newAction()
Definition: filteractionaddheader.cpp:196
MailCommon::FilterActionAddHeader::argsFromString
void argsFromString(const QString &argsStr)
Read extra arguments from given string.
Definition: filteractionaddheader.cpp:175
MailCommon::FilterActionAddHeader::sieveCode
QString sieveCode() const
Definition: filteractionaddheader.cpp:206
MailCommon::FilterActionWithString::mParameter
QString mParameter
Definition: filteractionwithstring.h:91
MailCommon::FilterAction::ReturnCode
ReturnCode
Describes the possible return codes of filter processing:
Definition: filteraction.h:60
MailCommon::ItemContext::item
Akonadi::Item & item()
Returns the item of the context.
Definition: itemcontext.cpp:30
MailCommon::FilterAction::filterActionModified
void filterActionModified()
Called to notify that the current FilterAction has had some value modification.
filteractionaddheader.h
context
const char * context
Definition: searchpatternedit.cpp:54
MailCommon::FilterActionAddHeader::sieveRequires
QStringList sieveRequires() const
Definition: filteractionaddheader.cpp:201
MailCommon::ItemContext
A helper class for the filtering process.
Definition: itemcontext.h:39
MailCommon::FilterActionAddHeader::argsAsString
QString argsAsString() const
Return extra arguments as string.
Definition: filteractionaddheader.cpp:161
This file is part of the KDE documentation.
Documentation copyright © 1996-2014 The KDE developers.
Generated on Tue Oct 14 2014 22:55:14 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

mailcommon

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

kdepim API Reference

Skip menu "kdepim API Reference"
  • akonadi_next
  • akregator
  • blogilo
  • calendarsupport
  • console
  •   kabcclient
  •   konsolekalendar
  • kaddressbook
  • kalarm
  •   lib
  • kdgantt2
  • kjots
  • kleopatra
  • kmail
  • knode
  • knotes
  • kontact
  • korgac
  • korganizer
  • ktimetracker
  • libkdepim
  • libkleo
  • libkpgp
  • mailcommon
  • messagelist
  • messageviewer

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal