• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdelibs API Reference
  • KDE Home
  • Contact Us
 

KDEUI

Public Slots | Signals | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | Static Protected Attributes | List of all members
KApplication Class Reference

#include <kapplication.h>

Inheritance diagram for KApplication:
Inheritance graph
[legend]

Public Slots

Q_SCRIPTABLE void quit ()
 
Q_SCRIPTABLE void reparseConfiguration ()
 
Q_SCRIPTABLE void updateUserTimestamp (int time=0)
 

Signals

void saveYourself ()
 

Public Member Functions

 KApplication (bool GUIenabled=true)
 
 KApplication (Display *display, Qt::HANDLE visual=0, Qt::HANDLE colormap=0)
 
 KApplication (Display *display, int &argc, char **argv, const QByteArray &rAppName, bool GUIenabled=true)
 
virtual ~KApplication ()
 
void clearStartupId ()
 
void commitData (QSessionManager &sm)
 
void disableSessionManagement ()
 
void enableSessionManagement ()
 
void iceIOErrorHandler (_IceConn *conn)
 
void installX11EventFilter (QWidget *filter)
 
bool notify (QObject *receiver, QEvent *event)
 
void removeX11EventFilter (const QWidget *filter)
 
void saveState (QSessionManager &sm)
 
KConfig * sessionConfig ()
 
bool sessionSaving () const
 
void setStartupId (const QByteArray &startup_id)
 
void setSynchronizeClipboard (bool synchronize)
 
void setTopWidget (QWidget *topWidget)
 
QByteArray startupId () const
 
void updateRemoteUserTimestamp (const QString &service, int time=0)
 
unsigned long userTimestamp () const
 
int xErrhandler (Display *, void *)
 
int xioErrhandler (Display *)
 

Static Public Member Functions

static QString checkRecoverFile (const QString &pFilename, bool &bRecover)
 
static KApplication * kApplication ()
 
static QString tempSaveName (const QString &pFilename)
 

Static Public Attributes

static bool loadedByKdeinit = false
 

Protected Member Functions

 KApplication (bool GUIenabled, const KComponentData &cData)
 
 KApplication (Display *display, Qt::HANDLE visual, Qt::HANDLE colormap, const KComponentData &cData)
 
bool x11EventFilter (XEvent *)
 

Static Protected Attributes

static KApplication * KApp = 0L
 

Detailed Description

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.

This class provides the following services to all KDE applications.

  • It controls the event queue (see QApplication ).
  • It provides the application with KDE resources such as accelerators, common menu entries, a KConfig object. session management events, help invocation etc.
  • Installs an empty signal handler for the SIGPIPE signal. If you want to catch this signal yourself, you have set a new signal handler after KApplication's constructor has run.
  • It can start new services

Controls and provides information to all KDE applications.

Author
Matthias Kalle Dalheimer kalle.nosp@m.@kde.nosp@m..org

Definition at line 82 of file kapplication.h.

Constructor & Destructor Documentation

KApplication::KApplication ( bool  GUIenabled = true)
explicit

This constructor is the one you should use.

It takes aboutData and command line arguments from KCmdLineArgs.

Parameters
GUIenabledSet to false to disable all GUI stuff. Note that for a non-GUI daemon, you might want to use QCoreApplication and a KComponentData instance instead. You'll save an unnecessary dependency to kdeui. The main difference is that you will have to do a number of things yourself:
  • Register to DBus, if necessary.
  • Call KGlobal::locale(), if using multiple threads.

Definition at line 344 of file kapplication.cpp.

KApplication::KApplication ( Display *  display,
Qt::HANDLE  visual = 0,
Qt::HANDLE  colormap = 0 
)
explicit

Constructor.

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

Parameters
displayWill be passed to Qt as the X display. The display must be valid and already opened.
visualA pointer to the X11 visual that should be used by the application. 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.
colormapThe colormap that should be used by the application. If this parameter is 0, the default colormap will be used instead.

Definition at line 356 of file kapplication.cpp.

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

Constructor.

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

Parameters
displayWill be passed to Qt as the X display. The display must be valid and already opened.
argccommand line argument count
argvcommand line argument value(s)
rAppNameapplication 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.
GUIenabledSet to false to disable all GUI stuff.

Definition at line 391 of file kapplication.cpp.

KApplication::~KApplication ( )
virtual

Definition at line 894 of file kapplication.cpp.

KApplication::KApplication ( bool  GUIenabled,
const KComponentData &  cData 
)
protected

Used by KUniqueApplication

Definition at line 379 of file kapplication.cpp.

KApplication::KApplication ( Display *  display,
Qt::HANDLE  visual,
Qt::HANDLE  colormap,
const KComponentData &  cData 
)
protected

Used by KUniqueApplication

Definition at line 367 of file kapplication.cpp.

Member Function Documentation

QString KApplication::checkRecoverFile ( const QString &  pFilename,
bool &  bRecover 
)
static

Check whether an auto-save file exists for the document you want to open.

Parameters
pFilenameThe full path to the document you want to open.
bRecoverThis gets set to true if there was a recover file.
Returns
The full path of the file to open.

Definition at line 1017 of file kapplication.cpp.

void KApplication::clearStartupId ( )

Used only by KStartupId.

Definition at line 1102 of file kapplication.cpp.

void KApplication::commitData ( QSessionManager &  sm)

Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManager.

Definition at line 652 of file kapplication.cpp.

void KApplication::disableSessionManagement ( )

