You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
dolphin/src/bookmarkselector.h

100 lines
3.4 KiB

/***************************************************************************
* Copyright (C) 2006 by Peter Penz *
* peter.penz@gmx.at *
* *
* 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 TQPopupMenu;
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 <peter.penz@gmx.at>
*/
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;
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 drawButton(TQPainter* painter);
private slots:
/**
* Updates the selected index and the icon if a bookmark
* has been activated by the user.
*/
void slotBookmarkActivated(int index);
void updateBookmarks();
private:
int m_selectedIndex;
TQPopupMenu* m_bookmarksMenu;
};
#endif