workspace/plasma/applets/kickoff/core/recentlyusedmodel.h

   1 /*
   2     Copyright 2007 Robert Knight <robertknight@gmail.com>
   3
   4     This library is free software; you can redistribute it and/or
   5     modify it under the terms of the GNU Library General Public
   6     License as published by the Free Software Foundation; either
   7     version 2 of the License, or (at your option) any later version.
   8
   9     This library is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12     Library General Public License for more details.
  13
  14     You should have received a copy of the GNU Library General Public License
  15     along with this library; see the file COPYING.LIB.  If not, write to
  16     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17     Boston, MA 02110-1301, USA.
  18 */
  19
  20 #ifndef RECENTLYUSEDMODEL_H
  21 #define RECENTLYUSEDMODEL_H
  22
  23 // Qt
  24 #include "core/kickoff_export.h"
  25 #include "core/kickoffmodel.h"
  26
  27 // KDE
  28 #include <KService>
  29
  30 namespace Kickoff
  31 {
  32
  33 /**
  34  * Model for the Recently Used view which provides a tree of recently used
  35  * applications and documents.
  36  */
  37 class KICKOFF_EXPORT RecentlyUsedModel : public KickoffModel
  38 {
  39     Q_OBJECT
  40
  41 public:
  42
  43     /** Defines what the model should display. */
  44     enum RecentType {
  45         DocumentsAndApplications, ///< display recently used documents and applications.
  46         DocumentsOnly, ///< documents only. recently used applications will not be displayed.
  47         ApplicationsOnly ///< applications only, recently used documents will not be displayed.
  48     };
  49
  50     /** Construct a new RecentlyUsedModel with the specified parent. */
  51     explicit RecentlyUsedModel(QObject *parent = 0, RecentType recenttype = DocumentsAndApplications, int maxRecentApps = -1);
  52     virtual ~RecentlyUsedModel();
  53
  54 public Q_SLOTS:
  55     void clearRecentApplications();
  56     void clearRecentDocuments();
  57     void clearRecentDocumentsAndApplications();
  58
  59 private Q_SLOTS:
  60     void recentDocumentAdded(const QString& path);
  61     void recentDocumentRemoved(const QString& path);
  62     void recentApplicationAdded(KService::Ptr, int startCount);
  63     void recentApplicationRemoved(KService::Ptr);
  64     void recentApplicationsCleared();
  65
  66 private:
  67     class Private;
  68     Private * const d;
  69 };
  70
  71 }
  72
  73 #endif // RECENTLYUSEDMODEL_H