/***************************************************************************
- * Copyright (C) 2006 by Peter Penz <peter.penz@gmx.at> *
+ * Copyright (C) 2006 by Peter Penz <peter.penz19@gmail.com> *
* Copyright (C) 2006 by Stefan Monov <logixoul@gmail.com> *
* Copyright (C) 2006 by Cvetoslav Ludmiloff <ludmiloff@gmail.com> *
* *
#ifndef DOLPHIN_MAINWINDOW_H
#define DOLPHIN_MAINWINDOW_H
-#include "dolphinview.h"
#include "panels/panel.h"
#include <config-nepomuk.h>
-#include <kfileitemdelegate.h>
+#include <KFileItemDelegate>
#include <kio/fileundomanager.h>
#include <ksortablelist.h>
#include <kxmlguiwindow.h>
-#include <kactionmenu.h>
+#include <KActionMenu>
-#include <QtCore/QList>
+#include "views/dolphinview.h"
+
+#include <QList>
typedef KIO::FileUndoManager::CommandType CommandType;
class KAction;
class DolphinViewActionHandler;
class DolphinApplication;
-class DolphinSearchBox;
class DolphinSettingsDialog;
class DolphinViewContainer;
-class KNewMenu;
+class DolphinRemoteEncoding;
+class KNewFileMenu;
class KTabBar;
class KUrl;
-class QDropEvent;
class QSplitter;
+class KJob;
/**
* @short Main window for Dolphin.
*/
DolphinViewContainer* activeViewContainer() const;
+ /**
+ * Opens each directory in \p dirs in a separate tab. If the "split view"
+ * option is enabled, 2 directories are collected within one tab.
+ */
+ void openDirectories(const QList<KUrl>& dirs);
+
+ /**
+ * Opens the directory which contains the files \p files
+ * and selects all files (implements the --select option
+ * of Dolphin).
+ */
+ void openFiles(const QList<KUrl>& files);
+
/**
* Returns true, if the main window contains two instances
* of a view container. The active view constainer can be
*/
bool isSplit() const;
- /**
- * If the main window contains two instances of a view container
- * (DolphinMainWindow::isSplit() returns true), then the
- * two views get toggled (the right view is on the left, the left
- * view on the right).
- */
- void toggleViews();
-
/** Renames the item represented by \a oldUrl to \a newUrl. */
void rename(const KUrl& oldUrl, const KUrl& newUrl);
/**
- * Refreshes the views of the main window by recreating them dependent from
+ * Refreshes the views of the main window by recreating them according to
* the given Dolphin settings.
*/
void refreshViews();
* Returns the 'Create New...' sub menu which also can be shared
* with other menus (e. g. a context menu).
*/
- KNewMenu* newMenu() const;
+ KNewFileMenu* newFileMenu() const;
/**
* Returns the 'Show Menubar' action which can be shared with
int getId() const;
/**
+ * Implementation of the MainWindowAdaptor/QDBusAbstractAdaptor interface.
* Inform all affected dolphin components (panels, views) of an URL
* change.
*/
void changeUrl(const KUrl& url);
- /**
- * Inform all affected dolphin components that a selection change is
- * requested.
- */
- void changeSelection(const KFileItemList& selection);
-
/** Stores all settings and quits Dolphin. */
void quit();
void requestItemInfo(const KFileItem& item);
protected:
+ /** @see QWidget::showEvent() */
+ virtual void showEvent(QShowEvent* event);
+
/** @see QMainWindow::closeEvent() */
virtual void closeEvent(QCloseEvent* event);
/** Updates the 'Create New...' sub menu. */
void updateNewMenu();
+ void createDirectory();
+
/** Shows the error message in the status bar of the active view. */
void showErrorMessage(const QString& message);
/**
* Updates the state of the 'Undo' menu action dependent
- * from the parameter \a available.
+ * on the parameter \a available.
*/
void slotUndoAvailable(bool available);
/**
* Copies all selected items to the clipboard and marks
- * the items as cutted.
+ * the items as cut.
*/
void cut();
/** Pastes the clipboard data to the active view. */
void paste();
+ /** Replaces the URL navigator by a search box to find files. */
+ void find();
+
/**
- * Updates the text of the paste action dependent from
+ * Updates the text of the paste action dependent on
* the number of items which are in the clipboard.
*/
void updatePasteAction();
/**
* Switches between one and two views:
* If one view is visible, it will get split into two views.
- * If already two views are visible, the nonactivated view gets closed.
+ * If already two views are visible, the active view gets closed.
*/
void toggleSplitView();
- /** Reloads the current active view. */
+ /** Reloads the currently active view. */
void reloadView();
- /** Stops the loading process for the current active view. */
+ /** Stops the loading process for the currently active view. */
void stopLoading();
- /**
- * Toggles between showing and hiding of the filter bar
- */
- void toggleFilterBarVisibility(bool show);
+ void enableStopAction();
+ void disableStopAction();
+
+ void showFilterBar();
/**
* Toggles between edit and browse mode of the navigation bar.
*/
void replaceLocation();
- /** Goes back on step of the URL history. */
+ /**
+ * Toggles the state of the panels between a locked and unlocked layout.
+ */
+ void togglePanelLockState();
+
+ /** Goes back one step of the URL history. */
void goBack();
/** Goes forward one step of the URL history. */
/** Goes up one hierarchy of the current URL. */
void goUp();
+ /**
+ * Open the previous URL in the URL history in a new tab
+ * if the middle mouse button is clicked.
+ */
+ void goBack(Qt::MouseButtons buttons);
+
+ /**
+ * Open the next URL in the URL history in a new tab
+ * if the middle mouse button is clicked.
+ */
+ void goForward(Qt::MouseButtons buttons);
+
+ /**
+ * Open the URL one hierarchy above the current URL in a new tab
+ * if the middle mouse button is clicked.
+ */
+ void goUp(Qt::MouseButtons buttons);
+
/** Goes to the home URL. */
void goHome();
*/
void slotSelectionChanged(const KFileItemList& selection);
- /** Enables changing of tabs via mouse wheel. */
- void slotWheelMoved(int wheelDelta);
-
/** Emits the signal requestItemInfo(). */
void slotRequestItemInfo(const KFileItem&);
void closeTab();
/**
- * Closes the tab with the index \index and activates the tab with index - 1.
+ * Closes the tab with the index \a index and activates the tab with index - 1.
*/
void closeTab(int index);
-
/**
* Opens a context menu for the tab with the index \a index
* on the position \a pos.
*/
void openTabContextMenu(int index, const QPoint& pos);
+ /**
+ * Is connected to the QTabBar signal tabMoved(int from, int to).
+ * Reorders the list of tabs after a tab was moved in the tab bar
+ * and sets m_tabIndex to the new index of the current tab.
+ */
+ void slotTabMoved(int from, int to);
+
/**
* Handles a click on a places item: if the middle mouse button is
* clicked, a new tab is opened for \a url, otherwise the current
void slotTestCanDecode(const QDragMoveEvent* event, bool& accept);
/**
- * Is connected with the Dolphin search box and searchs items that
- * match to the text entered in the search bar.
+ * If the URL can be listed, open it in the current view, otherwise
+ * run it through KRun.
+ */
+ void handleUrl(const KUrl& url);
+
+ /**
+ * handleUrl() can trigger a stat job to see if the url can actually
+ * be listed.
+ */
+ void slotHandleUrlStatFinished(KJob* job);
+
+ /**
+ * Is connected to the KTabBar signal receivedDropEvent.
+ * Allows dragging and dropping files onto tabs.
+ */
+ void tabDropEvent(int tab, QDropEvent* event);
+
+ /**
+ * Is invoked when the write state of a folder has been changed and
+ * enables/disables the "Create New..." menu entry.
*/
- void searchItems(const KUrl& url);
+ void slotWriteStateChanged(bool isFolderWritable);
+
+ void slotSearchModeChanged(bool enabled);
+
+ /**
+ * Opens the context menu on the current mouse position.
+ * @item File item context. If item is null, the context menu
+ * should be applied to \a url.
+ * @url URL which contains \a item.
+ * @customActions Actions that should be added to the context menu,
+ * if the file item is null.
+ */
+ void openContextMenu(const KFileItem& item,
+ const KUrl& url,
+ const QList<QAction*>& customActions);
private:
DolphinMainWindow(int id);
void createSecondaryView(int tabIndex);
+ /**
+ * Helper method for saveProperties() and readProperties(): Returns
+ * the property string for a tab with the index \a tabIndex and
+ * the property \a property.
+ */
+ QString tabProperty(const QString& property, int tabIndex) const;
+
+ /**
+ * Sets the window caption to url.fileName() if this is non-empty,
+ * "/" if the URL is "file:///", and url.protocol() otherwise.
+ */
+ void setUrlAsCaption(const KUrl& url);
+
+ QString squeezedText(const QString& text) const;
+
+ /**
+ * Adds a clone of the action \a action to the action-collection with
+ * the name \a actionName, so that the action \a action also can be
+ * added to the toolbar by the user. This is useful if the creation of
+ * \a action is e.g. done in Qt and hence cannot be added directly
+ * to the action-collection.
+ */
+ void addActionCloneToCollection(QAction* action, const QString& actionName);
+
private:
/**
* Implements a custom error handling for the undo manager. This
virtual void jobError(KIO::Job* job);
};
- KNewMenu* m_newMenu;
+ KNewFileMenu* m_newFileMenu;
KActionMenu* m_recentTabsMenu;
KAction* m_showMenuBar;
KTabBar* m_tabBar;
DolphinViewContainer* m_activeViewContainer;
QVBoxLayout* m_centralWidgetLayout;
- DolphinSearchBox* m_searchBox;
int m_id;
struct ViewTab
QList<ViewTab> m_viewTab;
DolphinViewActionHandler* m_actionHandler;
+ DolphinRemoteEncoding* m_remoteEncoding;
QPointer<DolphinSettingsDialog> m_settingsDialog;
+
+ KJob* m_lastHandleUrlStatJob;
+
+ /**
+ * Set to true, if the filter dock visibility is only temporary set
+ * to true by enabling the search mode.
+ */
+ bool m_filterDockIsTemporaryVisible;
};
inline DolphinViewContainer* DolphinMainWindow::activeViewContainer() const
return m_viewTab[m_tabIndex].secondaryView != 0;
}
-inline KNewMenu* DolphinMainWindow::newMenu() const
+inline KNewFileMenu* DolphinMainWindow::newFileMenu() const
{
- return m_newMenu;
+ return m_newFileMenu;
}
inline KAction* DolphinMainWindow::showMenuBarAction() const