Rename all the URL navigator related classes to prepare their migration

in kdelibs.

svn path=/trunk/KDE/kdebase/apps/; revision=649514

1 files changed, 99 insertions, 0 deletions

diff --git a/src/kfileplacesselector_p.h b/src/kfileplacesselector_p.h
new file mode 100644
index 000000000..1efe9bb4e
--- /dev/null
+++ b/src/kfileplacesselector_p.h
@@ -0,0 +1,99 @@
+/***************************************************************************
+ *   Copyright (C) 2006 by Peter Penz ([email protected])                  *
+ *   Copyright (C) 2007 by Kevin Ottens ([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 KFILEPLACESSELECTOR_P_H
+#define KFILEPLACESSELECTOR_P_H
+
+#include "kurlbutton_p.h"
+#include <kurl.h>
+
+class KFilePlacesModel;
+class KUrlNavigator;
+class KMenu;
+
+/**
+ * @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 KFilePlacesSelector : public KUrlButton
+{
+    Q_OBJECT
+
+public:
+    /**
+     * @param parent Parent widget where the bookmark selector
+     *               is embedded into.
+     */
+    KFilePlacesSelector(KUrlNavigator* parent, KFilePlacesModel* placesModel);
+
+    virtual ~KFilePlacesSelector();
+
+    /**
+     * 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 selected bookmark. */
+    KUrl selectedPlaceUrl() const;
+    /** Returns the selected bookmark. */
+    QString selectedPlaceText() const;
+
+    /** @see QWidget::sizeHint() */
+    virtual QSize sizeHint() const;
+
+signals:
+    /**
+     * Is send when a bookmark has been activated by the user.
+     * @param url URL of the selected place.
+     */
+    void placeActivated(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 activatePlace(QAction* action);
+
+    void updateMenu();
+
+private:
+    int m_selectedItem;
+    KUrlNavigator* m_urlNavigator;
+    KMenu* m_placesMenu;
+    KFilePlacesModel* m_placesModel;
+};
+
+#endif