workspace/plasma/applets/quicklaunch/quicklaunchApplet.h

   1 /***************************************************************************
   2  *   Copyright (C) 2008 by Lukas Appelhans                                 *
   3  *   l.appelhans@gmx.de                                                    *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.          *
  19  ***************************************************************************/
  20 #ifndef QUICKLAUNCHAPPLET_H
  21 #define QUICKLAUNCHAPPLET_H
  22
  23 #include <plasma/applet.h>
  24 #include <plasma/widgets/iconwidget.h>
  25 #include <QGraphicsLinearLayout>
  26 #include <QGraphicsGridLayout>
  27 #include <QGraphicsLayoutItem>
  28 #include <QList>
  29 #include <KIcon>
  30 #include <KDialog>
  31
  32 #include "ui_quicklaunchConfig.h"
  33 #include "ui_quicklaunchAdd.h"
  34
  35 #include "quicklaunchIcon.h"
  36
  37 namespace Plasma
  38 {
  39     class Dialog;
  40 }
  41
  42 class QuicklaunchLayout : public QGraphicsGridLayout
  43 {
  44     public:
  45         QuicklaunchLayout(QGraphicsLayoutItem *parent, int rowCount)
  46          : QGraphicsGridLayout(parent), m_rowCount(rowCount)
  47         {}
  48         void setRowCount(int rowCount) { m_rowCount = rowCount; }
  49         void addItem(Plasma::IconWidget *icon) {
  50             //kDebug() << "Row count is" << rowCount() << "Wanted row count is" << m_rowCount;
  51             //int row = m_rowCount == rowCount() || rowCount() == -1 ? 0 : rowCount();
  52             //int column = m_rowCount == rowCount()  || columnCount() == 0 ? columnCount() : columnCount() - 1;
  53             //kDebug() << "Adding icon to row = " << row << ", column = " << column;
  54             int row = 0;
  55             int column = 0;
  56             while (itemAt(row, column))
  57             {
  58                 kDebug() << "Row is" << row << "column is" << column;
  59                 if (row < m_rowCount - 1) {
  60                     row++;
  61                 }
  62                 else {
  63                     kDebug() << "column++";
  64                     row = 0;
  65                     column++;
  66                 }
  67             }
  68             QGraphicsGridLayout::addItem(icon, row, column);
  69         }
  70         QSizeF sizeHint(Qt::SizeHint which, const QSizeF & constraint = QSizeF()) const
  71         {
  72             if (which == Qt::PreferredSize) {
  73                 return QSizeF(columnCount() * geometry().height() / m_rowCount, QGraphicsGridLayout::sizeHint(which, constraint).height());
  74             }
  75             return QGraphicsGridLayout::sizeHint(which, constraint);
  76         }
  77     private:
  78         int m_rowCount;
  79 };
  80
  81 class QuicklaunchApplet : public Plasma::Applet
  82 {
  83     Q_OBJECT
  84     public:
  85         QuicklaunchApplet(QObject *parent, const QVariantList &args);
  86         ~QuicklaunchApplet();
  87
  88         /**
  89          * Returns hints about the geometry of the figure
  90          * @return Hints about proportionality of the applet
  91          */
  92         QSizeF sizeHint(Qt::SizeHint which, const QSizeF & constraint = QSizeF()) const;
  93
  94         /**
  95          * Returns info about if we want to expand or not
  96          * For now, we never need to expand
  97          */
  98         Qt::Orientations expandingDirections() const { return 0; }
  99
 100         /**
 101          * List of actions to add in context menu
 102          * @return List of QAction pointers
 103          */
 104         virtual QList<QAction*> contextActions(QuicklaunchIcon *icon = 0);
 105
 106     public slots:
 107         void createConfigurationInterface(KConfigDialog *parent);
 108         /**
 109          * Slot for showing the Add Icon interface
 110          */
 111         void showAddInterface();
 112
 113     protected:
 114         /**
 115          * Overloaded method to save the state on exit
 116          */
 117         void saveState(KConfigGroup &config) const;
 118
 119         virtual bool eventFilter(QObject * object, QEvent * event);
 120
 121         /**
 122          * Overloaded drag enter event listener
 123          * Check if the dragged item is valid
 124          */
 125         void dragEnterEvent(QGraphicsSceneDragDropEvent *event);
 126
 127         /**
 128          * Overloaded drag move event listener
 129          * Listens for drag moves
 130          */
 131         void dragMoveEvent(QGraphicsSceneDragDropEvent *event);
 132
 133         /**
 134          * Overloaded drop event listener
 135          * Determines if a dropped item is valid Url, and if so
 136          * add the icon to the applet
 137          */
 138         void dropEvent(QGraphicsSceneDragDropEvent *event);
 139
 140         /**
 141          * Called when something in the geometry has changed
 142          */
 143         void constraintsEvent(Plasma::Constraints constraints);
 144
 145     protected slots:
 146         /**
 147          * Called when the user has clicked OK in the Add Icon interface
 148          */
 149         void addAccepted();
 150
 151         /**
 152          * Called when the user has clicked OK or apply in the Config interface
 153          */
 154         void configAccepted();
 155
 156     private slots:
 157         void refactorUi();
 158         void showDialog();
 159         void removeCurrentIcon();
 160
 161     private:
 162         void init();
 163
 164         /**
 165          * Read a Url, and insert at the given position
 166          * @param index The position to insert the icon into
 167          * @param desktopFile The Url to read
 168          */
 169         void addProgram(int index, const QString &desktopFile);
 170
 171         /**
 172          * Read all Urls from a list, and insert into icon list
 173          * @param desktopFiles List with Urls
 174          */
 175         void loadPrograms(const QStringList &desktopFiles);
 176
 177         /**
 178          * Removes all items from a BoxLayout
 179          * @param layout Layout to clear
 180          */
 181         void clearLayout(QGraphicsLayout *layout);
 182
 183         /**
 184          * Saves icons into plasma applet config file
 185          */
 186         void saveConfig() {}
 187
 188         bool dropHandler(const int pos, const QMimeData *mimedata);
 189
 190         QGraphicsLinearLayout *m_layout;
 191         QuicklaunchLayout *m_innerLayout;
 192         QList<QuicklaunchIcon*> m_icons;
 193         Plasma::IconWidget *m_arrow;
 194         int m_visibleIcons;
 195         int m_rowCount;
 196         int m_dialogRowCount;
 197         Plasma::Dialog *m_dialog;
 198         QGraphicsWidget * m_dialogWidget;
 199         QuicklaunchLayout *m_dialogLayout;
 200         KDialog *m_addDialog;
 201         Ui::quicklaunchConfig uiConfig;
 202         Ui::quicklaunchAdd addUi;
 203         QuicklaunchIcon *m_rightClickedIcon;
 204         QPointF m_mousePressPos;
 205
 206         QAction* m_addAction;
 207         QAction* m_removeAction;
 208 };
 209
 210 #endif