kapplication.cpp

00001 /* This file is part of the KDE libraries
00002     Copyright (C) 1997 Matthias Kalle Dalheimer (kalle@kde.org)
00003     Copyright (C) 1998, 1999, 2000 KDE Team
00004 
00005     This library is free software; you can redistribute it and/or
00006     modify it under the terms of the GNU Library General Public
00007     License as published by the Free Software Foundation; either
00008     version 2 of the License, or (at your option) any later version.
00009 
00010     This library is distributed in the hope that it will be useful,
00011     but WITHOUT ANY WARRANTY; without even the implied warranty of
00012     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013     Library General Public License for more details.
00014 
00015     You should have received a copy of the GNU Library General Public License
00016     along with this library; see the file COPYING.LIB.  If not, write to
00017     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00018     Boston, MA 02110-1301, USA.
00019         */
00020 
00021 #include "config.h"
00022 
00023 #undef QT_NO_TRANSLATION
00024 #include <qtranslator.h>
00025 #define QT_NO_TRANSLATION
00026 #include <qdir.h>
00027 #include <qptrcollection.h>
00028 #include <qwidgetlist.h>
00029 #include <qstrlist.h>
00030 #include <qfile.h>
00031 #include <qmessagebox.h>
00032 #include <qtextstream.h>
00033 #include <qregexp.h>
00034 #include <qlineedit.h>
00035 #include <qtextedit.h>
00036 #include <qsessionmanager.h>
00037 #include <qptrlist.h>
00038 #include <qtimer.h>
00039 #include <qstylesheet.h>
00040 #include <qpixmapcache.h>
00041 #include <qtooltip.h>
00042 #include <qstylefactory.h>
00043 #include <qmetaobject.h>
00044 #ifndef QT_NO_SQL
00045 #include <qsqlpropertymap.h>
00046 #endif
00047 
00048 #undef QT_NO_TRANSLATION
00049 #include "kapplication.h"
00050 #define QT_NO_TRANSLATION
00051 #include <kglobal.h>
00052 #include <kstandarddirs.h>
00053 #include <kdebug.h>
00054 #include <klocale.h>
00055 #include <kstyle.h>
00056 #include <kiconloader.h>
00057 #include <kclipboard.h>
00058 #include <kconfig.h>
00059 #include <ksimpleconfig.h>
00060 #include <kcmdlineargs.h>
00061 #include <kaboutdata.h>
00062 #include <kglobalsettings.h>
00063 #include <kcrash.h>
00064 #include <kdatastream.h>
00065 #include <klibloader.h>
00066 #include <kmimesourcefactory.h>
00067 #include <kstdaccel.h>
00068 #include <kaccel.h>
00069 #include "kcheckaccelerators.h"
00070 #include <qptrdict.h>
00071 #include <kmacroexpander.h>
00072 #include <kshell.h>
00073 #include <kprotocolinfo.h>
00074 #include <kkeynative.h>
00075 #include <kmdcodec.h>
00076 #include <kglobalaccel.h>
00077 
00078 #if defined Q_WS_X11
00079 #include <kstartupinfo.h>
00080 #endif
00081 
00082 #include <dcopclient.h>
00083 #include <dcopref.h>
00084 
00085 #include <sys/types.h>
00086 #ifdef HAVE_SYS_STAT_H
00087 #include <sys/stat.h>
00088 #endif
00089 #include <sys/wait.h>
00090 
00091 #ifndef Q_WS_WIN
00092 #include "kwin.h"
00093 #endif
00094 
00095 #include <fcntl.h>
00096 #include <stdlib.h> // getenv(), srand(), rand()
00097 #include <signal.h>
00098 #include <unistd.h>
00099 #include <time.h>
00100 #include <sys/time.h>
00101 #include <errno.h>
00102 #include <string.h>
00103 #include <netdb.h>
00104 #if defined Q_WS_X11
00105 //#ifndef Q_WS_QWS //FIXME(E): NetWM should talk to QWS...
00106 #include <netwm.h>
00107 #endif
00108 
00109 #include "kprocctrl.h"
00110 
00111 #ifdef HAVE_PATHS_H
00112 #include <paths.h>
00113 #endif
00114 
00115 #ifdef Q_WS_X11
00116 #include <X11/Xlib.h>
00117 #include <X11/Xutil.h>
00118 #include <X11/Xatom.h>
00119 #include <X11/SM/SMlib.h>
00120 #include <fixx11h.h>
00121 #endif
00122 
00123 #ifndef Q_WS_WIN
00124 #include <KDE-ICE/ICElib.h>
00125 #else
00126 typedef void* IceIOErrorHandler;
00127 #include <windows.h>
00128 //KDE4: remove
00129 #define Button1Mask (1<<8)
00130 #define Button2Mask (1<<9)
00131 #define Button3Mask (1<<10)
00132 #endif
00133 
00134 #ifdef Q_WS_X11
00135 #define DISPLAY "DISPLAY"
00136 #elif defined(Q_WS_QWS)
00137 #define DISPLAY "QWS_DISPLAY"
00138 #endif
00139 
00140 #if defined Q_WS_X11
00141 #include <kipc.h>
00142 #endif
00143 
00144 #ifdef Q_WS_MACX
00145 #include <Carbon/Carbon.h>
00146 #include <qimage.h>
00147 #endif
00148 
00149 #include "kappdcopiface.h"
00150 
00151 // exported for kdm kfrontend
00152 KDE_EXPORT bool kde_have_kipc = true; // magic hook to disable kipc in kdm
00153 bool kde_kiosk_exception = false; // flag to disable kiosk restrictions
00154 bool kde_kiosk_admin = false;
00155 
00156 KApplication* KApplication::KApp = 0L;
00157 bool KApplication::loadedByKdeinit = false;
00158 DCOPClient *KApplication::s_DCOPClient = 0L;
00159 bool KApplication::s_dcopClientNeedsPostInit = false;
00160 
00161 #ifdef Q_WS_X11
00162 static Atom atom_DesktopWindow;
00163 static Atom atom_NetSupported;
00164 extern Time qt_x_time;
00165 extern Time qt_x_user_time;
00166 static Atom kde_xdnd_drop;
00167 #endif
00168 
00169 // duplicated from patched Qt, so that there won't be unresolved symbols if Qt gets
00170 // replaced by unpatched one
00171 KDECORE_EXPORT bool qt_qclipboard_bailout_hack = false;
00172 
00173 template class QPtrList<KSessionManaged>;
00174 
00175 #ifdef Q_WS_X11
00176 extern "C" {
00177 static int kde_xio_errhandler( Display * dpy )
00178 {
00179   return kapp->xioErrhandler( dpy );
00180 }
00181 
00182 static int kde_x_errhandler( Display *dpy, XErrorEvent *err )
00183 {
00184   return kapp->xErrhandler( dpy, err );
00185 }
00186 
00187 }
00188 
00189 extern "C" {
00190 static void kde_ice_ioerrorhandler( IceConn conn )
00191 {
00192     if(kapp)
00193         kapp->iceIOErrorHandler( conn );
00194     // else ignore the error for now
00195 }
00196 }
00197 #endif
00198 
00199 #ifdef Q_WS_WIN
00200 void KApplication_init_windows(bool GUIenabled);
00201 
00202 class QAssistantClient;
00203 #endif
00204 
00205 /*
00206   Private data to make keeping binary compatibility easier
00207  */
00208 class KApplicationPrivate
00209 {
00210 public:
00211   KApplicationPrivate()
00212     :   actionRestrictions( false ),
00213     refCount( 1 ),
00214     oldIceIOErrorHandler( 0 ),
00215     checkAccelerators( 0 ),
00216     overrideStyle( QString::null ),
00217     startup_id( "0" ),
00218     app_started_timer( NULL ),
00219     m_KAppDCOPInterface( 0L ),
00220     session_save( false )
00221 #ifdef Q_WS_X11
00222     ,oldXErrorHandler( NULL )
00223     ,oldXIOErrorHandler( NULL )
00224 #elif defined Q_WS_WIN
00225     ,qassistantclient( 0 )
00226 #endif
00227   {
00228   }
00229 
00230   ~KApplicationPrivate()
00231   {
00232 #ifdef Q_WS_WIN
00233      delete qassistantclient;
00234 #endif
00235   }
00236 
00237 
00238   bool actionRestrictions : 1;
00239   bool guiEnabled : 1;
00246   int refCount;
00247   IceIOErrorHandler oldIceIOErrorHandler;
00248   KCheckAccelerators* checkAccelerators;
00249   QString overrideStyle;
00250   QString geometry_arg;
00251   QCString startup_id;
00252   QTimer* app_started_timer;
00253   KAppDCOPInterface *m_KAppDCOPInterface;
00254   bool session_save;
00255 #ifdef Q_WS_X11
00256   int (*oldXErrorHandler)(Display*,XErrorEvent*);
00257   int (*oldXIOErrorHandler)(Display*);
00258 #elif defined Q_WS_WIN
00259   QAssistantClient* qassistantclient;
00260 #endif
00261 
00262   class URLActionRule
00263   {
00264   public:
00265 #define checkExactMatch(s, b) \
00266         if (s.isEmpty()) b = true; \
00267         else if (s[s.length()-1] == '!') \
00268         { b = false; s.truncate(s.length()-1); } \
00269         else b = true;
00270 #define checkStartWildCard(s, b) \
00271         if (s.isEmpty()) b = true; \
00272         else if (s[0] == '*') \
00273         { b = true; s = s.mid(1); } \
00274         else b = false;
00275 #define checkEqual(s, b) \
00276         b = (s == "=");
00277 
00278      URLActionRule(const QString &act,
00279                    const QString &bProt, const QString &bHost, const QString &bPath,
00280                    const QString &dProt, const QString &dHost, const QString &dPath,
00281                    bool perm)
00282                    : action(act),
00283                      baseProt(bProt), baseHost(bHost), basePath(bPath),
00284                      destProt(dProt), destHost(dHost), destPath(dPath),
00285                      permission(perm)
00286                    {
00287                       checkExactMatch(baseProt, baseProtWildCard);
00288                       checkStartWildCard(baseHost, baseHostWildCard);
00289                       checkExactMatch(basePath, basePathWildCard);
00290                       checkExactMatch(destProt, destProtWildCard);
00291                       checkStartWildCard(destHost, destHostWildCard);
00292                       checkExactMatch(destPath, destPathWildCard);
00293                       checkEqual(destProt, destProtEqual);
00294                       checkEqual(destHost, destHostEqual);
00295                    }
00296 
00297      bool baseMatch(const KURL &url, const QString &protClass)
00298      {
00299         if (baseProtWildCard)
00300         {
00301            if ( !baseProt.isEmpty() && !url.protocol().startsWith(baseProt) &&
00302                 (protClass.isEmpty() || (protClass != baseProt)) )
00303               return false;
00304         }
00305         else
00306         {
00307            if ( (url.protocol() != baseProt) &&
00308                 (protClass.isEmpty() || (protClass != baseProt)) )
00309               return false;
00310         }
00311         if (baseHostWildCard)
00312         {
00313            if (!baseHost.isEmpty() && !url.host().endsWith(baseHost))
00314               return false;
00315         }
00316         else
00317         {
00318            if (url.host() != baseHost)
00319               return false;
00320         }
00321         if (basePathWildCard)
00322         {
00323            if (!basePath.isEmpty() && !url.path().startsWith(basePath))
00324               return false;
00325         }
00326         else
00327         {
00328            if (url.path() != basePath)
00329               return false;
00330         }
00331         return true;
00332      }
00333 
00334      bool destMatch(const KURL &url, const QString &protClass, const KURL &base, const QString &baseClass)
00335      {
00336         if (destProtEqual)
00337         {
00338            if ( (url.protocol() != base.protocol()) &&
00339                 (protClass.isEmpty() || baseClass.isEmpty() || protClass != baseClass) )
00340               return false;
00341         }
00342         else if (destProtWildCard)
00343         {
00344            if ( !destProt.isEmpty() && !url.protocol().startsWith(destProt) &&
00345                 (protClass.isEmpty() || (protClass != destProt)) )
00346               return false;
00347         }
00348         else
00349         {
00350            if ( (url.protocol() != destProt) &&
00351                 (protClass.isEmpty() || (protClass != destProt)) )
00352               return false;
00353         }
00354         if (destHostWildCard)
00355         {
00356            if (!destHost.isEmpty() && !url.host().endsWith(destHost))
00357               return false;
00358         }
00359         else if (destHostEqual)
00360         {
00361            if (url.host() != base.host())
00362               return false;
00363         }
00364         else
00365         {
00366            if (url.host() != destHost)
00367               return false;
00368         }
00369         if (destPathWildCard)
00370         {
00371            if (!destPath.isEmpty() && !url.path().startsWith(destPath))
00372               return false;
00373         }
00374         else
00375         {
00376            if (url.path() != destPath)
00377               return false;
00378         }
00379         return true;
00380      }
00381 
00382      QString action;
00383      QString baseProt;
00384      QString baseHost;
00385      QString basePath;
00386      QString destProt;
00387      QString destHost;
00388      QString destPath;
00389      bool baseProtWildCard : 1;
00390      bool baseHostWildCard : 1;
00391      bool basePathWildCard : 1;
00392      bool destProtWildCard : 1;
00393      bool destHostWildCard : 1;
00394      bool destPathWildCard : 1;
00395      bool destProtEqual    : 1;
00396      bool destHostEqual    : 1;
00397      bool permission;
00398   };
00399   QPtrList<URLActionRule> urlActionRestrictions;
00400 
00401     QString sessionKey;
00402     QString pSessionConfigFile;
00403 };
00404 
00405 
00406 static QPtrList<QWidget>*x11Filter = 0;
00407 static bool autoDcopRegistration = true;
00408 
00409 void KApplication::installX11EventFilter( QWidget* filter )
00410 {
00411     if ( !filter )
00412         return;
00413     if (!x11Filter)
00414         x11Filter = new QPtrList<QWidget>;
00415     connect ( filter, SIGNAL( destroyed() ), this, SLOT( x11FilterDestroyed() ) );
00416     x11Filter->append( filter );
00417 }
00418 
00419 void KApplication::x11FilterDestroyed()
00420 {
00421     removeX11EventFilter( static_cast< const QWidget* >( sender()));
00422 }
00423 
00424 void KApplication::removeX11EventFilter( const QWidget* filter )
00425 {
00426     if ( !x11Filter || !filter )
00427         return;
00428     x11Filter->removeRef( filter );
00429     if ( x11Filter->isEmpty() ) {
00430         delete x11Filter;
00431         x11Filter = 0;
00432     }
00433 }
00434 
00435 // FIXME: remove this when we've get a better method of
00436 // customizing accelerator handling -- hopefully in Qt.
00437 // For now, this is set whenever an accelerator is overridden
00438 // in KAccelEventHandler so that the AccelOverride isn't sent twice. -- ellis, 19/10/02
00439 extern bool kde_g_bKillAccelOverride;
00440 
00441 bool KApplication::notify(QObject *receiver, QEvent *event)
00442 {
00443     QEvent::Type t = event->type();
00444     if (kde_g_bKillAccelOverride)
00445     {
00446        kde_g_bKillAccelOverride = false;
00447        // Indicate that the accelerator has been overridden.
00448        if (t == QEvent::AccelOverride)
00449        {
00450           static_cast<QKeyEvent *>(event)->accept();
00451           return true;
00452        }
00453        else
00454           kdWarning(125) << "kde_g_bKillAccelOverride set, but received an event other than AccelOverride." << endl;
00455     }
00456 
00457     if ((t == QEvent::AccelOverride) || (t == QEvent::KeyPress))
00458     {
00459        static const KShortcut& _selectAll = KStdAccel::selectAll();
00460        QLineEdit *edit = ::qt_cast<QLineEdit *>(receiver);
00461        if (edit)
00462        {
00463           // We have a keypress for a lineedit...
00464           QKeyEvent *kevent = static_cast<QKeyEvent *>(event);
00465           KKey key(kevent);
00466           if (_selectAll.contains(key))
00467           {
00468              if (t == QEvent::KeyPress)
00469              {
00470                 edit->selectAll();
00471                 return true;
00472              }
00473              else
00474              {
00475                 kevent->accept();
00476              }
00477           }
00478           // Ctrl-U deletes from start of line.
00479           if (key == KKey(Qt::CTRL + Qt::Key_U))
00480           {
00481              if (t == QEvent::KeyPress)
00482              {
00483                 if (!edit->isReadOnly())
00484                 {
00485                    QString t(edit->text());
00486                    t = t.mid(edit->cursorPosition());
00487                    edit->validateAndSet(t, 0, 0, 0);
00488                 }
00489                 return true;
00490              }
00491              else
00492              {
00493                 kevent->accept();
00494              }
00495 
00496           }
00497        }
00498        QTextEdit *medit = ::qt_cast<QTextEdit *>(receiver);
00499        if (medit)
00500        {
00501           // We have a keypress for a multilineedit...
00502           QKeyEvent *kevent = static_cast<QKeyEvent *>(event);
00503           if (_selectAll.contains(KKey(kevent)))
00504           {
00505              if (t == QEvent::KeyPress)
00506              {
00507                 medit->selectAll();
00508                 return true;
00509              }
00510              else
00511              {
00512                 kevent->accept();
00513              }
00514           }
00515        }
00516     }
00517     if( t == QEvent::Show && receiver->isWidgetType())
00518     {
00519         QWidget* w = static_cast< QWidget* >( receiver );
00520 #if defined Q_WS_X11
00521         if( w->isTopLevel() && !startupId().isEmpty()) // TODO better done using window group leader?
00522             KStartupInfo::setWindowStartupId( w->winId(), startupId());
00523 #endif
00524         if( w->isTopLevel() && !w->testWFlags( WX11BypassWM ) && !w->isPopup() && !event->spontaneous())
00525         {
00526             if( d->app_started_timer == NULL )
00527             {
00528                 d->app_started_timer = new QTimer( this );
00529                 connect( d->app_started_timer, SIGNAL( timeout()), SLOT( checkAppStartedSlot()));
00530             }
00531             if( !d->app_started_timer->isActive())
00532                 d->app_started_timer->start( 0, true );
00533         }
00534         if( w->isTopLevel() && ( w->icon() == NULL || w->icon()->isNull()))
00535         {
00536             // icon() cannot be null pixmap, it'll be the "unknown" icon - so check if there is this application icon
00537             static QPixmap* ic = NULL;
00538             if( ic == NULL )
00539                 ic = new QPixmap( KGlobal::iconLoader()->loadIcon( iconName(),
00540                     KIcon::NoGroup, 0, KIcon::DefaultState, NULL, true ));
00541             if( !ic->isNull())
00542             {
00543                 w->setIcon( *ic );
00544 #if defined Q_WS_X11
00545                 KWin::setIcons( w->winId(), *ic, miniIcon());
00546 #endif
00547             }
00548         }
00549     }
00550     return QApplication::notify(receiver, event);
00551 }
00552 
00553 void KApplication::checkAppStartedSlot()
00554 {
00555 #if defined Q_WS_X11
00556     KStartupInfo::handleAutoAppStartedSending();
00557 #endif
00558 }
00559 
00560 // the help class for session management communication
00561 static QPtrList<KSessionManaged>* sessionClients()
00562 {
00563     static QPtrList<KSessionManaged>* session_clients = 0L;
00564     if ( !session_clients )
00565         session_clients = new QPtrList<KSessionManaged>;
00566     return session_clients;
00567 }
00568 
00569 /*
00570   Auxiliary function to calculate a a session config name used for the
00571   instance specific config object.
00572   Syntax:  "session/<appname>_<sessionId>"
00573  */
00574 QString KApplication::sessionConfigName() const
00575 {
00576     QString sessKey = sessionKey();
00577     if ( sessKey.isEmpty() && !d->sessionKey.isEmpty() )
00578         sessKey = d->sessionKey;
00579     return QString("session/%1_%2_%3").arg(name()).arg(sessionId()).arg(sessKey);
00580 }
00581 
00582 #ifdef Q_WS_X11
00583 static SmcConn mySmcConnection = 0;
00584 static SmcConn tmpSmcConnection = 0;
00585 #else
00586 // FIXME(E): Implement for Qt Embedded
00587 // Possibly "steal" XFree86's libSM?
00588 #endif
00589 static QTime* smModificationTime = 0;
00590 
00591 KApplication::KApplication( int& argc, char** argv, const QCString& rAppName,
00592                             bool allowStyles, bool GUIenabled ) :
00593   QApplication( argc, argv, GUIenabled ), KInstance(rAppName),
00594 #ifdef Q_WS_X11
00595   display(0L),
00596 #endif
00597   d (new KApplicationPrivate())
00598 {
00599     aIconPixmap.pm.icon = 0L;
00600     aIconPixmap.pm.miniIcon = 0L;
00601     read_app_startup_id();
00602     if (!GUIenabled)
00603        allowStyles = false;
00604     useStyles = allowStyles;
00605     Q_ASSERT (!rAppName.isEmpty());
00606     setName(rAppName);
00607 
00608     installSigpipeHandler();
00609     KCmdLineArgs::initIgnore(argc, argv, rAppName.data());
00610     parseCommandLine( );
00611     init(GUIenabled);
00612     d->m_KAppDCOPInterface = new KAppDCOPInterface(this);
00613 }
00614 
00615 KApplication::KApplication( bool allowStyles, bool GUIenabled ) :
00616   QApplication( *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
00617                 GUIenabled ),
00618   KInstance( KCmdLineArgs::about),
00619 #ifdef Q_WS_X11
00620   display(0L),
00621 #endif
00622   d (new KApplicationPrivate)
00623 {
00624     aIconPixmap.pm.icon = 0L;
00625     aIconPixmap.pm.miniIcon = 0L;
00626     read_app_startup_id();
00627     if (!GUIenabled)
00628        allowStyles = false;
00629     useStyles = allowStyles;
00630     setName( instanceName() );
00631 
00632     installSigpipeHandler();
00633     parseCommandLine( );
00634     init(GUIenabled);
00635     d->m_KAppDCOPInterface = new KAppDCOPInterface(this);
00636 }
00637 
00638 #ifdef Q_WS_X11
00639 KApplication::KApplication( Display *dpy, Qt::HANDLE visual, Qt::HANDLE colormap,
00640                     bool allowStyles ) :
00641   QApplication( dpy, *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
00642                 visual, colormap ),
00643   KInstance( KCmdLineArgs::about), display(0L), d (new KApplicationPrivate)
00644 {
00645     aIconPixmap.pm.icon = 0L;
00646     aIconPixmap.pm.miniIcon = 0L;
00647     read_app_startup_id();
00648     useStyles = allowStyles;
00649     setName( instanceName() );
00650     installSigpipeHandler();
00651     parseCommandLine( );
00652     init( true );
00653     d->m_KAppDCOPInterface = new KAppDCOPInterface(this);
00654 }
00655 
00656 KApplication::KApplication( Display *dpy, Qt::HANDLE visual, Qt::HANDLE colormap,
00657                     bool allowStyles, KInstance * _instance ) :
00658   QApplication( dpy, *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
00659                 visual, colormap ),
00660   KInstance( _instance ), display(0L), d (new KApplicationPrivate)
00661 {
00662     aIconPixmap.pm.icon = 0L;
00663     aIconPixmap.pm.miniIcon = 0L;
00664     read_app_startup_id();
00665     useStyles = allowStyles;
00666     setName( instanceName() );
00667     installSigpipeHandler();
00668     parseCommandLine( );
00669     init( true );
00670     d->m_KAppDCOPInterface = new KAppDCOPInterface(this);
00671 }
00672 #endif
00673 
00674 KApplication::KApplication( bool allowStyles, bool GUIenabled, KInstance* _instance ) :
00675   QApplication( *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
00676                 GUIenabled ),
00677   KInstance( _instance ),
00678 #ifdef Q_WS_X11
00679   display(0L),
00680 #endif
00681   d (new KApplicationPrivate)
00682 {
00683     aIconPixmap.pm.icon = 0L;
00684     aIconPixmap.pm.miniIcon = 0L;
00685     read_app_startup_id();
00686     if (!GUIenabled)
00687        allowStyles = false;
00688     useStyles = allowStyles;
00689     setName( instanceName() );
00690 
00691     installSigpipeHandler();
00692     parseCommandLine( );
00693     init(GUIenabled);
00694     d->m_KAppDCOPInterface = new KAppDCOPInterface(this);
00695 }
00696 
00697 #ifdef Q_WS_X11
00698 KApplication::KApplication(Display *display, int& argc, char** argv, const QCString& rAppName,
00699                            bool allowStyles, bool GUIenabled ) :
00700   QApplication( display ), KInstance(rAppName),
00701   display(0L),
00702   d (new KApplicationPrivate())
00703 {
00704     aIconPixmap.pm.icon = 0L;
00705     aIconPixmap.pm.miniIcon = 0L;
00706     read_app_startup_id();
00707     if (!GUIenabled)
00708        allowStyles = false;
00709     useStyles = allowStyles;
00710 
00711     Q_ASSERT (!rAppName.isEmpty());
00712     setName(rAppName);
00713 
00714     installSigpipeHandler();
00715     KCmdLineArgs::initIgnore(argc, argv, rAppName.data());
00716     parseCommandLine( );
00717     init(GUIenabled);
00718     d->m_KAppDCOPInterface = new KAppDCOPInterface(this);
00719 }
00720 #endif
00721 
00722 int KApplication::xioErrhandler( Display* dpy )
00723 {
00724     if(kapp)
00725     {
00726         emit shutDown();
00727 #ifdef Q_WS_X11
00728         d->oldXIOErrorHandler( dpy );
00729 #else
00730         Q_UNUSED(dpy);
00731 #endif
00732     }
00733     exit( 1 );
00734     return 0;
00735 }
00736 
00737 int KApplication::xErrhandler( Display* dpy, void* err_ )
00738 { // no idea how to make forward decl. for XErrorEvent
00739 #ifdef Q_WS_X11
00740     XErrorEvent* err = static_cast< XErrorEvent* >( err_ );
00741     if(kapp)
00742     {
00743         // add KDE specific stuff here
00744         d->oldXErrorHandler( dpy, err );
00745     }
00746 #endif
00747     return 0;
00748 }
00749 
00750 void KApplication::iceIOErrorHandler( _IceConn *conn )
00751 {
00752     emit shutDown();
00753 
00754 #ifdef Q_WS_X11
00755     if ( d->oldIceIOErrorHandler != NULL )
00756       (*d->oldIceIOErrorHandler)( conn );
00757 #endif
00758     exit( 1 );
00759 }
00760 
00761 class KDETranslator : public QTranslator
00762 {
00763 public:
00764   KDETranslator(QObject *parent) : QTranslator(parent, "kdetranslator") {}
00765   virtual QTranslatorMessage findMessage(const char* context,
00766                      const char *sourceText,
00767                      const char* message) const
00768   {
00769     QTranslatorMessage res;
00770     res.setTranslation(KGlobal::locale()->translateQt(context, sourceText, message));
00771     return res;
00772   }
00773 };
00774 
00775 void KApplication::init(bool GUIenabled)
00776 {
00777   d->guiEnabled = GUIenabled;
00778   if ((getuid() != geteuid()) ||
00779       (getgid() != getegid()))
00780   {
00781      fprintf(stderr, "The KDE libraries are not designed to run with suid privileges.\n");
00782      ::exit(127);
00783   }
00784 
00785   KProcessController::ref();
00786 
00787   (void) KClipboardSynchronizer::self();
00788 
00789   QApplication::setDesktopSettingsAware( false );
00790 
00791   KApp = this;
00792 
00793 
00794 #ifdef Q_WS_X11 //FIXME(E)
00795   // create all required atoms in _one_ roundtrip to the X server
00796   if ( GUIenabled ) {
00797       const int max = 20;
00798       Atom* atoms[max];
00799       char* names[max];
00800       Atom atoms_return[max];
00801       int n = 0;
00802 
00803       atoms[n] = &kipcCommAtom;
00804       names[n++] = (char *) "KIPC_COMM_ATOM";
00805 
00806       atoms[n] = &atom_DesktopWindow;
00807       names[n++] = (char *) "KDE_DESKTOP_WINDOW";
00808 
00809       atoms[n] = &atom_NetSupported;
00810       names[n++] = (char *) "_NET_SUPPORTED";
00811 
00812       atoms[n] = &kde_xdnd_drop;
00813       names[n++] = (char *) "XdndDrop";
00814 
00815       XInternAtoms( qt_xdisplay(), names, n, false, atoms_return );
00816 
00817       for (int i = 0; i < n; i++ )
00818       *atoms[i] = atoms_return[i];
00819   }
00820 #endif
00821 
00822   dcopAutoRegistration();
00823   dcopClientPostInit();
00824 
00825   smw = 0;
00826 
00827   // Initial KIPC event mask.
00828 #if defined Q_WS_X11
00829   kipcEventMask = (1 << KIPC::StyleChanged) | (1 << KIPC::PaletteChanged) |
00830                   (1 << KIPC::FontChanged) | (1 << KIPC::BackgroundChanged) |
00831                   (1 << KIPC::ToolbarStyleChanged) | (1 << KIPC::SettingsChanged) |
00832                   (1 << KIPC::ClipboardConfigChanged) | (1 << KIPC::BlockShortcuts);
00833 #endif
00834 
00835   // Trigger creation of locale.
00836   (void) KGlobal::locale();
00837 
00838   KConfig* config = KGlobal::config();
00839   d->actionRestrictions = config->hasGroup("KDE Action Restrictions" ) && !kde_kiosk_exception;
00840   // For brain-dead configurations where the user's local config file is not writable.
00841   // * We use kdialog to warn the user, so we better not generate warnings from
00842   //   kdialog itself.
00843   // * Don't warn if we run with a read-only $HOME
00844   QCString readOnly = getenv("KDE_HOME_READONLY");
00845   if (readOnly.isEmpty() && (qstrcmp(name(), "kdialog") != 0))
00846   {
00847     KConfigGroupSaver saver(config, "KDE Action Restrictions");
00848     if (config->readBoolEntry("warn_unwritable_config",true))
00849        config->checkConfigFilesWritable(true);
00850   }
00851 
00852   if (GUIenabled)
00853   {
00854 #ifdef Q_WS_X11
00855     // this is important since we fork() to launch the help (Matthias)
00856     fcntl(ConnectionNumber(qt_xdisplay()), F_SETFD, FD_CLOEXEC);
00857     // set up the fancy (=robust and error ignoring ) KDE xio error handlers (Matthias)
00858     d->oldXErrorHandler = XSetErrorHandler( kde_x_errhandler );
00859     d->oldXIOErrorHandler = XSetIOErrorHandler( kde_xio_errhandler );
00860 #endif
00861 
00862     connect( this, SIGNAL( aboutToQuit() ), this, SIGNAL( shutDown() ) );
00863 
00864 #ifdef Q_WS_X11 //FIXME(E)
00865     display = desktop()->x11Display();
00866 #endif
00867 
00868     {
00869         QStringList plugins = KGlobal::dirs()->resourceDirs( "qtplugins" );
00870         QStringList::Iterator it = plugins.begin();
00871         while (it != plugins.end()) {
00872             addLibraryPath( *it );
00873             ++it;
00874         }
00875 
00876     }
00877     kdisplaySetStyle();
00878     kdisplaySetFont();
00879 //    kdisplaySetPalette(); done by kdisplaySetStyle
00880     propagateSettings(SETTINGS_QT);
00881 
00882     // Set default mime-source factory
00883     // XXX: This is a hack. Make our factory the default factory, but add the
00884     // previous default factory to the list of factories. Why? When the default
00885     // factory can't resolve something, it iterates in the list of factories.
00886     // But it QWhatsThis only uses the default factory. So if there was already
00887     // a default factory (which happens when using an image library using uic),
00888     // we prefer KDE's factory and so we put that old default factory in the
00889     // list and use KDE as the default. This may speed up things as well.
00890     QMimeSourceFactory* oldDefaultFactory = QMimeSourceFactory::takeDefaultFactory();
00891     QMimeSourceFactory::setDefaultFactory( mimeSourceFactory() );
00892     if ( oldDefaultFactory ) {
00893         QMimeSourceFactory::addFactory( oldDefaultFactory );
00894     }
00895 
00896     d->checkAccelerators = new KCheckAccelerators( this );
00897   }
00898 
00899 #ifdef Q_WS_MACX
00900   if (GUIenabled) {
00901       QPixmap pixmap = KGlobal::iconLoader()->loadIcon( KCmdLineArgs::appName(),
00902               KIcon::NoGroup, KIcon::SizeLarge, KIcon::DefaultState, 0L, false );
00903       if (!pixmap.isNull()) {
00904           QImage i = pixmap.convertToImage().convertDepth(32).smoothScale(40, 40);
00905           for(int y = 0; y < i.height(); y++) {
00906               uchar *l = i.scanLine(y);
00907               for(int x = 0; x < i.width(); x+=4)
00908                   *(l+x) = 255;
00909           }
00910           CGColorSpaceRef cs = CGColorSpaceCreateDeviceRGB();
00911           CGDataProviderRef dp = CGDataProviderCreateWithData(NULL,
00912                   i.bits(), i.numBytes(), NULL);
00913           CGImageRef ir = CGImageCreate(i.width(), i.height(), 8, 32, i.bytesPerLine(),
00914                   cs, kCGImageAlphaNoneSkipFirst, dp,
00915                   0, 0, kCGRenderingIntentDefault);
00916           //cleanup
00917           SetApplicationDockTileImage(ir);
00918           CGImageRelease(ir);
00919           CGColorSpaceRelease(cs);
00920           CGDataProviderRelease(dp);
00921       }
00922   }
00923 #endif
00924 
00925 
00926   // save and restore the RTL setting, as installTranslator calls qt_detectRTLLanguage,
00927   // which makes it impossible to use the -reverse cmdline switch with KDE apps
00928   bool rtl = reverseLayout();
00929   installTranslator(new KDETranslator(this));
00930   setReverseLayout( rtl );
00931   if (i18n( "_: Dear Translator! Translate this string to the string 'LTR' in "
00932      "left-to-right languages (as english) or to 'RTL' in right-to-left "
00933      "languages (such as Hebrew and Arabic) to get proper widget layout." ) == "RTL")
00934     setReverseLayout( !rtl );
00935 
00936   // install appdata resource type
00937   KGlobal::dirs()->addResourceType("appdata", KStandardDirs::kde_default("data")
00938                                    + QString::fromLatin1(name()) + '/');
00939   pSessionConfig = 0L;
00940   bSessionManagement = true;
00941 
00942 #ifdef Q_WS_X11
00943   // register a communication window for desktop changes (Matthias)
00944   if (GUIenabled && kde_have_kipc )
00945   {
00946     smw = new QWidget(0,0);
00947     long data = 1;
00948     XChangeProperty(qt_xdisplay(), smw->winId(),
00949             atom_DesktopWindow, atom_DesktopWindow,
00950             32, PropModeReplace, (unsigned char *)&data, 1);
00951   }
00952   d->oldIceIOErrorHandler = IceSetIOErrorHandler( kde_ice_ioerrorhandler );
00953 #elif defined(Q_WS_WIN)
00954   KApplication_init_windows(GUIenabled);
00955 #else
00956   // FIXME(E): Implement for Qt Embedded
00957 #endif
00958 }
00959 
00960 static int my_system (const char *command) {
00961    int pid, status;
00962 
00963    pid = fork();
00964    if (pid == -1)
00965       return -1;
00966    if (pid == 0) {
00967       const char* shell = "/bin/sh";
00968       execl(shell, shell, "-c", command, (void *)0);
00969       ::_exit(127);
00970    }
00971    do {
00972       if (waitpid(pid, &status, 0) == -1) {
00973          if (errno != EINTR)
00974             return -1;
00975        } else
00976             return status;
00977    } while(1);
00978 }
00979 
00980 
00981 DCOPClient *KApplication::dcopClient()
00982 {
00983   if (s_DCOPClient)
00984     return s_DCOPClient;
00985 
00986   s_DCOPClient = new DCOPClient();
00987   KCmdLineArgs *args = KCmdLineArgs::parsedArgs("kde");
00988   if (args && args->isSet("dcopserver"))
00989   {
00990     s_DCOPClient->setServerAddress( args->getOption("dcopserver"));
00991   }
00992   if( kapp ) {
00993     connect(s_DCOPClient, SIGNAL(attachFailed(const QString &)),
00994             kapp, SLOT(dcopFailure(const QString &)));
00995     connect(s_DCOPClient, SIGNAL(blockUserInput(bool) ),
00996             kapp, SLOT(dcopBlockUserInput(bool)) );
00997   }
00998   else
00999     s_dcopClientNeedsPostInit = true;
01000 
01001   DCOPClient::setMainClient( s_DCOPClient );
01002   return s_DCOPClient;
01003 }
01004 
01005 void KApplication::dcopClientPostInit()
01006 {
01007   if( s_dcopClientNeedsPostInit )
01008     {
01009     s_dcopClientNeedsPostInit = false;
01010     connect(s_DCOPClient, SIGNAL(blockUserInput(bool) ),
01011             SLOT(dcopBlockUserInput(bool)) );
01012     s_DCOPClient->bindToApp(); // Make sure we get events from the DCOPClient.
01013     }
01014 }
01015 
01016 void KApplication::dcopAutoRegistration()
01017 {
01018   if (autoDcopRegistration)
01019      {
01020      ( void ) dcopClient();
01021      if( dcopClient()->appId().isEmpty())
01022          dcopClient()->registerAs(name());
01023      }
01024 }
01025 
01026 void KApplication::disableAutoDcopRegistration()
01027 {
01028   autoDcopRegistration = false;
01029 }
01030 
01031 KConfig* KApplication::sessionConfig()
01032 {
01033     if (pSessionConfig)
01034         return pSessionConfig;
01035 
01036     // create an instance specific config object
01037     pSessionConfig = new KConfig( sessionConfigName(), false, false);
01038     return pSessionConfig;
01039 }
01040 
01041 void KApplication::ref()
01042 {
01043     d->refCount++;
01044     //kdDebug() << "KApplication::ref() : refCount = " << d->refCount << endl;
01045 }
01046 
01047 void KApplication::deref()
01048 {
01049     d->refCount--;
01050     //kdDebug() << "KApplication::deref() : refCount = " << d->refCount << endl;
01051     if ( d->refCount <= 0 )
01052         quit();
01053 }
01054 
01055 KSessionManaged::KSessionManaged()
01056 {
01057     sessionClients()->remove( this );
01058     sessionClients()->append( this );
01059 }
01060 
01061 KSessionManaged::~KSessionManaged()
01062 {
01063     sessionClients()->remove( this );
01064 }
01065 
01066 bool KSessionManaged::saveState(QSessionManager&)
01067 {
01068     return true;
01069 }
01070 
01071 bool KSessionManaged::commitData(QSessionManager&)
01072 {
01073     return true;
01074 }
01075 
01076 
01077 void KApplication::disableSessionManagement() {
01078   bSessionManagement = false;
01079 }
01080 
01081 void KApplication::enableSessionManagement() {
01082   bSessionManagement = true;
01083 #ifdef Q_WS_X11
01084   // Session management support in Qt/KDE is awfully broken.
01085   // If konqueror disables session management right after its startup,
01086   // and enables it later (preloading stuff), it won't be properly
01087   // saved on session shutdown.
01088   // I'm not actually sure why it doesn't work, but saveState()
01089   // doesn't seem to be called on session shutdown, possibly
01090   // because disabling session management after konqueror startup
01091   // disabled it somehow. Forcing saveState() here for this application
01092   // seems to fix it.
01093   if( mySmcConnection ) {
01094         SmcRequestSaveYourself( mySmcConnection, SmSaveLocal, False,
01095                 SmInteractStyleAny,
01096                 False, False );
01097 
01098     // flush the request
01099     IceFlush(SmcGetIceConnection(mySmcConnection));
01100   }
01101 #endif
01102 }
01103 
01104 
01105 bool KApplication::requestShutDown(
01106     ShutdownConfirm confirm, ShutdownType sdtype, ShutdownMode sdmode )
01107 {
01108 #ifdef Q_WS_X11
01109     QApplication::syncX();
01110     /*  use ksmserver's dcop interface if necessary  */
01111     if ( confirm == ShutdownConfirmYes ||
01112          sdtype != ShutdownTypeDefault ||
01113          sdmode != ShutdownModeDefault )
01114     {
01115         QByteArray data;
01116         QDataStream arg(data, IO_WriteOnly);
01117         arg << (int)confirm << (int)sdtype << (int)sdmode;
01118     return dcopClient()->send( "ksmserver", "ksmserver",
01119                                    "logout(int,int,int)", data );
01120     }
01121 
01122     if ( mySmcConnection ) {
01123         // we already have a connection to the session manager, use it.
01124         SmcRequestSaveYourself( mySmcConnection, SmSaveBoth, True,
01125                 SmInteractStyleAny,
01126                 confirm == ShutdownConfirmNo, True );
01127 
01128     // flush the request
01129     IceFlush(SmcGetIceConnection(mySmcConnection));
01130         return true;
01131     }
01132 
01133     // open a temporary connection, if possible
01134 
01135     propagateSessionManager();
01136     QCString smEnv = ::getenv("SESSION_MANAGER");
01137     if (smEnv.isEmpty())
01138         return false;
01139 
01140     if (! tmpSmcConnection) {
01141     char cerror[256];
01142     char* myId = 0;
01143     char* prevId = 0;
01144     SmcCallbacks cb;
01145     tmpSmcConnection = SmcOpenConnection( 0, 0, 1, 0,
01146                           0, &cb,
01147                           prevId,
01148                           &myId,
01149                           255,
01150                           cerror );
01151     ::free( myId ); // it was allocated by C
01152     if (!tmpSmcConnection )
01153         return false;
01154     }
01155 
01156     SmcRequestSaveYourself( tmpSmcConnection, SmSaveBoth, True,
01157                 SmInteractStyleAny, False, True );
01158 
01159     // flush the request
01160     IceFlush(SmcGetIceConnection(tmpSmcConnection));
01161     return true;
01162 #else
01163     // FIXME(E): Implement for Qt Embedded
01164     return false;
01165 #endif
01166 }
01167 
01168 void KApplication::propagateSessionManager()
01169 {
01170 #ifdef Q_WS_X11
01171     QCString fName = QFile::encodeName(locateLocal("socket", "KSMserver"));
01172     QCString display = ::getenv(DISPLAY);
01173     // strip the screen number from the display
01174     display.replace(QRegExp("\\.[0-9]+$"), "");
01175     int i;
01176     while( (i = display.find(':')) >= 0)
01177        display[i] = '_';
01178 
01179     fName += "_"+display;
01180     QCString smEnv = ::getenv("SESSION_MANAGER");
01181     bool check = smEnv.isEmpty();
01182     if ( !check && smModificationTime ) {
01183          QFileInfo info( fName );
01184          QTime current = info.lastModified().time();
01185          check = current > *smModificationTime;
01186     }
01187     if ( check ) {
01188         delete smModificationTime;
01189         QFile f( fName );
01190         if ( !f.open( IO_ReadOnly ) )
01191             return;
01192         QFileInfo info ( f );
01193         smModificationTime = new QTime( info.lastModified().time() );
01194         QTextStream t(&f);
01195         t.setEncoding( QTextStream::Latin1 );
01196         QString s = t.readLine();
01197         f.close();
01198         ::setenv( "SESSION_MANAGER", s.latin1(), true  );
01199     }
01200 #endif
01201 }
01202 
01203 void KApplication::commitData( QSessionManager& sm )
01204 {
01205     d->session_save = true;
01206     bool canceled = false;
01207     for (KSessionManaged* it = sessionClients()->first();
01208          it && !canceled;
01209          it = sessionClients()->next() ) {
01210         canceled = !it->commitData( sm );
01211     }
01212     if ( canceled )
01213         sm.cancel();
01214 
01215     if ( sm.allowsInteraction() ) {
01216         QWidgetList done;
01217         QWidgetList *list = QApplication::topLevelWidgets();
01218         bool canceled = false;
01219         QWidget* w = list->first();
01220         while ( !canceled && w ) {
01221             if ( !w->testWState( WState_ForceHide ) && !w->inherits("KMainWindow") ) {
01222                 QCloseEvent e;
01223                 sendEvent( w, &e );
01224                 canceled = !e.isAccepted();
01225                 if ( !canceled )
01226                     done.append( w );
01227                 delete list; // one never knows...
01228                 list = QApplication::topLevelWidgets();
01229                 w = list->first();
01230             } else {
01231                 w = list->next();
01232             }
01233             while ( w && done.containsRef( w ) )
01234                 w = list->next();
01235         }
01236         delete list;
01237     }
01238 
01239 
01240     if ( !bSessionManagement )
01241         sm.setRestartHint( QSessionManager::RestartNever );
01242     else
01243     sm.setRestartHint( QSessionManager::RestartIfRunning );
01244     d->session_save = false;
01245 }
01246 
01247 void KApplication::saveState( QSessionManager& sm )
01248 {
01249     d->session_save = true;
01250 #ifdef Q_WS_X11
01251     static bool firstTime = true;
01252     mySmcConnection = (SmcConn) sm.handle();
01253 
01254     if ( !bSessionManagement ) {
01255         sm.setRestartHint( QSessionManager::RestartNever );
01256     d->session_save = false;
01257         return;
01258     }
01259     else
01260     sm.setRestartHint( QSessionManager::RestartIfRunning );
01261 
01262     if ( firstTime ) {
01263         firstTime = false;
01264     d->session_save = false;
01265         return; // no need to save the state.
01266     }
01267 
01268     // remove former session config if still existing, we want a new
01269     // and fresh one. Note that we do not delete the config file here,
01270     // this is done by the session manager when it executes the
01271     // discard commands. In fact it would be harmful to remove the
01272     // file here, as the session might be stored under a different
01273     // name, meaning the user still might need it eventually.
01274     if ( pSessionConfig ) {
01275         delete pSessionConfig;
01276         pSessionConfig = 0;
01277     }
01278 
01279     // tell the session manager about our new lifecycle
01280     QStringList restartCommand = sm.restartCommand();
01281 
01282     QCString multiHead = getenv("KDE_MULTIHEAD");
01283     if (multiHead.lower() == "true") {
01284         // if multihead is enabled, we save our -display argument so that
01285         // we are restored onto the correct head... one problem with this
01286         // is that the display is hard coded, which means we cannot restore
01287         // to a different display (ie. if we are in a university lab and try,
01288         // try to restore a multihead session, our apps could be started on
01289         // someone else's display instead of our own)
01290         QCString displayname = getenv(DISPLAY);
01291         if (! displayname.isNull()) {
01292             // only store the command if we actually have a DISPLAY
01293             // environment variable
01294             restartCommand.append("-display");
01295             restartCommand.append(displayname);
01296         }
01297         sm.setRestartCommand( restartCommand );
01298     }
01299 
01300 
01301     // finally: do session management
01302     emit saveYourself(); // for compatibility
01303     bool canceled = false;
01304     for (KSessionManaged* it = sessionClients()->first();
01305          it && !canceled;
01306          it = sessionClients()->next() ) {
01307         canceled = !it->saveState( sm );
01308     }
01309 
01310     // if we created a new session config object, register a proper discard command
01311     if ( pSessionConfig ) {
01312         pSessionConfig->sync();
01313         QStringList discard;
01314         discard  << "rm" << locateLocal("config", sessionConfigName());
01315         sm.setDiscardCommand( discard );
01316     } else {
01317     sm.setDiscardCommand( "" );
01318     }
01319 
01320     if ( canceled )
01321         sm.cancel();
01322 #else
01323     // FIXME(E): Implement for Qt Embedded
01324 #endif
01325     d->session_save = false;
01326 }
01327 
01328 bool KApplication::sessionSaving() const
01329 {
01330     return d->session_save;
01331 }
01332 
01333 void KApplication::startKdeinit()
01334 {
01335 #ifndef Q_WS_WIN //TODO
01336   // Try to launch kdeinit.
01337   QString srv = KStandardDirs::findExe(QString::fromLatin1("kdeinit"));
01338   if (srv.isEmpty())
01339      srv = KStandardDirs::findExe(QString::fromLatin1("kdeinit"), KGlobal::dirs()->kfsstnd_defaultbindir());
01340   if (srv.isEmpty())
01341      return;
01342   if (kapp && (Tty != kapp->type()))
01343     setOverrideCursor( Qt::waitCursor );
01344   my_system(QFile::encodeName(srv)+" --suicide");
01345   if (kapp && (Tty != kapp->type()))
01346     restoreOverrideCursor();
01347 #endif
01348 }
01349 
01350 void KApplication::dcopFailure(const QString &msg)
01351 {
01352   static int failureCount = 0;
01353   failureCount++;
01354   if (failureCount == 1)
01355   {
01356      startKdeinit();
01357      return;
01358   }
01359   if (failureCount == 2)
01360   {
01361 #ifdef Q_WS_WIN
01362      KGlobal::config()->setGroup("General");
01363      if (KGlobal::config()->readBoolEntry("ignoreDCOPFailures", false))
01364          return;
01365 #endif
01366      QString msgStr(i18n("There was an error setting up inter-process "
01367                       "communications for KDE. The message returned "
01368                       "by the system was:\n\n"));
01369      msgStr += msg;
01370      msgStr += i18n("\n\nPlease check that the \"dcopserver\" program is running!");
01371 
01372      if (Tty != kapp->type())
01373      {
01374        QMessageBox::critical
01375          (
01376            kapp->mainWidget(),
01377            i18n("DCOP communications error (%1)").arg(kapp->caption()),
01378            msgStr,
01379            i18n("&OK")
01380          );
01381      }
01382      else
01383      {
01384        fprintf(stderr, "%s\n", msgStr.local8Bit().data());
01385      }
01386 
01387      return;
01388   }
01389 }
01390 
01391 static const KCmdLineOptions qt_options[] =
01392 {
01393   //FIXME: Check if other options are specific to Qt/X11
01394 #ifdef Q_WS_X11
01395    { "display <displayname>", I18N_NOOP("Use the X-server display 'displayname'"), 0},
01396 #else
01397    { "display <displayname>", I18N_NOOP("Use the QWS display 'displayname'"), 0},
01398 #endif
01399    { "session <sessionId>", I18N_NOOP("Restore the application for the given 'sessionId'"), 0},
01400    { "cmap", I18N_NOOP("Causes the application to install a private color\nmap on an 8-bit display"), 0},
01401    { "ncols <count>", I18N_NOOP("Limits the number of colors allocated in the color\ncube on an 8-bit display, if the application is\nusing the QApplication::ManyColor color\nspecification"), 0},
01402    { "nograb", I18N_NOOP("tells Qt to never grab the mouse or the keyboard"), 0},
01403    { "dograb", I18N_NOOP("running under a debugger can cause an implicit\n-nograb, use -dograb to override"), 0},
01404    { "sync", I18N_NOOP("switches to synchronous mode for debugging"), 0},
01405    { "fn", 0, 0},
01406    { "font <fontname>", I18N_NOOP("defines the application font"), 0},
01407    { "bg", 0, 0},
01408    { "background <color>", I18N_NOOP("sets the default background color and an\napplication palette (light and dark shades are\ncalculated)"), 0},
01409    { "fg", 0, 0},
01410    { "foreground <color>", I18N_NOOP("sets the default foreground color"), 0},
01411    { "btn", 0, 0},
01412    { "button <color>", I18N_NOOP("sets the default button color"), 0},
01413    { "name <name>", I18N_NOOP("sets the application name"), 0},
01414    { "title <title>", I18N_NOOP("sets the application title (caption)"), 0},
01415 #ifdef Q_WS_X11
01416    { "visual TrueColor", I18N_NOOP("forces the application to use a TrueColor visual on\nan 8-bit display"), 0},
01417    { "inputstyle <inputstyle>", I18N_NOOP("sets XIM (X Input Method) input style. Possible\nvalues are onthespot, overthespot, offthespot and\nroot"), 0 },
01418    { "im <XIM server>", I18N_NOOP("set XIM server"),0},
01419    { "noxim", I18N_NOOP("disable XIM"), 0 },
01420 #endif
01421 #ifdef Q_WS_QWS
01422    { "qws", I18N_NOOP("forces the application to run as QWS Server"), 0},
01423 #endif
01424    { "reverse", I18N_NOOP("mirrors the whole layout of widgets"), 0},
01425    KCmdLineLastOption
01426 };
01427 
01428 static const KCmdLineOptions kde_options[] =
01429 {
01430    { "caption <caption>",       I18N_NOOP("Use 'caption' as name in the titlebar"), 0},
01431    { "icon <icon>",             I18N_NOOP("Use 'icon' as the application icon"), 0},
01432    { "miniicon <icon>",         I18N_NOOP("Use 'icon' as the icon in the titlebar"), 0},
01433    { "config <filename>",       I18N_NOOP("Use alternative configuration file"), 0},
01434    { "dcopserver <server>",     I18N_NOOP("Use the DCOP Server specified by 'server'"), 0},
01435    { "nocrashhandler",          I18N_NOOP("Disable crash handler, to get core dumps"), 0},
01436    { "waitforwm",          I18N_NOOP("Waits for a WM_NET compatible windowmanager"), 0},
01437    { "style <style>", I18N_NOOP("sets the application GUI style"), 0},
01438    { "geometry <geometry>", I18N_NOOP("sets the client geometry of the main widget - see man X for the argument format"), 0},
01439    { "smkey <sessionKey>", 0, 0}, // this option is obsolete and exists only to allow smooth upgrades from sessions
01440                                   // saved under Qt 3.0.x -- Qt 3.1.x includes the session key now automatically in
01441                   // the session id (Simon)
01442    KCmdLineLastOption
01443 };
01444 
01445 void
01446 KApplication::addCmdLineOptions()
01447 {
01448    KCmdLineArgs::addCmdLineOptions(qt_options, "Qt", "qt");
01449    KCmdLineArgs::addCmdLineOptions(kde_options, "KDE", "kde");
01450 }
01451 
01452 void KApplication::parseCommandLine( )
01453 {
01454     KCmdLineArgs *args = KCmdLineArgs::parsedArgs("kde");
01455 
01456     if ( !args ) return;
01457 
01458     if (args->isSet("config"))
01459     {
01460         QString config = QString::fromLocal8Bit(args->getOption("config"));
01461         setConfigName(config);
01462     }
01463 
01464     if (args->isSet("style"))
01465     {
01466 
01467        QStringList styles = QStyleFactory::keys();
01468        QString reqStyle(args->getOption("style").lower());
01469 
01470        for (QStringList::ConstIterator it = styles.begin(); it != styles.end(); ++it)
01471            if ((*it).lower() == reqStyle)
01472            {
01473                d->overrideStyle = *it;
01474                break;
01475            }
01476 
01477        if (d->overrideStyle.isEmpty())
01478           fprintf(stderr, "%s", i18n("The style %1 was not found\n").arg(reqStyle).local8Bit().data());
01479     }
01480 
01481     if (args->isSet("caption"))
01482     {
01483        aCaption = QString::fromLocal8Bit(args->getOption("caption"));
01484     }
01485 
01486     if (args->isSet("miniicon"))
01487     {
01488        const char *tmp = args->getOption("miniicon");
01489        if (!aIconPixmap.pm.miniIcon) {
01490          aIconPixmap.pm.miniIcon = new QPixmap;
01491        }
01492        *aIconPixmap.pm.miniIcon = SmallIcon(tmp);
01493        aMiniIconName = tmp;
01494     }
01495 
01496     if (args->isSet("icon"))
01497     {
01498        const char *tmp = args->getOption("icon");
01499        if (!aIconPixmap.pm.icon) {
01500           aIconPixmap.pm.icon = new QPixmap;
01501        }
01502        *aIconPixmap.pm.icon = DesktopIcon( tmp );
01503        aIconName = tmp;
01504        if (!aIconPixmap.pm.miniIcon) {
01505          aIconPixmap.pm.miniIcon = new QPixmap;
01506        }
01507        if (aIconPixmap.pm.miniIcon->isNull())
01508        {
01509           *aIconPixmap.pm.miniIcon = SmallIcon( tmp );
01510           aMiniIconName = tmp;
01511        }
01512     }
01513 
01514     bool nocrashhandler = (getenv("KDE_DEBUG") != NULL);
01515     if (!nocrashhandler && args->isSet("crashhandler"))
01516     {
01517         // set default crash handler / set emergency save function to nothing
01518         KCrash::setCrashHandler(KCrash::defaultCrashHandler);
01519         KCrash::setEmergencySaveFunction(NULL);
01520 
01521         KCrash::setApplicationName(QString(args->appName()));
01522     }
01523 
01524 #ifdef Q_WS_X11
01525     if ( args->isSet( "waitforwm" ) ) {
01526         Atom type;
01527         (void) desktop(); // trigger desktop creation, we need PropertyNotify events for the root window
01528         int format;
01529         unsigned long length, after;
01530         unsigned char *data;
01531         while ( XGetWindowProperty( qt_xdisplay(), qt_xrootwin(), atom_NetSupported,
01532                     0, 1, false, AnyPropertyType, &type, &format,
01533                                     &length, &after, &data ) != Success || !length ) {
01534             if ( data )
01535                 XFree( data );
01536             XEvent event;
01537             XWindowEvent( qt_xdisplay(), qt_xrootwin(), PropertyChangeMask, &event );
01538         }
01539         if ( data )
01540             XFree( data );
01541     }
01542 #else
01543     // FIXME(E): Implement for Qt Embedded
01544 #endif
01545 
01546     if (args->isSet("geometry"))
01547     {
01548         d->geometry_arg = args->getOption("geometry");
01549     }
01550 
01551     if (args->isSet("smkey"))
01552     {
01553         d->sessionKey = args->getOption("smkey");
01554     }
01555 
01556 }
01557 
01558 QString KApplication::geometryArgument() const
01559 {
01560     return d->geometry_arg;
01561 }
01562 
01563 QPixmap KApplication::icon() const
01564 {
01565   if( !aIconPixmap.pm.icon) {
01566       aIconPixmap.pm.icon = new QPixmap;
01567   }
01568   if( aIconPixmap.pm.icon->isNull()) {
01569       *aIconPixmap.pm.icon = DesktopIcon( instanceName() );
01570   }
01571   return *aIconPixmap.pm.icon;
01572 }
01573 
01574 QString KApplication::iconName() const
01575 {
01576   return aIconName.isNull() ? (QString)instanceName() : aIconName;
01577 }
01578 
01579 QPixmap KApplication::miniIcon() const
01580 {
01581   if (!aIconPixmap.pm.miniIcon) {
01582       aIconPixmap.pm.miniIcon = new QPixmap;
01583   }
01584   if (aIconPixmap.pm.miniIcon->isNull()) {
01585       *aIconPixmap.pm.miniIcon = SmallIcon( instanceName() );
01586   }
01587   return *aIconPixmap.pm.miniIcon;
01588 }
01589 
01590 QString KApplication::miniIconName() const
01591 {
01592   return aMiniIconName.isNull() ? (QString)instanceName() : aMiniIconName;
01593 }
01594 
01595 extern void kDebugCleanup();
01596 
01597 KApplication::~KApplication()
01598 {
01599   delete aIconPixmap.pm.miniIcon;
01600   aIconPixmap.pm.miniIcon = 0L;
01601   delete aIconPixmap.pm.icon;
01602   aIconPixmap.pm.icon = 0L;
01603   delete d->m_KAppDCOPInterface;
01604 
01605   // First call the static deleters and then call KLibLoader::cleanup()
01606   // The static deleters may delete libraries for which they need KLibLoader.
01607   // KLibLoader will take care of the remaining ones.
01608   KGlobal::deleteStaticDeleters();
01609   KLibLoader::cleanUp();
01610 
01611   delete smw;
01612 
01613   // close down IPC
01614   delete s_DCOPClient;
01615   s_DCOPClient = 0L;
01616 
01617   KProcessController::deref();
01618 
01619 #ifdef Q_WS_X11
01620   if ( d->oldXErrorHandler != NULL )
01621       XSetErrorHandler( d->oldXErrorHandler );
01622   if ( d->oldXIOErrorHandler != NULL )
01623       XSetIOErrorHandler( d->oldXIOErrorHandler );
01624   if ( d->oldIceIOErrorHandler != NULL )
01625       IceSetIOErrorHandler( d->oldIceIOErrorHandler );
01626 #endif
01627 
01628   delete d;
01629   KApp = 0;
01630 
01631 #ifdef Q_WS_X11
01632   mySmcConnection = 0;
01633   delete smModificationTime;
01634   smModificationTime = 0;
01635 
01636   // close the temporary smc connection
01637   if (tmpSmcConnection) {
01638       SmcCloseConnection( tmpSmcConnection, 0, 0 );
01639       tmpSmcConnection = 0;
01640   }
01641 #else
01642   // FIXME(E): Implement for Qt Embedded
01643 #endif
01644 }
01645 
01646 
01647 #ifdef Q_WS_X11
01648 class KAppX11HackWidget: public QWidget
01649 {
01650 public:
01651     bool publicx11Event( XEvent * e) { return x11Event( e ); }
01652 };
01653 #endif
01654 
01655 
01656 
01657 static bool kapp_block_user_input = false;
01658 
01659 void KApplication::dcopBlockUserInput( bool b )
01660 {
01661     kapp_block_user_input = b;
01662 }
01663 
01664 #ifdef Q_WS_X11
01665 bool KApplication::x11EventFilter( XEvent *_event )
01666 {
01667     switch ( _event->type ) {
01668         case ClientMessage:
01669         {
01670 #if KDE_IS_VERSION( 3, 90, 90 )
01671 #warning This should be already in Qt, check.
01672 #endif
01673         // Workaround for focus stealing prevention not working when dragging e.g. text from KWrite
01674         // to KDesktop -> the dialog asking for filename doesn't get activated. This is because
01675         // Qt-3.2.x doesn't have concept of qt_x_user_time at all, and Qt-3.3.0b1 passes the timestamp
01676         // in the XdndDrop message in incorrect field (and doesn't update qt_x_user_time either).
01677         // Patch already sent, future Qt version should have this fixed.
01678             if( _event->xclient.message_type == kde_xdnd_drop )
01679                 { // if the message is XdndDrop
01680                 if( _event->xclient.data.l[ 1 ] == 1 << 24     // and it's broken the way it's in Qt-3.2.x
01681                     && _event->xclient.data.l[ 2 ] == 0
01682                     && _event->xclient.data.l[ 4 ] == 0
01683                     && _event->xclient.data.l[ 3 ] != 0 )
01684                     {
01685                     if( qt_x_user_time == 0
01686                         || NET::timestampCompare( _event->xclient.data.l[ 3 ], qt_x_user_time ) > 0 )
01687                         { // and the timestamp looks reasonable
01688                         qt_x_user_time = _event->xclient.data.l[ 3 ]; // update our qt_x_user_time from it
01689                         }
01690                     }
01691                 else // normal DND, only needed until Qt updates qt_x_user_time from XdndDrop
01692                     {
01693                     if( qt_x_user_time == 0
01694                         || NET::timestampCompare( _event->xclient.data.l[ 2 ], qt_x_user_time ) > 0 )
01695                         { // the timestamp looks reasonable
01696                         qt_x_user_time = _event->xclient.data.l[ 2 ]; // update our qt_x_user_time from it
01697                         }
01698                     }
01699                 }
01700         }
01701     default: break;
01702     }
01703 
01704     if ( kapp_block_user_input ) {
01705         switch ( _event->type  ) {
01706         case ButtonPress:
01707         case ButtonRelease:
01708         case XKeyPress:
01709         case XKeyRelease:
01710         case MotionNotify:
01711         case EnterNotify:
01712         case LeaveNotify:
01713             return true;
01714         default:
01715             break;
01716         }
01717     }
01718 
01719     if (x11Filter) {
01720         for (QWidget *w=x11Filter->first(); w; w=x11Filter->next()) {
01721             if (((KAppX11HackWidget*) w)->publicx11Event(_event))
01722                 return true;
01723         }
01724     }
01725 
01726     if ((_event->type == ClientMessage) &&
01727             (_event->xclient.message_type == kipcCommAtom))
01728     {
01729         XClientMessageEvent *cme = (XClientMessageEvent *) _event;
01730 
01731         int id = cme->data.l[0];
01732         int arg = cme->data.l[1];
01733         if ((id < 32) && (kipcEventMask & (1 << id)))
01734         {
01735             switch (id)
01736             {
01737             case KIPC::StyleChanged:
01738                 KGlobal::config()->reparseConfiguration();
01739                 kdisplaySetStyle();
01740                 break;
01741 
01742             case KIPC::ToolbarStyleChanged:
01743                 KGlobal::config()->reparseConfiguration();
01744                 if (useStyles)
01745                     emit toolbarAppearanceChanged(arg);
01746                 break;
01747 
01748             case KIPC::PaletteChanged:
01749                 KGlobal::config()->reparseConfiguration();
01750                 kdisplaySetPalette();
01751                 break;
01752 
01753             case KIPC::FontChanged:
01754                 KGlobal::config()->reparseConfiguration();
01755                 KGlobalSettings::rereadFontSettings();
01756                 kdisplaySetFont();
01757                 break;
01758 
01759             case KIPC::BackgroundChanged:
01760                 emit backgroundChanged(arg);
01761                 break;
01762 
01763             case KIPC::SettingsChanged:
01764                 KGlobal::config()->reparseConfiguration();
01765                 if (arg == SETTINGS_PATHS)
01766                     KGlobalSettings::rereadPathSettings();
01767                 else if (arg == SETTINGS_MOUSE)
01768                     KGlobalSettings::rereadMouseSettings();
01769                 propagateSettings((SettingsCategory)arg);
01770                 break;
01771 
01772             case KIPC::IconChanged:
01773                 QPixmapCache::clear();
01774                 KGlobal::config()->reparseConfiguration();
01775                 KGlobal::instance()->newIconLoader();
01776                 emit iconChanged(arg);
01777                 break;
01778 
01779             case KIPC::ClipboardConfigChanged:
01780                 KClipboardSynchronizer::newConfiguration(arg);
01781                 break;
01782                 
01783             case KIPC::BlockShortcuts:
01784                 KGlobalAccel::blockShortcuts(arg);
01785                 emit kipcMessage(id, arg); // some apps may do additional things
01786                 break;
01787             }
01788         }
01789         else if (id >= 32)
01790         {
01791             emit kipcMessage(id, arg);
01792         }
01793         return true;
01794     }
01795     return false;
01796 }
01797 #endif // Q_WS_X11
01798 
01799 void KApplication::updateUserTimestamp( unsigned long time )
01800 {
01801 #if defined Q_WS_X11
01802     if( time == 0 )
01803     { // get current X timestamp
01804         Window w = XCreateSimpleWindow( qt_xdisplay(), qt_xrootwin(), 0, 0, 1, 1, 0, 0, 0 );
01805         XSelectInput( qt_xdisplay(), w, PropertyChangeMask );
01806         unsigned char data[ 1 ];
01807         XChangeProperty( qt_xdisplay(), w, XA_ATOM, XA_ATOM, 8, PropModeAppend, data, 1 );
01808         XEvent ev;
01809         XWindowEvent( qt_xdisplay(), w, PropertyChangeMask, &ev );
01810         time = ev.xproperty.time;
01811         XDestroyWindow( qt_xdisplay(), w );
01812     }
01813     if( qt_x_user_time == 0
01814         || NET::timestampCompare( time, qt_x_user_time ) > 0 ) // check time > qt_x_user_time
01815         qt_x_user_time = time;
01816 #endif
01817 }
01818 
01819 unsigned long KApplication::userTimestamp() const
01820 {
01821 #if defined Q_WS_X11
01822     return qt_x_user_time;
01823 #else
01824     return 0;
01825 #endif
01826 }
01827 
01828 void KApplication::updateRemoteUserTimestamp( const QCString& dcopId, unsigned long time )
01829 {
01830 #if defined Q_WS_X11
01831     if( time == 0 )
01832         time = qt_x_user_time;
01833     DCOPRef( dcopId, "MainApplication-Interface" ).call( "updateUserTimestamp", time );
01834 #endif
01835 }
01836 
01837 void KApplication::invokeEditSlot( const char *slot )
01838 {
01839   QObject *object = focusWidget();
01840   if( !object )
01841     return;
01842 
01843   QMetaObject *meta = object->metaObject();
01844 
01845   int idx = meta->findSlot( slot + 1, true );
01846   if( idx < 0 )
01847     return;
01848 
01849   object->qt_invoke( idx, 0 );
01850 }
01851 
01852 void KApplication::addKipcEventMask(int id)
01853 {
01854     if (id >= 32)
01855     {
01856         kdDebug(101) << "Cannot use KIPC event mask for message IDs >= 32\n";
01857         return;
01858     }
01859     kipcEventMask |= (1 << id);
01860 }
01861 
01862 void KApplication::removeKipcEventMask(int id)
01863 {
01864     if (id >= 32)
01865     {
01866         kdDebug(101) << "Cannot use KIPC event mask for message IDs >= 32\n";
01867         return;
01868     }
01869     kipcEventMask &= ~(1 << id);
01870 }
01871 
01872 void KApplication::enableStyles()
01873 {
01874     if (!useStyles)
01875     {
01876         useStyles = true;
01877         applyGUIStyle();
01878     }
01879 }
01880 
01881 void KApplication::disableStyles()
01882 {
01883     useStyles = false;
01884 }
01885 
01886 void KApplication::applyGUIStyle()
01887 {
01888     if ( !useStyles ) return;
01889 
01890     KConfigGroup pConfig (KGlobal::config(), "General");
01891     QString defaultStyle = KStyle::defaultStyle();
01892     QString styleStr = pConfig.readEntry("widgetStyle", defaultStyle);
01893 
01894     if (d->overrideStyle.isEmpty()) {
01895       // ### add check whether we already use the correct style to return then
01896       // (workaround for Qt misbehavior to avoid double style initialization)
01897 
01898       QStyle* sp = QStyleFactory::create( styleStr );
01899 
01900       // If there is no default style available, try falling back any available style
01901       if ( !sp && styleStr != defaultStyle)
01902           sp = QStyleFactory::create( defaultStyle );
01903       if ( !sp )
01904           sp = QStyleFactory::create( *(QStyleFactory::keys().begin()) );
01905       setStyle(sp);
01906     }
01907     else
01908         setStyle(d->overrideStyle);
01909     // Reread palette from config file.
01910     kdisplaySetPalette();
01911 }
01912 
01913 QString KApplication::caption() const
01914 {
01915   // Caption set from command line ?
01916   if( !aCaption.isNull() )
01917         return aCaption;
01918   else
01919       // We have some about data ?
01920       if ( KGlobal::instance()->aboutData() )
01921         return KGlobal::instance()->aboutData()->programName();
01922       else
01923         // Last resort : application name
01924         return name();
01925 }
01926 
01927 
01928 //
01929 // 1999-09-20: Espen Sand
01930 // An attempt to simplify consistent captions.
01931 //
01932 QString KApplication::makeStdCaption( const QString &userCaption,
01933                                       bool withAppName, bool modified ) const
01934 {
01935   QString s = userCaption.isEmpty() ? caption() : userCaption;
01936 
01937   // If the document is modified, add '[modified]'.
01938   if (modified)
01939       s += QString::fromUtf8(" [") + i18n("modified") + QString::fromUtf8("]");
01940 
01941   if ( !userCaption.isEmpty() ) {
01942       // Add the application name if:
01943       // User asked for it, it's not a duplication  and the app name (caption()) is not empty
01944       if ( withAppName && !caption().isNull() && !userCaption.endsWith(caption())  )
01945       s += QString::fromUtf8(" - ") + caption();
01946   }
01947 
01948   return s;
01949 }
01950 
01951 QPalette KApplication::createApplicationPalette()
01952 {
01953     KConfig *config = KGlobal::config();
01954     KConfigGroupSaver saver( config, "General" );
01955     return createApplicationPalette( config, KGlobalSettings::contrast() );
01956 }
01957 
01958 QPalette KApplication::createApplicationPalette( KConfig *config, int contrast_ )
01959 {
01960     QColor kde34Background( 239, 239, 239 );
01961     QColor kde34Blue( 103,141,178 );
01962 
01963     QColor kde34Button;
01964     if ( QPixmap::defaultDepth() > 8 )
01965       kde34Button.setRgb( 221, 223, 228 );
01966     else
01967       kde34Button.setRgb( 220, 220, 220 );
01968 
01969     QColor kde34Link( 0, 0, 238 );
01970     QColor kde34VisitedLink( 82, 24, 139 );
01971 
01972     QColor background = config->readColorEntry( "background", &kde34Background );
01973     QColor foreground = config->readColorEntry( "foreground", &black );
01974     QColor button = config->readColorEntry( "buttonBackground", &kde34Button );
01975     QColor buttonText = config->readColorEntry( "buttonForeground", &black );
01976     QColor highlight = config->readColorEntry( "selectBackground", &kde34Blue );
01977     QColor highlightedText = config->readColorEntry( "selectForeground", &white );
01978     QColor base = config->readColorEntry( "windowBackground", &white );
01979     QColor baseText = config->readColorEntry( "windowForeground", &black );
01980     QColor link = config->readColorEntry( "linkColor", &kde34Link );
01981     QColor visitedLink = config->readColorEntry( "visitedLinkColor", &kde34VisitedLink );
01982 
01983     int highlightVal, lowlightVal;
01984     highlightVal = 100 + (2*contrast_+4)*16/10;
01985     lowlightVal = 100 + (2*contrast_+4)*10;
01986 
01987     QColor disfg = foreground;
01988 
01989     int h, s, v;
01990     disfg.hsv( &h, &s, &v );
01991     if (v > 128)
01992     // dark bg, light fg - need a darker disabled fg
01993     disfg = disfg.dark(lowlightVal);
01994     else if (disfg != black)
01995     // light bg, dark fg - need a lighter disabled fg - but only if !black
01996     disfg = disfg.light(highlightVal);
01997     else
01998     // black fg - use darkgray disabled fg
01999     disfg = Qt::darkGray;
02000 
02001 
02002     QColorGroup disabledgrp(disfg, background,
02003                             background.light(highlightVal),
02004                             background.dark(lowlightVal),
02005                             background.dark(120),
02006                             background.dark(120), base);
02007 
02008     QColorGroup colgrp(foreground, background, background.light(highlightVal),
02009                        background.dark(lowlightVal),
02010                        background.dark(120),
02011                        baseText, base);
02012 
02013     int inlowlightVal = lowlightVal-25;
02014     if(inlowlightVal < 120)
02015         inlowlightVal = 120;
02016 
02017     colgrp.setColor(QColorGroup::Highlight, highlight);
02018     colgrp.setColor(QColorGroup::HighlightedText, highlightedText);
02019     colgrp.setColor(QColorGroup::Button, button);
02020     colgrp.setColor(QColorGroup::ButtonText, buttonText);
02021     colgrp.setColor(QColorGroup::Midlight, background.light(110));
02022     colgrp.setColor(QColorGroup::Link, link);
02023     colgrp.setColor(QColorGroup::LinkVisited, visitedLink);
02024 
02025     disabledgrp.setColor(QColorGroup::Button, button);
02026 
02027     QColor disbtntext = buttonText;
02028     disbtntext.hsv( &h, &s, &v );
02029     if (v > 128)
02030     // dark button, light buttonText - need a darker disabled buttonText
02031     disbtntext = disbtntext.dark(lowlightVal);
02032     else if (disbtntext != black)
02033     // light buttonText, dark button - need a lighter disabled buttonText - but only if !black
02034     disbtntext = disbtntext.light(highlightVal);
02035     else
02036     // black button - use darkgray disabled buttonText
02037     disbtntext = Qt::darkGray;
02038 
02039     disabledgrp.setColor(QColorGroup::ButtonText, disbtntext);
02040     disabledgrp.setColor(QColorGroup::Midlight, background.light(110));
02041     disabledgrp.setColor(QColorGroup::Highlight, highlight.dark(120));
02042     disabledgrp.setColor(QColorGroup::Link, link);
02043     disabledgrp.setColor(QColorGroup::LinkVisited, visitedLink);
02044 
02045     return QPalette(colgrp, disabledgrp, colgrp);
02046 }
02047 
02048 
02049 void KApplication::kdisplaySetPalette()
02050 {
02051 #ifdef Q_WS_MACX
02052     //Can I have this on other platforms, please!? --Sam
02053     {
02054         KConfig *config = KGlobal::config();
02055         KConfigGroupSaver saver( config, "General" );
02056         bool do_not_set_palette = FALSE;
02057         if(config->readBoolEntry("nopaletteChange", &do_not_set_palette))
02058             return;
02059     }
02060 #endif
02061     QApplication::setPalette( createApplicationPalette(), true);
02062     emit kdisplayPaletteChanged();
02063     emit appearanceChanged();
02064 }
02065 
02066 
02067 void KApplication::kdisplaySetFont()
02068 {
02069     QApplication::setFont(KGlobalSettings::generalFont(), true);
02070     QApplication::setFont(KGlobalSettings::menuFont(), true, "QMenuBar");
02071     QApplication::setFont(KGlobalSettings::menuFont(), true, "QPopupMenu");
02072     QApplication::setFont(KGlobalSettings::menuFont(), true, "KPopupTitle");
02073 
02074     // "patch" standard QStyleSheet to follow our fonts
02075     QStyleSheet* sheet = QStyleSheet::defaultSheet();
02076     sheet->item ("pre")->setFontFamily (KGlobalSettings::fixedFont().family());
02077     sheet->item ("code")->setFontFamily (KGlobalSettings::fixedFont().family());
02078     sheet->item ("tt")->setFontFamily (KGlobalSettings::fixedFont().family());
02079 
02080     emit kdisplayFontChanged();
02081     emit appearanceChanged();
02082 }
02083 
02084 
02085 void KApplication::kdisplaySetStyle()
02086 {
02087     if (useStyles)
02088     {
02089         applyGUIStyle();
02090         emit kdisplayStyleChanged();
02091         emit appearanceChanged();
02092     }
02093 }
02094 
02095 
02096 void KApplication::propagateSettings(SettingsCategory arg)
02097 {
02098     KConfigBase* config = KGlobal::config();
02099     KConfigGroupSaver saver( config, "KDE" );
02100 
02101     int num = config->readNumEntry("CursorBlinkRate", QApplication::cursorFlashTime());
02102     if ((num != 0) && (num < 200))
02103         num = 200;
02104     if (num > 2000)
02105         num = 2000;
02106     QApplication::setCursorFlashTime(num);
02107     num = config->readNumEntry("DoubleClickInterval", QApplication::doubleClickInterval());
02108     QApplication::setDoubleClickInterval(num);
02109     num = config->readNumEntry("StartDragTime", QApplication::startDragTime());
02110     QApplication::setStartDragTime(num);
02111     num = config->readNumEntry("StartDragDist", QApplication::startDragDistance());
02112     QApplication::setStartDragDistance(num);
02113     num = config->readNumEntry("WheelScrollLines", QApplication::wheelScrollLines());
02114     QApplication::setWheelScrollLines(num);
02115 
02116     bool b = config->readBoolEntry("EffectAnimateMenu", false);
02117     QApplication::setEffectEnabled( Qt::UI_AnimateMenu, b);
02118     b = config->readBoolEntry("EffectFadeMenu", false);
02119     QApplication::setEffectEnabled( Qt::UI_FadeMenu, b);
02120     b = config->readBoolEntry("EffectAnimateCombo", false);
02121     QApplication::setEffectEnabled( Qt::UI_AnimateCombo, b);
02122     b = config->readBoolEntry("EffectAnimateTooltip", false);
02123     QApplication::setEffectEnabled( Qt::UI_AnimateTooltip, b);
02124     b = config->readBoolEntry("EffectFadeTooltip", false);
02125     QApplication::setEffectEnabled( Qt::UI_FadeTooltip, b);
02126     b = !config->readBoolEntry("EffectNoTooltip", false);
02127     QToolTip::setGloballyEnabled( b );
02128 
02129     emit settingsChanged(arg);
02130 }
02131 
02132 void KApplication::installKDEPropertyMap()
02133 {
02134 #ifndef QT_NO_SQL
02135     static bool installed = false;
02136     if (installed) return;
02137     installed = true;
02144     // QSqlPropertyMap takes ownership of the new default map.
02145     QSqlPropertyMap *kdeMap = new QSqlPropertyMap;
02146     kdeMap->insert( "KColorButton", "color" );
02147     kdeMap->insert( "KComboBox", "currentItem" );
02148     kdeMap->insert( "KDatePicker", "date" );
02149     kdeMap->insert( "KDateWidget", "date" );
02150     kdeMap->insert( "KDateTimeWidget", "dateTime" );
02151     kdeMap->insert( "KEditListBox", "items" );
02152     kdeMap->insert( "KFontCombo", "family" );
02153     kdeMap->insert( "KFontRequester", "font" );
02154     kdeMap->insert( "KFontChooser", "font" );
02155     kdeMap->insert( "KHistoryCombo", "currentItem" );
02156     kdeMap->insert( "KListBox", "currentItem" );
02157     kdeMap->insert( "KLineEdit", "text" );
02158     kdeMap->insert( "KRestrictedLine", "text" );
02159     kdeMap->insert( "KSqueezedTextLabel", "text" );
02160     kdeMap->insert( "KTextBrowser", "source" );
02161     kdeMap->insert( "KTextEdit", "text" );
02162     kdeMap->insert( "KURLRequester", "url" );
02163     kdeMap->insert( "KPasswordEdit", "password" );
02164     kdeMap->insert( "KIntNumInput", "value" );
02165     kdeMap->insert( "KIntSpinBox", "value" );
02166     kdeMap->insert( "KDoubleNumInput", "value" );
02167     // Temp til fixed in QT then enable ifdef with the correct version num
02168     kdeMap->insert( "QGroupBox", "checked" );
02169     kdeMap->insert( "QTabWidget", "currentPage" );
02170     QSqlPropertyMap::installDefaultMap( kdeMap );
02171 #endif
02172 }
02173 
02174 void KApplication::invokeHelp( const QString& anchor,
02175                                const QString& _appname) const
02176 {
02177     return invokeHelp( anchor, _appname, "" );
02178 }
02179 
02180 #ifndef Q_WS_WIN
02181 // for win32 we're using simple help tools like Qt Assistant,
02182 // see kapplication_win.cpp
02183 void KApplication::invokeHelp( const QString& anchor,
02184                                const QString& _appname,
02185                                const QCString& startup_id ) const
02186 {
02187    QString url;
02188    QString appname;
02189    if (_appname.isEmpty())
02190      appname = name();
02191    else
02192      appname = _appname;
02193 
02194    if (!anchor.isEmpty())
02195      url = QString("help:/%1?anchor=%2").arg(appname).arg(anchor);
02196    else
02197      url = QString("help:/%1/index.html").arg(appname);
02198 
02199    QString error;
02200    if ( !dcopClient()->isApplicationRegistered("khelpcenter") )
02201    {
02202        if (startServiceByDesktopName("khelpcenter", url, &error, 0, 0, startup_id, false))
02203        {
02204            if (Tty != kapp->type())
02205                QMessageBox::critical(kapp->mainWidget(), i18n("Could not Launch Help Center"),
02206                i18n("Could not launch the KDE Help Center:\n\n%1").arg(error), i18n("&OK"));
02207            else
02208                kdWarning() << "Could not launch help:\n" << error << endl;
02209        return;
02210        }
02211    }
02212    else
02213        DCOPRef( "khelpcenter", "KHelpCenterIface" ).send( "openUrl", url, startup_id );
02214 }
02215 #endif
02216 
02217 void KApplication::invokeHTMLHelp( const QString& _filename, const QString& topic ) const
02218 {
02219    kdWarning() << "invoking HTML help is deprecated! use docbook and invokeHelp!\n";
02220 
02221    QString filename;
02222 
02223    if( _filename.isEmpty() )
02224      filename = QString(name()) + "/index.html";
02225    else
02226      filename = _filename;
02227 
02228    QString url;
02229    if (!topic.isEmpty())
02230      url = QString("help:/%1#%2").arg(filename).arg(topic);
02231    else
02232      url = QString("help:/%1").arg(filename);
02233 
02234    QString error;
02235    if ( !dcopClient()->isApplicationRegistered("khelpcenter") )
02236    {
02237        if (startServiceByDesktopName("khelpcenter", url, &error, 0, 0, "", false))
02238        {
02239            if (Tty != kapp->type())
02240                QMessageBox::critical(kapp->mainWidget(), i18n("Could not Launch Help Center"),
02241                i18n("Could not launch the KDE Help Center:\n\n%1").arg(error), i18n("&OK"));
02242            else
02243                kdWarning() << "Could not launch help:\n" << error << endl;
02244            return;
02245        }
02246    }
02247    else
02248        DCOPRef( "khelpcenter", "KHelpCenterIface" ).send( "openUrl", url );
02249 }
02250 
02251 
02252 void KApplication::invokeMailer(const QString &address, const QString &subject)
02253 {
02254     return invokeMailer(address,subject,"");
02255 }
02256 
02257 void KApplication::invokeMailer(const QString &address, const QString &subject, const QCString& startup_id)
02258 {
02259    invokeMailer(address, QString::null, QString::null, subject, QString::null, QString::null,
02260        QStringList(), startup_id );
02261 }
02262 
02263 void KApplication::invokeMailer(const KURL &mailtoURL)
02264 {
02265     return invokeMailer( mailtoURL, "" );
02266 }
02267 
02268 void KApplication::invokeMailer(const KURL &mailtoURL, const QCString& startup_id )
02269 {
02270     return invokeMailer( mailtoURL, startup_id, false);
02271 }
02272 
02273 void KApplication::invokeMailer(const KURL &mailtoURL, const QCString& startup_id, bool allowAttachments )
02274 {
02275    QString address = KURL::decode_string(mailtoURL.path()), subject, cc, bcc, body;
02276    QStringList queries = QStringList::split('&', mailtoURL.query().mid(1));
02277    QStringList attachURLs;
02278    for (QStringList::Iterator it = queries.begin(); it != queries.end(); ++it)
02279    {
02280      QString q = (*it).lower();
02281      if (q.startsWith("subject="))
02282        subject = KURL::decode_string((*it).mid(8));
02283      else
02284      if (q.startsWith("cc="))
02285        cc = cc.isEmpty()? KURL::decode_string((*it).mid(3)): cc + ',' + KURL::decode_string((*it).mid(3));
02286      else
02287      if (q.startsWith("bcc="))
02288        bcc = bcc.isEmpty()? KURL::decode_string((*it).mid(4)): bcc + ',' + KURL::decode_string((*it).mid(4));
02289      else
02290      if (q.startsWith("body="))
02291        body = KURL::decode_string((*it).mid(5));
02292      else
02293      if (allowAttachments && q.startsWith("attach="))
02294        attachURLs.push_back(KURL::decode_string((*it).mid(7)));
02295      else
02296      if (allowAttachments && q.startsWith("attachment="))
02297        attachURLs.push_back(KURL::decode_string((*it).mid(11)));
02298      else
02299      if (q.startsWith("to="))
02300        address = address.isEmpty()? KURL::decode_string((*it).mid(3)): address + ',' + KURL::decode_string((*it).mid(3));
02301    }
02302 
02303    invokeMailer( address, cc, bcc, subject, body, QString::null, attachURLs, startup_id );
02304 }
02305 
02306 void KApplication::invokeMailer(const QString &to, const QString &cc, const QString &bcc,
02307                                 const QString &subject, const QString &body,
02308                                 const QString & messageFile, const QStringList &attachURLs)
02309 {
02310     return invokeMailer(to,cc,bcc,subject,body,messageFile,attachURLs,"");
02311 }
02312 
02313 #ifndef Q_WS_WIN
02314 // on win32, for invoking browser we're using win32 API
02315 // see kapplication_win.cpp
02316 
02317 static QStringList splitEmailAddressList( const QString & aStr )
02318 {
02319   // This is a copy of KPIM::splitEmailAddrList().
02320   // Features:
02321   // - always ignores quoted characters
02322   // - ignores everything (including parentheses and commas)
02323   //   inside quoted strings
02324   // - supports nested comments
02325   // - ignores everything (including double quotes and commas)
02326   //   inside comments
02327 
02328   QStringList list;
02329 
02330   if (aStr.isEmpty())
02331     return list;
02332 
02333   QString addr;
02334   uint addrstart = 0;
02335   int commentlevel = 0;
02336   bool insidequote = false;
02337 
02338   for (uint index=0; index<aStr.length(); index++) {
02339     // the following conversion to latin1 is o.k. because
02340     // we can safely ignore all non-latin1 characters
02341     switch (aStr[index].latin1()) {
02342     case '"' : // start or end of quoted string
02343       if (commentlevel == 0)
02344         insidequote = !insidequote;
02345       break;
02346     case '(' : // start of comment
02347       if (!insidequote)
02348         commentlevel++;
02349       break;
02350     case ')' : // end of comment
02351       if (!insidequote) {
02352         if (commentlevel > 0)
02353           commentlevel--;
02354         else {
02355           //kdDebug() << "Error in address splitting: Unmatched ')'"
02356           //          << endl;
02357           return list;
02358         }
02359       }
02360       break;
02361     case '\\' : // quoted character
02362       index++; // ignore the quoted character
02363       break;
02364     case ',' :
02365       if (!insidequote && (commentlevel == 0)) {
02366         addr = aStr.mid(addrstart, index-addrstart);
02367         if (!addr.isEmpty())
02368           list += addr.simplifyWhiteSpace();
02369         addrstart = index+1;
02370       }
02371       break;
02372     }
02373   }
02374   // append the last address to the list
02375   if (!insidequote && (commentlevel == 0)) {
02376     addr = aStr.mid(addrstart, aStr.length()-addrstart);
02377     if (!addr.isEmpty())
02378       list += addr.simplifyWhiteSpace();
02379   }
02380   //else
02381   //  kdDebug() << "Error in address splitting: "
02382   //            << "Unexpected end of address list"
02383   //            << endl;
02384 
02385   return list;
02386 }
02387 
02388 void KApplication::invokeMailer(const QString &_to, const QString &_cc, const QString &_bcc,
02389                                 const QString &subject, const QString &body,
02390                                 const QString & /*messageFile TODO*/, const QStringList &attachURLs,
02391                                 const QCString& startup_id )
02392 {
02393    KConfig config("emaildefaults");
02394 
02395    config.setGroup("Defaults");
02396    QString group = config.readEntry("Profile","Default");
02397 
02398    config.setGroup( QString("PROFILE_%1").arg(group) );
02399    QString command = config.readPathEntry("EmailClient");
02400 
02401    QString to, cc, bcc;
02402    if (command.isEmpty() || command == QString::fromLatin1("kmail")
02403        || command.endsWith("/kmail"))
02404    {
02405      command = QString::fromLatin1("kmail --composer -s %s -c %c -b %b --body %B --attach %A -- %t");
02406      if ( !_to.isEmpty() )
02407      {
02408        // put the whole address lists into RFC2047 encoded blobs; technically
02409        // this isn't correct, but KMail understands it nonetheless
02410        to = QString( "=?utf8?b?%1?=" )
02411             .arg( KCodecs::base64Encode( _to.utf8(), false ) );
02412      }
02413      if ( !_cc.isEmpty() )
02414        cc = QString( "=?utf8?b?%1?=" )
02415             .arg( KCodecs::base64Encode( _cc.utf8(), false ) );
02416      if ( !_bcc.isEmpty() )
02417        bcc = QString( "=?utf8?b?%1?=" )
02418              .arg( KCodecs::base64Encode( _bcc.utf8(), false ) );
02419    } else {
02420      to = _to;
02421      cc = _cc;
02422      bcc = _bcc;
02423      if( !command.contains( '%' ))
02424          command += " %u";
02425    }
02426 
02427    if (config.readBoolEntry("TerminalClient", false))
02428    {
02429      KConfigGroup confGroup( KGlobal::config(), "General" );
02430      QString preferredTerminal = confGroup.readPathEntry("TerminalApplication", "konsole");
02431      command = preferredTerminal + " -e " + command;
02432    }
02433 
02434    QStringList cmdTokens = KShell::splitArgs(command);
02435    QString cmd = cmdTokens[0];
02436    cmdTokens.remove(cmdTokens.begin());
02437 
02438    KURL url;
02439    QStringList qry;
02440    if (!to.isEmpty())
02441    {
02442      QStringList tos = splitEmailAddressList( to );
02443      url.setPath( tos.first() );
02444      tos.remove( tos.begin() );
02445      for (QStringList::ConstIterator it = tos.begin(); it != tos.end(); ++it)
02446        qry.append( "to=" + KURL::encode_string( *it ) );
02447    }
02448    const QStringList ccs = splitEmailAddressList( cc );
02449    for (QStringList::ConstIterator it = ccs.begin(); it != ccs.end(); ++it)
02450       qry.append( "cc=" + KURL::encode_string( *it ) );
02451    const QStringList bccs = splitEmailAddressList( bcc );
02452    for (QStringList::ConstIterator it = bccs.begin(); it != bccs.end(); ++it)
02453       qry.append( "bcc=" + KURL::encode_string( *it ) );
02454    for (QStringList::ConstIterator it = attachURLs.begin(); it != attachURLs.end(); ++it)
02455       qry.append( "attach=" + KURL::encode_string( *it ) );
02456    if (!subject.isEmpty())
02457       qry.append( "subject=" + KURL::encode_string( subject ) );
02458    if (!body.isEmpty())
02459       qry.append( "body=" + KURL::encode_string( body ) );
02460    url.setQuery( qry.join( "&" ) );
02461    if ( ! (to.isEmpty() && qry.isEmpty()) )
02462       url.setProtocol("mailto");
02463 
02464    QMap<QChar, QString> keyMap;
02465    keyMap.insert('t', to);
02466    keyMap.insert('s', subject);
02467    keyMap.insert('c', cc);
02468    keyMap.insert('b', bcc);
02469    keyMap.insert('B', body);
02470    keyMap.insert('u', url.url());
02471 
02472    QString attachlist = attachURLs.join(",");
02473    attachlist.prepend('\'');
02474    attachlist.append('\'');
02475    keyMap.insert('A', attachlist);
02476 
02477    for (QStringList::Iterator it = cmdTokens.begin(); it != cmdTokens.end(); )
02478    {
02479      if (*it == "%A")
02480      {
02481          if (it == cmdTokens.begin()) // better safe than sorry ...
02482              continue;
02483          QStringList::ConstIterator urlit = attachURLs.begin();
02484          QStringList::ConstIterator urlend = attachURLs.end();
02485          if ( urlit != urlend )
02486          {
02487              QStringList::Iterator previt = it;
02488              --previt;
02489              *it = *urlit;
02490              ++it;
02491              while ( ++urlit != urlend )
02492              {
02493                  cmdTokens.insert( it, *previt );
02494                  cmdTokens.insert( it, *urlit );
02495              }
02496          } else {
02497              --it;
02498              it = cmdTokens.remove( cmdTokens.remove( it ) );
02499          }
02500      } else {
02501          *it = KMacroExpander::expandMacros(*it, keyMap);
02502          ++it;
02503      }
02504    }
02505 
02506    QString error;
02507    // TODO this should check if cmd has a .desktop file, and use data from it, together
02508    // with sending more ASN data
02509    if (kdeinitExec(cmd, cmdTokens, &error, NULL, startup_id ))
02510      if (Tty != kapp->type())
02511        QMessageBox::critical(kapp->mainWidget(), i18n("Could not Launch Mail Client"),
02512              i18n("Could not launch the mail client:\n\n%1").arg(error), i18n("&OK"));
02513      else
02514        kdWarning() << "Could not launch mail client:\n" << error << endl;
02515 }
02516 #endif
02517 
02518 void KApplication::invokeBrowser( const QString &url )
02519 {
02520     return invokeBrowser( url, "" );
02521 }
02522 
02523 #ifndef Q_WS_WIN
02524 // on win32, for invoking browser we're using win32 API
02525 // see kapplication_win.cpp
02526 void KApplication::invokeBrowser( const QString &url, const QCString& startup_id )
02527 {
02528    QString error;
02529 
02530    if (startServiceByDesktopName("kfmclient", url, &error, 0, 0, startup_id, false))
02531    {
02532       if (Tty != kapp->type())
02533           QMessageBox::critical(kapp->mainWidget(), i18n("Could not Launch Browser"),
02534                i18n("Could not launch the browser:\n\n%1").arg(error), i18n("&OK"));
02535       else
02536           kdWarning() << "Could not launch browser:\n" << error << endl;
02537       return;
02538    }
02539 }
02540 #endif
02541 
02542 void KApplication::cut()
02543 {
02544   invokeEditSlot( SLOT( cut() ) );
02545 }
02546 
02547 void KApplication::copy()
02548 {
02549   invokeEditSlot( SLOT( copy() ) );
02550 }
02551 
02552 void KApplication::paste()
02553 {
02554   invokeEditSlot( SLOT( paste() ) );
02555 }
02556 
02557 void KApplication::clear()
02558 {
02559   invokeEditSlot( SLOT( clear() ) );
02560 }
02561 
02562 void KApplication::selectAll()
02563 {
02564   invokeEditSlot( SLOT( selectAll() ) );
02565 }
02566 
02567 QCString
02568 KApplication::launcher()
02569 {
02570    return "klauncher";
02571 }
02572 
02573 static int
02574 startServiceInternal( const QCString &function,
02575               const QString& _name, const QStringList &URLs,
02576               QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02577 {
02578    struct serviceResult
02579    {
02580       int result;
02581       QCString dcopName;
02582       QString error;
02583       pid_t pid;
02584    };
02585 
02586    // Register app as able to send DCOP messages
02587    DCOPClient *dcopClient;
02588    if (kapp)
02589       dcopClient = kapp->dcopClient();
02590    else
02591       dcopClient = new DCOPClient;
02592 
02593    if (!dcopClient->isAttached())
02594    {
02595       if (!dcopClient->attach())
02596       {
02597          if (error)
02598             *error = i18n("Could not register with DCOP.\n");
02599          return -1;
02600       }
02601    }
02602    QByteArray params;
02603    QDataStream stream(params, IO_WriteOnly);
02604    stream << _name << URLs;
02605    QCString replyType;
02606    QByteArray replyData;
02607    QCString _launcher = KApplication::launcher();
02608    QValueList<QCString> envs;
02609 #ifdef Q_WS_X11
02610    if (qt_xdisplay()) {
02611        QCString dpystring(XDisplayString(qt_xdisplay()));
02612        envs.append( QCString("DISPLAY=") + dpystring );
02613    } else if( getenv( "DISPLAY" )) {
02614        QCString dpystring( getenv( "DISPLAY" ));
02615        envs.append( QCString("DISPLAY=") + dpystring );
02616    }
02617 #endif
02618    stream << envs;
02619 #if defined Q_WS_X11
02620    // make sure there is id, so that user timestamp exists
02621    stream << ( startup_id.isEmpty() ? KStartupInfo::createNewStartupId() : startup_id );
02622 #endif
02623    if( function.left( 12 ) != "kdeinit_exec" )
02624        stream << noWait;
02625 
02626    if (!dcopClient->call(_launcher, _launcher,
02627         function, params, replyType, replyData))
02628    {
02629         if (error)
02630            *error = i18n("KLauncher could not be reached via DCOP.\n");
02631         if (!kapp)
02632            delete dcopClient;
02633         return -1;
02634    }
02635    if (!kapp)
02636       delete dcopClient;
02637 
02638    if (noWait)
02639       return 0;
02640 
02641    QDataStream stream2(replyData, IO_ReadOnly);
02642    serviceResult result;
02643    stream2 >> result.result >> result.dcopName >> result.error >> result.pid;
02644    if (dcopService)
02645       *dcopService = result.dcopName;
02646    if (error)
02647       *error = result.error;
02648    if (pid)
02649       *pid = result.pid;
02650    return result.result;
02651 }
02652 
02653 int
02654 KApplication::startServiceByName( const QString& _name, const QString &URL,
02655                   QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02656 {
02657    QStringList URLs;
02658    if (!URL.isEmpty())
02659       URLs.append(URL);
02660    return startServiceInternal(
02661                       "start_service_by_name(QString,QStringList,QValueList<QCString>,QCString,bool)",
02662                       _name, URLs, error, dcopService, pid, startup_id, noWait);
02663 }
02664 
02665 int
02666 KApplication::startServiceByName( const QString& _name, const QStringList &URLs,
02667                   QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02668 {
02669    return startServiceInternal(
02670                       "start_service_by_name(QString,QStringList,QValueList<QCString>,QCString,bool)",
02671                       _name, URLs, error, dcopService, pid, startup_id, noWait);
02672 }
02673 
02674 int
02675 KApplication::startServiceByDesktopPath( const QString& _name, const QString &URL,
02676                   QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02677 {
02678    QStringList URLs;
02679    if (!URL.isEmpty())
02680       URLs.append(URL);
02681    return startServiceInternal(
02682                       "start_service_by_desktop_path(QString,QStringList,QValueList<QCString>,QCString,bool)",
02683                       _name, URLs, error, dcopService, pid, startup_id, noWait);
02684 }
02685 
02686 int
02687 KApplication::startServiceByDesktopPath( const QString& _name, const QStringList &URLs,
02688                   QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02689 {
02690    return startServiceInternal(
02691                       "start_service_by_desktop_path(QString,QStringList,QValueList<QCString>,QCString,bool)",
02692                       _name, URLs, error, dcopService, pid, startup_id, noWait);
02693 }
02694 
02695 int
02696 KApplication::startServiceByDesktopName( const QString& _name, const QString &URL,
02697                   QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02698 {
02699    QStringList URLs;
02700    if (!URL.isEmpty())
02701       URLs.append(URL);
02702    return startServiceInternal(
02703                       "start_service_by_desktop_name(QString,QStringList,QValueList<QCString>,QCString,bool)",
02704                       _name, URLs, error, dcopService, pid, startup_id, noWait);
02705 }
02706 
02707 int
02708 KApplication::startServiceByDesktopName( const QString& _name, const QStringList &URLs,
02709                   QString *error, QCString *dcopService, int *pid, const QCString& startup_id, bool noWait )
02710 {
02711    return startServiceInternal(
02712                       "start_service_by_desktop_name(QString,QStringList,QValueList<QCString>,QCString,bool)",
02713                       _name, URLs, error, dcopService, pid, startup_id, noWait);
02714 }
02715 
02716 int
02717 KApplication::kdeinitExec( const QString& name, const QStringList &args,
02718                            QString *error, int *pid )
02719 {
02720     return kdeinitExec( name, args, error, pid, "" );
02721 }
02722 
02723 int
02724 KApplication::kdeinitExec( const QString& name, const QStringList &args,
02725                            QString *error, int *pid, const QCString& startup_id )
02726 {
02727    return startServiceInternal("kdeinit_exec(QString,QStringList,QValueList<QCString>,QCString)",
02728         name, args, error, 0, pid, startup_id, false);
02729 }
02730 
02731 int
02732 KApplication::kdeinitExecWait( const QString& name, const QStringList &args,
02733                            QString *error, int *pid )
02734 {
02735     return kdeinitExecWait( name, args, error, pid, "" );
02736 }
02737 
02738 int
02739 KApplication::kdeinitExecWait( const QString& name, const QStringList &args,
02740                            QString *error, int *pid, const QCString& startup_id )
02741 {
02742    return startServiceInternal("kdeinit_exec_wait(QString,QStringList,QValueList<QCString>,QCString)",
02743         name, args, error, 0, pid, startup_id, false);
02744 }
02745 
02746 QString KApplication::tempSaveName( const QString& pFilename ) const
02747 {
02748   QString aFilename;
02749 
02750   if( QDir::isRelativePath(pFilename) )
02751     {
02752       kdWarning(101) << "Relative filename passed to KApplication::tempSaveName" << endl;
02753       aFilename = QFileInfo( QDir( "." ), pFilename ).absFilePath();
02754     }
02755   else
02756     aFilename = pFilename;
02757 
02758   QDir aAutosaveDir( QDir::homeDirPath() + "/autosave/" );
02759   if( !aAutosaveDir.exists() )
02760     {
02761       if( !aAutosaveDir.mkdir( aAutosaveDir.absPath() ) )
02762         {
02763           // Last chance: use temp dir
02764           aAutosaveDir.setPath( KGlobal::dirs()->saveLocation("tmp") );
02765         }
02766     }
02767 
02768   aFilename.replace( "/", "\\!" ).prepend( "#" ).append( "#" ).prepend( "/" ).prepend( aAutosaveDir.absPath() );
02769 
02770   return aFilename;
02771 }
02772 
02773 
02774 QString KApplication::checkRecoverFile( const QString& pFilename,
02775         bool& bRecover ) const
02776 {
02777   QString aFilename;
02778 
02779   if( QDir::isRelativePath(pFilename) )
02780     {
02781       kdWarning(101) << "Relative filename passed to KApplication::tempSaveName" << endl;
02782       aFilename = QFileInfo( QDir( "." ), pFilename ).absFilePath();
02783     }
02784   else
02785     aFilename = pFilename;
02786 
02787   QDir aAutosaveDir( QDir::homeDirPath() + "/autosave/" );
02788   if( !aAutosaveDir.exists() )
02789     {
02790       if( !aAutosaveDir.mkdir( aAutosaveDir.absPath() ) )
02791         {
02792           // Last chance: use temp dir
02793           aAutosaveDir.setPath( KGlobal::dirs()->saveLocation("tmp") );
02794         }
02795     }
02796 
02797   aFilename.replace( "/", "\\!" ).prepend( "#" ).append( "#" ).prepend( "/" ).prepend( aAutosaveDir.absPath() );
02798 
02799   if( QFile( aFilename ).exists() )
02800     {
02801       bRecover = true;
02802       return aFilename;
02803     }
02804   else
02805     {
02806       bRecover = false;
02807       return pFilename;
02808     }
02809 }
02810 
02811 
02812 bool checkAccess(const QString& pathname, int mode)
02813 {
02814   int accessOK = access( QFile::encodeName(pathname), mode );
02815   if ( accessOK == 0 )
02816     return true;  // OK, I can really access the file
02817 
02818   // else
02819   // if we want to write the file would be created. Check, if the
02820   // user may write to the directory to create the file.
02821   if ( (mode & W_OK) == 0 )
02822     return false;   // Check for write access is not part of mode => bail out
02823 
02824 
02825   if (!access( QFile::encodeName(pathname), F_OK)) // if it already exists
02826       return false;
02827 
02828   //strip the filename (everything until '/' from the end
02829   QString dirName(pathname);
02830   int pos = dirName.findRev('/');
02831   if ( pos == -1 )
02832     return false;   // No path in argument. This is evil, we won't allow this
02833   else if ( pos == 0 ) // don't turn e.g. /root into an empty string
02834       pos = 1;
02835 
02836   dirName.truncate(pos); // strip everything starting from the last '/'
02837 
02838   accessOK = access( QFile::encodeName(dirName), W_OK );
02839   // -?- Can I write to the accessed diretory
02840   if ( accessOK == 0 )
02841     return true;  // Yes
02842   else
02843     return false; // No
02844 }
02845 
02846 void KApplication::setTopWidget( QWidget *topWidget )
02847 {
02848   if( !topWidget )
02849       return;
02850 
02851     // set the specified caption
02852     if ( !topWidget->inherits("KMainWindow") ) { // KMainWindow does this already for us
02853         topWidget->setCaption( caption() );
02854     }
02855 
02856     // set the specified icons
02857     topWidget->setIcon( icon() ); //standard X11
02858 #if defined Q_WS_X11
02859 //#ifdef Q_WS_X11 // FIXME(E): Implement for Qt/Embedded
02860     KWin::setIcons(topWidget->winId(), icon(), miniIcon() ); // NET_WM hints for KWin
02861 
02862     // set the app startup notification window property
02863     KStartupInfo::setWindowStartupId( topWidget->winId(), startupId());
02864 #endif
02865 }
02866 
02867 QCString KApplication::startupId() const
02868 {
02869     return d->startup_id;
02870 }
02871 
02872 void KApplication::setStartupId( const QCString& startup_id )
02873 {
02874     if( startup_id == d->startup_id )
02875         return;
02876 #if defined Q_WS_X11
02877     KStartupInfo::handleAutoAppStartedSending(); // finish old startup notification if needed
02878 #endif
02879     if( startup_id.isEmpty())
02880         d->startup_id = "0";
02881     else
02882         {
02883         d->startup_id = startup_id;
02884 #if defined Q_WS_X11
02885         KStartupInfoId id;
02886         id.initId( startup_id );
02887         long timestamp = id.timestamp();
02888         if( timestamp != 0 )
02889             updateUserTimestamp( timestamp );
02890 #endif
02891         }
02892 }
02893 
02894 // read the startup notification env variable, save it and unset it in order
02895 // not to propagate it to processes started from this app
02896 void KApplication::read_app_startup_id()
02897 {
02898 #if defined Q_WS_X11
02899     KStartupInfoId id = KStartupInfo::currentStartupIdEnv();
02900     KStartupInfo::resetStartupEnv();
02901     d->startup_id = id.id();
02902 #endif
02903 }
02904 
02905 int KApplication::random()
02906 {
02907    static bool init = false;
02908    if (!init)
02909    {
02910       unsigned int seed;
02911       init = true;
02912       int fd = open("/dev/urandom", O_RDONLY);
02913       if (fd < 0 || ::read(fd, &seed, sizeof(seed)) != sizeof(seed))
02914       {
02915             // No /dev/urandom... try something else.
02916             srand(getpid());
02917             seed = rand()+time(0);
02918       }
02919       if (fd >= 0) close(fd);
02920       srand(seed);
02921    }
02922    return rand();
02923 }
02924 
02925 QString KApplication::randomString(int length)
02926 {
02927    if (length <=0 ) return QString::null;
02928 
02929    QString str; str.setLength( length );
02930    int i = 0;
02931    while (length--)
02932    {
02933       int r=random() % 62;
02934       r+=48;
02935       if (r>57) r+=7;
02936       if (r>90) r+=6;
02937       str[i++] =  char(r);
02938       // so what if I work backwards?
02939    }
02940    return str;
02941 }
02942 
02943 bool KApplication::authorize(const QString &genericAction)
02944 {
02945    if (!d->actionRestrictions)
02946       return true;
02947 
02948    KConfig *config = KGlobal::config();
02949    KConfigGroupSaver saver( config, "KDE Action Restrictions" );
02950    return config->readBoolEntry(genericAction, true);
02951 }
02952 
02953 bool KApplication::authorizeKAction(const char *action)
02954 {
02955    if (!d->actionRestrictions || !action)
02956       return true;
02957 
02958    static const QString &action_prefix = KGlobal::staticQString( "action/" );
02959 
02960    return authorize(action_prefix + action);
02961 }
02962 
02963 bool KApplication::authorizeControlModule(const QString &menuId)
02964 {
02965    if (menuId.isEmpty() || kde_kiosk_exception)
02966       return true;
02967    KConfig *config = KGlobal::config();
02968    KConfigGroupSaver saver( config, "KDE Control Module Restrictions" );
02969    return config->readBoolEntry(menuId, true);
02970 }
02971 
02972 QStringList KApplication::authorizeControlModules(const QStringList &menuIds)
02973 {
02974    KConfig *config = KGlobal::config();
02975    KConfigGroupSaver saver( config, "KDE Control Module Restrictions" );
02976    QStringList result;
02977    for(QStringList::ConstIterator it = menuIds.begin();
02978        it != menuIds.end(); ++it)
02979    {
02980       if (config->readBoolEntry(*it, true))
02981          result.append(*it);
02982    }
02983    return result;
02984 }
02985 
02986 void KApplication::initUrlActionRestrictions()
02987 {
02988   d->urlActionRestrictions.setAutoDelete(true);
02989   d->urlActionRestrictions.clear();
02990   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
02991   ("open", QString::null, QString::null, QString::null, QString::null, QString::null, QString::null, true));
02992   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
02993   ("list", QString::null, QString::null, QString::null, QString::null, QString::null, QString::null, true));
02994 // TEST:
02995 //  d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
02996 //  ("list", QString::null, QString::null, QString::null, QString::null, QString::null, QString::null, false));
02997 //  d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
02998 //  ("list", QString::null, QString::null, QString::null, "file", QString::null, QDir::homeDirPath(), true));
02999   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03000   ("link", QString::null, QString::null, QString::null, ":internet", QString::null, QString::null, true));
03001   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03002   ("redirect", QString::null, QString::null, QString::null, ":internet", QString::null, QString::null, true));
03003 
03004   // We allow redirections to file: but not from internet protocols, redirecting to file:
03005   // is very popular among io-slaves and we don't want to break them
03006   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03007   ("redirect", QString::null, QString::null, QString::null, "file", QString::null, QString::null, true));
03008   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03009   ("redirect", ":internet", QString::null, QString::null, "file", QString::null, QString::null, false));
03010 
03011   // local protocols may redirect everywhere
03012   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03013   ("redirect", ":local", QString::null, QString::null, QString::null, QString::null, QString::null, true));
03014 
03015   // Anyone may redirect to about:
03016   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03017   ("redirect", QString::null, QString::null, QString::null, "about", QString::null, QString::null, true));
03018 
03019   // Anyone may redirect to itself, cq. within it's own group
03020   d->urlActionRestrictions.append( new KApplicationPrivate::URLActionRule
03021   ("redirect", QString::null, QString::null, QString::null, "=", QString::null, QString::null, true));
03022 
03023   KConfig *config = KGlobal::config();
03024   KConfigGroupSaver saver( config, "KDE URL Restrictions" );
03025   int count = config->readNumEntry("rule_count");
03026   QString keyFormat = QString("rule_%1");
03027   for(int i = 1; i <= count; i++)
03028   {
03029     QString key = keyFormat.arg(i);
03030     QStringList rule = config->readListEntry(key);
03031     if (rule.count() != 8)
03032       continue;
03033     QString action = rule[0];
03034     QString refProt = rule[1];
03035     QString refHost = rule[2];
03036     QString refPath = rule[3];
03037     QString urlProt = rule[4];
03038     QString urlHost = rule[5];
03039     QString urlPath = rule[6];
03040     QString strEnabled = rule[7].lower();
03041 
03042     bool bEnabled = (strEnabled == "true");
03043 
03044     if (refPath.startsWith("$HOME"))
03045        refPath.replace(0, 5, QDir::homeDirPath());
03046     else if (refPath.startsWith("~"))
03047        refPath.replace(0, 1, QDir::homeDirPath());
03048     if (urlPath.startsWith("$HOME"))
03049        urlPath.replace(0, 5, QDir::homeDirPath());
03050     else if (urlPath.startsWith("~"))
03051        urlPath.replace(0, 1, QDir::homeDirPath());
03052 
03053     if (refPath.startsWith("$TMP"))
03054        refPath.replace(0, 4, KGlobal::dirs()->saveLocation("tmp"));
03055     if (urlPath.startsWith("$TMP"))
03056        urlPath.replace(0, 4, KGlobal::dirs()->saveLocation("tmp"));
03057 
03058     d->urlActionRestrictions.append(new KApplicationPrivate::URLActionRule
03059         ( action, refProt, refHost, refPath, urlProt, urlHost, urlPath, bEnabled));
03060   }
03061 }
03062 
03063 void KApplication::allowURLAction(const QString &action, const KURL &_baseURL, const KURL &_destURL)
03064 {
03065   if (authorizeURLAction(action, _baseURL, _destURL))
03066      return;
03067 
03068   d->urlActionRestrictions.append(new KApplicationPrivate::URLActionRule
03069         ( action, _baseURL.protocol(), _baseURL.host(), _baseURL.path(-1),
03070                   _destURL.protocol(), _destURL.host(), _destURL.path(-1), true));
03071 }
03072 
03073 bool KApplication::authorizeURLAction(const QString &action, const KURL &_baseURL, const KURL &_destURL)
03074 {
03075   if (_destURL.isEmpty())
03076      return true;
03077 
03078   bool result = false;
03079   if (d->urlActionRestrictions.isEmpty())
03080      initUrlActionRestrictions();
03081 
03082   KURL baseURL(_baseURL);
03083   baseURL.setPath(QDir::cleanDirPath(baseURL.path()));
03084   QString baseClass = KProtocolInfo::protocolClass(baseURL.protocol());
03085   KURL destURL(_destURL);
03086   destURL.setPath(QDir::cleanDirPath(destURL.path()));
03087   QString destClass = KProtocolInfo::protocolClass(destURL.protocol());
03088 
03089   for(KApplicationPrivate::URLActionRule *rule = d->urlActionRestrictions.first();
03090       rule; rule = d->urlActionRestrictions.next())
03091   {
03092      if ((result != rule->permission) && // No need to check if it doesn't make a difference
03093          (action == rule->action) &&
03094          rule->baseMatch(baseURL, baseClass) &&
03095          rule->destMatch(destURL, destClass, baseURL, baseClass))
03096      {
03097         result = rule->permission;
03098      }
03099   }
03100   return result;
03101 }
03102 
03103 
03104 uint KApplication::keyboardModifiers()
03105 {
03106 #ifdef Q_WS_X11
03107     Window root;
03108     Window child;
03109     int root_x, root_y, win_x, win_y;
03110     uint keybstate;
03111     XQueryPointer( qt_xdisplay(), qt_xrootwin(), &root, &child,
03112                    &root_x, &root_y, &win_x, &win_y, &keybstate );
03113     return keybstate & 0x00ff;
03114 #elif defined W_WS_MACX
03115     return GetCurrentEventKeyModifiers() & 0x00ff;
03116 #else
03117     //TODO for win32
03118     return 0;
03119 #endif
03120 }
03121 
03122 uint KApplication::mouseState()
03123 {
03124     uint mousestate;
03125 #ifdef Q_WS_X11
03126     Window root;
03127     Window child;
03128     int root_x, root_y, win_x, win_y;
03129     XQueryPointer( qt_xdisplay(), qt_xrootwin(), &root, &child,
03130                    &root_x, &root_y, &win_x, &win_y, &mousestate );
03131 #elif defined(Q_WS_WIN)
03132     const bool mousebtn_swapped = GetSystemMetrics(SM_SWAPBUTTON);
03133     if (GetAsyncKeyState(VK_LBUTTON))
03134         mousestate |= (mousebtn_swapped ? Button3Mask : Button1Mask);
03135     if (GetAsyncKeyState(VK_MBUTTON))
03136         mousestate |= Button2Mask;
03137     if (GetAsyncKeyState(VK_RBUTTON))
03138         mousestate |= (mousebtn_swapped ? Button1Mask : Button3Mask);
03139 #elif defined(Q_WS_MACX)
03140     mousestate = GetCurrentEventButtonState();
03141 #else
03142     //TODO: other platforms
03143 #endif
03144     return mousestate & 0xff00;
03145 }
03146 
03147 Qt::ButtonState KApplication::keyboardMouseState()
03148 {
03149     int ret = 0;
03150 #ifdef Q_WS_X11
03151     Window root;
03152     Window child;
03153     int root_x, root_y, win_x, win_y;
03154     uint state;
03155     XQueryPointer( qt_xdisplay(), qt_xrootwin(), &root, &child,
03156                    &root_x, &root_y, &win_x, &win_y, &state );
03157     // transform the same way like Qt's qt_x11_translateButtonState()
03158     if( state & Button1Mask )
03159         ret |= LeftButton;
03160     if( state & Button2Mask )
03161         ret |= MidButton;
03162     if( state & Button3Mask )
03163         ret |= RightButton;
03164     if( state & ShiftMask )
03165         ret |= ShiftButton;
03166     if( state & ControlMask )
03167         ret |= ControlButton;
03168     if( state & KKeyNative::modX( KKey::ALT ))
03169         ret |= AltButton;
03170     if( state & KKeyNative::modX( KKey::WIN ))
03171         ret |= MetaButton;
03172 #elif defined(Q_WS_WIN)
03173     const bool mousebtn_swapped = GetSystemMetrics(SM_SWAPBUTTON);
03174     if (GetAsyncKeyState(VK_LBUTTON))
03175         ret |= (mousebtn_swapped ? RightButton : LeftButton);
03176     if (GetAsyncKeyState(VK_MBUTTON))
03177         ret |= MidButton;
03178     if (GetAsyncKeyState(VK_RBUTTON))
03179         ret |= (mousebtn_swapped ? LeftButton : RightButton);
03180     if (GetAsyncKeyState(VK_SHIFT))
03181         ret |= ShiftButton;
03182     if (GetAsyncKeyState(VK_CONTROL))
03183         ret |= ControlButton;
03184     if (GetAsyncKeyState(VK_MENU))
03185         ret |= AltButton;
03186     if (GetAsyncKeyState(VK_LWIN) || GetAsyncKeyState(VK_RWIN))
03187         ret |= MetaButton;
03188 #else
03189     //TODO: other platforms
03190 #endif
03191     return static_cast< ButtonState >( ret );
03192 }
03193 
03194 void KApplication::installSigpipeHandler()
03195 {
03196 #ifdef Q_OS_UNIX
03197     struct sigaction act;
03198     act.sa_handler = SIG_IGN;
03199     sigemptyset( &act.sa_mask );
03200     act.sa_flags = 0;
03201     sigaction( SIGPIPE, &act, 0 );
03202 #endif
03203 }
03204 
03205 void KApplication::sigpipeHandler(int)
03206 {
03207     int saved_errno = errno;
03208     // Using kdDebug from a signal handler is not a good idea.
03209 #ifndef NDEBUG
03210     char msg[1000];
03211     sprintf(msg, "*** SIGPIPE *** (ignored, pid = %ld)\n", (long) getpid());
03212     write(2, msg, strlen(msg));
03213 #endif
03214 
03215     // Do nothing.
03216     errno = saved_errno;
03217 }
03218 
03219 bool KApplication::guiEnabled()
03220 {
03221     return kapp && kapp->d->guiEnabled;
03222 }
03223 
03224 void KApplication::virtual_hook( int id, void* data )
03225 { KInstance::virtual_hook( id, data ); }
03226 
03227 void KSessionManaged::virtual_hook( int, void* )
03228 { /*BASE::virtual_hook( id, data );*/ }
03229 
03230 #include "kapplication.moc"
KDE Home | KDE Accessibility Home | Description of Access Keys