org.kde.koala
Interface KApplicationSignals


public interface KApplicationSignals


Method Summary
 void appearanceChanged()
          Emitted when KApplication has changed either its GUI style, its font or its palette in response to a kdisplay request.
 void backgroundChanged(int desk)
          Emitted when the desktop background has been changed by kcmdisplay.
 void iconChanged(int group)
          Emitted when the global icon settings have been changed.
 void kdisplayFontChanged()
          Emitted when KApplication has changed its font in response to a KControl request.
 void kdisplayPaletteChanged()
          Emitted when KApplication has changed its palette due to a KControl request.
 void kdisplayStyleChanged()
          Emitted when KApplication has changed its GUI style in response to a KControl request.
 void kipcMessage(int id, int data)
          Emitted when a KIPC user message has been received.
 void saveYourself()
          Session management asks you to save the state of your application.
 void settingsChanged(int category)
          Emitted when the global settings have been changed - see KGlobalSettings KApplication takes care of calling reparseConfiguration on KGlobal.config() so that applications/classes using this only have to re-read the configuration
 void shutDown()
          Your application is killed.
 void toolbarAppearanceChanged(int arg1)
          Emitted when the settings for toolbars have been changed.
 

Method Detail

kdisplayPaletteChanged

void kdisplayPaletteChanged()
Emitted when KApplication has changed its palette due to a KControl request. Normally, widgets will update their palette automatically, but you should connect to this to program special behavior.


kdisplayStyleChanged

void kdisplayStyleChanged()
Emitted when KApplication has changed its GUI style in response to a KControl request. Normally, widgets will update their styles automatically (as they would respond to an explicit setGUIStyle() call), but you should connect to this to program special behavior.


kdisplayFontChanged

void kdisplayFontChanged()
Emitted when KApplication has changed its font in response to a KControl request. Normally widgets will update their fonts automatically, but you should connect to this to monitor global font changes, especially if you are using explicit fonts. Note: If you derive from a QWidget-based class, a faster method is to reimplement QWidget.fontChange(). This is the preferred way to get informed about font updates.


appearanceChanged

void appearanceChanged()
Emitted when KApplication has changed either its GUI style, its font or its palette in response to a kdisplay request. Normally, widgets will update their styles automatically, but you should connect to this to program special behavior. @short Emitted when KApplication has changed either its GUI style, its font or its palette in response to a kdisplay request.


toolbarAppearanceChanged

void toolbarAppearanceChanged(int arg1)
Emitted when the settings for toolbars have been changed. KToolBar will know what to do.


backgroundChanged

void backgroundChanged(int desk)
Emitted when the desktop background has been changed by kcmdisplay.

Parameters:
desk - The desktop whose background has changed.

settingsChanged

void settingsChanged(int category)
Emitted when the global settings have been changed - see KGlobalSettings KApplication takes care of calling reparseConfiguration on KGlobal.config() so that applications/classes using this only have to re-read the configuration

Parameters:
category - the category among the enum above

iconChanged

void iconChanged(int group)
Emitted when the global icon settings have been changed.

Parameters:
group - the new group

kipcMessage

void kipcMessage(int id,
                 int data)
Emitted when a KIPC user message has been received.

Parameters:
id - the message id
data - the data
See Also:
KIPC, KIPC#Message, #addKipcEventMask, #removeKipcEventMask

saveYourself

void saveYourself()
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 KSessionManaged and reimplement the functions KSessionManaged.commitData() and/or KSessionManaged.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 shutDown() (see the following).


shutDown

void shutDown()
Your application is killed. Either by your program itself, xkill or (the usual case) by KDE's logout. The signal is particularly useful if your application has to do some last-second cleanups. Note that no user interaction is possible at this state.