kdecore Library API Documentation
Overview Class Hierarchy Classes Classes (annotated) Members Namespaces Source Files

KApplication Class Reference

Controls and provides information to all KDE applications. Controls and provides information to all KDE applications. More...

#include <kapplication.h>

Inheritance diagram for KApplication:

Inheritance graph
[legend]
Collaboration diagram for KApplication:

Collaboration graph
[legend]
List of all members.

Public Types

enum  CaptionLayout { CaptionAppLast = 1, CaptionAppFirst, CaptionNoApp }
enum  ShutdownConfirm { ShutdownConfirmDefault = -1, ShutdownConfirmNo = 0, ShutdownConfirmYes = 1 }
enum  ShutdownType { ShutdownTypeDefault = -1, ShutdownTypeNone = 0, ShutdownTypeReboot = 1, ShutdownTypeHalt = 2 }
enum  ShutdownMode {
  ShutdownModeDefault = -1, ShutdownModeSchedule = 0, ShutdownModeTryNow = 1, ShutdownModeForceNow = 2,
  ShutdownModeInteractive = 3
}
enum  {
  ShiftModifier = 1<<0, LockModifier = 1<<1, ControlModifier = 1<<2, Modifier1 = 1<<3,
  Modifier2 = 1<<4, Modifier3 = 1<<5, Modifier4 = 1<<6, Modifier5 = 1<<7
}
enum  {
  Button1Pressed = 1<<8, Button2Pressed = 1<<9, Button3Pressed = 1<<10, Button4Pressed = 1<<11,
  Button5Pressed = 1<<12
}
enum  SettingsCategory {
  SETTINGS_MOUSE, SETTINGS_COMPLETION, SETTINGS_PATHS, SETTINGS_POPUPMENU,
  SETTINGS_QT, SETTINGS_SHORTCUTS
}

Public Slots

void invokeBrowser (const QString &url, const QCString &startup_id)
void invokeBrowser (const QString &url)
void cut ()
void copy ()
void paste ()
void clear ()
void selectAll ()
void ref ()
void deref ()

Signals

void kdisplayPaletteChanged ()
void kdisplayStyleChanged ()
void kdisplayFontChanged ()
void appearanceChanged ()
void toolbarAppearanceChanged (int)
void backgroundChanged (int desk)
void settingsChanged (int category)
void iconChanged (int group)
void kipcMessage (int id, int data)
void saveYourself ()
void shutDown ()

Public Member Functions

 KApplication (bool allowStyles=true, bool GUIenabled=true)
 KApplication (Display *display, Qt::HANDLE visual=0, Qt::HANDLE colormap=0, bool allowStyles=true)
 KApplication (Display *display, int &argc, char **argv, const QCString &rAppName, bool allowStyles=true, bool GUIenabled=true)
 KApplication (int &argc, char **argv, const QCString &rAppName, bool allowStyles=true, bool GUIenabled=true) KDE_DEPRECATED
