KBookmarkMenu Class Reference
This class provides a bookmark menu. More...
#include <kbookmarkmenu.h>
Inheritance diagram for KBookmarkMenu:

Public Slots | |
void | slotBookmarksChanged (const QString &) |
Signals | |
void | aboutToShowContextMenu (const KBookmark &, QPopupMenu *) |
Public Member Functions | |
KBookmarkMenu (KBookmarkManager *mgr, KBookmarkOwner *owner, KPopupMenu *parentMenu, KActionCollection *collec, bool root, bool add=true, const QString &parentAddress="") | |
void | fillBookmarkMenu () |
void | ensureUpToDate () |
Static Public Member Functions | |
DynMenuInfo | showDynamicBookmarks (const QString &id) |
void | setDynamicBookmarks (const QString &id, const DynMenuInfo &info) |
QStringList | dynamicBookmarksList () |
Protected Slots | |
void | slotAboutToShow () |
void | slotAboutToShowContextMenu (KPopupMenu *, int, QPopupMenu *) |
void | slotActionHighlighted (KAction *) |
void | slotRMBActionRemove (int) |
void | slotRMBActionInsert (int) |
void | slotRMBActionCopyLocation (int) |
void | slotRMBActionEditAt (int) |
void | slotRMBActionProperties (int) |
void | slotBookmarkSelected () |
void | slotAddBookmarksList () |
void | slotAddBookmark () |
void | slotNewFolder () |
void | slotNSLoad () |
Protected Member Functions | |
KExtendedBookmarkOwner * | extOwner () |
void | refill () |
void | addAddBookmark () |
void | addAddBookmarksList () |
void | addEditBookmarks () |
void | addNewFolder () |
void | fillContextMenu (QPopupMenu *, const QString &, int) |
Protected Attributes | |
bool | m_bIsRoot:1 |
bool | m_bAddBookmark:1 |
bool | m_bDirty:1 |
bool | m_bNSBookmark:1 |
bool | m_bAddShortcuts:1 |
KBookmarkManager * | m_pManager |
KBookmarkOwner * | m_pOwner |
KPopupMenu * | m_parentMenu |
QPtrList< KBookmarkMenu > | m_lstSubMenus |
KActionCollection * | m_actionCollection |
QPtrList< KAction > | m_actions |
QString | m_parentAddress |
Static Protected Attributes | |
QString | s_highlightedAddress |
QString | s_highlightedImportLocation |
QString | s_highlightedImportType |
Detailed Description
This class provides a bookmark menu.It is typically used in cooperation with KActionMenu but doesn't have to be.
If you use this class by itself, then it will use KDE defaults for everything -- the bookmark path, bookmark editor, bookmark launcher.. everything. These defaults reside in the classes KBookmarkOwner (editing bookmarks) and KBookmarkManager (almost everything else). If you wish to change the defaults in any way, you must reimplement and instantiate those classes before this class is ever called.
Using this class is very simple:
1) Create a popup menu (either KActionMenu or KPopupMenu will do) 2) Instantiate a new KBookmarkMenu object using the above popup menu as a parameter 3) Insert your (now full) popup menu wherever you wish
Again, if you wish to modify any defaults, the procedure is:
1a) Reimplement your own KBookmarkOwner 1b) Reimplement and instantiate your own KBookmarkManager
Definition at line 78 of file kbookmarkmenu.h.
Constructor & Destructor Documentation
|
Fills a bookmark menu (one instance of KBookmarkMenu is created for the toplevel menu, but also one per submenu).
References QObject::connect(), KPopupMenu::contextMenu(), QObject::disconnect(), QString::isNull(), m_actions, m_lstSubMenus, m_parentAddress, m_parentMenu, QPtrList::setAutoDelete(), KActionCollection::setHighlightingEnabled(), and KPopupMenu::setKeyboardShortcutsEnabled(). Referenced by fillBookmarkMenu(). |
Member Function Documentation
|
Even if you think you need to use this, you are probably wrong. It fills a bookmark menu starting a given KBookmark. This is public for KBookmarkBar. Definition at line 560 of file kbookmarkmenu.cc. References QPtrList::append(), QValueList::begin(), QObject::connect(), dynamicBookmarksList(), QValueList::end(), QFile::exists(), KBookmarkManager::findByAddress(), KBookmarkGroup::first(), QPopupMenu::insertSeparator(), KBookmarkMenu(), KBookmarkMenu::DynMenuInfo::location, m_actions, m_lstSubMenus, m_parentAddress, m_parentMenu, KBookmarkMenu::DynMenuInfo::name, KBookmarkGroup::next(), KBookmarkManager::path(), KActionMenu::plug(), KActionMenu::popupMenu(), QString::replace(), QObject::setProperty(), KBookmarkMenu::DynMenuInfo::show, showDynamicBookmarks(), slotNSLoad(), KBookmarkMenu::DynMenuInfo::type, and KBookmarkManager::userBookmarksManager(). |
|
Call ensureUpToDate() if you need KBookmarkMenu to adjust to its final size before it is executed. Definition at line 158 of file kbookmarkmenu.cc. |
|
References KConfigBase::hasGroup(), KConfigBase::hasKey(), KBookmarkMenu::DynMenuInfo::location, KBookmarkMenu::DynMenuInfo::name, KConfigBase::readBoolEntry(), KConfigBase::readEntry(), KConfigBase::readPathEntry(), KBookmarkManager::root(), KConfigBase::setGroup(), KBookmarkMenu::DynMenuInfo::show, KBookmarkMenu::DynMenuInfo::type, and KBookmarkManager::userBookmarksManager(). Referenced by fillBookmarkMenu(), setDynamicBookmarks(), KBookmarkManager::setShowNSBookmarks(), and KBookmarkManager::showNSBookmarks(). |
|
Shows an extra menu for the given bookmarks file and type. Upgrades from option inside XBEL to option in rc file on first call of this function.
References KConfigBase::hasKey(), KBookmarkMenu::DynMenuInfo::location, KBookmarkMenu::DynMenuInfo::name, KConfigBase::readListEntry(), KConfigBase::setGroup(), KBookmarkMenu::DynMenuInfo::show, showDynamicBookmarks(), KConfigBase::sync(), KBookmarkMenu::DynMenuInfo::type, KConfigBase::writeEntry(), and KConfigBase::writePathEntry(). Referenced by KBookmarkManager::setShowNSBookmarks(). |
|
References KConfigBase::hasKey(), KConfigBase::readListEntry(), and KConfigBase::setGroup(). Referenced by fillBookmarkMenu(). |
|
load Netscape's bookmarks Definition at line 757 of file kbookmarkmenu.cc. References m_parentMenu, and KBookmarkMenuNSImporter::openBookmarks(). Referenced by fillBookmarkMenu(). |
Member Data Documentation
|
The menu in which we plug our actions. Supplied in the constructor. Definition at line 207 of file kbookmarkmenu.h. Referenced by fillBookmarkMenu(), KBookmarkMenu(), and slotNSLoad(). |
|
List of our sub menus. Definition at line 211 of file kbookmarkmenu.h. Referenced by fillBookmarkMenu(), and KBookmarkMenu(). |
|
List of our actions. Definition at line 216 of file kbookmarkmenu.h. Referenced by fillBookmarkMenu(), and KBookmarkMenu(). |
|
Parent bookmark for this menu. Definition at line 220 of file kbookmarkmenu.h. Referenced by fillBookmarkMenu(), and KBookmarkMenu(). |
The documentation for this class was generated from the following files: