class KNotifyDialog

# class KNotifyDialog | KNotifyDialog presents an interface for configuring an application's KNotify events. More...
Definition | `#include <knotifydialog.h>`
Inherits | KDialogBase (kdeui) [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

#### Public Methods

- KNotifyDialog ( QWidget *parent = 0, const char *name = 0, bool modal = true, const KAboutData *aboutData = KGlobal::instance()->aboutData() )
- virtual ~KNotifyDialog ()
- virtual void addApplicationEvents ( const char *appName )
- virtual void addApplicationEvents ( const QString& path )
- virtual void clearApplicationEvents ()

#### Public Static Methods

- static int configure ( QWidget *parent = 0, const char *name = 0, const KAboutData *aboutData = KGlobal::instance()->aboutData() )

## Detailed Description

KNotifyDialog presents an interface for configuring an application's KNotify events.

Rather than requiring the user to wade through the entire list of applications' events in KControl, your application can make the list of its own notifications available here.

Typical usage is calling the static configure() method:

     (void) KNotifyDialog::configure( someParentWidget );

KNotifyDialog ( QWidget *parent = 0, const char *name = 0, bool modal = true, const KAboutData *aboutData = KGlobal::instance()->aboutData() ) | ### KNotifyDialog

If you want a non-modal dialog, you need to instantiate KNotifyDialog yourself instead of using the configure() method.

Parameters:

parent | The parent widget for the dialog
name | The widget name
modal | If true, this will be a modal dialog, otherwise non-modal.
aboutData | A pointer to a KAboutData object. KAboutData::appName() will be used to find the KNotify events (in the eventsrc file). Set this to 0L if you want to add all events yourself with addApplicationEvents().

~KNotifyDialog () | ### ~KNotifyDialog

[virtual]

Destroys the KNotifyDialog

int configure ( QWidget *parent = 0, const char *name = 0, const KAboutData *aboutData = KGlobal::instance()->aboutData() ) | ### configure

[static]

Convenience method to create exec() a modal KNotifyDialog.

Parameters:

parent | The parent widget for the dialog
name | The widget name
aboutData | A pointer to a KAboutData object. KAboutData::appName() will be used to find the KNotify events (in the eventsrc file).

Returns: The value of QDialog::exec()

See also: exec, for, the, return, values.

void addApplicationEvents ( const char *appName ) | ### addApplicationEvents

[virtual]

With this method, you can add the KNotify events of one eventsrc files to the view. KNotifyDialog can handle events for multiple applications (i.e. eventsrc files). Successive calls with a different `appName` will add them.

Parameters:

appName | The application's name, i.e. the name passed to the KApplication constructor or KAboutData.

See also: clearApplicationEvents()

void addApplicationEvents ( const QString& path ) | ### addApplicationEvents

[virtual]

With this method, you can add the KNotify events of one eventsrc files to the view. KNotifyDialog can handle events for multiple applications (i.e. eventsrc files). Successive calls with a different `path` will add them.

Parameters:

path | The absolute or relative path to the eventsrc file to be configured. A relative path would be e.g. "kwin/eventsrc".

See also: clearApplicationEvents()

void clearApplicationEvents () | ### clearApplicationEvents

[virtual]

Removes all the events added with addApplicationEvents()

See also: addApplicationEvents()

- Author: Carsten Pfeiffer
- Generated: root on macppc.ports.openbsd.org on Sat Sep 6 10:37:17 2003, using kdoc 2.0a54.