KConfig * sessionConfig ()
bool isRestored () const
void disableSessionManagement ()
void enableSessionManagement ()
bool requestShutDown (ShutdownConfirm confirm=ShutdownConfirmDefault, ShutdownType sdtype=ShutdownTypeDefault, ShutdownMode sdmode=ShutdownModeDefault)
void propagateSessionManager ()
void commitData (QSessionManager &sm)
void saveState (QSessionManager &sm)
bool sessionSaving () const
QPixmap icon () const
QString iconName () const
QPixmap miniIcon () const
QString miniIconName () const
void setTopWidget (QWidget *topWidget)
void invokeHelp (const QString &anchor, const QString &appname, const QCString &startup_id) const
void invokeHelp (const QString &anchor=QString::null, const QString &appname=QString::null) const
void invokeHTMLHelp (const QString &aFilename, const QString &aTopic=QString::null) const KDE_DEPRECATED
void invokeMailer (const QString &address, const QString &subject, const QCString &startup_id)
void invokeMailer (const QString &address, const QString &subject)
void invokeMailer (const KURL &mailtoURL, const QCString &startup_id, bool allowAttachments)
void invokeMailer (const KURL &mailtoURL, const QCString &startup_id)
void invokeMailer (const KURL &mailtoURL)
void invokeMailer (const QString &to, const QString &cc, const QString &bcc, const QString &subject, const QString &body, const QString &messageFile, const QStringList &attachURLs, const QCString &startup_id)
void invokeMailer (const QString &to, const QString &cc, const QString &bcc, const QString &subject, const QString &body, const QString &messageFile=QString::null, const QStringList &attachURLs=QStringList())
QString caption () const
KDE_DEPRECATED KStyle * kstyle () const
QString makeStdCaption (const QString &userCaption, bool withAppName=true, bool modified=false) const
QString tempSaveName (const QString &pFilename) const
QString checkRecoverFile (const QString &pFilename, bool &bRecover) const
Display * getDisplay ()
void enableStyles ()
void disableStyles ()
void installX11EventFilter (QWidget *filter)
void removeX11EventFilter (const QWidget *filter)
void addKipcEventMask (int id)
void removeKipcEventMask (int id)
QCString startupId () const
void setStartupId (const QCString &startup_id)
void updateUserTimestamp (unsigned long time=0)
unsigned long userTimestamp () const
void updateRemoteUserTimestamp (const QCString &dcopId, unsigned long time=0)
QString geometryArgument () const
void installKDEPropertyMap ()
bool authorize (const QString &genericAction)
bool authorizeKAction (const char *action)
bool authorizeURLAction (const QString &action, const KURL &baseURL, const KURL &destURL)
void allowURLAction (const QString &action, const KURL &_baseURL, const KURL &_destURL)
bool authorizeControlModule (const QString &menuId)
QStringList authorizeControlModules (const QStringList &menuIds)
bool notify (QObject *receiver, QEvent *event)
int xErrhandler (Display *, void *)
int xioErrhandler (Display *)
void iceIOErrorHandler (_IceConn *conn)

Static Public Member Functions

static void addCmdLineOptions ()
static KApplication * kApplication ()
static DCOPClient * dcopClient ()
static void disableAutoDcopRegistration ()
static QCString launcher ()
static int startServiceByName (const QString &_name, const QString &URL, QString *error=0, QCString *dcopService=0, int *pid=0, const QCString &startup_id="", bool noWait=false)
static int startServiceByName (const QString &_name, const QStringList &URLs=QStringList(), QString *error=0, QCString *dcopService=0, int *pid=0, const QCString &startup_id="", bool noWait=false)
static int startServiceByDesktopPath (const QString &_name, const QString &URL, QString *error=0, QCString *dcopService=0, int *pid=0, const QCString &startup_id="", bool noWait=false)
static int startServiceByDesktopPath (const QString &_name, const QStringList &URLs=QStringList(), QString *error=0, QCString *dcopService=0, int *pid=0, const QCString &startup_id="", bool noWait=false)
static int startServiceByDesktopName (const QString &_name, const QString &URL, QString *error=0, QCString *dcopService=0, int *pid=0, const QCString &startup_id="", bool noWait=false)
static int startServiceByDesktopName (const QString &_name, const QStringList &URLs=QStringList(), QString *error=0, QCString *dcopService=0, int *pid=0, const QCString &startup_id="", bool noWait=false)
static int kdeinitExec (const QString &name, const QStringList &args, QString *error, int *pid, const QCString &startup_id)
static int kdeinitExec (const QString &name, const QStringList &args=QStringList(), QString *error=0, int *pid=0)
static int kdeinitExecWait (const QString &name, const QStringList &args, QString *error, int *pid, const QCString &startup_id)
static int kdeinitExecWait (const QString &name, const QStringList &args=QStringList(), QString *error=0, int *pid=0)
static int random ()
static QString randomString (int length)
static ButtonState keyboardMouseState ()
static uint keyboardModifiers () KDE_DEPRECATED
static uint mouseState () KDE_DEPRECATED
static void startKdeinit ()
static QPalette createApplicationPalette ()
static QPalette createApplicationPalette (KConfig *config, int contrast)
static void installSigpipeHandler ()
static bool guiEnabled ()

Static Public Attributes

static bool loadedByKdeinit = false

Protected Member Functions

 KApplication (bool allowStyles, bool GUIenabled, KInstance *_instance)
 KApplication (Display *display, Qt::HANDLE visual, Qt::HANDLE colormap, bool allowStyles, KInstance *_instance)
bool x11EventFilter (XEvent *)
void invokeEditSlot (const char *slot)
virtual void virtual_hook (int id, void *data)

Protected Attributes

Display * display
Atom kipcCommAtom
int kipcEventMask
int pArgc