Disables session management for this application.

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

Definition at line 625 of file kapplication.cpp.

void KApplication::enableSessionManagement ( )

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

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

Definition at line 629 of file kapplication.cpp.

void KApplication::iceIOErrorHandler ( _IceConn *  conn)

Definition at line 445 of file kapplication.cpp.

void KApplication::installX11EventFilter ( QWidget *  filter)

Installs widget filter as global X11 event filter.

The widget filter receives XEvents in its standard QWidget::x11Event() function.

Warning: Only do this when absolutely necessary. An installed X11 filter can slow things down.

Definition at line 254 of file kapplication.cpp.

KApplication * KApplication::kApplication ( )
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 603 of file kapplication.cpp.

bool KApplication::notify ( QObject *  receiver,
QEvent *  event 
)

Definition at line 288 of file kapplication.cpp.

void KApplication::quit ( )
slot

Definition at line 620 of file kapplication.cpp.

void KApplication::removeX11EventFilter ( const QWidget *  filter)

Removes global X11 event filter previously installed by installX11EventFilter().

Definition at line 269 of file kapplication.cpp.

void KApplication::reparseConfiguration ( )
slot

Definition at line 615 of file kapplication.cpp.

void KApplication::saveState ( QSessionManager &  sm)

Reimplemented for internal purposes, mainly the highlevel handling of session management with KSessionManager.

Definition at line 735 of file kapplication.cpp.

void KApplication::saveYourself ( )
signal

Session management asks you to save the state of your application.

This signal is provided for compatibility only. For new applications, simply use KMainWindow. By reimplementing KMainWindow::queryClose(), KMainWindow::saveProperties() and KMainWindow::readProperties() you can simply handle session management for applications with multiple toplevel windows.

For purposes without KMainWindow, create an instance of KSessionManager and reimplement the functions KSessionManager::commitData() and/or KSessionManager::saveState()

If you still want to use this signal, here is what you should do:

Connect to this signal in order to save your data. Do NOT manipulate the UI in that slot, it is blocked by the session manager.

Use the sessionConfig() KConfig object to store all your instance specific data.

Do not do any closing at this point! The user may still select Cancel wanting to continue working with your application. Cleanups could be done after aboutToQuit().

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 608 of file kapplication.cpp.

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

Definition at line 814 of file kapplication.cpp.

void KApplication::setStartupId ( const QByteArray &  startup_id)

Sets a new value for the application startup notification window property for newly created toplevel windows.

Parameters
startup_idthe startup notification identifier
See also
KStartupInfo::setNewStartupId

Definition at line 1080 of file kapplication.cpp.

void KApplication::setSynchronizeClipboard ( bool  synchronize)

Sets how the primary and clipboard selections are synchronized in an X11 environment.

Definition at line 1151 of file kapplication.cpp.

void KApplication::setTopWidget ( QWidget *  topWidget)

Sets the top widget of the application.

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

Parameters
topWidgetA top widget of the application.
See also
icon(), caption()

Definition at line 1059 of file kapplication.cpp.

QByteArray KApplication::startupId ( ) const

Returns the app startup notification identifier for this running application.

Returns
the startup notification identifier

Definition at line 1075 of file kapplication.cpp.

QString KApplication::tempSaveName ( const QString &  pFilename)
static

Get a file name in order to make a temporary copy of your document.

Parameters
pFilenameThe full path to the current file of your document.
Returns
A new filename for auto-saving.
Deprecated:
use KTemporaryFile, KSaveFile or KAutoSaveFile instead

Definition at line 985 of file kapplication.cpp.

void KApplication::updateRemoteUserTimestamp ( const QString &  service,
int  time = 0 
)

Updates the last user action timestamp in the application registered to DBUS with id service to the given time, or to this application's user time, if 0 is given.

Use before causing user interaction in the remote application, e.g. invoking a dialog in the application using a DCOP call. Consult focus stealing prevention section in kdebase/kwin/README.

Definition at line 971 of file kapplication.cpp.

void KApplication::updateUserTimestamp ( int  time = 0)
slot

Updates the last user action timestamp to the given time, or to the current time, if 0 is given.

Do not use unless you're really sure what you're doing. Consult focus stealing prevention section in kdebase/kwin/README.

Definition at line 939 of file kapplication.cpp.

unsigned long KApplication::userTimestamp ( ) const

Returns the last user action timestamp or 0 if no user activity has taken place yet.

See also
updateuserTimestamp

Definition at line 962 of file kapplication.cpp.

bool KApplication::x11EventFilter ( XEvent *  _event)
protected

Used to catch X11 events.

Definition at line 925 of file kapplication.cpp.

int KApplication::xErrhandler ( Display *  dpy,
void *  err_ 
)

Definition at line 428 of file kapplication.cpp.

int KApplication::xioErrhandler ( Display *  dpy)

Definition at line 414 of file kapplication.cpp.

Member Data Documentation

KApplication * KApplication::KApp = 0L
staticprotected

Current application object.

Definition at line 468 of file kapplication.h.

bool KApplication::loadedByKdeinit = false
static

Definition at line 404 of file kapplication.h.


The documentation for this class was generated from the following files:
  • kapplication.h
  • kapplication.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2014 The KDE developers.
Generated on Tue Oct 14 2014 22:49:17 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Modules
  • Related Pages

kdelibs API Reference

Skip menu "kdelibs API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  • kjsembed
  •   WTF
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Nepomuk-Core
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal