You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdepim/kmail/signatureconfigurator.cpp

269 lines
9.2 KiB

/* -*- 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"