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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
/***************************************************************************
smb4knetworkbrowser - The network browser widget of Smb4K.
-------------------
begin : Mo Jan 8 2007
copyright : (C) 2007 by Alexander Reinholdt
email : dustpuppy@users.berlios.de
***************************************************************************/
/***************************************************************************
* 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 SMB4KNETWORKBROWSER_H
#define SMB4KNETWORKBROWSER_H
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
// KDE includes
#include <klistview.h>
// forward declarations
class Smb4KNetworkBrowserItem;
class Smb4KNetworkBrowserToolTip;
class Smb4KNetworkBrowser : public KListView
{
Q_OBJECT
TQ_OBJECT
public:
/**
* The constructor
*
* @param parent The parent widget
*
* @param name The widget name
*/
Smb4KNetworkBrowser( TQWidget *parent = 0, const char *name = 0 );
/**
* The destructor
*/
~Smb4KNetworkBrowser();
/**
* Enumeration for the columns in the list view.
*/
enum Columns{ Network = 0, Type = 1, IP = 2, Comment = 3 };
/**
* Returns the global position of the mouse with respect
* to the viewport.
*
* @returns the position of the mouse.
*/
const TQPoint &mousePosition() { return m_pos; }
/**
* Returns a pointer to the current tool tip or NULL, if there
* is no tool tip at the moment. Please note, that the tool tip
* is generated 2 sec before it is shown.
*
* @returns a pointer to the current tool tip.
*/
Smb4KNetworkBrowserToolTip *tooltip() { return m_tooltip; }
/**
* Block the showing of tool tips. If @p block is set to TRUE, the
* current tool tip gets deleted (if there is one) and no tool tip
* will be shown until @p block is reset to FALSE.
*
* @param block Set this parameter to TRUE to block the showing
* of tool tips.
*/
void blockToolTips( bool block );
signals:
/**
* This signal is emitted when the tool tip is about to be shown.
*
* @param item The item for which the tool tip should be shown.
*/
void aboutToShowToolTip( Smb4KNetworkBrowserItem *item );
/**
* This signal is emitted when the tool tip has been closed.
*/
void closedToolTip();
protected:
/**
* Reimplemented from TQListView. This slot keeps track of the
* mouse position and handles the tool tips.
*
* @param e The mouse event
*/
void contentsMouseMoveEvent( TQMouseEvent *e );
protected slots:
/**
* This slot is called whenever a TQListViewItem is expanded or
* collapsed. At the moment it is only used to select the item.
*
* @param item The list view item that has been
* expanded/collapsed.
*/
void slotItemExpandedCollapsed( TQListViewItem *item );
/**
* This slot is called when the user executed an item. It is used
* to open the item if it is expandable.
*
* @param item The item that has been executed.
*/
void slotItemExecuted( TQListViewItem *item );
/**
* This slot shows the tool tip.
*/
void slotShowToolTip();
private:
/**
* The global position of the mouse with respect to the widget.
*/
TQPoint m_pos;
/**
* The tool tip for the network browser
*/
Smb4KNetworkBrowserToolTip *m_tooltip;
/**
* Block tool tips
*/
bool m_block_tooltip;
};
#endif
|
