|
|
This namespace provides a method for issuing events to a KNotifyServer call KNotifyClient::event("eventname"); to issue it. On installation, there should be a file called $KDEDIR/share/apps/appname/eventsrc which contains the events.
The file looks like this:
[!Global!] IconName=Filename (e.g. kdesktop, without any extension) Comment=FriendlyNameOfApp [eventname] Name=FriendlyNameOfEvent Comment=Description Of Event default_sound=filetoplay.wav default_presentation=1 ... |
default_presentation contains these ORed events: None=0, Sound=1, Messagebox=2, Logfile=4, Stderr=8
You can also use the "nopresentation" key, with any the presentations ORed. Those that are in that field will not appear in the kcontrol module. This was intended for software like KWin to not allow a window-opening that opens a window (e.g., allowing to disable KMessageBoxes from appearing) If the user edits the eventsrc file manually, it will appear. This only affects the KcmNotify.
You can also use the following events, which are system controlled and do not need to be placed in your eventsrc:
| Instance (class) | Instance |
Makes it possible to use KNotifyClient with a KInstance that is not the application.
Use like this:
KNotifyClient::Instance(myInstance); KNotifyClient::event("MyEvent"); |
| enum { Default=-1, None=0, Sound=1, Messagebox=2, Logfile=4, Stderr=8 } |
| enum { Notification=1, Warning=2, Error=4, Catastrophe=8 } |
| enum StandardEvent { cannotOpenFile, notification, warning, fatalError, catastrophe } | StandardEvent |
default events you can use
| bool startDaemon ()
| startDaemon |
This starts the KNotify Daemon, if it's not already started. This will be useful for games that use sound effects. Run this at the start of the program, and there won't be a pause when it is first triggered.
Returns: true if daemon is running (always true at the moment)
| bool event (const QString &message, const QString &text=QString::null)
| event |
This should be the most used method in here. Call it by KNotifyClient::event("EventName"); It will use KApplication::kApplication->dcopClient() to communicate to the server
Parameters:
| message | The name of the event |
| text | The text to put in a dialog box. This won't be shown if the user connected the event to sound, only. |
| bool event ( StandardEvent event, const QString& text=QString::null )
| event |
Allows to easily emit standard events.
Parameters:
| event | The event you want to raise. |
| text | The text explaining the event you raise. |
| bool userEvent (const QString &text=QString::null, int present=Default, int level=Default,
const QString &sound=QString::null, const QString &file=QString::null)
| userEvent |
Will fire an event that's not registered.
Parameters:
| text | The error message text, if applicable |
| present | The error message level, defaulting to "Default" |
| file | The sound file to play if selected with present |
| void beep (const QString& reason=QString::null)
| beep |
This is a simple substitution for QApplication::beep(). It simply calls
KNotifyClient::event( KNotifyClient::notification, reason ); |
| int getPresentation (const QString &eventname)
| getPresentation |
Gets the presentation associated with a certain event name Remeber that they may be ORed: if (present & KNotifyClient::Sound) { [Yes, sound is a default] }
| QString getFile (const QString &eventname, int present)
| getFile |
Gets the default file associated with a certain event name The control panel module will list all the event names This has the potential for being slow.
| int getDefaultPresentation (const QString &eventname)
| getDefaultPresentation |
Gets the default presentation for the event of this program. Remember that the Presentation may be ORed. Try this: if (present & KNotifyClient::Sound) { [Yes, sound is a default] }
| QString getDefaultFile (const QString &eventname, int present)
| getDefaultFile |
Gets the default File for the event of this program. It gets it in relation to present. Some events don't apply to this function ("Message Box") Some do (Sound)
| KInstance * instance ()
| instance |
Shortcut to KNotifyClient::Instance::current() :)
Returns: the current KInstance.