Static Protected Attributes

static KApplication * KApp = 0L

Detailed Description

Controls and provides information to all KDE applications. Controls and provides information to all KDE applications.

Only one object of this class can be instantiated in a single app. This instance is always accessible via the 'kapp' global variable. See cut() for an example.

This class provides the following services to all KDE applications.

The way a service gets started depends on the 'X-DCOP-ServiceType' entry in the desktop file of the service:

There are three possibilities:

Author:
Matthias Kalle Dalheimer <kalle@kde.org>

Definition at line 94 of file kapplication.h.

Member Enumeration Documentation

enum KApplication::ShutdownConfirm
 

The possible values for the confirm parameter of requestShutDown().

Enumeration values:
ShutdownConfirmDefault  Obey the user's confirmation setting.
ShutdownConfirmNo  Don't confirm, shutdown without asking.
ShutdownConfirmYes  Always confirm, ask even if the user turned it off.

Definition at line 255 of file kapplication.h.

enum KApplication::ShutdownType
 

The possible values for the sdtype parameter of requestShutDown().

Enumeration values:
ShutdownTypeDefault  Select previous action or the default if it's the first time.
ShutdownTypeNone  Only log out.
ShutdownTypeReboot  Log out and reboot the machine.
ShutdownTypeHalt  Log out and halt the machine.

Definition at line 273 of file kapplication.h.

enum KApplication::ShutdownMode
 

The possible values for the sdmode parameter of requestShutDown().

Enumeration values:
ShutdownModeDefault  Select previous mode or the default if it's the first time.
ShutdownModeSchedule  Schedule a shutdown (halt or reboot) for the time all active sessions have exited.
ShutdownModeTryNow  Shut down, if no sessions are active.

Otherwise do nothing.

ShutdownModeForceNow  Force shutdown.

Kill any possibly active sessions.

ShutdownModeInteractive  Pop up a dialog asking the user what to do if sessions are still active.

Definition at line 295 of file kapplication.h.

anonymous enum
 

Deprecated:
Same values as Button1Mask etc. in X.h

Definition at line 1061 of file kapplication.h.

enum KApplication::SettingsCategory
 

Valid values for the settingsChanged signal.

Definition at line 1217 of file kapplication.h.

Constructor & Destructor Documentation

KApplication::KApplication (  bool  allowStyles = true,
bool  GUIenabled = true
) 
 

This constructor takes aboutData and command line arguments from KCmdLineArgs.

Parameters:
allowStyles Set to false to disable the loading on plugin based styles. This is only useful to applications that do not display a GUI normally. If you do create an application with allowStyles set to false it normally runs in the background but under special circumstances displays widgets. Call enableStyles() before displaying any widgets.
GUIenabled Set to false to disable all GUI stuff. This implies no styles either.

Definition at line 618 of file kapplication.cpp.

References installSigpipeHandler(), and KInstance::instanceName().

KApplication::KApplication (  Display *  display,
Qt::HANDLE  visual = 0,
Qt::HANDLE  colormap = 0,
bool  allowStyles = true
) 
 

Constructor.

Parses command-line arguments. Use this constructor when you you need to use a non-default visual or colormap.

Parameters:
display Will be passed to Qt as the X display. The display must be valid and already opened.
visual A pointer to the X11 visual that should be used by the appliction. Note that only TrueColor visuals are supported on depths greater than 8 bpp. If this parameter is NULL, the default visual will be used instead.
colormap The colormap that should be used by the application. If this parameter is 0, the default colormap will be used instead.
allowStyles Set to false to disable the loading on plugin based styles. This is only useful to applications that do not display a GUI normally. If you do create an application with allowStyles set to false that normally runs in the background but under special circumstances displays widgets call enableStyles() before displaying any widgets.
Since:
KDE 3.3

Definition at line 642 of file kapplication.cpp.

References installSigpipeHandler(), and KInstance::instanceName().

KApplication::KApplication (  Display *  display,
int &  argc,
char **  argv,
const QCString &  rAppName,
bool  allowStyles = true,
bool  GUIenabled = true
) 
 

Constructor.

Parses command-line arguments. Use this constructor to use KApplication in a Motif or Xt program.

