Revision as of 14:47, 18 February 2013

Q_PROPERTIES

All qproperties and invokables must go

Enums

Type probably goes in plasma.h

       enum Type {
           NoContainmentType = -1,  /**< @internal */
           DesktopContainment = 0,  /**< A desktop containment */ New name -> suggestions [ Canvas ]
           PanelContainment,        /**< A desktop panel */
           CustomContainment = 127, /**< A containment that is neither a desktop nor a panel
                                       but something application specific */
          CustomPanelContainment = 128 /**< A customized desktop panel */
       };

ToolType goes in plasma.h it becomes ActionType (not related to toolbox anymore)

       enum ToolType {
           AddTool = 0,
           ConfigureTool = 100,
           ControlTool = 200,
           MiscTool = 300,
           DestructiveTool = 400,
           UserToolType = DestructiveTool + 1000
       };
       Q_ENUMS(ToolType)

Constructors

as

Status	Action	Method
DONE	Keep	explicit Containment(QObject *parent , const QString &serviceId , uint containmentId );
DONE	Keep	Containment(QObject *parent, const QVariantList &args);
DONE	Keep	~Containment();

Bookkeeping

as

Status	Action	Method
TO DO	Rename	Applet *addApplet(const QString &name, const QVariantList args, const QRectF geometry ; -> becomes createApplet, args and geometry arguments go away	<{{{3}}}>
TO DO	Paramenters	void addApplet(Applet *applet, const QPointF pos); -> pos parameter goes	<{{{3}}}>
DONE	Keep	QList<Applet *> applets() const;
TO DO	Remove	void clearApplets();	<{{{3}}}>
TO DO	Paramenters	void setScreen(int screen, int desktop); -> remove desktop	<{{{3}}}>
DONE	Keep	int screen() const;
TO DO	Remove	int lastScreen() const;	<{{{3}}}>
TO DO	Remove	int desktop() const;	<{{{3}}}>
TO DO	Remove	int lastDesktop() const;	<{{{3}}}>
TO DO	Remove	void addAssociatedWidget(QWidget *widget);	<{{{3}}}>
TO DO	Remove	void removeAssociatedWidget(QWidget *widget);	<{{{3}}}>
TO DO	Remove	bool drawWallpaper();	<{{{3}}}>
DONE	Keep	void setWallpaper(const QString &pluginName);
DONE	Keep	QString wallpaper() const;
DONE	Keep	void setActivity(const QString &activityId);
DONE	Keep	QString activity() const;

Actions

as

Status	Action	Method
DONE	Keep	void enableAction(const QString &name, bool enable);
TO DO	Remove	void addToolBoxAction(QAction *action);	<{{{3}}}>
TO DO	Remove	void removeToolBoxAction(QAction *action);	<{{{3}}}>

Containment Actions

as

Status	Action	Method
TO DO	Rename	void setContainmentActions(const QString &trigger, const QString &pluginName); -> Rename to addContainmentActions	<{{{3}}}> {{FeatureTodo \| Remove \| QString containmentActions(const QString &trigger); {{FeatureTodo \| Remove \| QStringList containmentActionsTriggers(); {{FeatureTodo \| Add \| QHash<QString, ContainmentsActions *> containmentActions() const;
TO DO	Remove	KConfigGroup containmentActionsConfig(); Remove after adding ContainmentActions::config()	<{{{3}}}>

Plugin loading

as

Status	Action	Method
TO DO	PluginLoader	static KPluginInfo::List listContainments(const QString &category, const QString &parentApp);	<{{{3}}}>
TO DO	PluginLoader	static KPluginInfo::List listContainmentsOfType(const QString &type, const QString &category , const QString &parentApp );	<{{{3}}}>
TO DO	PluginLoader	static QStringList listContainmentTypes();	<{{{3}}}>
TO DO	PluginLoader	static KPluginInfo::List listContainmentsForMimeType(const QString &mimeType);	<{{{3}}}>

Configuration

as

Status	Action	Method
DONE	Keep	void save(KConfigGroup &group) const;
DONE	Keep	void restore(KConfigGroup &group);
DONE	Keep	protected virtual void saveContents(KConfigGroup &group) const;
DONE	Keep	protected virtual void restoreContents(KConfigGroup &group);

UI specific stuff

UI specific things don't belong to this library

as

Status	Action	Method
TO DO	Remove	void showContextMenu(const QPointF &containmentPos, const QPoint &screenPos);	<{{{3}}}>
TO DO	Remove	virtual void showDropZone(const QPoint pos);	<{{{3}}}>
TO DO	Remove	void contextMenuEvent(QContextMenuEvent *event);	<{{{3}}}>
TO DO	Remove	void wheelEvent(QWheelEvent *event);	<{{{3}}}>
TO DO	Remove	signal void toolBoxToggled();	<{{{3}}}>
TO DO	Remove	signal void toolBoxVisibilityChanged(bool);	<{{{3}}}>

@@ Line 24: / Line 24: @@
          };
          Q_ENUMS(ToolType)
+= Constructors =
+{| cellspacing="0" cellpadding="5" border="1" style="border: 1px solid gray; border-collapse: collapse; text-align: left; width: 100%;" class="sortable"
+|- style="background: rgb(236, 236, 236) none repeat scroll 0% 0%; -moz-background-clip: border; -moz-background-origin: padding; -moz-background-inline-policy: continuous; white-space: nowrap;"
+as
+! Status
+! Action
+! Method
+{{FeatureDone|Keep|explicit Containment(QObject *parent , const QString &serviceId , uint containmentId );}}
+{{FeatureDone|Keep|Containment(QObject *parent, const QVariantList &args);}}
+{{FeatureDone|Keep|~Containment();}}
+|}
 = Bookkeeping =
@@ Line 68: / Line 83: @@
 |}
-= Constructors =
+=Containment Actions=
 {| cellspacing="0" cellpadding="5" border="1" style="border: 1px solid gray; border-collapse: collapse; text-align: left; width: 100%;" class="sortable"
@@ Line 77: / Line 92: @@
 ! Method
-{{FeatureDone|Keep|explicit Containment(QObject *parent , const QString &serviceId , uint containmentId );}}
+{{FeatureTodo | Rename |  void setContainmentActions(const QString &trigger, const QString &pluginName); -> Rename to addContainmentActions }}
-{{FeatureDone|Keep|Containment(QObject *parent, const QVariantList &args);}}
+{{FeatureTodo | Remove | QString containmentActions(const QString &trigger);
-{{FeatureDone|Keep|~Containment();}}
+{{FeatureTodo | Remove | QStringList containmentActionsTriggers();
+{{FeatureTodo | Add |  QHash<QString, ContainmentsActions *> containmentActions() const;
+{{FeatureTodo | Remove | KConfigGroup containmentActionsConfig(); Remove after adding ContainmentActions::config()}}
 |}