From ce4a32fe52ef09d8f5ff1dd22c001110902b60a2 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: 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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- kcmshell/Makefile.am | 39 ++++++ kcmshell/main.cpp | 346 +++++++++++++++++++++++++++++++++++++++++++++++++++ kcmshell/main.h | 104 ++++++++++++++++ 3 files changed, 489 insertions(+) create mode 100644 kcmshell/Makefile.am create mode 100644 kcmshell/main.cpp create mode 100644 kcmshell/main.h (limited to 'kcmshell') diff --git a/kcmshell/Makefile.am b/kcmshell/Makefile.am new file mode 100644 index 000000000..81b3e2c8e --- /dev/null +++ b/kcmshell/Makefile.am @@ -0,0 +1,39 @@ +# +# Copyright (c) 1999 Matthias Hoelzer-Kluepfel +# Copyright (c) 2000 Matthias Elter +# Copyright (c) 2004 Frans Englich +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program 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 General Public License for more details. +# +# 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, USA. +# + +AM_CPPFLAGS = -I$(top_srcdir)/kutils $(all_includes) +METASOURCES = AUTO + +lib_LTLIBRARIES = +bin_PROGRAMS = +kdeinit_LTLIBRARIES = kcmshell.la + +kcmshell_la_SOURCES = main.cpp main.skel +kcmshell_la_LIBADD = ../kutils/libkutils.la +kcmshell_la_LDFLAGS = $(all_libraries) -module -avoid-version + +noinst_HEADERS = main.h + +messages: rc.cpp + $(XGETTEXT) *.cpp -o $(podir)/kcmshell.pot + + +include $(top_srcdir)/admin/Doxyfile.am + diff --git a/kcmshell/main.cpp b/kcmshell/main.cpp new file mode 100644 index 000000000..e1b03d1e7 --- /dev/null +++ b/kcmshell/main.cpp @@ -0,0 +1,346 @@ +/* + Copyright (c) 1999 Matthias Hoelzer-Kluepfel + Copyright (c) 2000 Matthias Elter + Copyright (c) 2004 Frans Englich + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program 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 General Public License for more details. + + 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, USA. + +*/ + +#include + +#include +#include + +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "main.h" +#include "main.moc" + +using namespace std; + +KService::List m_modules; + +static KCmdLineOptions options[] = +{ + { "list", I18N_NOOP("List all possible modules"), 0}, + { "+module", I18N_NOOP("Configuration module to open"), 0 }, + { "lang ", I18N_NOOP("Specify a particular language"), 0 }, + { "embed ", I18N_NOOP("Embeds the module with buttons in window with id "), 0 }, + { "embed-proxy ", I18N_NOOP("Embeds the module without buttons in window with id "), 0 }, + { "silent", I18N_NOOP("Do not display main window"), 0 }, + KCmdLineLastOption +}; + +static void listModules(const QString &baseGroup) +{ + + KServiceGroup::Ptr group = KServiceGroup::group(baseGroup); + + if (!group || !group->isValid()) + return; + + KServiceGroup::List list = group->entries(true, true); + + for( KServiceGroup::List::ConstIterator it = list.begin(); + it != list.end(); it++) + { + KSycocaEntry *p = (*it); + if (p->isType(KST_KService)) + { + KService *s = static_cast(p); + if (!kapp->authorizeControlModule(s->menuId())) + continue; + m_modules.append(s); + } + else if (p->isType(KST_KServiceGroup)) + listModules(p->entryPath()); + } +} + +static KService::Ptr locateModule(const QCString& module) +{ + QString path = QFile::decodeName(module); + + if (!path.endsWith(".desktop")) + path += ".desktop"; + + KService::Ptr service = KService::serviceByStorageId( path ); + if (!service) + { + kdWarning(780) << "Could not find module '" << module << "'." << endl; + return 0; + } + + // avoid finding random non-kde applications + if ( module.left( 4 ) != "kde-" && service->library().isEmpty() ) + return locateModule( "kde-" + module ); + + if(!KCModuleLoader::testModule( module )) + { + kdDebug(780) << "According to \"" << module << "\"'s test function, it should Not be loaded." << endl; + return 0; + } + + return service; +} + +bool KCMShell::isRunning() +{ + if( dcopClient()->appId() == m_dcopName ) + return false; // We are the one and only. + + kdDebug(780) << "kcmshell with modules '" << + m_dcopName << "' is already running." << endl; + + dcopClient()->attach(); // Reregister as anonymous + dcopClient()->setNotifications(true); + + QByteArray data; + QDataStream str( data, IO_WriteOnly ); + str << kapp->startupId(); + QCString replyType; + QByteArray replyData; + if (!dcopClient()->call(m_dcopName, "dialog", "activate(QCString)", + data, replyType, replyData)) + { + kdDebug(780) << "Calling DCOP function dialog::activate() failed." << endl; + return false; // Error, we have to do it ourselves. + } + + return true; +} + +KCMShellMultiDialog::KCMShellMultiDialog( int dialogFace, const QString& caption, + QWidget *parent, const char *name, bool modal) + : KCMultiDialog( dialogFace, caption, parent, name, modal ), + DCOPObject("dialog") +{ +} + +void KCMShellMultiDialog::activate( QCString asn_id ) +{ + kdDebug(780) << k_funcinfo << endl; + + KStartupInfo::setNewStartupId( this, asn_id ); +} + +void KCMShell::setDCOPName(const QCString &dcopName, bool rootMode ) +{ + m_dcopName = "kcmshell_"; + if( rootMode ) + m_dcopName += "rootMode_"; + + m_dcopName += dcopName; + + dcopClient()->registerAs(m_dcopName, false); +} + +void KCMShell::waitForExit() +{ + kdDebug(780) << k_funcinfo << endl; + + connect(dcopClient(), SIGNAL(applicationRemoved(const QCString&)), + SLOT( appExit(const QCString&) )); + exec(); +} + +void KCMShell::appExit(const QCString &appId) +{ + kdDebug(780) << k_funcinfo << endl; + + if( appId == m_dcopName ) + { + kdDebug(780) << "'" << appId << "' closed, dereferencing." << endl; + deref(); + } +} + +static void setIcon(QWidget *w, const QString &iconName) +{ + QPixmap icon = DesktopIcon(iconName); + QPixmap miniIcon = SmallIcon(iconName); + w->setIcon( icon ); //standard X11 +#if defined Q_WS_X11 && ! defined K_WS_QTONLY + KWin::setIcons(w->winId(), icon, miniIcon ); +#endif +} + +extern "C" KDE_EXPORT int kdemain(int _argc, char *_argv[]) +{ + KAboutData aboutData( "kcmshell", I18N_NOOP("KDE Control Module"), + 0, + I18N_NOOP("A tool to start single KDE control modules"), + KAboutData::License_GPL, + I18N_NOOP("(c) 1999-2004, The KDE Developers") ); + + aboutData.addAuthor("Frans Englich", I18N_NOOP("Maintainer"), "frans.englich@kde.org"); + aboutData.addAuthor("Daniel Molkentin", 0, "molkentin@kde.org"); + aboutData.addAuthor("Matthias Hoelzer-Kluepfel",0, "hoelzer@kde.org"); + aboutData.addAuthor("Matthias Elter",0, "elter@kde.org"); + aboutData.addAuthor("Matthias Ettrich",0, "ettrich@kde.org"); + aboutData.addAuthor("Waldo Bastian",0, "bastian@kde.org"); + + KGlobal::locale()->setMainCatalogue("kcmshell"); + + KCmdLineArgs::init(_argc, _argv, &aboutData); + KCmdLineArgs::addCmdLineOptions( options ); // Add our own options. + KCMShell app; + + const KCmdLineArgs *args = KCmdLineArgs::parsedArgs(); + + const QCString lang = args->getOption("lang"); + if( !lang.isNull() ) + KGlobal::locale()->setLanguage(lang); + + if (args->isSet("list")) + { + cout << i18n("The following modules are available:").local8Bit() << endl; + + listModules( "Settings/" ); + + int maxLen=0; + + for( KService::List::ConstIterator it = m_modules.begin(); it != m_modules.end(); ++it) + { + int len = (*it)->desktopEntryName().length(); + if (len > maxLen) + maxLen = len; + } + + for( KService::List::ConstIterator it = m_modules.begin(); it != m_modules.end(); ++it) + { + QString entry("%1 - %2"); + + entry = entry.arg((*it)->desktopEntryName().leftJustify(maxLen, ' ')) + .arg(!(*it)->comment().isEmpty() ? (*it)->comment() + : i18n("No description available")); + + cout << entry.local8Bit() << endl; + } + return 0; + } + + if (args->count() < 1) + { + args->usage(); + return -1; + } + + QCString dcopName; + KService::List modules; + for (int i = 0; i < args->count(); i++) + { + KService::Ptr service = locateModule(args->arg(i)); + if( service ) + { + modules.append(service); + if( !dcopName.isEmpty() ) + dcopName += "_"; + + dcopName += args->arg(i); + } + } + + /* Check if this particular module combination is already running, but + * allow the same module to run when embedding(root mode) */ + app.setDCOPName(dcopName, + ( args->isSet( "embed-proxy" ) || args->isSet( "embed" ))); + if( app.isRunning() ) + { + app.waitForExit(); + return 0; + } + + KDialogBase::DialogType dtype = KDialogBase::Plain; + + if ( modules.count() < 1 ) + return 0; + else if( modules.count() > 1 ) + dtype = KDialogBase::IconList; + + bool idValid; + int id; + + if ( args->isSet( "embed-proxy" )) + { + id = args->getOption( "embed-proxy" ).toInt(&idValid); + if( idValid ) + { + KCModuleProxy *module = new KCModuleProxy( modules.first()->desktopEntryName() ); + module->realModule(); + QXEmbed::embedClientIntoWindow( module, id); + app.exec(); + delete module; + } + else + kdDebug(780) << "Supplied id '" << id << "' is not valid." << endl; + + return 0; + + } + + KCMShellMultiDialog *dlg = new KCMShellMultiDialog( dtype, + i18n("Configure - %1").arg(kapp->caption()), 0, "", true ); + + for (KService::List::ConstIterator it = modules.begin(); it != modules.end(); ++it) + dlg->addModule(KCModuleInfo(*it)); + + if ( args->isSet( "embed" )) + { + id = args->getOption( "embed" ).toInt(&idValid); + if( idValid ) + { + QXEmbed::embedClientIntoWindow( dlg, id ); + dlg->exec(); + delete dlg; + } + else + kdDebug(780) << "Supplied id '" << id << "' is not valid." << endl; + + } + else + { + + if (kapp->iconName() != kapp->name()) + setIcon(dlg, kapp->iconName()); + else if ( modules.count() == 1 ) + setIcon(dlg, KCModuleInfo( modules.first()).icon()); + + dlg->exec(); + delete dlg; + } + + return 0; +} +// vim: sw=4 et sts=4 diff --git a/kcmshell/main.h b/kcmshell/main.h new file mode 100644 index 000000000..6b4c944ee --- /dev/null +++ b/kcmshell/main.h @@ -0,0 +1,104 @@ +/* + Copyright (c) 2001 Waldo Bastian + Copyright (c) 2004 Frans Englich + + 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. + +*/ + +#ifndef __kcmshell_h__ +#define __kcmshell_h__ + +#include + +#include +#include + +/** + * The KApplication instance for kcmshell. + */ +class KCMShell : public KApplication +{ + Q_OBJECT + +public: + + /** + * Sets m_dcopName basically to @p dcopName, + * and then registers with DCOP. + * + * @param dcopName name to set the DCOP name to + * @param rootMode true if the kcmshell is embedding + */ + void setDCOPName(const QCString &dcopName, bool rootMode ); + + /** + * Waits until the last instance of kcmshell with the same + * module as this one exits, and then exits. + */ + void waitForExit(); + + /** + * @return true if the shell is running + */ + bool isRunning(); + +private slots: + + /** + */ + void appExit( const QCString &appId ); + +private: + + /** + * The DCOP name which actually is registered. + * For example "kcmshell_mouse". + */ + QCString m_dcopName; + +}; + + +/** + * Essentially a plain KCMultiDialog, but has the additional functionality + * of allowing it to be told to request windows focus. + * + * @author Waldo Bastian + */ +class KCMShellMultiDialog : public KCMultiDialog, public DCOPObject +{ + Q_OBJECT + K_DCOP + +public: + + /** + */ + KCMShellMultiDialog( int dialogFace, const QString& caption, + QWidget *parent=0, const char *name=0, bool modal=false); + +k_dcop: + + /** + */ + virtual void activate( QCString asn_id ); + +}; + + +// vim: sw=4 et sts=4 +#endif //__kcmshell_h__ -- cgit v1.2.3