┌   ┐
54
└   ┘

summaryrefslogtreecommitdiff
path: root/src/tooltips/tooltipmanager.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/tooltips/tooltipmanager.h')
-rw-r--r--src/tooltips/tooltipmanager.h91
1 files changed, 91 insertions, 0 deletions
diff --git a/src/tooltips/tooltipmanager.h b/src/tooltips/tooltipmanager.h
new file mode 100644
index 000000000..96df4819e
--- /dev/null
+++ b/src/tooltips/tooltipmanager.h
@@ -0,0 +1,91 @@
+/*******************************************************************************
+ * 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 QAbstractItemView;
+class QModelIndex;
+class QTimer;
+class KToolTipItem;
+
+/**
+ * @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(const KFileItem& item);
+
+private:
+ void showToolTip(KToolTipItem* tip);
+
+ QAbstractItemView* m_view;
+ DolphinModel* m_dolphinModel;
+ DolphinSortFilterProxyModel* m_proxyModel;
+
+ QTimer* m_timer;
+ QTimer* m_previewTimer;
+ QTimer* m_waitOnPreviewTimer;
+ KFileItem m_item;
+ QRect m_itemRect;
+ bool m_preview;
+ bool m_generatingPreview;
+ bool m_previewIsLate;
+ int m_previewPass;
+ KToolTipItem* m_emptyRenderedKToolTipItem;
+ QPixmap m_pix;
+
+};
+
+#endif