kpilot/lib

ConduitConfigBase Class Reference

#include <plugin.h>

List of all members.


Detailed Description

The first classe here: ConduitConfigBase is for configuration purposes.

ConduitConfigBase: this is an object (with a widget!) that is embedded in a dialog. This is the currently preferred form for configuration, and it's what is used in the KPilot conduit configuration dialog. The factory is asked for a "ConduitConfigBase" object.

NB. The reason that this is a QObject which needs to create a separate widget - instead of a QWidget subclass - has to do with layouting. If you make the widget with designer then the easiest thing to do is to use a grid layout there. Making ConduitConfigBase a QWidget subclass would require an additional layout here, which seems a little foolish.

Definition at line 66 of file plugin.h.


Signals

void changed (bool)

Public Member Functions

 ConduitConfigBase (QWidget *parent=0L, const char *n=0L)
virtual ~ConduitConfigBase ()
virtual bool isModified () const
QWidget * widget () const
virtual void commit ()=0
virtual void load ()=0
virtual bool maybeSave ()
QString conduitName () const

Protected Slots

void modified ()

Protected Member Functions

virtual QString maybeSaveText () const
void unmodified ()

Protected Attributes

bool fModified
QWidget * fWidget
QString fConduitName

Member Function Documentation

virtual bool ConduitConfigBase::isModified (  )  const [inline, virtual]

This function is called to check whether the configuration of the conduit has changed -- and hence, whether the user needs to be prompted.

By default, this just returns fModified, but you can do more complicated things.

Definition at line 79 of file plugin.h.

virtual void ConduitConfigBase::commit (  )  [pure virtual]

Load or save the config widget's settings in the given KConfig object; leave the group unchanged.

load() and commit() should both call unmodified() to indicate that the current settings match the on-disk ones.

bool ConduitConfigBase::maybeSave (  )  [virtual]

Called when the object is to be hidden again and might need to save changed settings.

Should prompt the user and call commit() if needed. Override this function only if you need a very different kind of prompt window.

Returns false if the change is to be canceled. Returns true otherwise, whether or not the changes were saved.

Definition at line 83 of file plugin.cc.

QString ConduitConfigBase::maybeSaveText (  )  const [protected, virtual]

This function provides the string for the prompt used in maybeSave().

Override it to change the text.

Definition at line 75 of file plugin.cc.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys