alecs/plasma-framework
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

apidox clarifications

Browse Source 
svn path=/trunk/KDE/kdebase/workspace/libs/plasma/; revision=820958
This commit is contained in:
Aaron J. Seigo 2008-06-15 21:47:25 +00:00
parent d03c0f5eb6
commit a69ce2c265
1 changed files with 21 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
applet.h
View File

@ -121,12 +121,24 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
KConfigGroup config(const QString &group) const; KConfigGroup config(const QString &group) const;
/** /**
* Saves state information about this applet. * Saves state information about this applet that will
* be accessed when next instantiated in the restore(KConfigGroup&) method.
*
* This method does not need to be reimplmented by Applet
* subclasses, but can be useful for Applet specializations
* (such as Containment) to do so.
*
* Applet subclasses may instead want to reimplement saveState().
**/ **/
virtual void save(KConfigGroup &group) const; virtual void save(KConfigGroup &group) const;
/** /**
* Restores state information about this applet. * Restores state information about this applet saved previously
* in save(KConfigGroup&).
*
* This method does not need to be reimplmented by Applet
* subclasses, but can be useful for Applet specializations
* (such as Containment) to do so.
**/ **/
virtual void restore(KConfigGroup &group); virtual void restore(KConfigGroup &group);
@ -579,8 +591,13 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
void setFailedToLaunch(bool failed, const QString& reason = QString()); void setFailedToLaunch(bool failed, const QString& reason = QString());
/** /**
* Called when a request to save the state of the applet is made * When called, the Applet should write any information needed as part
* during runtime * of the Applet's running state to the configuration object in config()
* and/or globalConfig().
*
* Applets that always sync their settings/state with the config
* objects when these settings/states change do not need to reimplement
* this method.
**/ **/
virtual void saveState(KConfigGroup &config) const; virtual void saveState(KConfigGroup &config) const;