org.kde.koala

Interface KApplicationSignals

public interface KApplicationSignals

Method Summary
voidappearanceChanged()
Emitted when KApplication has changed either its GUI style, its font or its palette in response to a kdisplay request.
voidbackgroundChanged(int desk)
Emitted when the desktop background has been changed by kcmdisplay.
voidiconChanged(int group)
Emitted when the global icon settings have been changed.
voidkdisplayFontChanged()
Emitted when KApplication has changed its font in response to a KControl request.
voidkdisplayPaletteChanged()
Emitted when KApplication has changed its palette due to a KControl request.
voidkdisplayStyleChanged()
Emitted when KApplication has changed its GUI style in response to a KControl request.
voidkipcMessage(int id, int data)
Emitted when a KIPC user message has been received.
voidsaveYourself()
Session management asks you to save the state of your application.
voidsettingsChanged(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
voidshutDown()
Your application is killed.
voidtoolbarAppearanceChanged(int arg1)
Emitted when the settings for toolbars have been changed.

Method Detail

appearanceChanged

public 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.

backgroundChanged

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

Parameters: desk The desktop whose background has changed.

UNKNOWN: Emitted when the desktop background has been changed by kcmdisplay.

iconChanged

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

Parameters: group the new group

UNKNOWN: Emitted when the global icon settings have been changed.

kdisplayFontChanged

public 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.

UNKNOWN: Emitted when KApplication has changed its font in response to a KControl request.

kdisplayPaletteChanged

public 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.

UNKNOWN: Emitted when KApplication has changed its palette due to a KControl request.

kdisplayStyleChanged

public 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.

UNKNOWN: Emitted when KApplication has changed its GUI style in response to a KControl request.

kipcMessage

public 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 KApplicationSignals KApplicationSignals

UNKNOWN: Emitted when a KIPC user message has been received.

saveYourself

public 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).

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

settingsChanged

public 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

UNKNOWN: 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

shutDown

public 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.

UNKNOWN: Your application is killed.

toolbarAppearanceChanged

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

UNKNOWN: Emitted when the settings for toolbars have been changed.