diff options
Diffstat (limited to 'libkdepim/kcmdesignerfields.cpp')
| -rw-r--r-- | libkdepim/kcmdesignerfields.cpp | 429 |
1 files changed, 429 insertions, 0 deletions
diff --git a/libkdepim/kcmdesignerfields.cpp b/libkdepim/kcmdesignerfields.cpp new file mode 100644 index 000000000..8e18efc47 --- /dev/null +++ b/libkdepim/kcmdesignerfields.cpp @@ -0,0 +1,429 @@ +/* + This file is part of libkdepim. + + Copyright (c) 2004 Tobias Koenig <tokoe@kde.org> + Copyright (c) 2004 Cornelius Schumacher <schumacher@kde.org> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public License + along with this library; see the file COPYING.LIB. If not, write to + the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + Boston, MA 02110-1301, USA. +*/ + +#include <unistd.h> + +#include <qimage.h> +#include <qlabel.h> +#include <qlayout.h> +#include <qobjectlist.h> +#include <qpixmap.h> +#include <qpushbutton.h> +#include <qwhatsthis.h> +#include <qgroupbox.h> +#include <qwidgetfactory.h> +#include <qregexp.h> +#include <qtimer.h> + +#include <kaboutdata.h> +#include <kdebug.h> +#include <kdialog.h> +#include <kglobal.h> +#include <klistview.h> +#include <klocale.h> +#include <krun.h> +#include <kstandarddirs.h> +#include <kactivelabel.h> +#include <kdirwatch.h> +#include <kfiledialog.h> +#include <kmessagebox.h> +#include <kprocess.h> +#include <kio/netaccess.h> + +#include "kcmdesignerfields.h" + +using namespace KPIM; + +class PageItem : public QCheckListItem +{ + public: + PageItem( QListView *parent, const QString &path ) + : QCheckListItem( parent, "", QCheckListItem::CheckBox ), + mPath( path ), mIsActive( false ) + { + mName = path.mid( path.findRev( '/' ) + 1 ); + + QWidget *wdg = QWidgetFactory::create( mPath, 0, 0 ); + if ( wdg ) { + setText( 0, wdg->caption() ); + + QPixmap pm = QPixmap::grabWidget( wdg ); + QImage img = pm.convertToImage().smoothScale( 300, 300, QImage::ScaleMin ); + mPreview = img; + + QObjectList *list = wdg->queryList( "QWidget" ); + QObjectListIt it( *list ); + + QMap<QString, QString> allowedTypes; + allowedTypes.insert( "QLineEdit", i18n( "Text" ) ); + allowedTypes.insert( "QTextEdit", i18n( "Text" ) ); + allowedTypes.insert( "QSpinBox", i18n( "Numeric Value" ) ); + allowedTypes.insert( "QCheckBox", i18n( "Boolean" ) ); + allowedTypes.insert( "QComboBox", i18n( "Selection" ) ); + allowedTypes.insert( "QDateTimeEdit", i18n( "Date & Time" ) ); + allowedTypes.insert( "KLineEdit", i18n( "Text" ) ); + allowedTypes.insert( "KDateTimeWidget", i18n( "Date & Time" ) ); + allowedTypes.insert( "KDatePicker", i18n( "Date" ) ); + + while ( it.current() ) { + if ( allowedTypes.find( it.current()->className() ) != allowedTypes.end() ) { + QString name = it.current()->name(); + if ( name.startsWith( "X_" ) ) { + new QListViewItem( this, name, + allowedTypes[ it.current()->className() ], + it.current()->className(), + QWhatsThis::textFor( static_cast<QWidget*>( it.current() ) ) ); + } + } + + ++it; + } + + delete list; + } + } + + QString name() const { return mName; } + QString path() const { return mPath; } + + QPixmap preview() + { + return mPreview; + } + + void setIsActive( bool isActive ) { mIsActive = isActive; } + bool isActive() const { return mIsActive; } + + protected: + void paintBranches( QPainter *p, const QColorGroup & cg, int w, int y, int h ) + { + QListViewItem::paintBranches( p, cg, w, y, h ); + } + + private: + QString mName; + QString mPath; + QPixmap mPreview; + bool mIsActive; +}; + +KCMDesignerFields::KCMDesignerFields( QWidget *parent, const char *name ) + : KCModule( parent, name ) +{ + QTimer::singleShot( 0, this, SLOT( delayedInit() ) ); + + KAboutData *about = new KAboutData( I18N_NOOP( "KCMDesignerfields" ), + I18N_NOOP( "Qt Designer Fields Dialog" ), + 0, 0, KAboutData::License_LGPL, + I18N_NOOP( "(c), 2004 Tobias Koenig" ) ); + + about->addAuthor( "Tobias Koenig", 0, "tokoe@kde.org" ); + about->addAuthor( "Cornelius Schumacher", 0, "schumacher@kde.org" ); + setAboutData( about ); +} + +void KCMDesignerFields::delayedInit() +{ + kdDebug() << "KCMDesignerFields::delayedInit()" << endl; + + initGUI(); + + connect( mPageView, SIGNAL( selectionChanged( QListViewItem* ) ), + this, SLOT( updatePreview( QListViewItem* ) ) ); + connect( mPageView, SIGNAL( clicked( QListViewItem* ) ), + this, SLOT( itemClicked( QListViewItem* ) ) ); + + connect( mDeleteButton, SIGNAL( clicked() ), + this, SLOT( deleteFile() ) ); + connect( mImportButton, SIGNAL( clicked() ), + this, SLOT( importFile() ) ); + connect( mDesignerButton, SIGNAL( clicked() ), + this, SLOT( startDesigner() ) ); + + load(); + + // Install a dirwatcher that will detect newly created or removed designer files + KDirWatch *dw = new KDirWatch( this ); + dw->addDir( localUiDir(), true ); + connect( dw, SIGNAL( created(const QString&) ), SLOT( rebuildList() ) ); + connect( dw, SIGNAL( deleted(const QString&) ), SLOT( rebuildList() ) ); + connect( dw, SIGNAL( dirty(const QString&) ), SLOT( rebuildList() ) ); +} + +void KCMDesignerFields::deleteFile() +{ + QListViewItem *item = mPageView->selectedItem(); + if ( item ) { + PageItem *pageItem = static_cast<PageItem*>( item->parent() ? item->parent() : item ); + if (KMessageBox::warningContinueCancel(this, + i18n( "<qt>Do you really want to delete '<b>%1</b>'?</qt>").arg( pageItem->text(0) ), "", KStdGuiItem::del() ) + == KMessageBox::Continue) + KIO::NetAccess::del( pageItem->path(), 0 ); + } + // The actual view refresh will be done automagically by the slots connected to kdirwatch +} + +void KCMDesignerFields::importFile() +{ + KURL src = KFileDialog::getOpenFileName( QDir::homeDirPath(), i18n("*.ui|Designer Files"), + this, i18n("Import Page") ); + KURL dest = localUiDir(); + dest.setFileName(src.fileName()); + KIO::NetAccess::file_copy( src, dest, -1, true, false, this ); + // The actual view refresh will be done automagically by the slots connected to kdirwatch +} + + +void KCMDesignerFields::loadUiFiles() +{ + QStringList list = KGlobal::dirs()->findAllResources( "data", uiPath() + "/*.ui", true, true ); + for ( QStringList::iterator it = list.begin(); it != list.end(); ++it ) { + new PageItem( mPageView, *it ); + } +} + +void KCMDesignerFields::rebuildList() +{ + QStringList ai = saveActivePages(); + updatePreview( 0 ); + mPageView->clear(); + loadUiFiles(); + loadActivePages(ai); +} + +void KCMDesignerFields::loadActivePages(const QStringList& ai) +{ + QListViewItemIterator it( mPageView ); + while ( it.current() ) { + if ( it.current()->parent() == 0 ) { + PageItem *item = static_cast<PageItem*>( it.current() ); + if ( ai.find( item->name() ) != ai.end() ) { + item->setOn( true ); + item->setIsActive( true ); + } + } + + ++it; + } +} + +void KCMDesignerFields::load() +{ + loadActivePages( readActivePages() ); +} + +QStringList KCMDesignerFields::saveActivePages() +{ + QListViewItemIterator it( mPageView, QListViewItemIterator::Checked | + QListViewItemIterator::Selectable ); + + QStringList activePages; + while ( it.current() ) { + if ( it.current()->parent() == 0 ) { + PageItem *item = static_cast<PageItem*>( it.current() ); + activePages.append( item->name() ); + } + + ++it; + } + + return activePages; +} + +void KCMDesignerFields::save() +{ + writeActivePages( saveActivePages() ); +} + +void KCMDesignerFields::defaults() +{ +} + +void KCMDesignerFields::initGUI() +{ + QVBoxLayout *layout = new QVBoxLayout( this, KDialog::marginHint(), + KDialog::spacingHint() ); + + bool noDesigner = KStandardDirs::findExe("designer").isEmpty(); + + if ( noDesigner ) + { + QString txt = + i18n("<qt><b>Warning:</b> Qt Designer could not be found. It is probably not " + "installed. You will only be able to import existing designer files.</qt>"); + QLabel *lbl = new QLabel( txt, this ); + layout->addWidget( lbl ); + } + + QHBoxLayout *hbox = new QHBoxLayout( layout, KDialog::spacingHint() ); + + mPageView = new KListView( this ); + mPageView->addColumn( i18n( "Available Pages" ) ); + mPageView->setRootIsDecorated( true ); + mPageView->setAllColumnsShowFocus( true ); + mPageView->setFullWidth( true ); + hbox->addWidget( mPageView ); + + QGroupBox *box = new QGroupBox(1, Qt::Horizontal, i18n("Preview of Selected Page"), this ); + + mPagePreview = new QLabel( box ); + mPagePreview->setMinimumWidth( 300 ); + + mPageDetails = new QLabel( box ); + + hbox->addWidget( box ); + + loadUiFiles(); + + hbox = new QHBoxLayout( layout, KDialog::spacingHint() ); + + QString cwHowto = i18n("<qt><p>This section allows you to add your own GUI" + " Elements ('<i>Widgets</i>') to store your own values" + " into %1. Proceed as described below:</p>" + "<ol>" + "<li>Click on '<i>Edit with Qt Designer</i>'" + "<li>In the dialog, select '<i>Widget</i>', then click <i>OK</i>" + "<li>Add your widgets to the form" + "<li>Save the file in the directory proposed by Qt Designer" + "<li>Close Qt Designer" + "</ol>" + "<p>In case you already have a designer file (*.ui) located" + " somewhere on your hard disk, simply choose '<i>Import Page</i>'</p>" + "<p><b>Important:</b> The name of each input widget you place within" + " the form must start with '<i>X_</i>'; so if you want the widget to" + " correspond to your custom entry '<i>X-Foo</i>', set the widget's" + " <i>name</i> property to '<i>X_Foo</i>'.</p>" + "<p><b>Important:</b> The widget will edit custom fields with an" + " application name of %2. To change the application name" + " to be edited, set the widget name in Qt Designer.</p></qt>" ) + .arg( applicationName(), applicationName() ); + + KActiveLabel *activeLabel = new KActiveLabel( + i18n( "<a href=\"whatsthis:%1\">How does this work?</a>" ).arg(cwHowto), this ); + hbox->addWidget( activeLabel ); + + // ### why is this needed? Looks like a KActiveLabel bug... + activeLabel->setSizePolicy( QSizePolicy::Preferred, QSizePolicy::Maximum ); + + hbox->addStretch( 1 ); + + mDeleteButton = new QPushButton( i18n( "Delete Page" ), this); + mDeleteButton->setEnabled( false ); + hbox->addWidget( mDeleteButton ); + mImportButton = new QPushButton( i18n( "Import Page..." ), this); + hbox->addWidget( mImportButton ); + mDesignerButton = new QPushButton( i18n( "Edit with Qt Designer..." ), this ); + hbox->addWidget( mDesignerButton ); + + if ( noDesigner ) + mDesignerButton->setEnabled( false ); + + // FIXME: Why do I have to call show() for all widgets? A this->show() doesn't + // seem to work. + mPageView->show(); + box->show(); + activeLabel->show(); + mDeleteButton->show(); + mImportButton->show(); + mDesignerButton->show(); +} + +void KCMDesignerFields::updatePreview( QListViewItem *item ) +{ + bool widgetItemSelected = false; + + if ( item ) { + if ( item->parent() ) { + QString details = QString( "<qt><table>" + "<tr><td align=\"right\"><b>%1</b></td><td>%2</td></tr>" + "<tr><td align=\"right\"><b>%3</b></td><td>%4</td></tr>" + "<tr><td align=\"right\"><b>%5</b></td><td>%6</td></tr>" + "<tr><td align=\"right\"><b>%7</b></td><td>%8</td></tr>" + "</table></qt>" ) + .arg( i18n( "Key:" ) ) + .arg( item->text( 0 ).replace("X_","X-") ) + .arg( i18n( "Type:" ) ) + .arg( item->text( 1 ) ) + .arg( i18n( "Classname:" ) ) + .arg( item->text( 2 ) ) + .arg( i18n( "Description:" ) ) + .arg( item->text( 3 ) ); + + mPageDetails->setText( details ); + + PageItem *pageItem = static_cast<PageItem*>( item->parent() ); + mPagePreview->setPixmap( pageItem->preview() ); + } else { + mPageDetails->setText( QString::null ); + + PageItem *pageItem = static_cast<PageItem*>( item ); + mPagePreview->setPixmap( pageItem->preview() ); + + widgetItemSelected = true; + } + + mPagePreview->setFrameStyle( QFrame::Panel | QFrame::Sunken ); + } else { + mPagePreview->setPixmap( QPixmap() ); + mPagePreview->setFrameStyle( 0 ); + mPageDetails->setText( QString::null ); + } + + mDeleteButton->setEnabled( widgetItemSelected ); +} + +void KCMDesignerFields::itemClicked( QListViewItem *item ) +{ + if ( !item || item->parent() != 0 ) + return; + + PageItem *pageItem = static_cast<PageItem*>( item ); + + if ( pageItem->isOn() != pageItem->isActive() ) { + emit changed( true ); + pageItem->setIsActive( pageItem->isOn() ); + } +} + +void KCMDesignerFields::startDesigner() +{ + QString cmdLine = "designer"; + + // check if path exists and create one if not. + QString cepPath = localUiDir(); + if( !KGlobal::dirs()->exists(cepPath) ) { + KIO::NetAccess::mkdir( cepPath, this ); + } + + // finally jump there + chdir(cepPath.local8Bit()); + + QListViewItem *item = mPageView->selectedItem(); + if ( item ) { + PageItem *pageItem = static_cast<PageItem*>( item->parent() ? item->parent() : item ); + cmdLine += " " + KProcess::quote( pageItem->path() ); + } + + KRun::runCommand( cmdLine ); +} + +#include "kcmdesignerfields.moc" |