kcmodulecontainer.cpp
/* This file is part of the KDE libraries
Copyright (C) 2004 Frans Englich <frans.englich@telia.com>
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 <qlayout.h>
#include <qpixmap.h>
#include <qstringlist.h>
#include <qtabwidget.h>
#include <qtooltip.h>
#include <qvaluelist.h>
#include <kcmodule.h>
#include <kcmoduleinfo.h>
#include <kcmoduleloader.h>
#include <kcmoduleproxy.h>
#include <kdebug.h>
#include <kdialog.h>
#include <kglobal.h>
#include <kiconloader.h>
#include <kpushbutton.h>
#include <kservice.h>
#include <kstdguiitem.h>
#include "kcmodulecontainer.h"
#include "kcmodulecontainer.moc"
/***********************************************************************/
class KCModuleContainer::KCModuleContainerPrivate
{
public:
KCModuleContainerPrivate( const QStringList& mods )
: modules( mods )
, tabWidget( 0 )
, buttons( 0 )
, hasRootKCM( false )
, btnRootMode( 0 )
, btnLayout( 0 )
, topLayout( 0 )
{}
QStringList modules;
QTabWidget *tabWidget;
int buttons;
bool hasRootKCM: 1;
KPushButton *btnRootMode;
QHBoxLayout *btnLayout;
QVBoxLayout *topLayout;
};
/***********************************************************************/
/***********************************************************************/
KCModuleContainer::KCModuleContainer( QWidget* parent, const char* name,
const QString& mods )
: KCModule( parent, name )
{
d = new KCModuleContainerPrivate( QStringList::split( ",", QString(mods).remove( " " )) );
init();
}
KCModuleContainer::KCModuleContainer( QWidget* parent, const char* name,
const QStringList& mods )
: KCModule( parent, name ), d( new KCModuleContainerPrivate( mods ) )
{
init();
}
void KCModuleContainer::init()
{
d->topLayout = new QVBoxLayout( this, 0, KDialog::spacingHint(), "topLayout" );
d->tabWidget = new QTabWidget(this, "tabWidget");
d->tabWidget->setMargin(KDialog::marginHint());
connect( d->tabWidget, SIGNAL( currentChanged( QWidget* ) ), SLOT( tabSwitched( QWidget* ) ));
d->topLayout->addWidget( d->tabWidget );
if ( !d->modules.isEmpty() )
{
/* Add our modules */
for ( QStringList::Iterator it = d->modules.begin(); it != d->modules.end(); ++it )
addModule( (*it) );
finalize();
}
}
void KCModuleContainer::finalize()
{
setButtons( d->buttons );
if ( d->hasRootKCM ) /* Add a root mode button */
{
if(!d->btnLayout) /* It could already be added */
{
d->btnLayout = new QHBoxLayout(this, 0, 0, "btnLayout");
d->btnRootMode = new KPushButton(KStdGuiItem::adminMode(), this, "btnRootMode");
d->btnLayout->addWidget( d->btnRootMode );
d->btnLayout->addStretch();
d->topLayout->addLayout( d->btnLayout );
}
}
}
void KCModuleContainer::addModule( const QString& module )
{
/* In case it doesn't exist we just silently drop it.
* This allows people to easily extend containers.
* For example, KCM monitor gamma can be in kdegraphics.
*/
if ( !KService::serviceByDesktopName( module ) )
{
kdDebug(713) << "KCModuleContainer: module '" <<
module << "' was not found and thus not loaded" << endl;
return;
}
if( !KCModuleLoader::testModule( module ))
return;
KCModuleProxy* proxy = new KCModuleProxy( module, false, d->tabWidget, module.latin1());
allModules.append( proxy );
d->tabWidget->addTab( proxy, QIconSet(KGlobal::iconLoader()->loadIcon(
proxy->moduleInfo().icon(), KIcon::Desktop)),
/* QT eats ampersands for dinner. But not this time. */
proxy->moduleInfo().moduleName().replace( "&", "&&" ));
d->tabWidget->setTabToolTip( proxy, proxy->moduleInfo().comment() );
connect( proxy, SIGNAL(changed(KCModuleProxy *)), SLOT(moduleChanged(KCModuleProxy *)));
/* Collect our buttons - we go for the common deliminator */
d->buttons = d->buttons | proxy->realModule()->buttons();
/* If we should add an Administrator Mode button */
if ( proxy->moduleInfo().needsRootPrivileges() )
d->hasRootKCM=true;
}
void KCModuleContainer::tabSwitched( QWidget * module )
{
if ( !d->hasRootKCM )
return;
/* Not like this. Not like this. */
disconnect( d->btnRootMode, 0, 0, 0 );
/* Welcome to the real world huh baby? */
KCModuleProxy* mod = (KCModuleProxy *) module;
if ( mod->moduleInfo().needsRootPrivileges() && !mod->rootMode() )
{
d->btnRootMode->setEnabled( true );
connect( d->btnRootMode, SIGNAL( clicked() ),
SLOT( runAsRoot() ));
connect( mod, SIGNAL( childClosed() ),
SLOT ( rootExited() ));
}
else
d->btnRootMode->setEnabled( false );
setQuickHelp( mod->quickHelp() );
setAboutData( const_cast<KAboutData*>(mod->aboutData()) );
}
void KCModuleContainer::runAsRoot()
{
if ( d->tabWidget->currentPage() )
( (KCModuleProxy *) d->tabWidget->currentPage() )->runAsRoot();
d->btnRootMode->setEnabled( false );
}
void KCModuleContainer::rootExited()
{
connect( d->btnRootMode, SIGNAL( clicked() ), SLOT( runAsRoot() ));
d->btnRootMode->setEnabled( true );
}
void KCModuleContainer::save()
{
ModuleList list = changedModules;
ModuleList::iterator it;
for ( it = list.begin() ; it !=list.end() ; ++it )
{
(*it)->save();
}
emit changed( false );
}
void KCModuleContainer::load()
{
ModuleList list = allModules;
ModuleList::iterator it;
for ( it = list.begin() ; it !=list.end() ; ++it )
{
(*it)->load();
}
emit changed( false );
}
void KCModuleContainer::defaults()
{
ModuleList list = allModules;
ModuleList::iterator it;
for ( it = list.begin() ; it !=list.end() ; ++it )
{
(*it)->defaults();
}
emit changed( true );
}
void KCModuleContainer::moduleChanged(KCModuleProxy * proxy)
{
changedModules.append( proxy );
if( changedModules.isEmpty() )
return;
emit changed(true);
}
KCModuleContainer::~KCModuleContainer()
{
delete d;
}
/***********************************************************************/
KPushButton
KCModuleInfo::comment
QString comment() const
Definition: kcmoduleinfo.h:142
KCModuleContainer::changedModules
ModuleList changedModules
A list containing KCModuleProxy objects which have changed and must be saved.
Definition: kcmodulecontainer.h:137
KCModuleContainer::KCModuleContainer
KCModuleContainer(QWidget *parent, const char *name, const QStringList &mods)
Creates a KCModuleContainer with tabs, each one containing one of the specified modules in mods...
Definition: kcmodulecontainer.cpp:81
KCModule::setQuickHelp
void setQuickHelp(const QString &help)
KCModuleContainer::finalize
void finalize()
Sets this KCM's buttons and adds a AdminMode button if necessary.
Definition: kcmodulecontainer.cpp:107
KCModule::setButtons
void setButtons(int btn)
KCModuleProxy::moduleInfo
const KCModuleInfo & moduleInfo() const
Definition: kcmoduleproxy.cpp:626
KGlobal::iconLoader
static KIconLoader * iconLoader()
KCModuleContainer::save
void save()
Reimplemented for internal purposes.
Definition: kcmodulecontainer.cpp:202
kdDebug
kdbgstream kdDebug(int area=0)
KIcon::Desktop
KCModule::setAboutData
void setAboutData(KAboutData *about)
KCModuleContainer::load
void load()
Reimplemented for internal purposes.
Definition: kcmodulecontainer.cpp:215
KCModuleProxy::aboutData
const KAboutData * aboutData() const
Definition: kcmoduleproxy.cpp:588
KCModuleInfo::needsRootPrivileges
bool needsRootPrivileges() const
Definition: kcmoduleinfo.cpp:211
KCModuleLoader::testModule
static bool testModule(const QString &module)
Checks whether an KCModule should be shown by running its test function.
Definition: kcmoduleloader.cpp:216
KCModuleContainer::addModule
void addModule(const QString &module)
Adds the specified module to the tab widget.
Definition: kcmodulecontainer.cpp:124
KCModuleProxy
Encapsulates a KCModule for embedding.
Definition: kcmoduleproxy.h:68
KCModuleProxy::quickHelp
QString quickHelp() const
Definition: kcmoduleproxy.cpp:559
KCModuleContainer::defaults
void defaults()
Reimplemented for internal purposes.
Definition: kcmodulecontainer.cpp:227
KCModuleContainer::~KCModuleContainer
virtual ~KCModuleContainer()
Default destructor.
Definition: kcmodulecontainer.cpp:249
KCModuleContainer::allModules
ModuleList allModules
A list of all modules which are encapsulated.
Definition: kcmodulecontainer.h:142
KStdGuiItem::adminMode
static KGuiItem adminMode()
KCModuleInfo::icon
QString icon() const
Definition: kcmoduleinfo.h:147
KCModule::buttons
int buttons() const
endl
kndbgstream & endl(kndbgstream &s)
KCModuleProxy::rootMode
bool rootMode() const
Returns whether the module is running in root mode.
Definition: kcmoduleproxy.cpp:631
KCModuleProxy::realModule
KCModule * realModule() const
Access to the actual module.
Definition: kcmoduleproxy.cpp:140
KCModule
KCModuleInfo::moduleName
QString moduleName() const
Definition: kcmoduleinfo.h:131
KCModule::changed
void changed()

KDE Home | KDE Accessibility Home | Description of Access Keys