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

mailcommon

  • sources
  • kde-4.14
  • kdepim
  • mailcommon
  • filter
  • filteractions
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 bool FilterActionAddHeader::isEmpty() const
48 {
49  return (mParameter.isEmpty() || mValue.isEmpty());
50 }
51 
52 FilterAction::ReturnCode FilterActionAddHeader::process(ItemContext &context , bool) const
53 {
54  if ( isEmpty() )
55  return ErrorButGoOn;
56 
57  KMime::Message::Ptr msg = context.item().payload<KMime::Message::Ptr>();
58 
59  KMime::Headers::Base *header = KMime::Headers::createHeader( mParameter.toLatin1() );
60  if ( !header ) {
61  header = new KMime::Headers::Generic( mParameter.toLatin1(), msg.get(), mValue, "utf-8" );
62  } else {
63  header->fromUnicodeString( mValue, "utf-8" );
64  }
65 
66  msg->setHeader( header );
67  msg->assemble();
68 
69  context.setNeedsPayloadStore();
70 
71  return GoOn;
72 }
73 
74 QWidget* FilterActionAddHeader::createParamWidget( QWidget *parent ) const
75 {
76  QWidget *widget = new QWidget( parent );
77  QHBoxLayout *layout = new QHBoxLayout( widget );
78  layout->setSpacing( 4 );
79  layout->setMargin( 0 );
80 
81  PimCommon::MinimumComboBox *comboBox = new PimCommon::MinimumComboBox( widget );
82  comboBox->setObjectName( QLatin1String("combo") );
83  comboBox->setEditable( true );
84  comboBox->setInsertPolicy( QComboBox::InsertAtBottom );
85 
86  KCompletion *comp = comboBox->completionObject();
87  comp->setIgnoreCase(true);
88  comp->insertItems(mParameterList);
89  comp->setCompletionMode(KGlobalSettings::CompletionPopupAuto);
90 
91 
92  layout->addWidget( comboBox, 0 /* stretch */ );
93 
94  QLabel *label = new QLabel( i18n( "With value:" ), widget );
95  label->setObjectName(QLatin1String("label_value"));
96  label->setFixedWidth( label->sizeHint().width() );
97  layout->addWidget( label, 0 );
98 
99  KLineEdit *lineEdit = new KLineEdit( widget );
100  lineEdit->setObjectName( QLatin1String("ledit") );
101  lineEdit->setTrapReturnKey(true);
102  lineEdit->setClearButtonShown( true );
103  layout->addWidget( lineEdit, 1 );
104 
105  setParamWidgetValue( widget );
106 
107  connect( comboBox, SIGNAL(currentIndexChanged(int)),
108  this, SIGNAL(filterActionModified()) );
109  connect( comboBox->lineEdit(), SIGNAL(textChanged(QString)),
110  this, SIGNAL(filterActionModified()) );
111  connect( lineEdit, SIGNAL(textChanged(QString)),
112  this, SIGNAL(filterActionModified()) );
113 
114  return widget;
115 }
116 
117 void FilterActionAddHeader::setParamWidgetValue( QWidget *paramWidget ) const
118 {
119  const int index = mParameterList.indexOf( mParameter );
120 
121  PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
122  Q_ASSERT( comboBox );
123  comboBox->clear();
124  comboBox->addItems( mParameterList );
125 
126  if ( index < 0 ) {
127  comboBox->addItem( mParameter );
128  comboBox->setCurrentIndex( comboBox->count() - 1 );
129  } else {
130  comboBox->setCurrentIndex( index );
131  }
132 
133  KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("ledit") );
134  Q_ASSERT( lineEdit );
135 
136  lineEdit->setText( mValue );
137 }
138 
139 void FilterActionAddHeader::applyParamWidgetValue( QWidget *paramWidget )
140 {
141  const PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
142  Q_ASSERT( comboBox );
143  mParameter = comboBox->currentText();
144 
145  const KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("ledit") );
146  Q_ASSERT( lineEdit );
147  mValue = lineEdit->text();
148 }
149 
150 void FilterActionAddHeader::clearParamWidget( QWidget *paramWidget ) const
151 {
152  PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
153  Q_ASSERT( comboBox );
154  comboBox->setCurrentIndex( 0 );
155 
156  KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("ledit") );
157  Q_ASSERT( lineEdit );
158  lineEdit->clear();
159 }
160 
161 SearchRule::RequiredPart FilterActionAddHeader::requiredPart() const
162 {
163  return SearchRule::CompleteMessage;
164 }
165 
166 
167 QString FilterActionAddHeader::argsAsString() const
168 {
169  QString result = mParameter;
170  result += QLatin1Char( '\t' );
171  result += mValue;
172 
173  return result;
174 }
175 
176 QString FilterActionAddHeader::displayString() const
177 {
178  return label() + QLatin1String( " \"" ) + Qt::escape( argsAsString() ) + QLatin1String( "\"" );
179 }
180 
181 void FilterActionAddHeader::argsFromString( const QString &argsStr )
182 {
183  const QStringList list = argsStr.split( QLatin1Char( '\t' ) );
184  QString result;
185  if ( list.count() < 2 ) {
186  result = list[ 0 ];
187  mValue.clear();
188  } else {
189  result = list[ 0 ];
190  mValue = list[ 1 ];
191  }
192 
193  int index = mParameterList.indexOf( result );
194  if ( index < 0 ) {
195  mParameterList.append( result );
196  index = mParameterList.count() - 1;
197  }
198 
199  mParameter = mParameterList.at( index );
200 }
201 
202 FilterAction* FilterActionAddHeader::newAction()
203 {
204  return new FilterActionAddHeader;
205 }
206 
207 QStringList FilterActionAddHeader::sieveRequires() const
208 {
209  return QStringList() <<QLatin1String("editheader");
210 }
211 
212 QString FilterActionAddHeader::sieveCode() const
213 {
214  if (isEmpty()) {
215  return QLatin1String("# invalid filter. Need to fix it by hand");
216  } else {
217  return QString::fromLatin1("addheader \"%1\" \"%2\";").arg(mParameter).arg(mValue);
218  }
219 }
220 
221 QString FilterActionAddHeader::informationAboutNotValidAction() const
222 {
223  //KF5 add i18n
224  QString result;
225  if (mParameter.isEmpty()) {
226  result = QString::fromLatin1("The header name was missing.");
227  }
228  if (mValue.isEmpty()) {
229  if (result.isEmpty()) {
230  result += QLatin1Char('\n');
231  }
232  result += QLatin1String("The header value was missing.");
233  }
234  if (!result.isEmpty()) {
235  result = name() + QLatin1Char('\n') + result;
236  }
237  return result;
238 }
239 
QWidget
MailCommon::FilterAction::GoOn
Go on with applying filter actions.
Definition: filteraction.h:62
QSize::width
int width() const
QWidget::setFixedWidth
void setFixedWidth(int w)
MailCommon::FilterActionAddHeader::process
ReturnCode process(ItemContext &context, bool applyOnOutbound) const
Execute action on given message (inside the item context).
Definition: filteractionaddheader.cpp:52
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:161
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:139
QString::split
QStringList split(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs) const
MailCommon::FilterActionAddHeader::displayString
QString displayString() const
Returns a translated string describing this filter for visualization purposes, e.g.
Definition: filteractionaddheader.cpp:176
MailCommon::FilterActionAddHeader::clearParamWidget
void clearParamWidget(QWidget *paramWidget) const
The filter action shall clear it's parameter widget's contents.
Definition: filteractionaddheader.cpp:150
QList::at
const T & at(int i) const
MailCommon::FilterActionAddHeader::createParamWidget
QWidget * createParamWidget(QWidget *parent) const
Creates a widget for setting the filter action parameter.
Definition: filteractionaddheader.cpp:74
MailCommon::ItemContext::setNeedsPayloadStore
void setNeedsPayloadStore()
Marks that the item's payload has been changed and needs to be written back.
Definition: itemcontext.cpp:44
QHBoxLayout
MailCommon::SearchRule::CompleteMessage
Definition: searchrule.h:82
QString::clear
void clear()
MailCommon::FilterAction
Abstract base class for mail filter actions.
Definition: filteraction.h:52
QBoxLayout::addWidget
void addWidget(QWidget *widget, int stretch, QFlags< Qt::AlignmentFlag > alignment)
QList::count
int count(const T &value) const
QList::append
void append(const T &value)
MailCommon::FilterActionWithStringList::mParameterList
QStringList mParameterList
Definition: filteractionwithstringlist.h:85
MailCommon::FilterAction::ErrorButGoOn
A non-critical error occurred.
Definition: filteraction.h:63
QObject
QObject::setObjectName
void setObjectName(const QString &name)
QString::isEmpty
bool isEmpty() const
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:117
MailCommon::FilterActionAddHeader::FilterActionAddHeader
FilterActionAddHeader(QObject *parent=0)
Definition: filteractionaddheader.cpp:34
MailCommon::SearchRule::RequiredPart
RequiredPart
Definition: searchrule.h:79
QString
MailCommon::FilterAction::label
QString label() const
Returns i18n'd label, ie.
Definition: filteraction.cpp:45
QLayout::setMargin
void setMargin(int margin)
MailCommon::FilterAction::name
QString name() const
Returns identifier name, ie.
Definition: filteraction.cpp:50
QStringList
MailCommon::FilterActionAddHeader::newAction
static FilterAction * newAction()
Definition: filteractionaddheader.cpp:202
QLatin1Char
MailCommon::FilterActionAddHeader::argsFromString
void argsFromString(const QString &argsStr)
Read extra arguments from given string.
Definition: filteractionaddheader.cpp:181
MailCommon::FilterActionAddHeader::sieveCode
QString sieveCode() const
Definition: filteractionaddheader.cpp:212
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
QString::toLatin1
QByteArray toLatin1() const
QLatin1String
MailCommon::ItemContext::item
Akonadi::Item & item()
Returns the item of the context.
Definition: itemcontext.cpp:29
Qt::escape
QString escape(const QString &plain)
MailCommon::FilterAction::filterActionModified
void filterActionModified()
Called to notify that the current FilterAction has had some value modification.
filteractionaddheader.h
QLabel::sizeHint
virtual QSize sizeHint() const
context
const char * context
Definition: searchpatternedit.cpp:54
MailCommon::FilterActionAddHeader::informationAboutNotValidAction
QString informationAboutNotValidAction() const
Definition: filteractionaddheader.cpp:221
QString::fromLatin1
QString fromLatin1(const char *str, int size)
QStringList::indexOf
int indexOf(const QRegExp &rx, int from) const
MailCommon::FilterActionAddHeader::isEmpty
bool isEmpty() const
Determines whether this action is valid.
Definition: filteractionaddheader.cpp:47
MailCommon::FilterActionAddHeader::sieveRequires
QStringList sieveRequires() const
Definition: filteractionaddheader.cpp:207
MailCommon::ItemContext
A helper class for the filtering process.
Definition: itemcontext.h:39
QObject::connect
bool connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QLabel
QString::arg
QString arg(qlonglong a, int fieldWidth, int base, const QChar &fillChar) const
QBoxLayout::setSpacing
void setSpacing(int spacing)
MailCommon::FilterActionAddHeader::argsAsString
QString argsAsString() const
Return extra arguments as string.
Definition: filteractionaddheader.cpp:167
QObject::findChild
T findChild(const QString &name) const
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:31:40 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
  • pimprint

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