Parameters:
display Will be passed to Qt as the X display. The display must be valid and already opened.
argc command line argument count
argv command line argument value(s)
rAppName application name. Will be used for finding the associated message files and icon files, and as the default registration name for DCOP. This is a mandatory parameter.
allowStyles Set to false to disable the loading on plugin based styles. This is only useful to applications that do not display a GUI normally. If you do create an application with allowStyles set to false that normally runs in the background but under special circumstances displays widgets call enableStyles() before displaying any widgets.
GUIenabled Set to false to disable all GUI stuff. This implies no styles either.

Definition at line 701 of file kapplication.cpp.

References installSigpipeHandler(), and QApplication::Q_ASSERT().

KApplication::KApplication (  int &  argc,
char **  argv,
const QCString &  rAppName,
bool  allowStyles = true,
bool  GUIenabled = true
) 
 

Deprecated:
do not use it at all, it will make your application crash, use KCmdLineArgs
Constructor. Parses command-line arguments.

Parameters:
argc command line argument count
argv command line argument value(s)
rAppName application name. Will be used for finding the associated message files and icon files, and as the default registration name for DCOP. This is a mandatory parameter.
allowStyles Set to false to disable the loading on plugin based styles. This is only useful to applications that do not display a GUI normally. If you do create an application with allowStyles set to false that normally runs in the background but under special circumstances displays widgets call enableStyles() before displaying any widgets.
GUIenabled Set to false to disable all GUI stuff. This implies no styles either.

Definition at line 594 of file kapplication.cpp.

References installSigpipeHandler(), and QApplication::Q_ASSERT().

Member Function Documentation

void KApplication::addCmdLineOptions (   )  [static]
 

Add Qt and KDE command line options to KCmdLineArgs.

Reimplemented in KUniqueApplication.

Definition at line 1464 of file kapplication.cpp.

References KCmdLineArgs::addCmdLineOptions().

Referenced by KCmdLineArgs::init().

static KApplication* KApplication::kApplication (   )  [inline, static]
 

Returns the current application object.

This is similar to the global QApplication pointer qApp. It allows access to the single global KApplication object, since more than one cannot be created in the same application. It saves you the trouble of having to pass the pointer explicitly to every function that may require it.

Returns:
the current application object

Definition at line 215 of file kapplication.h.

KConfig * KApplication::sessionConfig (   ) 
 

Returns the application session config object.

Returns:
A pointer to the application's instance specific KConfig object.
See also:
KConfig

Definition at line 1035 of file kapplication.cpp.

bool KApplication::isRestored (   )  const [inline]
 

Is the application restored from the session manager?

Returns:
If true, this application was restored by the session manager. Note that this may mean the config object returned by sessionConfig() contains data saved by a session closedown.
See also:
sessionConfig()

Definition at line 234 of file kapplication.h.

References QApplication::isSessionRestored().

Referenced by KUniqueApplication::restoringSession().

void KApplication::disableSessionManagement (   ) 
 

Disables session management for this application.

Useful in case your application is started by the initial "startkde" script.

Definition at line 1081 of file kapplication.cpp.

void KApplication::enableSessionManagement (   ) 
 

Enables again session management for this application, formerly disabled by calling disableSessionManagement().

You usually shouldn't call this function, as the session management is enabled by default.

Definition at line 1085 of file kapplication.cpp.

bool KApplication::requestShutDown (  ShutdownConfirm  confirm = ShutdownConfirmDefault,
ShutdownType  sdtype = ShutdownTypeDefault,
ShutdownMode  sdmode = ShutdownModeDefault
) 
 

Asks the session manager to shut the session down.

Using confirm == ShutdownConfirmYes or sdtype != ShutdownTypeDefault or sdmode != ShutdownModeDefault causes the use of ksmserver's DCOP interface. The remaining two combinations use the standard XSMP and will work with any session manager compliant with it.

Parameters:
confirm Whether to ask the user if he really wants to log out. ShutdownConfirm
sdtype The action to take after logging out. ShutdownType
sdmode If/When the action should be taken. ShutdownMode
Returns:
true on success, false if the session manager could not be contacted.

Definition at line 1109 of file kapplication.cpp.

References dcopClient(), QCString::isEmpty(), propagateSessionManager(), DCOPClient::send(), ShutdownConfirmNo, ShutdownConfirmYes, ShutdownModeDefault, ShutdownTypeDefault, and QApplication::syncX().

void KApplication::propagateSessionManager (   ) 
 

Propagates the network address of the session manager in the SESSION_MANAGER environment variable so that child processes can pick it up.

