src/kiconcanvas.h

   1 /* vi: ts=8 sts=4 sw=4
   2  * kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;
   3  *
   4  * This file is part of the KDE project, module kfile.
   5  * Copyright (C) 2006 Luke Sandell <lasandell@gmail.com>
   6  *           (C) 2002 Carsten Pfeiffer <pfeiffer@kde.org>
   7  *           (C) 2000 Geert Jansen <jansen@kde.org>
   8  *           (C) 2000 Kurt Granroth <granroth@kde.org>
   9  *           (C) 1997 Christoph Neerfeld <chris@kde.org>
  10  *
  11  * This is free software; it comes under the GNU Library General
  12  * Public License, version 2. See the file "COPYING.LIB" for the
  13  * exact licensing terms.
  14  */
  15
  16 #ifndef _KICONCANVAS_H_
  17 #define _KICONCANVAS_H_
  18
  19 #include <qstring.h>
  20 #include <qstringlist.h>
  21 #include <kiconview.h>
  22
  23 class QTimer;
  24 class KIconLoader;
  25 class Q3DragObject;
  26 class QIconLoader;
  27
  28 /**
  29  * Icon canvas for KIconDialog.
  30  */
  31 class KIO_EXPORT KIconCanvas: public KIconView
  32 /* NOTE: Why export this? */
  33 {
  34     Q_OBJECT
  35
  36 public:
  37     KIconCanvas(QWidget *parent=0L, const char *name=0L);
  38     ~KIconCanvas();
  39
  40     /**
  41      * Load icons into the canvas.
  42      */
  43     void loadFiles(const QStringList& files);
  44
  45     /**
  46      * Returns the current icon.
  47      */
  48     QString getCurrent() const;
  49
  50     void setIconLoader(KIconLoader *loader);
  51
  52     void setGroupOrSize(int groupOrSize);
  53
  54     void setStrictIconSize(bool strictIconSize);
  55
  56 public slots:
  57     void stopLoading();
  58
  59 signals:
  60     /**
  61      * Emitted when the current icon has changed.
  62      */
  63     void nameChanged(QString);
  64     /* KDE 4: Make it const QString */
  65
  66     void startLoading(int);
  67     void progress(int);
  68     void finished();
  69
  70 private slots:
  71     void slotLoadFiles();
  72     void slotCurrentChanged(Q3IconViewItem *item);
  73
  74 private:
  75     QStringList mFiles;
  76     QTimer *mpTimer;
  77     KIconLoader *mpLoader;
  78
  79 protected:
  80     virtual void virtual_hook( int id, void* data );
  81     virtual Q3DragObject *dragObject();
  82     void loadIcon(const QString &path);
  83
  84 private:
  85     class KIconCanvasPrivate;
  86     KIconCanvasPrivate *d;
  87 };
  88
  89 #endif