blob: c662618ec5a32d8fe42c0f87b47c4463f89af081 (
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
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
|
/***************************************************************************
* Copyright (C) 2006 by Peter Penz *
* [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 BOOKMARKSELECTOR_H
#define BOOKMARKSELECTOR_H
#include <kbookmark.h>
#include <urlbutton.h>
class UrlNavigator;
class Q3PopupMenu;
class KUrl;
/**
* @brief Allows to select a bookmark from a popup menu.
*
* The icon from the current selected bookmark is shown
* inside the bookmark selector.
*
* @see UrlNavigator
* @author Peter Penz <[email protected]>
*/
class BookmarkSelector : public UrlButton
{
Q_OBJECT
public:
/**
* @param parent Parent widget where the bookmark selector
* is embedded into.
*/
BookmarkSelector(UrlNavigator* parent);
virtual ~BookmarkSelector();
/**
* Updates the selection dependent from the given Url \a url. The
* Url must not match exactly to one of the available bookmarks:
* The bookmark which is equal to the Url or at least is a parent Url
* is selected. If there are more than one possible parent Url candidates,
* the bookmark which covers the bigger range of the Url is selected.
*/
void updateSelection(const KUrl& url);
/**
* Returns the index of the selected bookmark. To get
* the bookmark, use BookmarkSelector::selectedBookmark().
*/
int selectedIndex() const { return m_selectedIndex; }
/** Returns the selected bookmark. */
KBookmark selectedBookmark() const;
/** @see QWidget::sizeHint() */
virtual QSize sizeHint() const;
signals:
/**
* Is send when a bookmark has been activated by the user.
* @param index Index of the selected bookmark.
*/
void bookmarkActivated(int index);
protected:
/**
* Draws the icon of the selected Url as content of the Url
* selector.
*/
virtual void paintEvent(QPaintEvent* event);
private slots:
/**
* Updates the selected index and the icon if a bookmark
* has been activated by the user.
*/
void slotBookmarkActivated(int index);
private:
int m_selectedIndex;
Q3PopupMenu* m_bookmarksMenu;
};
#endif
|
