• 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
filteractionrewriteheader.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 "filteractionrewriteheader.h"
21 
22 #include "widgets/regexplineedit.h"
23 #include <pimcommon/widgets/minimumcombobox.h>
24 
25 #include <KDE/KLineEdit>
26 #include <KDE/KLocale>
27 
28 #include <QHBoxLayout>
29 #include <QLabel>
30 #include <QTextDocument>
31 
32 using namespace MailCommon;
33 
34 FilterAction* FilterActionRewriteHeader::newAction()
35 {
36  return new FilterActionRewriteHeader;
37 }
38 
39 FilterActionRewriteHeader::FilterActionRewriteHeader( QObject *parent )
40  : FilterActionWithStringList( QLatin1String("rewrite header"), i18n( "Rewrite Header" ), parent )
41 {
42  mParameterList << QLatin1String("")
43  << QLatin1String("Subject")
44  << QLatin1String("Reply-To")
45  << QLatin1String("Delivered-To")
46  << QLatin1String("X-KDE-PR-Message")
47  << QLatin1String("X-KDE-PR-Package")
48  << QLatin1String("X-KDE-PR-Keywords");
49 
50  mParameter = mParameterList.at( 0 );
51 }
52 
53 bool FilterActionRewriteHeader::isEmpty() const
54 {
55  return (mParameter.isEmpty() || mRegExp.isEmpty());
56 }
57 
58 QString FilterActionRewriteHeader::informationAboutNotValidAction() const
59 {
60  //KF5 add i18n
61  QString info;
62  if (mParameter.isEmpty()) {
63  info = QLatin1String("Header not defined");
64  }
65  if (mRegExp.isEmpty()) {
66  if (!info.isEmpty()) {
67  info += QLatin1Char('\n');
68  }
69  info += QLatin1String("Search string is empty.");
70  }
71  return info;
72 }
73 
74 FilterAction::ReturnCode FilterActionRewriteHeader::process(ItemContext &context , bool) const
75 {
76  if ( isEmpty() )
77  return ErrorButGoOn;
78 
79  const KMime::Message::Ptr msg = context.item().payload<KMime::Message::Ptr>();
80 
81  const QByteArray param(mParameter.toLatin1());
82  KMime::Headers::Base *header = msg->headerByType(param);
83  if ( !header ) {
84  return GoOn; //TODO: Maybe create a new header by type?
85  }
86 
87  QString value = header->asUnicodeString();
88  const QString oldValue = value;
89  const QString newValue = value.replace( mRegExp, mReplacementString );
90  if (newValue != oldValue) {
91  msg->removeHeader( param );
92 
93  KMime::Headers::Base *newheader = KMime::Headers::createHeader(param);
94  if ( !newheader ) {
95  newheader = new KMime::Headers::Generic(param, msg.get(), newValue, "utf-8" );
96  } else {
97  newheader->fromUnicodeString( newValue, "utf-8" );
98  }
99  msg->setHeader( newheader );
100  msg->assemble();
101 
102  context.setNeedsPayloadStore();
103  }
104  return GoOn;
105 }
106 
107 SearchRule::RequiredPart FilterActionRewriteHeader::requiredPart() const
108 {
109  return SearchRule::CompleteMessage;
110 }
111 
112 
113 QWidget* FilterActionRewriteHeader::createParamWidget( QWidget *parent ) const
114 {
115  QWidget *widget = new QWidget( parent );
116  QHBoxLayout *layout = new QHBoxLayout( widget );
117  layout->setSpacing( 4 );
118  layout->setMargin( 0 );
119 
120  PimCommon::MinimumComboBox *comboBox = new PimCommon::MinimumComboBox( widget );
121  comboBox->setEditable( true );
122  comboBox->setObjectName( QLatin1String("combo") );
123  comboBox->setInsertPolicy( QComboBox::InsertAtBottom );
124  layout->addWidget( comboBox, 0 /* stretch */ );
125 
126  KCompletion *comp = comboBox->completionObject();
127  comp->setIgnoreCase(true);
128  comp->insertItems(mParameterList);
129  comp->setCompletionMode(KGlobalSettings::CompletionPopupAuto);
130 
131  QLabel *label = new QLabel( i18n( "Replace:" ), widget );
132  label->setObjectName(QLatin1String("label_replace"));
133  label->setFixedWidth( label->sizeHint().width() );
134  layout->addWidget( label, 0 );
135 
136  RegExpLineEdit *regExpLineEdit = new RegExpLineEdit( widget );
137  regExpLineEdit->setObjectName( QLatin1String("search") );
138  layout->addWidget( regExpLineEdit, 1 );
139 
140  label = new QLabel( i18n( "With:" ), widget );
141  label->setFixedWidth( label->sizeHint().width() );
142  label->setObjectName(QLatin1String("label_with"));
143  layout->addWidget( label, 0 );
144 
145  KLineEdit *lineEdit = new KLineEdit( widget );
146  lineEdit->setObjectName( QLatin1String("replace") );
147  lineEdit->setClearButtonShown( true );
148  lineEdit->setTrapReturnKey(true);
149  layout->addWidget( lineEdit, 1 );
150 
151  setParamWidgetValue( widget );
152 
153  connect( comboBox, SIGNAL(currentIndexChanged(int)),
154  this, SIGNAL(filterActionModified()) );
155  connect( comboBox->lineEdit(), SIGNAL(textChanged(QString)),
156  this, SIGNAL(filterActionModified()) );
157  connect( regExpLineEdit, SIGNAL(textChanged(QString)),
158  this, SIGNAL(filterActionModified()) );
159  connect( lineEdit, SIGNAL(textChanged(QString)),
160  this, SIGNAL(filterActionModified()) );
161 
162  return widget;
163 }
164 
165 void FilterActionRewriteHeader::setParamWidgetValue( QWidget *paramWidget ) const
166 {
167  const int index = mParameterList.indexOf( mParameter );
168  PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
169  Q_ASSERT( comboBox );
170 
171  comboBox->clear();
172  comboBox->addItems( mParameterList );
173  if ( index < 0 ) {
174  comboBox->addItem( mParameter );
175  comboBox->setCurrentIndex( comboBox->count() - 1 );
176  } else {
177  comboBox->setCurrentIndex( index );
178  }
179 
180  RegExpLineEdit *regExpLineEdit = paramWidget->findChild<RegExpLineEdit*>( QLatin1String("search") );
181  Q_ASSERT( regExpLineEdit );
182  regExpLineEdit->setText( mRegExp.pattern() );
183 
184  KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("replace") );
185  Q_ASSERT( lineEdit );
186  lineEdit->setText( mReplacementString );
187 }
188 
189 void FilterActionRewriteHeader::applyParamWidgetValue( QWidget *paramWidget )
190 {
191  const PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
192  Q_ASSERT( comboBox );
193  mParameter = comboBox->currentText();
194 
195  const RegExpLineEdit *regExpLineEdit = paramWidget->findChild<RegExpLineEdit*>( QLatin1String("search") );
196  Q_ASSERT( regExpLineEdit );
197  mRegExp.setPattern( regExpLineEdit->text() );
198 
199  const KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("replace") );
200  Q_ASSERT( lineEdit );
201  mReplacementString = lineEdit->text();
202 }
203 
204 void FilterActionRewriteHeader::clearParamWidget( QWidget *paramWidget ) const
205 {
206  PimCommon::MinimumComboBox *comboBox = paramWidget->findChild<PimCommon::MinimumComboBox*>( QLatin1String("combo") );
207  Q_ASSERT( comboBox );
208  comboBox->setCurrentIndex( 0 );
209 
210  RegExpLineEdit *regExpLineEdit = paramWidget->findChild<RegExpLineEdit*>( QLatin1String("search") );
211  Q_ASSERT( regExpLineEdit );
212  regExpLineEdit->clear();
213 
214  KLineEdit *lineEdit = paramWidget->findChild<KLineEdit*>( QLatin1String("replace") );
215  Q_ASSERT( lineEdit );
216  lineEdit->clear();
217 }
218 
219 QString FilterActionRewriteHeader::argsAsString() const
220 {
221  QString result = mParameter;
222  result += QLatin1Char( '\t' );
223  result += mRegExp.pattern();
224  result += QLatin1Char( '\t' );
225  result += mReplacementString;
226 
227  return result;
228 }
229 
230 QString FilterActionRewriteHeader::displayString() const
231 {
232  return label() + QLatin1String( " \"" ) + Qt::escape( argsAsString() ) + QLatin1String( "\"" );
233 }
234 
235 void FilterActionRewriteHeader::argsFromString( const QString &argsStr )
236 {
237  const QStringList list = argsStr.split( QLatin1Char( '\t' ) );
238  if (list.count() < 3)
239  return;
240  QString result;
241 
242  result = list[ 0 ];
243  mRegExp.setPattern( list[ 1 ] );
244  mReplacementString = list[ 2 ];
245 
246  int index = mParameterList.indexOf( result );
247  if ( index < 0 ) {
248  mParameterList.append( result );
249  index = mParameterList.count() - 1;
250  }
251 
252  mParameter = mParameterList.at( index );
253 }
254 
255 
256 
MailCommon::FilterActionRewriteHeader::newAction
static FilterAction * newAction()
Definition: filteractionrewriteheader.cpp:34
MailCommon::FilterActionRewriteHeader::process
ReturnCode process(ItemContext &context, bool applyOnOutbound) const
Execute action on given message (inside the item context).
Definition: filteractionrewriteheader.cpp:74
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)
QRegExp::isEmpty
bool isEmpty() const
MailCommon::FilterActionWithStringList
Abstract base class for filter actions with a fixed set of string parameters.
Definition: filteractionwithstringlist.h:49
QByteArray
QString::split
QStringList split(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs) const
MailCommon::RegExpLineEdit::setText
void setText(const QString &)
Definition: regexplineedit.cpp:102
QList::at
const T & at(int i) const
MailCommon::ItemContext::setNeedsPayloadStore
void setNeedsPayloadStore()
Marks that the item's payload has been changed and needs to be written back.
Definition: itemcontext.cpp:44
MailCommon::RegExpLineEdit
Definition: regexplineedit.h:46
QHBoxLayout
MailCommon::FilterActionRewriteHeader::argsAsString
QString argsAsString() const
Return extra arguments as string.
Definition: filteractionrewriteheader.cpp:219
MailCommon::RegExpLineEdit::clear
void clear()
Definition: regexplineedit.cpp:92
MailCommon::SearchRule::CompleteMessage
Definition: searchrule.h:82
QRegExp::setPattern
void setPattern(const QString &pattern)
MailCommon::FilterAction
Abstract base class for mail filter actions.
Definition: filteraction.h:52
MailCommon::FilterActionRewriteHeader::argsFromString
void argsFromString(const QString &argsStr)
Read extra arguments from given string.
Definition: filteractionrewriteheader.cpp:235
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
MailCommon::FilterActionRewriteHeader::applyParamWidgetValue
void applyParamWidgetValue(QWidget *paramWidget)
The filter action shall set it's parameter from the widget's contents.
Definition: filteractionrewriteheader.cpp:189
QObject
MailCommon::FilterActionRewriteHeader::setParamWidgetValue
void setParamWidgetValue(QWidget *paramWidget) const
The filter action shall set it's widget's contents from it's parameter.
Definition: filteractionrewriteheader.cpp:165
QObject::setObjectName
void setObjectName(const QString &name)
QString::isEmpty
bool isEmpty() const
filteractionrewriteheader.h
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::FilterActionRewriteHeader::displayString
QString displayString() const
Returns a translated string describing this filter for visualization purposes, e.g.
Definition: filteractionrewriteheader.cpp:230
QStringList
QLatin1Char
regexplineedit.h
MailCommon::FilterActionWithString::mParameter
QString mParameter
Definition: filteractionwithstring.h:91
QString::replace
QString & replace(int position, int n, QChar after)
MailCommon::FilterAction::ReturnCode
ReturnCode
Describes the possible return codes of filter processing:
Definition: filteraction.h:60
MailCommon::FilterActionRewriteHeader::FilterActionRewriteHeader
FilterActionRewriteHeader(QObject *parent=0)
Definition: filteractionrewriteheader.cpp:39
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::FilterActionRewriteHeader::isEmpty
bool isEmpty() const
Determines whether this action is valid.
Definition: filteractionrewriteheader.cpp:53
MailCommon::FilterAction::filterActionModified
void filterActionModified()
Called to notify that the current FilterAction has had some value modification.
QLabel::sizeHint
virtual QSize sizeHint() const
QRegExp::pattern
QString pattern() const
context
const char * context
Definition: searchpatternedit.cpp:54
QStringList::indexOf
int indexOf(const QRegExp &rx, int from) const
MailCommon::FilterActionRewriteHeader::clearParamWidget
void clearParamWidget(QWidget *paramWidget) const
The filter action shall clear it's parameter widget's contents.
Definition: filteractionrewriteheader.cpp:204
MailCommon::FilterActionRewriteHeader::informationAboutNotValidAction
QString informationAboutNotValidAction() const
Definition: filteractionrewriteheader.cpp:58
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
MailCommon::FilterActionRewriteHeader::createParamWidget
QWidget * createParamWidget(QWidget *parent) const
Creates a widget for setting the filter action parameter.
Definition: filteractionrewriteheader.cpp:113
MailCommon::FilterActionRewriteHeader::requiredPart
SearchRule::RequiredPart requiredPart() const
Returns the required part from the item that is needed for the action to operate. ...
Definition: filteractionrewriteheader.cpp:107
QBoxLayout::setSpacing
void setSpacing(int spacing)
MailCommon::RegExpLineEdit::text
QString text() const
Definition: regexplineedit.cpp:97
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