blob: 334f25ba379c0004c1ca18d3c3e69cbe522bcdb8 (
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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/***************************************************************************
* 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 KMenu;
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
*/
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;
/**
* Returns the base bookmark for the URL \a url.
* The base bookmark is defined as bookmark which is equal to
* the URL or at least is a parent URL. If there are more than
* one possible parent URL candidates, the bookmark which covers
* the bigger range of the URL is returned.
*
* Example: the url is '/home/peter/Documents/Music. Available
* bookmarks are:
* - /home/peter
* - /home/peter/Documents
*
* The base URL will be '/home/peter/Documents'.
*/
static KBookmark baseBookmark(const KUrl& url);
signals:
/**
* Is send when a bookmark has been activated by the user.
* @param url URL of the selected bookmark.
*/
void bookmarkActivated(const KUrl& url);
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 to the bookmark
* which is indicated by the triggered action \a action.
*/
void activateBookmark(QAction* action);
private:
static int baseBookmarkIndex(const KUrl& url);
private:
int m_selectedIndex;
UrlNavigator* m_urlNavigator;
KMenu* m_bookmarksMenu;
};
#endif
|
