kutils/kcmodulecontainer.cpp

   1 /* This file is part of the KDE libraries
   2     Copyright (C) 2004 Frans Englich <frans.englich@telia.com>
   3
   4     This library is free software; you can redistribute it and/or
   5     modify it under the terms of the GNU Library General Public
   6     License as published by the Free Software Foundation; either
   7     version 2 of the License, or (at your option) any later version.
   8
   9     This library 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 GNU
  12     Library General Public License for more details.
  13
  14     You should have received a copy of the GNU Library General Public License
  15     along with this library; see the file COPYING.LIB.  If not, write to
  16     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17     Boston, MA 02110-1301, USA.
  18 */
  19
  20 #include "kcmodulecontainer.h"
  21 #include "kcmodulecontainer.moc"
  22
  23 #include <QtGui/QLayout>
  24 #include <QtGui/QPixmap>
  25 #include <QtCore/QStringList>
  26
  27 #include <kcmodule.h>
  28 #include <kcmoduleinfo.h>
  29 #include <kcmoduleloader.h>
  30 #include <kcmoduleproxy.h>
  31 #include <kdebug.h>
  32 #include <kdialog.h>
  33 #include <kglobal.h>
  34 #include <kguiitem.h>
  35 #include <kicon.h>
  36 #include <kiconloader.h>
  37 #include <kpushbutton.h>
  38 #include <kservice.h>
  39 #include <kstandardguiitem.h>
  40 #include <ktabwidget.h>
  41
  42 /***********************************************************************/
  43 class KCModuleContainer::KCModuleContainerPrivate
  44 {
  45         public:
  46                 KCModuleContainerPrivate( const QStringList& mods )
  47                         : modules( mods )
  48                         , tabWidget( 0 )
  49                         , topLayout( 0 )
  50                         {}
  51
  52                 QStringList modules;
  53                 KTabWidget *tabWidget;
  54                 KCModule::Buttons buttons;
  55                 QVBoxLayout *topLayout;
  56
  57
  58 };
  59 /***********************************************************************/
  60
  61
  62
  63 // The KCModuleContainer is only a wrapper around real KCModules. Therefore it doesn't need a
  64 // special KComponentData and can just use the global instance. The contained KCModules create their own
  65 // KComponentData objects when needed.
  66 /***********************************************************************/
  67 KCModuleContainer::KCModuleContainer( QWidget* parent, const QString& mods )
  68         : KCModule( KGlobal::mainComponent(), parent ),d(new KCModuleContainerPrivate( QString(mods).remove( ' ' ).split( ',' ) ))
  69 {
  70         init();
  71 }
  72
  73 KCModuleContainer::KCModuleContainer( QWidget* parent, const QStringList& mods )
  74         : KCModule( KGlobal::mainComponent(), parent ), d( new KCModuleContainerPrivate( mods ) )
  75 {
  76         init();
  77 }
  78
  79 void KCModuleContainer::init()
  80 {
  81         d->topLayout = new QVBoxLayout( this );
  82         d->topLayout->setMargin( 0 );
  83         d->topLayout->setSpacing( KDialog::spacingHint() );
  84         d->topLayout->setObjectName( "topLayout" );
  85         d->tabWidget = new KTabWidget(this);
  86         d->tabWidget->setObjectName( "tabWidget");
  87         connect( d->tabWidget, SIGNAL( currentChanged( QWidget* ) ), SLOT( tabSwitched( QWidget* ) ));
  88         d->topLayout->addWidget( d->tabWidget );
  89
  90         if ( !d->modules.isEmpty() )
  91         {
  92                 /* Add our modules */
  93                 for ( QStringList::const_iterator it = d->modules.constBegin(); it != d->modules.constEnd(); ++it )
  94                         addModule( (*it) );
  95         }
  96 }
  97
  98 void KCModuleContainer::addModule( const QString& module )
  99 {
 100         /* In case it doesn't exist we just silently drop it.
 101          * This allows people to easily extend containers.
 102          * For example, KCM monitor gamma can be in kdegraphics.
 103          */
 104         KService::Ptr service = KService::serviceByDesktopName( module );
 105         if ( !service )
 106         {
 107                 kDebug(713) << "KCModuleContainer: module '" <<
 108                         module << "' was not found and thus not loaded" << endl;
 109                 return;
 110         }
 111
 112         if ( service->noDisplay() )
 113                 return;
 114
 115         KCModuleProxy* proxy = new KCModuleProxy( service, d->tabWidget );
 116         allModules.append( proxy );
 117
 118         proxy->setObjectName( module.toLatin1() );
 119
 120         d->tabWidget->addTab( proxy, KIcon( proxy->moduleInfo().icon() ),
 121                         /* Qt eats ampersands for dinner. But not this time. */
 122                         proxy->moduleInfo().moduleName().replace( '&', "&&" ));
 123
 124         d->tabWidget->setTabToolTip( d->tabWidget->indexOf( proxy ), proxy->moduleInfo().comment() );
 125
 126         connect( proxy, SIGNAL(changed(KCModuleProxy *)), SLOT(moduleChanged(KCModuleProxy *)));
 127
 128         /* Collect our buttons - we go for the common deliminator */
 129         setButtons( buttons() | proxy->realModule()->buttons() );
 130 }
 131
 132 void KCModuleContainer::tabSwitched( QWidget * module )
 133 {
 134         KCModuleProxy* mod = (KCModuleProxy *) module;
 135         setQuickHelp( mod->quickHelp() );
 136         setAboutData( mod->aboutData() );
 137 }
 138
 139 void KCModuleContainer::save()
 140 {
 141         ModuleList list = changedModules;
 142         ModuleList::iterator it;
 143         for ( it = list.begin() ; it !=list.end() ; ++it )
 144         {
 145                 (*it)->save();
 146         }
 147
 148         emit changed( false );
 149
 150 }
 151
 152 void KCModuleContainer::load()
 153 {
 154         ModuleList list = allModules;
 155         ModuleList::iterator it;
 156         for ( it = list.begin() ; it !=list.end() ; ++it )
 157         {
 158                 (*it)->load();
 159         }
 160
 161         emit changed( false );
 162 }
 163
 164 void KCModuleContainer::defaults()
 165 {
 166         ModuleList list = allModules;
 167         ModuleList::iterator it;
 168         for ( it = list.begin() ; it !=list.end() ; ++it )
 169         {
 170                 (*it)->defaults();
 171         }
 172
 173         emit changed( true );
 174 }
 175
 176
 177 void KCModuleContainer::moduleChanged(KCModuleProxy * proxy)
 178 {
 179         changedModules.append( proxy );
 180         if( changedModules.isEmpty() )
 181                 return;
 182
 183         emit changed(true);
 184 }
 185
 186 KCModuleContainer::~KCModuleContainer()
 187 {
 188         delete d;
 189 }
 190
 191 /***********************************************************************/
 192
 193
 194
 195