]> cloud.milkyroute.net Git - dolphin.git/blobdiff - src/panels/folders/folderspanel.h
Add clang-format and format code as in Frameworks
[dolphin.git] / src / panels / folders / folderspanel.h
index 14d8e8782d88f0571b987829f34d0c87bd8c7d7d..1a482436a80e3e63ae62813ffdc51bfe0bf5cb7a 100644 (file)
@@ -1,32 +1,20 @@
-/***************************************************************************
- *   Copyright (C) 2006 by Peter Penz <peter.penz19@gmail.com>             *
- *                                                                         *
- *   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            *
- ***************************************************************************/
+/*
+ * SPDX-FileCopyrightText: 2006 Peter Penz <peter.penz19@gmail.com>
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later
+ */
 
 #ifndef FOLDERSPANEL_H
 #define FOLDERSPANEL_H
 
-#include <KUrl>
-#include <panels/panel.h>
+#include "panels/panel.h"
+
+#include <QUrl>
 
 class KFileItemModel;
 class KItemListController;
 class QGraphicsSceneDragDropEvent;
-
+class KFileItem;
 /**
  * @brief Shows a tree view of the directories starting from
  *        the currently selected place.
@@ -39,39 +27,42 @@ class FoldersPanel : public Panel
     Q_OBJECT
 
 public:
-    FoldersPanel(QWidget* parent = 0);
-    virtual ~FoldersPanel();
+    explicit FoldersPanel(QWidget *parent = nullptr);
+    ~FoldersPanel() override;
 
     void setShowHiddenFiles(bool show);
+    void setLimitFoldersPanelToHome(bool enable);
     bool showHiddenFiles() const;
+    bool limitFoldersPanelToHome() const;
 
     void setAutoScrolling(bool enable);
     bool autoScrolling() const;
 
-    void rename(const KFileItemitem);
+    void rename(const KFileItem &item);
 
-signals:
-    void folderActivated(const KUrl& url);
-    void folderMiddleClicked(const KUrl& url);
-    void errorMessage(const QString& error);
+Q_SIGNALS:
+    void folderActivated(const QUrl &url);
+    void folderInNewTab(const QUrl &url);
+    void folderInNewActiveTab(const QUrl &url);
+    void errorMessage(const QString &error);
 
 protected:
     /** @see Panel::urlChanged() */
-    virtual bool urlChanged();
+    bool urlChanged() override;
 
     /** @see QWidget::showEvent() */
-    virtual void showEvent(QShowEvent* event);
+    void showEvent(QShowEvent *event) override;
 
     /** @see QWidget::keyPressEvent() */
-    virtual void keyPressEvent(QKeyEvent* event);
+    void keyPressEvent(QKeyEvent *event) override;
 
-private slots:
+private Q_SLOTS:
     void slotItemActivated(int index);
     void slotItemMiddleClicked(int index);
-    void slotItemContextMenuRequested(int index, const QPointFpos);
-    void slotViewContextMenuRequested(const QPointFpos);
-    void slotItemDropEvent(int index, QGraphicsSceneDragDropEventevent);
-    void slotRoleEditingFinished(int index, const QByteArray& role, const QVariant& value);
+    void slotItemContextMenuRequested(int index, const QPointF &pos);
+    void slotViewContextMenuRequested(const QPointF &pos);
+    void slotItemDropEvent(int index, QGraphicsSceneDragDropEvent *event);
+    void slotRoleEditingFinished(int index, const QByteArray &role, const QVariant &value);
 
     void slotLoadingCompleted();
 
@@ -82,12 +73,22 @@ private slots:
     void startFadeInAnimation();
 
 private:
+    /**
+     * Indicate if it is allowed to leave current location.
+     */
+    enum NavigationBehaviour {
+        StayWhereYouAre, ///< Don't leave current location.
+        AllowJumpHome ///< Go Home only when context menu option got checked.
+    };
     /**
      * Initializes the base URL of the tree and expands all
      * directories until \a url.
      * @param url  URL of the leaf directory that should get expanded.
+     * @param navigationBehaviour Navigation behaviour \see NavigationBehaviour
      */
-    void loadTree(const KUrl& url);
+    void loadTree(const QUrl &url, NavigationBehaviour navigationBehaviour = StayWhereYouAre);
+
+    void reloadTree();
 
     /**
      * Sets the item with the index \a index as current item, selects
@@ -97,8 +98,8 @@ private:
 
 private:
     bool m_updateCurrentItem;
-    KItemListControllerm_controller;
-    KFileItemModelm_model;
+    KItemListController *m_controller;
+    KFileItemModel *m_model;
 };
 
 #endif // FOLDERSPANEL_H