src/dolphintabwidget.h

   1 /***************************************************************************
   2  * Copyright (C) 2014 by Emmanuel Pescosta <emmanuelpescosta099@gmail.com> *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program; if not, write to the                         *
  16  *   Free Software Foundation, Inc.,                                       *
  17  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  18  ***************************************************************************/
  19
  20 #ifndef DOLPHIN_TAB_WIDGET_H
  21 #define DOLPHIN_TAB_WIDGET_H
  22
  23 #include <QTabWidget>
  24 #include <QUrl>
  25
  26 class DolphinViewContainer;
  27 class DolphinTabPage;
  28 class KConfigGroup;
  29
  30 class DolphinTabWidget : public QTabWidget
  31 {
  32     Q_OBJECT
  33
  34 public:
  35     /**
  36      * @brief Controls where tabs are placed
  37      */
  38     enum TabPlacement {
  39         /**
  40           * The new tab is placed after the current tab
  41           */
  42         AfterCurrentTab,
  43         /**
  44           * The new tab is placed after the last tab
  45           */
  46         AfterLastTab
  47     };
  48     explicit DolphinTabWidget(QWidget* parent);
  49
  50     /**
  51      * @return Tab page at the current index (can be 0 if tabs count is smaller than 1)
  52      */
  53     DolphinTabPage* currentTabPage() const;
  54
  55     /**
  56      * @return the next tab page. If the current active tab is the last tab,
  57      * it returns the first tab. If there is only one tab, returns nullptr
  58      */
  59     DolphinTabPage* nextTabPage() const;
  60
  61     /**
  62      * @return the previous tab page. If the current active tab is the first tab,
  63      * it returns the last tab. If there is only one tab, returns nullptr
  64      */
  65     DolphinTabPage* prevTabPage() const;
  66
  67     /**
  68      * @return Tab page at the given \a index (can be 0 if the index is out-of-range)
  69      */
  70     DolphinTabPage* tabPageAt(const int index) const;
  71
  72     void saveProperties(KConfigGroup& group) const;
  73     void readProperties(const KConfigGroup& group);
  74
  75     /**
  76      * Refreshes the views of the main window by recreating them according to
  77      * the given Dolphin settings.
  78      */
  79     void refreshViews();
  80
  81     /**
  82      * @return Whether any of the tab pages contains @p url in their primary
  83      * or secondary view.
  84      */
  85     bool isUrlOpen(const QUrl& url) const;
  86
  87 signals:
  88     /**
  89      * Is emitted when the active view has been changed, by changing the current
  90      * tab or by activating another view when split view is enabled in the current
  91      * tab.
  92      */
  93     void activeViewChanged(DolphinViewContainer* viewContainer);
  94
  95     /**
  96      * Is emitted when the number of open tabs has changed (e.g. by opening or
  97      * closing a tab)
  98      */
  99     void tabCountChanged(int count);
 100
 101     /**
 102      * Is emitted when a tab has been closed.
 103      */
 104     void rememberClosedTab(const QUrl& url, const QByteArray& state);
 105
 106     /**
 107      * Is emitted when the url of the current tab has been changed. This signal
 108      * is also emitted when the active view has been changed.
 109      */
 110     void currentUrlChanged(const QUrl& url);
 111
 112 public slots:
 113     /**
 114      * Opens a new view with the current URL that is part of a tab and activates
 115      * the tab.
 116      */
 117     void openNewActivatedTab();
 118
 119     /**
 120      * Opens a new tab showing the  URL \a primaryUrl and the optional URL
 121      * \a secondaryUrl and activates the tab.
 122      */
 123     void openNewActivatedTab(const QUrl& primaryUrl, const QUrl& secondaryUrl = QUrl());
 124
 125     /**
 126      * Opens a new tab in the background showing the URL \a primaryUrl and the
 127      * optional URL \a secondaryUrl. \a tabPlacement controls where the new tab
 128      * is placed.
 129      */
 130     void openNewTab(const QUrl &primaryUrl, const QUrl &secondaryUrl = QUrl(),
 131                     DolphinTabWidget::TabPlacement tabPlacement = AfterLastTab);
 132
 133     /**
 134      * Opens each directory in \p dirs in a separate tab. If \a splitView is set,
 135      * 2 directories are collected within one tab.
 136      * \pre \a dirs must contain at least one url.
 137      */
 138     void openDirectories(const QList<QUrl>& dirs, bool splitView);
 139
 140     /**
 141      * Opens the directories which contain the files \p files and selects all files.
 142      * If \a splitView is set, 2 directories are collected within one tab.
 143      * \pre \a files must contain at least one url.
 144      */
 145     void openFiles(const QList<QUrl> &files, bool splitView);
 146
 147     /**
 148      * Closes the currently active tab.
 149      */
 150     void closeTab();
 151
 152     /**
 153      * Closes the tab with the index \a index and activates the tab with index - 1.
 154      */
 155     void closeTab(const int index);
 156
 157     /**
 158      * Activates the tab with the index \a index.
 159      */
 160     void activateTab(const int index);
 161
 162     /**
 163      * Activates the last tab in the tab bar.
 164      */
 165     void activateLastTab();
 166
 167     /**
 168      * Activates the next tab in the tab bar.
 169      * If the current active tab is the last tab, it activates the first tab.
 170      */
 171     void activateNextTab();
 172
 173     /**
 174      * Activates the previous tab in the tab bar.
 175      * If the current active tab is the first tab, it activates the last tab.
 176      */
 177     void activatePrevTab();
 178
 179     /**
 180      * Is invoked if the Places panel got visible/invisible and takes care
 181      * that the places-selector of all views is only shown if the Places panel
 182      * is invisible.
 183      */
 184     void slotPlacesPanelVisibilityChanged(bool visible);
 185
 186     /**
 187      * Is called when the user wants to reopen a previously closed tab from
 188      * the recent tabs menu.
 189      */
 190     void restoreClosedTab(const QByteArray& state);
 191
 192     /** Copies all selected items to the inactive view. */
 193     void copyToInactiveSplitView();
 194
 195     /** Moves all selected items to the inactive view. */
 196     void moveToInactiveSplitView();
 197
 198 private slots:
 199     /**
 200      * Opens the tab with the index \a index in a new Dolphin instance and closes
 201      * this tab.
 202      */
 203     void detachTab(int index);
 204
 205     /**
 206      * Opens a new tab showing the url from tab at the given \a index and
 207      * activates the tab.
 208      */
 209     void openNewActivatedTab(int index);
 210
 211     /**
 212      * Is connected to the KTabBar signal receivedDropEvent.
 213      * Allows dragging and dropping files onto tabs.
 214      */
 215     void tabDropEvent(int tab, QDropEvent* event);
 216
 217     /**
 218      * The active view url of a tab has been changed so update the text and the
 219      * icon of the corresponding tab.
 220      */
 221     void tabUrlChanged(const QUrl& url);
 222
 223     void currentTabChanged(int index);
 224
 225 protected:
 226     void tabInserted(int index) override;
 227     void tabRemoved(int index) override;
 228
 229 private:
 230     /**
 231      * @param tabPage The tab page to get the name of
 232      * @return The name of the tab page
 233      */
 234     QString tabName(DolphinTabPage* tabPage) const;
 235
 236     /**
 237      * @param url The URL that we would like
 238      * @return a QPair with first containing the index of the tab with the
 239      * desired URL or -1 if not found. Second says true if URL is in primary
 240      * view container, false otherwise. False means the URL is in the secondary
 241      * view container, unless first == -1. In that case the value of second
 242      * is meaningless.
 243      */
 244     QPair<int, bool> indexByUrl(const QUrl& url) const;
 245
 246 private:
 247     /** Caches the (negated) places panel visibility */
 248     bool m_placesSelectorVisible;
 249
 250     int m_lastViewedTab;
 251 };
 252
 253 #endif