org.kde.koala

Class KIPC

public class KIPC extends Object implements QtSupport

This class implements a very simple IPC mechanism for KDE. You can send a message of a predefined type to either a specific application, or to all KDE application on the current display. The message can carry one integer of data. KIPC is mainly used in KDE for sending "Change Messages", i.e. a message to all KDE apps that a certain setting (the font, for example) has changed. For anything more complex it is recommended to use DCOP -- the Desktop Communications Protocol. Messages with id code < 32 are called "System Messages". These are directly handled by KApplication. Examples are: PaletteChanged and StyleChanged. Messages with id code >= 32 are user messages. KApplication emits the signal kipcMessage(id,arg) for each user message it receives. KIPC is implemented using X11 ClientMessage events.

Author: Geert Jansen

See Also: KApplication

UNKNOWN: This class implements a very simple IPC mechanism for KDE.

Field Summary
static intBackgroundChanged
static intBlockShortcuts
static intClipboardConfigChanged
static intFontChanged
static intIconChanged
static intPaletteChanged
A identifier for messages.
static intSettingsChanged
static intStyleChanged
static intToolbarStyleChanged
static intUserMessage
Constructor Summary
protected KIPC(Class dummy)
KIPC()
Method Summary
voiddispose()
Delete the wrapped C++ instance ahead of finalize()
protected voidfinalize()
Deletes the wrapped C++ instance
booleanisDisposed()
Has the wrapped C++ instance been deleted?
static voidsendMessage(int msg, long w, int data)
Send a message to a specific application.
static voidsendMessage(int msg, long w)
static voidsendMessageAll(int msg, int data)
Send a message to all KDE application on the current display.
static voidsendMessageAll(int msg)

Field Detail

BackgroundChanged

public static final int BackgroundChanged

BlockShortcuts

public static final int BlockShortcuts

ClipboardConfigChanged

public static final int ClipboardConfigChanged

FontChanged

public static final int FontChanged

IconChanged

public static final int IconChanged

PaletteChanged

public static final int PaletteChanged
A identifier for messages. Messages below UserMessage are system messages, messages above can be defined by the user.

UNKNOWN: A identifier for messages.

SettingsChanged

public static final int SettingsChanged

StyleChanged

public static final int StyleChanged

ToolbarStyleChanged

public static final int ToolbarStyleChanged

UserMessage

public static final int UserMessage

Constructor Detail

KIPC

protected KIPC(Class dummy)

KIPC

public KIPC()

Method Detail

dispose

public void dispose()
Delete the wrapped C++ instance ahead of finalize()

finalize

protected void finalize()
Deletes the wrapped C++ instance

isDisposed

public boolean isDisposed()
Has the wrapped C++ instance been deleted?

sendMessage

public static void sendMessage(int msg, long w, int data)
Send a message to a specific application.

Parameters: msg The message to send. w The window id of a toplevel window of the target application. data An optional integer of data.

UNKNOWN: Send a message to a specific application.

sendMessage

public static void sendMessage(int msg, long w)

sendMessageAll

public static void sendMessageAll(int msg, int data)
Send a message to all KDE application on the current display.

Parameters: msg The message to send. data An optional integer of data.

UNKNOWN: Send a message to all KDE application on the current display.

sendMessageAll

public static void sendMessageAll(int msg)