/* This file is part of the KDE project   Copyright (C) 1998, 1999 Torben Weis <weis@kde.org>   This library is free software; you can redistribute it and/or   modify it under the terms of the GNU Library General Public   License as published by the Free Software Foundation; either   version 2 of the License, or (at your option) any later version.   This library 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   Library General Public License for more details.   You should have received a copy of the GNU Library General Public License   along with this library; see the file COPYING.LIB.  If not, write to   the Free Software Foundation, Inc., 59 Temple Place - Suite 330,   Boston, MA 02111-1307, USA.*/#ifndef __kcelbookmarkmenu_h__#define __kcelbookmarkmenu_h__#include <qptrlist.h>#include <qptrstack.h>#include <qobject.h>#include <sys/types.h>#include "kbookmark.h"#include "kbookmarkmanager.h"class QString;class KBookmark;class KAction;class KActionMenu;class KActionCollection;class KCelBookmarkOwner;class KCelBookmarkMenu;class KPopupMenu;namespace KIO { class Job; }/**         This is straight from KDE code *          I just need special code to generate the Icon *          When a new bookmark is added * * 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 * @ref KBookmarkOwner (editing bookmarks) and @ref KBookmarkManager * (almost everything else).  If you wish to change the defaults in * any way, you must reimplement and instantiate those classes * <em>before</em> 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 */class KCelBookmarkMenu : public QObject{  Q_OBJECTpublic:  /**   * Fills a bookmark menu   * (one instance of KBookmarkMenu is created for the toplevel menu,   *  but also one per submenu).   *   * @param owner implementation of the KBookmarkOwner interface (callbacks)   * @param parentMenu menu to be filled   * @param collec parent collection for the KActions. Only used for other menus than the toplevel one.   * @param root true for the toplevel menu   * @param add true to show the "Add Bookmark" and "New Folder" entries   * @param parentAddress the address of the group containing the items   * that we want to show.   * @see KBookmark::address.   * Be careful :   * A _null_ parentAddress denotes a NS-bookmark menu.   * An _empty_ parentAddress denotes the toplevel bookmark menu   */  KCelBookmarkMenu( KBookmarkManager* mgr,                 KCelBookmarkOwner * owner, KPopupMenu * parentMenu,                 KActionCollection * collec, bool root, bool add = true,                 const QString & parentAddress = "" );  ~KCelBookmarkMenu();  /**   * 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.   */  void fillBookmarkMenu();  /**   * Call ensureUpToDate() if you need KBookmarkMenu to adjust to its final size before it is executed.   **/  void ensureUpToDate();public slots: // public for bookmark bar  void slotBookmarksChanged(const QString &);protected slots:  void slotAboutToShow();  void slotBookmarkSelected();  void slotAddBookmark();  void slotAddRelativeBookmark();  void slotAddSettingsBookmark();  void slotNewFolder();protected:  void refill();  void addAddBookmark();  void addAddRelativeBookmark();  void addAddSettingsBookmark();  void addEditBookmarks();  void addNewFolder();  bool m_bIsRoot:1;  bool m_bAddBookmark:1;  bool m_bDirty:1;  bool m_bNSBookmark:1;  KBookmarkManager* m_pManager;  KCelBookmarkOwner *m_pOwner;  /**   * The menu in which we plug our actions.   * Supplied in the constructor.   */  KPopupMenu * m_parentMenu;  /**   * List of our sub menus   */  QPtrList<KCelBookmarkMenu> m_lstSubMenus;  KActionCollection * m_actionCollection;  /**   * List of our actions.   */  QPtrList<KAction> m_actions;  /**   * Parent bookmark for this menu.   */  QString m_parentAddress;};#endif