• 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
filteractionwithurl.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 "filteractionwithurl.h"
21 
22 #include <KDE/KUrlRequester>
23 
24 #include <QHBoxLayout>
25 #include <QWhatsThis>
26 #include <QTextDocument>
27 
28 using namespace MailCommon;
29 
30 FilterActionWithUrlHelpButton::FilterActionWithUrlHelpButton(QWidget *parent)
31  : QToolButton(parent)
32 {
33  //KF5 add i18n
34  setToolTip(QLatin1String("Help"));
35  setIcon( KIcon( QLatin1String("help-hint") ) );
36 }
37 
38 FilterActionWithUrlHelpButton::~FilterActionWithUrlHelpButton()
39 {
40 
41 }
42 
43 FilterActionWithUrl::FilterActionWithUrl( const QString &name, const QString &label, QObject *parent )
44  : FilterAction( name, label, parent )
45 {
46 }
47 
48 FilterActionWithUrl::~FilterActionWithUrl()
49 {
50 }
51 
52 bool FilterActionWithUrl::isEmpty() const
53 {
54  return mParameter.trimmed().isEmpty();
55 }
56 
57 QWidget* FilterActionWithUrl::createParamWidget( QWidget *parent ) const
58 {
59  QWidget *widget = new QWidget(parent);
60  QHBoxLayout *layout = new QHBoxLayout;
61  layout->setMargin(0);
62  layout->setSpacing(0);
63  widget->setLayout(layout);
64  KUrlRequester *requester = new KUrlRequester( parent );
65  requester->setObjectName(QLatin1String("requester"));
66  requester->setUrl( KUrl( mParameter ) );
67  layout->addWidget(requester);
68  mHelpButton = new FilterActionWithUrlHelpButton(parent);
69  mHelpButton->setObjectName(QLatin1String("helpbutton"));
70  connect(mHelpButton, SIGNAL(clicked()), this, SLOT(slotHelp()));
71  layout->addWidget(mHelpButton);
72 
73  connect( requester, SIGNAL(textChanged(QString)), this, SIGNAL(filterActionModified()) );
74 
75  return widget;
76 }
77 
78 void FilterActionWithUrl::slotHelp()
79 {
80  //KF5 add i18n / Improve it
81  QString fullWhatsThis = QLatin1String("You can get specific header when when you use %{headername}.");
82  QWhatsThis::showText( QCursor::pos(), fullWhatsThis, mHelpButton );
83 }
84 
85 void FilterActionWithUrl::applyParamWidgetValue( QWidget *paramWidget )
86 {
87  KUrlRequester *requester = paramWidget->findChild<KUrlRequester*>( QLatin1String("requester") );
88  Q_ASSERT( requester );
89 
90  if (QUrl(requester->text()).isRelative()) {
91  mParameter = requester->text();
92  } else {
93  const KUrl url = requester->url();
94  mParameter = (url.isLocalFile() ? url.toLocalFile() : url.path());
95  }
96 }
97 
98 void FilterActionWithUrl::setParamWidgetValue( QWidget *paramWidget ) const
99 {
100  KUrlRequester *requester = paramWidget->findChild<KUrlRequester*>( QLatin1String("requester") );
101  Q_ASSERT( requester );
102  requester->setUrl( KUrl( mParameter ) );
103 }
104 
105 void FilterActionWithUrl::clearParamWidget( QWidget *paramWidget ) const
106 {
107  KUrlRequester *requester = paramWidget->findChild<KUrlRequester*>( QLatin1String("requester") );
108  Q_ASSERT( requester );
109  requester->clear();
110 }
111 
112 void FilterActionWithUrl::argsFromString( const QString &argsStr )
113 {
114  mParameter = argsStr;
115 }
116 
117 QString FilterActionWithUrl::argsAsString() const
118 {
119  return mParameter;
120 }
121 
122 QString FilterActionWithUrl::displayString() const
123 {
124  return label() + QLatin1String( " \"" ) + Qt::escape( argsAsString() ) + QLatin1String( "\"" );
125 }
126 
127 
MailCommon::FilterActionWithUrl::setParamWidgetValue
virtual void setParamWidgetValue(QWidget *paramWidget) const
The filter action shall set it's widget's contents from it's parameter.
Definition: filteractionwithurl.cpp:98
MailCommon::FilterActionWithUrl::displayString
virtual QString displayString() const
Returns a translated string describing this filter for visualization purposes, e.g.
Definition: filteractionwithurl.cpp:122
QWhatsThis::showText
void showText(const QPoint &pos, const QString &text, QWidget *w)
QWidget
MailCommon::FilterActionWithUrl::applyParamWidgetValue
virtual void applyParamWidgetValue(QWidget *paramWidget)
The filter action shall set it's parameter from the widget's contents.
Definition: filteractionwithurl.cpp:85
MailCommon::FilterActionWithUrl::clearParamWidget
virtual void clearParamWidget(QWidget *paramWidget) const
The filter action shall clear it's parameter widget's contents.
Definition: filteractionwithurl.cpp:105
MailCommon::FilterActionWithUrl::mParameter
QString mParameter
Definition: filteractionwithurl.h:111
QHBoxLayout
filteractionwithurl.h
QAbstractButton::setIcon
void setIcon(const QIcon &icon)
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)
QWidget::setLayout
void setLayout(QLayout *layout)
QObject
MailCommon::FilterActionWithUrl::createParamWidget
virtual QWidget * createParamWidget(QWidget *parent) const
Creates a widget for setting the filter action parameter.
Definition: filteractionwithurl.cpp:57
QObject::setObjectName
void setObjectName(const QString &name)
QString::isEmpty
bool isEmpty() const
QString::trimmed
QString trimmed() const
MailCommon::FilterActionWithUrl::argsFromString
virtual void argsFromString(const QString &argsStr)
Definition: filteractionwithurl.cpp:112
QString
MailCommon::FilterAction::label
QString label() const
Returns i18n'd label, ie.
Definition: filteraction.cpp:45
QLayout::setMargin
void setMargin(int margin)
MailCommon::FilterActionWithUrl::FilterActionWithUrl
FilterActionWithUrl(const QString &name, const QString &label, QObject *parent=0)
Creates a new filter action.
Definition: filteractionwithurl.cpp:43
QToolButton
QUrl
MailCommon::FilterActionWithUrl::argsAsString
virtual QString argsAsString() const
Return extra arguments as string.
Definition: filteractionwithurl.cpp:117
QCursor::pos
QPoint pos()
QLatin1String
Qt::escape
QString escape(const QString &plain)
MailCommon::FilterAction::filterActionModified
void filterActionModified()
Called to notify that the current FilterAction has had some value modification.
MailCommon::FilterActionWithUrlHelpButton::~FilterActionWithUrlHelpButton
~FilterActionWithUrlHelpButton()
Definition: filteractionwithurl.cpp:38
MailCommon::FilterActionWithUrlHelpButton::FilterActionWithUrlHelpButton
FilterActionWithUrlHelpButton(QWidget *parent=0)
Definition: filteractionwithurl.cpp:30
MailCommon::FilterActionWithUrlHelpButton
Abstract base class for filter actions with a command line as parameter.
Definition: filteractionwithurl.h:48
QWidget::setToolTip
void setToolTip(const QString &)
QObject::connect
bool connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
MailCommon::FilterActionWithUrl::isEmpty
virtual bool isEmpty() const
Determines whether this action is valid.
Definition: filteractionwithurl.cpp:52
MailCommon::FilterActionWithUrl::~FilterActionWithUrl
~FilterActionWithUrl()
Destroys the filter action.
Definition: filteractionwithurl.cpp:48
QBoxLayout::setSpacing
void setSpacing(int spacing)
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