apidox clarifications

svn path=/trunk/KDE/kdebase/workspace/libs/plasma/; revision=788145
This commit is contained in:
Aaron J. Seigo 2008-03-20 20:54:51 +00:00
parent 9d5aa89497
commit 5bd198db4a

View File

@ -120,8 +120,8 @@ class PLASMA_EXPORT DataEngine : public QObject
Plasma::IntervalAlignment intervalAlignment = NoAlignment) const; Plasma::IntervalAlignment intervalAlignment = NoAlignment) const;
/** /**
* Connects all sources to an object for data updates. The object must * Connects all currently existing sources to an object for data updates.
* have a slot with the following signature: * The object must have a slot with the following signature:
* *
* SLOT(dataUpdated(QString,Plasma::DataEngine::Data)) * SLOT(dataUpdated(QString,Plasma::DataEngine::Data))
* *
@ -131,6 +131,10 @@ class PLASMA_EXPORT DataEngine : public QObject
* This method may be called multiple times for the same visualization * This method may be called multiple times for the same visualization
* without side-effects. This can be useful to change the updateInterval. * without side-effects. This can be useful to change the updateInterval.
* *
* Note that this method does not automatically connect sources that
* may appear later on. Connecting and responding to the sourceAdded sigal
* is still required to achieve that.
*
* @param visualization the object to connect the data source to * @param visualization the object to connect the data source to
* @param updateInterval the frequency, in milliseconds, with which to signal updates; * @param updateInterval the frequency, in milliseconds, with which to signal updates;
* a value of 0 (the default) means to update only * a value of 0 (the default) means to update only
@ -140,7 +144,7 @@ class PLASMA_EXPORT DataEngine : public QObject
* per-visualization and can be handy for items that require * per-visualization and can be handy for items that require
* constant updates such as scrolling graphs or clocks. * constant updates such as scrolling graphs or clocks.
**/ **/
Q_INVOKABLE void connectAllSources(QObject* viualization, uint updateInterval = 0, Q_INVOKABLE void connectAllSources(QObject* visualization, uint updateInterval = 0,
Plasma::IntervalAlignment intervalAlignment = NoAlignment) const; Plasma::IntervalAlignment intervalAlignment = NoAlignment) const;
/** /**