1 files changed, 106 insertions, 0 deletions
diff --git a/src/views/tooltips/tooltipmanager.h b/src/views/tooltips/tooltipmanager.h
new file mode 100644
index 000000000..24e72f28b
--- /dev/null
+++ b/src/views/tooltips/tooltipmanager.h
@@ -0,0 +1,106 @@
+/*******************************************************************************
+ *   Copyright (C) 2008 by Konstantin Heil <[email protected]> *
+ *                                                                             *
+ *   This program is free software; you can redistribute it and/or modify      *
+ *   it under the terms of the GNU General Public License as published by      *
+ *   the Free Software Foundation; either version 2 of the License, or         *
+ *   (at your option) any later version.                                       *
+ *                                                                             *
+ *   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 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 TOOLTIPMANAGER_H
+#define TOOLTIPMANAGER_H
+
+#include <QObject>
+#include <QRect>
+
+#include <kfileitem.h>
+
+class DolphinModel;
+class DolphinSortFilterProxyModel;
+class FileMetaDataToolTip;
+class QAbstractItemView;
+class QModelIndex;
+class QTimer;
+
+/**
+ * @brief Manages the tooltips for an item view.
+ *
+ * When hovering an item, a tooltip is shown after
+ * a short timeout. The tooltip is hidden again when the
+ * viewport is hovered or the item view has been left.
+ */
+class ToolTipManager : public QObject
+{
+    Q_OBJECT
+
+public:
+    explicit ToolTipManager(QAbstractItemView* parent,
+                            DolphinSortFilterProxyModel* model);
+    virtual ~ToolTipManager();
+
+public slots:
+    /**
+     * Hides the currently shown tooltip. Invoking this method is
+     * only needed when the tooltip should be hidden although
+     * an item is hovered.
+     */
+    void hideTip();
+
+protected:
+    virtual bool eventFilter(QObject* watched, QEvent* event);
+
+private slots:
+    void requestToolTip(const QModelIndex& index);
+    void hideToolTip();
+    void prepareToolTip();
+    void startPreviewJob();
+    void setPreviewPix(const KFileItem& item, const QPixmap& pix);
+    void previewFailed();
+    void showToolTip();
+    
+private:
+    void showToolTipDelayed(const QPixmap& pixmap);
+
+private:
+    QAbstractItemView* m_view;
+    DolphinModel* m_dolphinModel;
+    DolphinSortFilterProxyModel* m_proxyModel;
+
+    /// Timeout from requesting a tooltip until the tooltip is shown
+    QTimer* m_prepareToolTipTimer;
+    
+    /// Timeout from requesting a tooltip until starting a job to
+    /// create a preview pixmap. The preview job is started before
+    /// m_prepareToolTipTimer has been exceeded, to have the preview
+    /// pixmap ideally before the tooltip will be shown.
+    QTimer* m_startPreviewJobTimer;
+    
+    /// Don't show the tooltip, before the preview has been received. The
+    /// time indicates the interval, when the check for a received
+    /// is done.
+    QTimer* m_waitOnPreviewTimer;
+    
+    /// The tooltip is shown slightly delayed to prevent a flickering
+    /// because of layouting the content.
+    QTimer* m_showToolTipDelayedTimer;
+
+    FileMetaDataToolTip* m_fileMetaDataToolTip;
+
+    KFileItem m_item;
+    QRect m_itemRect;
+    bool m_generatingPreview;
+    bool m_hasDefaultIcon;
+    QPixmap m_previewPixmap;
+};
+
+#endif