Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 268 insertions, 0 deletions

diff --git a/kmail/signatureconfigurator.cpp b/kmail/signatureconfigurator.cpp
new file mode 100644
index 00000000..68bfd194
--- /dev/null
+++ b/kmail/signatureconfigurator.cpp
@@ -0,0 +1,268 @@
+/*  -*- c++ -*-
+    signatureconfigurator.cpp
+
+    KMail, the KDE mail client.
+    Copyright (c) 2002 the KMail authors.
+    See file AUTHORS for details
+
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License,
+    version 2.0, as published by the Free Software Foundation.
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software Foundation,
+    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, US
+*/
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include "signatureconfigurator.h"
+
+#include <klocale.h>
+#include <kdialog.h>
+#include <klineedit.h>
+#include <kurlrequester.h>
+#include <kshellcompletion.h>
+#include <krun.h>
+
+#include <qcheckbox.h>
+#include <qcombobox.h>
+#include <qdir.h>
+#include <qfileinfo.h>
+#include <qlabel.h>
+#include <qlayout.h>
+#include <qtextedit.h>
+#include <qwhatsthis.h>
+#include <qwidgetstack.h>
+
+#include <assert.h>
+
+using namespace KMail;
+
+namespace KMail {
+
+  SignatureConfigurator::SignatureConfigurator( QWidget * parent, const char * name )
+    : QWidget( parent, name )
+  {
+    // tmp. vars:
+    QLabel * label;
+    QWidget * page;
+    QHBoxLayout * hlay;
+    QVBoxLayout * vlay;
+    QVBoxLayout * page_vlay;
+
+    vlay = new QVBoxLayout( this, 0, KDialog::spacingHint(), "main layout" );
+
+    // "enable signatue" checkbox:
+    mEnableCheck = new QCheckBox( i18n("&Enable signature"), this );
+    QWhatsThis::add(mEnableCheck,
+        i18n("Check this box if you want KMail to append a signature to mails "
+             "written with this identity."));
+    vlay->addWidget( mEnableCheck );
+
+    // "obtain signature text from" combo and label:
+    hlay = new QHBoxLayout( vlay ); // inherits spacing
+    mSourceCombo = new QComboBox( false, this );
+    QWhatsThis::add(mSourceCombo,
+        i18n("Click on the widgets below to obtain help on the input methods."));
+    mSourceCombo->setEnabled( false ); // since !mEnableCheck->isChecked()
+    mSourceCombo->insertStringList( QStringList()
+		   << i18n("continuation of \"obtain signature text from\"",
+			   "Input Field Below")
+		   << i18n("continuation of \"obtain signature text from\"",
+			   "File")
+                   << i18n("continuation of \"obtain signature text from\"",
+			   "Output of Command")
+		   );
+    label = new QLabel( mSourceCombo,
+			i18n("Obtain signature &text from:"), this );
+    label->setEnabled( false ); // since !mEnableCheck->isChecked()
+    hlay->addWidget( label );
+    hlay->addWidget( mSourceCombo, 1 );
+
+    // widget stack that is controlled by the source combo:
+    QWidgetStack * widgetStack = new QWidgetStack( this );
+    widgetStack->setEnabled( false ); // since !mEnableCheck->isChecked()
+    vlay->addWidget( widgetStack, 1 );
+    connect( mSourceCombo, SIGNAL(highlighted(int)),
+	     widgetStack, SLOT(raiseWidget(int)) );
+    // connects for the enabling of the widgets depending on
+    // signatureEnabled:
+    connect( mEnableCheck, SIGNAL(toggled(bool)),
+	     mSourceCombo, SLOT(setEnabled(bool)) );
+    connect( mEnableCheck, SIGNAL(toggled(bool)),
+	     widgetStack, SLOT(setEnabled(bool)) );
+    connect( mEnableCheck, SIGNAL(toggled(bool)),
+	     label, SLOT(setEnabled(bool)) );
+    // The focus might be still in the widget that is disabled
+    connect( mEnableCheck, SIGNAL(clicked()),
+	     mEnableCheck, SLOT(setFocus()) );
+
+    int pageno = 0;
+    // page 0: input field for direct entering:
+    mTextEdit = new QTextEdit( widgetStack );
+    QWhatsThis::add(mTextEdit,
+        i18n("Use this field to enter an arbitrary static signature."));
+    widgetStack->addWidget( mTextEdit, pageno );
+    mTextEdit->setFont( KGlobalSettings::fixedFont() );
+    mTextEdit->setWordWrap( QTextEdit::NoWrap );
+    mTextEdit->setTextFormat( Qt::PlainText );
+
+    widgetStack->raiseWidget( 0 ); // since mSourceCombo->currentItem() == 0
+
+    // page 1: "signature file" requester, label, "edit file" button:
+    ++pageno;
+	page = new QWidget( widgetStack );
+    widgetStack->addWidget( page, pageno ); // force sequential numbers (play safe)
+    page_vlay = new QVBoxLayout( page, 0, KDialog::spacingHint() );
+    hlay = new QHBoxLayout( page_vlay ); // inherits spacing
+    mFileRequester = new KURLRequester( page );
+    QWhatsThis::add(mFileRequester,
+        i18n("Use this requester to specify a text file that contains your "
+             "signature. It will be read every time you create a new mail or "
+             "append a new signature."));
+    hlay->addWidget( new QLabel( mFileRequester,
+				 i18n("S&pecify file:"), page ) );
+    hlay->addWidget( mFileRequester, 1 );
+    mFileRequester->button()->setAutoDefault( false );
+    connect( mFileRequester, SIGNAL(textChanged(const QString &)),
+	     this, SLOT(slotEnableEditButton(const QString &)) );
+    mEditButton = new QPushButton( i18n("Edit &File"), page );
+    QWhatsThis::add(mEditButton, i18n("Opens the specified file in a text editor."));
+    connect( mEditButton, SIGNAL(clicked()), SLOT(slotEdit()) );
+    mEditButton->setAutoDefault( false );
+    mEditButton->setEnabled( false ); // initially nothing to edit
+    hlay->addWidget( mEditButton );
+    page_vlay->addStretch( 1 ); // spacer
+
+    // page 2: "signature command" requester and label:
+    ++pageno;
+    page = new QWidget( widgetStack );
+    widgetStack->addWidget( page, pageno );
+    page_vlay = new QVBoxLayout( page, 0, KDialog::spacingHint() );
+    hlay = new QHBoxLayout( page_vlay ); // inherits spacing
+    mCommandEdit = new KLineEdit( page );
+    mCommandEdit->setCompletionObject( new KShellCompletion() );
+    mCommandEdit->setAutoDeleteCompletionObject( true );
+    QWhatsThis::add(mCommandEdit,
+        i18n("You can add an arbitrary command here, either with or without path "
+             "depending on whether or not the command is in your Path. For every "
+             "new mail, KMail will execute the command and use what it outputs (to "
+             "standard output) as a signature. Usual commands for use with this "
+             "mechanism are \"fortune\" or \"ksig -random\"."));
+    hlay->addWidget( new QLabel( mCommandEdit,
+				 i18n("S&pecify command:"), page ) );
+    hlay->addWidget( mCommandEdit, 1 );
+    page_vlay->addStretch( 1 ); // spacer
+
+  }
+
+  SignatureConfigurator::~SignatureConfigurator() {
+
+  }
+
+  bool SignatureConfigurator::isSignatureEnabled() const {
+    return mEnableCheck->isChecked();
+  }
+
+  void SignatureConfigurator::setSignatureEnabled( bool enable ) {
+    mEnableCheck->setChecked( enable );
+  }
+
+  Signature::Type SignatureConfigurator::signatureType() const {
+    if ( !isSignatureEnabled() ) return Signature::Disabled;
+
+    switch ( mSourceCombo->currentItem() ) {
+    case 0:  return Signature::Inlined;
+    case 1:  return Signature::FromFile;
+    case 2:  return Signature::FromCommand;
+    default: return Signature::Disabled;
+    }
+  }
+
+  void SignatureConfigurator::setSignatureType( Signature::Type type ) {
+    setSignatureEnabled( type != Signature::Disabled );
+
+    int idx = 0;
+    switch( type ) {
+    case Signature::Inlined:     idx = 0; break;
+    case Signature::FromFile:	 idx = 1; break;
+    case Signature::FromCommand: idx = 2; break;
+    default:                     idx = 0; break;
+    };
+
+    mSourceCombo->setCurrentItem( idx );
+  }
+
+  QString SignatureConfigurator::inlineText() const {
+    return mTextEdit->text();
+  }
+
+  void SignatureConfigurator::setInlineText( const QString & text ) {
+    mTextEdit->setText( text );
+  }
+
+  QString SignatureConfigurator::fileURL() const {
+    QString file = mFileRequester->url().stripWhiteSpace();
+
+    // Force the filename to be relative to ~ instead of $PWD depending
+    // on the rest of the code (KRun::run in Edit and KFileItem on save)
+    if ( !file.isEmpty() && QFileInfo( file ).isRelative() )
+        file = QDir::home().absPath() + QDir::separator() + file;
+
+    return file;
+  }
+
+  void SignatureConfigurator::setFileURL( const QString & url ) {
+    mFileRequester->setURL( url );
+  }
+
+  QString SignatureConfigurator::commandURL() const {
+    return mCommandEdit->text();
+  }
+
+  void SignatureConfigurator::setCommandURL( const QString & url ) {
+    mCommandEdit->setText( url );
+  }
+
+
+  Signature SignatureConfigurator::signature() const {
+    Signature sig;
+    sig.setType( signatureType() );
+    sig.setText( inlineText() );
+    if ( signatureType() == Signature::FromCommand )
+      sig.setUrl( commandURL(), true );
+    if ( signatureType() == Signature::FromFile )
+      sig.setUrl( fileURL(), false );
+    return sig;
+  }
+
+  void SignatureConfigurator::setSignature( const Signature & sig ) {
+    setSignatureType( sig.type() );
+    setInlineText( sig.text() );
+    if ( sig.type() == Signature::FromFile )
+      setFileURL( sig.url() );
+    else
+      setFileURL( QString::null );
+    if ( sig.type() == Signature::FromCommand )
+      setCommandURL( sig.url() );
+    else
+      setCommandURL( QString::null );
+  }
+
+  void SignatureConfigurator::slotEnableEditButton( const QString & url ) {
+    mEditButton->setDisabled( url.stripWhiteSpace().isEmpty() );
+  }
+
+  void SignatureConfigurator::slotEdit() {
+    QString url = fileURL();
+    // slotEnableEditButton should prevent this assert from being hit:
+    assert( !url.isEmpty() );
+
+    (void)KRun::runURL( KURL( url ), QString::fromLatin1("text/plain") );
+  }
+
+} // namespace KMail
+
+#include "signatureconfigurator.moc"