KNotifyClient is the class for notifying the user when something special happened.
For example, if you are writing a KDE version of wget, the popular GNU utility to grab files off the Web, you would do this:
And with your program, you would install a file named eventsrc to $KDEDATADIR/APP/eventsrc ($KDEDIR/share/apps/APPNAME/eventsrc). Continuing with our example, you would use the following eventsrc:
The presentation and nopresentation fields are produced by adding:
nopresentation was originally created to prevent an infinite recursion situation with KWin calling KNotify, which opens a window, for which KWin calls KNotify. You should have very little need for it.
And the level field is produced by adding:
Logfile uses the key default_file, in the same format as default_sound.
Several systemwide handlers also exist, all defined in your own $KDEDIR/share/config directory: cannotopenfile, notification, warning, fatalerror, and catastrophe. A more complete list is availible in: KDEDIR/share/config/eventsrc
These can be called with