If SESSION_MANAGER isn't defined yet, the address is searched in $HOME/.KSMserver.

This function is called by clients that are started outside the session ( i.e. before ksmserver is started), but want to launch other processes that should participate in the session. Examples are kdesktop or kicker.

Definition at line 1172 of file kapplication.cpp.

References QFile::close(), QFile::encodeName(), QCString::find(), QCString::isEmpty(), QFileInfo::lastModified(), QString::latin1(), QFile::open(), QTextStream::readLine(), QCString::replace(), and QTextStream::setEncoding().

Referenced by requestShutDown().

bool KApplication::sessionSaving (   )  const
 

Returns true if the application is currently saving its session data (most probably before KDE logout).

This is intended for use mainly in KMainWindow::queryClose() and KMainWindow::queryExit().

See also:
KMainWindow::queryClose

KMainWindow::queryExit

Since:
3.1.1

Definition at line 1347 of file kapplication.cpp.

DCOPClient * KApplication::dcopClient (   )  [static]
 

Returns a pointer to a DCOPClient for the application.

If a client does not exist yet, it is created when this function is called.

Returns:
the DCOPClient for the application

Definition at line 985 of file kapplication.cpp.

References KCmdLineArgs::getOption(), KCmdLineArgs::isSet(), KCmdLineArgs::parsedArgs(), and DCOPClient::setMainClient().

Referenced by invokeHelp(), invokeHTMLHelp(), requestShutDown(), and KUniqueApplication::start().

void KApplication::disableAutoDcopRegistration (   )  [static]
 

Disable automatic dcop registration Must be called before creating a KApplication instance to have an effect.

Definition at line 1030 of file kapplication.cpp.

QPixmap KApplication::icon (   )  const
 

Returns a QPixmap with the application icon.

Returns:
the application icon

Referenced by setTopWidget().

QString KApplication::iconName (   )  const
 

Returns the name of the application icon.

Returns:
the icon's name

Definition at line 1592 of file kapplication.cpp.

References KInstance::instanceName(), and QString::isNull().

QPixmap KApplication::miniIcon (   )  const
 

Returns the mini-icon for the application as a QPixmap.

Returns:
the application's mini icon

Referenced by setTopWidget().

QString KApplication::miniIconName (   )  const
 

Returns the name of the mini-icon for the application.

Returns:
the mini icon's name

Definition at line 1608 of file kapplication.cpp.

References KInstance::instanceName(), and QString::isNull().

void KApplication::setTopWidget (  QWidget *  topWidget  ) 
 

Sets the top widget of the application.

This means basically applying the right window caption and icon. An application may have several top widgets. You don't need to call this function manually when using KMainWindow.

Parameters:
topWidget A top widget of the application.
See also:
icon(), caption()

Definition at line 2857 of file kapplication.cpp.

References caption(), icon(), miniIcon(), KStartupInfo::setWindowStartupId(), and startupId().

void KApplication::invokeHelp (  const QString &  anchor,
const QString &  appname,
const QCString &  startup_id
)  const
 

Invokes the KHelpCenter HTML help viewer from docbook sources.

Parameters:
anchor This has to be a defined anchor in your docbook sources. If empty the main index is loaded
appname This allows you to show the help of another application. If empty the current name() is used
startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

Definition at line 2201 of file kapplication.cpp.

References QString::arg(), QMessageBox::critical(), dcopClient(), endl(), and startServiceByDesktopName().

void KApplication::invokeHTMLHelp (  const QString &  aFilename,
const QString &  aTopic = QString::null
)  const
 

Deprecated:
Invoke the khelpcenter HTML help viewer from HTML sources. Please use invokeHelp() instead.
Parameters:
aFilename The filename that is to be loaded. Its location is computed automatically according to the KFSSTND. If aFilename is empty, the logical appname with .html appended to it is used.
aTopic This allows context-sensitive help. Its value will be appended to the filename, prefixed with a "#" (hash) character.

Definition at line 2235 of file kapplication.cpp.

References QString::arg(), QMessageBox::critical(), dcopClient(), endl(), and startServiceByDesktopName().

void KApplication::invokeMailer (  const QString &  address,
const QString &  subject,
const QCString &  startup_id
) 
 

Convenience method; invokes the standard email application.

Parameters:
address The destination address
subject Subject string. Can be QString::null.
startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

