summaryrefslogtreecommitdiffstats
path: root/src/knemod/interfacetooltip.h
blob: 7c4dbd9ed4c989c70d8c735a3f1a4f849fbdaa85 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
/* This file is part of KNemo
   Copyright (C) 2004 Percy Leonhardt <percy@eris23.de>

   KNemo is free software; you can redistribute it and/or modify
   it under the terms of the GNU Library General Public License as
   published by the Free Software Foundation; either version 2 of
   the License, or (at your option) any later version.

   KNemo 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 Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/

#ifndef INTERFACETOOLTIP_H
#define INTERFACETOOLTIP_H

#include <qpair.h>
#include <qtooltip.h>

class Interface;

/**
 * This call is responsible for displaying the tooltip of an
 * interface icon. It is derived from QToolTip and overwrites
 * the function maybeTip(const QPoint & p) to update the tooltip
 * text just before it is going to be displayed.
 *
 * @short Display tooltip according to user settings
 * @author Percy Leonhardt <percy@eris23.de>
 */

class InterfaceToolTip : public QToolTip
{
public:
    /**
     * Default Constructor
     */
    InterfaceToolTip( Interface* interface, QWidget* parent = 0L );

    /**
     * Default Destructor
     */
    virtual ~InterfaceToolTip();

    /**
     * From the Qt documentation:
     * It is called when there is a possibility that a tool tip should
     * be shown and must decide whether there is a tool tip for the point p
     * in the widget that this QToolTip object relates to. If so, maybeTip()
     * must call tip() with the rectangle the tip applies to, the tip's text
     * and optionally the QToolTipGroup details and the geometry in screen
     * coordinates.
     */
    void maybeTip( const QPoint& );

private:
    void setupText( QString& text );
    void setupToolTipArray();

    // the interface this tooltip belongs to
    Interface* mInterface;
    // the tooltip text for each information
    QPair<QString, int> mToolTips[25];
};

#endif // INTERFACETOOLTIP_H