class KIPC

This class implements a very simple IPC mechanism for KDE. More...

Definition#include <kipc.h>
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Static Methods


Detailed Description

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.

enum Message { PaletteChanged=0, FontChanged, StyleChanged, BackgroundChanged, SettingsChanged, IconChanged, ToolbarStyleChanged, UserMessage=32 }

Message

void  sendMessage (Message msg, WId w, int data=0)

sendMessage

[static]

Send a message to a specific application.

Parameters:
msgThe message to send.
wThe window id of a toplevel window of the target application.
dataAn optional integer of data.

void  sendMessageAll (Message msg, int data=0)

sendMessageAll

[static]

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

Parameters:
msgThe message to send.
dataAn optional integer of data.