Definition at line 2275 of file kapplication.cpp.

Referenced by invokeMailer().

void KApplication::invokeMailer (  const KURL &  mailtoURL,
const QCString &  startup_id,
bool  allowAttachments
) 
 

Invokes the standard email application.

Parameters:
mailtoURL A mailto URL.
startup_id for app startup notification, "0" for none, "" ( empty string ) is the default
allowAttachments whether attachments specified in mailtoURL should be honoured. The default is false; do not honour requests for attachments.

Definition at line 2291 of file kapplication.cpp.

References KURL::decode_string(), invokeMailer(), QString::isEmpty(), QString::lower(), QStringList::split(), and QString::startsWith().

void KApplication::invokeMailer (  const QString &  to,
const QString &  cc,
const QString &  bcc,
const QString &  subject,
const QString &  body,
const QString &  messageFile,
const QStringList &  attachURLs,
const QCString &  startup_id
) 
 

Convenience method; invokes the standard email application.

All parameters are optional.

Parameters:
to The destination address.
cc The Cc field
bcc The Bcc field
subject Subject string
body A string containing the body of the mail (exclusive with messageFile)
messageFile A file (URL) containing the body of the mail (exclusive with body) - currently unsupported
attachURLs List of URLs to be attached to the mail.
startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

Definition at line 2406 of file kapplication.cpp.

References QString::arg(), QMap::begin(), KInstance::config(), QMessageBox::critical(), QMap::end(), endl(), QString::endsWith(), KMacroExpander::expandMacros(), QString::fromLatin1(), QMap::insert(), QString::isEmpty(), QStringList::join(), kdeinitExec(), KConfigBase::readBoolEntry(), KConfigBase::readEntry(), KConfigBase::readPathEntry(), KConfigBase::setGroup(), KURL::setPath(), KURL::setProtocol(), KURL::setQuery(), KShell::splitArgs(), and KURL::url().

void KApplication::invokeBrowser (  const QString &  url,
const QCString &  startup_id
)  [slot]
 

Invokes the standard browser.

Note that you should only do this when you know for sure that the browser can handle the URL (i.e. its mimetype). In doubt, if the URL can point to an image or anything else than directory or HTML, prefer to use new KRun( url ).

Parameters:
url The destination address
startup_id for app startup notification, "0" for none, "" ( empty string ) is the default

Definition at line 2537 of file kapplication.cpp.

References QString::arg(), QMessageBox::critical(), endl(), and startServiceByDesktopName().

void KApplication::cut (   )  [slot]
 

If the widget with focus provides a cut() slot, call that slot.

Thus for a simple application cut can be implemented as: 

 KStdAction::cut( kapp, SLOT( cut() ), actionCollection() );

Definition at line 2553 of file kapplication.cpp.

References invokeEditSlot().

void KApplication::copy (   )  [slot]
 

If the widget with focus provides a copy() slot, call that slot.

Thus for a simple application copy can be implemented as: 

 KStdAction::copy( kapp, SLOT( copy() ), actionCollection() );

Definition at line 2558 of file kapplication.cpp.

References invokeEditSlot().

void KApplication::paste (   )  [slot]
 

If the widget with focus provides a paste() slot, call that slot.

Thus for a simple application copy can be implemented as: 

 KStdAction::paste( kapp, SLOT( paste() ), actionCollection() );

Definition at line 2563 of file kapplication.cpp.

References invokeEditSlot().

void KApplication::clear (   )  [slot]
 

If the widget with focus provides a clear() slot, call that slot.

Thus for a simple application clear() can be implemented as: 

 new KAction( i18n( "Clear" ), "editclear", 0, kapp, SLOT( clear() ), actionCollection(), "clear" );

Note that for some widgets, this may not provide the intended bahavior. For example if you make use of the code above and a KListView has the focus, clear() will clear all of the items in the list. If this is not the intened behavior and you want to make use of this slot, you can subclass KListView and reimplement this slot. For example the following code would implement a KListView without this behavior:

 class MyListView : public KListView {
   Q_OBJECT
 public:
   MyListView( QWidget * parent = 0, const char * name = 0, WFlags f = 0 ) : KListView( parent, name, f ) {}
   virtual ~MyListView() {}
 public slots:
   virtual void clear() {}
 };

Definition at line 2568 of file kapplication.cpp.

References invokeEditSlot().

void KApplication::selectAll (   )  [slot]