← Back to branch summary

~ubuntu-branches/ubuntu/utopic/kde-workspace/utopic-proposed

« back to all changes in this revision

Viewing changes to kinfocenter/ToolTips/tooltipmanager.h

  • Committer: Bazaar Package Importer
  • Author(s): Michał Zając
  • Date: 2011-07-09 08:31:15 UTC
  • Revision ID: james.westby@ubuntu.com-20110709083115-ohyxn6z93mily9fc
Tags: upstream-4.6.90
Import upstream version 4.6.90

Show diffs side-by-side

added added

removed removed

Lines of Context:
kinfocenter/ToolTips/tooltipmanager.h
 
1
/*******************************************************************************
 
2
 *   Copyright (C) 2008 by Konstantin Heil <konst.heil@stud.uni-heidelberg.de> *
 
3
 *                                                                             *
 
4
 *   This program is free software; you can redistribute it and/or modify      *
 
5
 *   it under the terms of the GNU General Public License as published by      *
 
6
 *   the Free Software Foundation; either version 2 of the License, or         *
 
7
 *   (at your option) any later version.                                       *
 
8
 *                                                                             *
 
9
 *   This program 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             *
 
12
 *   GNU General Public License for more details.                              *
 
13
 *                                                                             *
 
14
 *   You should have received a copy of the GNU General Public License         *
 
15
 *   along with this program; if not, write to the                             *
 
16
 *   Free Software Foundation, Inc.,                                           *
 
17
 *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA                *
 
18
 *******************************************************************************/
 
19
 
 
20
#ifndef TOOLTIPMANAGER_H
 
21
#define TOOLTIPMANAGER_H
 
22
 
 
23
#include <QtCore/QObject>
 
24
 
 
25
#include <QtCore/QModelIndex>
 
26
 
 
27
class QLayout;
 
28
class QAbstractItemView;
 
29
 
 
30
/**
 
31
 * @brief Manages the tooltips for an item view.
 
32
 *
 
33
 * When hovering an item, a tooltip is shown after
 
34
 * a short timeout. The tooltip is hidden again when the
 
35
 * viewport is hovered or the item view has been left.
 
36
 */
 
37
class ToolTipManager : public QObject
 
38
{
 
39
    Q_OBJECT
 
40
 
 
41
public:
 
42
    /**
 
43
    * Standard constructor. The ToolTipManager will start handling ToolTip events on the provided
 
44
    * view immediately.
 
45
    *
 
46
    * @param parent The view which will have the tooltips displayed for.
 
47
    */
 
48
    explicit ToolTipManager(QAbstractItemView* parent);
 
49
    virtual ~ToolTipManager();
 
50
 
 
51
public Q_SLOTS:
 
52
    /**
 
53
     * Hides the currently shown tooltip. Invoking this method is
 
54
     * only needed when the tooltip should be hidden although
 
55
     * an item is hovered.
 
56
     */
 
57
    void hideToolTip();
 
58
 
 
59
protected:
 
60
    /**
 
61
    * Please see the Qt documentation for more details.
 
62
    *
 
63
    * @param watched The object that was being watched.
 
64
    * @param event The event object.
 
65
    * @returns true if the event was handled in this filter, or false if it was not.
 
66
    */
 
67
    virtual bool eventFilter( QObject* watched, QEvent* event );
 
68
 
 
69
private Q_SLOTS:
 
70
    void prepareToolTip();
 
71
    void requestToolTip(const QModelIndex& index);
 
72
 
 
73
private:
 
74
    void showToolTip( const QModelIndex& menuItem );
 
75
    QWidget * createTipContent( const QModelIndex& item );
 
76
    QLayout * generateToolTipLine( const QModelIndex& item, QWidget * toolTip, const QSize& iconSize, bool comment );
 
77
 
 
78
    class Private;
 
79
    ToolTipManager::Private* d;
 
80
};
 
81
 
 
82
#endif