kde-workspace/plasma/desktop/shell/activitymanager/activitymanager.h
2014-11-13 19:30:51 +02:00

117 lines
3.9 KiB
C++

/*
* Copyright 2010 by Chani Armitage <chani@kde.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU Library/Lesser General Public License
* version 2, or (at your option) any later version, as published by the
* Free Software Foundation
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details
*
* You should have received a copy of the GNU Library/Lesser General Public
* License along with this program; if not, write to the
* Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef ACTIVITYMANAGER_H
#define ACTIVITYMANAGER_H
#include <QGraphicsWidget>
#include <Plasma/Plasma>
namespace Plasma
{
class Corona;
class Containment;
}
class ActivityManagerPrivate;
class ActivityManager : public QGraphicsWidget
{
Q_OBJECT
/**
* list of all activity creation actions (ie new desktop, new search and launch, etc)
*/
Q_PROPERTY(QList<QVariant> activityTypeActions READ activityTypeActions NOTIFY activityTypeActionsChanged)
/**
* Plasma location of the panel containment the controller is associated to
*/
Q_PROPERTY(Location location READ location NOTIFY locationChanged)
Q_ENUMS(Location)
/**
* Orientation the controller will be disaplayed, depends from location
*/
Q_PROPERTY(Qt::Orientation orientation READ orientation NOTIFY orientationChanged)
Q_PROPERTY(bool canAddActivities READ canAddActivities CONSTANT)
Q_PROPERTY(bool canAddWidgets READ canAddWidgets CONSTANT)
public:
/**
* The Location enumeration describes where on screen an element, such as an
* Applet or its managing container, is positioned on the screen.
**/
enum Location {
Floating = 0, /**< Free floating. Neither geometry or z-ordering
is described precisely by this value. */
Desktop, /**< On the planar desktop layer, extending across
the full screen from edge to edge */
FullScreen, /**< Full screen */
TopEdge, /**< Along the top of the screen*/
BottomEdge, /**< Along the bottom of the screen*/
LeftEdge, /**< Along the left side of the screen */
RightEdge /**< Along the right side of the screen */
};
explicit ActivityManager(Plasma::Location loc, QGraphicsItem *parent=0);
ActivityManager(QGraphicsItem *parent=0);
~ActivityManager();
/**
* Changes the current containment
* you've got to call this at least once so that it can access the corona
* FIXME if you can use scene() as corona, get rid of this
*/
void setContainment(Plasma::Containment *containment);
void setLocation(Plasma::Location loc);
//FIXME: it's asymmetric due to the problems of QML of exporting enums
ActivityManager::Location location();
Qt::Orientation orientation() const;
QList<QVariant> activityTypeActions();
Q_INVOKABLE QPixmap pixmapForActivity(const QString &activityId);
Q_INVOKABLE void cloneCurrentActivity();
Q_INVOKABLE void createActivity(const QString &pluginName);
Q_INVOKABLE void createActivityFromScript(const QString &script, const QString &name, const QString &icon, const QStringList &startupApps);
Q_INVOKABLE void downloadActivityScripts();
Q_INVOKABLE QString chooseIcon() const;
bool canAddActivities() const;
bool canAddWidgets() const;
Q_SIGNALS:
void locationChanged(Plasma::Location loc);
void orientationChanged();
void closeClicked();
void addWidgetsRequested();
void activityTypeActionsChanged();
private:
Q_PRIVATE_SLOT(d, void containmentDestroyed())
ActivityManagerPrivate * const d;
friend class ActivityManagerPrivate;
};
#endif