#include "dolphinview.h"
#include "sidebarpage.h"
+#include <config-nepomuk.h>
+
#include <kxmlguiwindow.h>
#include <ksortablelist.h>
#include <konq_undo.h>
-#include <QList>
+#include <QtCore/QList>
class DolphinApplication;
+class DolphinViewContainer;
class KNewMenu;
class KUrl;
class QSplitter;
virtual ~DolphinMainWindow();
/**
- * Activates the given view, which means that
- * all menu actions are applied to this view. When
- * having a split view setup the nonactive view
- * is usually shown in darker colors.
- */
- void setActiveView(DolphinView* view);
+ * Returns the currently active view.
+ * All menu actions are applied to this view. When
+ * having a split view setup, the nonactive view
+ * is usually shown in darker colors.
+ */
+ DolphinViewContainer* activeViewContainer() const;
/**
- * Returns the currently active view. See
- * DolphinMainWindow::setActiveView() for more details.
+ * Returns true, if the main window contains two instances
+ * of a view container. The active view constainer can be
+ * accessed by DolphinMainWindow::activeViewContainer().
*/
- DolphinView* activeView() const
- {
- return m_activeView;
- }
+ 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);
/**
- * Refreshs the views of the main window by recreating them dependent from
+ * Refreshes the views of the main window by recreating them dependent from
* 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
- {
- return m_newMenu;
- }
+ KNewMenu* newMenu() const;
public slots:
/**
/**
* Returns the main window ID used through DBus.
*/
- int getId() const
- {
- return m_id;
- }
+ int getId() const;
/**
* Inform all affected dolphin components (sidebars, views) of an URL
* Inform all affected dolphin components that a selection change is
* requested.
*/
- void changeSelection(const KFileItemList& selection);
+ void changeSelection(const QList<KFileItem>& selection);
/** Stores all settings and quits Dolphin. */
void quit();
* Is sent if the selection of the currently active view has
* been changed.
*/
- void selectionChanged(const KFileItemList& selection);
+ void selectionChanged(const QList<KFileItem>& selection);
/**
* Is sent if the url of the currently active view has
*/
void urlChanged(const KUrl& url);
+ /**
+ * Is emitted if information of an item is requested to be shown e. g. in the sidebar.
+ * If item is null, no item information request is pending.
+ */
+ void requestItemInfo(const KFileItem& item);
+
protected:
/** @see QMainWindow::closeEvent */
virtual void closeEvent(QCloseEvent* event);
/**
* Opens the properties window for the selected items of the
- * active view. The properties windows shows informations
+ * active view. The properties windows shows information
* like name, size and permissions.
*/
void properties();
+ /**
+ * Shows the error information from the places model
+ * in the status bar.
+ */
+ void slotHandlePlacesError(const QString &message);
+
/**
* Shows the error information of the job \a job
* in the status bar.
/** The sorting of the current view should be done by the type. */
void sortByType();
+ /** The sorting of the current view should be done by the rating. */
+ void sortByRating();
+
+ /** The sorting of the current view should be done by tags. */
+ void sortByTags();
+
/** Switches between an ascending and descending sorting order. */
void toggleSortOrder();
/** Updates the state of the 'Additional Information' actions. */
void slotAdditionalInfoChanged(KFileItemDelegate::AdditionalInformation info);
- /** Updates the state of the 'Edit' menu actions. */
- void slotSelectionChanged(const KFileItemList& selection);
+ /**
+ * Updates the state of the 'Edit' menu actions and emits
+ * the signal selectionChanged().
+ */
+ void slotSelectionChanged(const QList<KFileItem>& selection);
+
+ /** Emits the signal requestItemInfo(). */
+ void slotRequestItemInfo(const KFileItem&);
/**
* Updates the state of the 'Back' and 'Forward' menu
/** Open a new main window. */
void openNewMainWindow();
+ /** Toggles the active view if two views are shown within the main window. */
+ void toggleActiveView();
+
private:
DolphinMainWindow(int id);
void init();
- void loadSettings();
- void setupAccel();
+ /**
+ * Activates the given view, which means that
+ * all menu actions are applied to this view. When
+ * having a split view setup, the nonactive view
+ * is usually shown in darker colors.
+ */
+ void setActiveViewContainer(DolphinViewContainer* view);
+
void setupActions();
void setupDockWidgets();
void updateHistory();
*/
void connectViewSignals(int viewIndex);
+ /**
+ * Updates the text of the split action:
+ * If two views are shown, the text is set to "Split",
+ * otherwise the text is set to "Join". The icon
+ * is updated to match with the text and the currently active view.
+ */
+ void updateSplitAction();
+
private:
/**
- * DolphinMainWindowsupports only one or two views, which
- * are handled internally as primary and secondary view.
+ * DolphinMainWindow supports up to two views beside each other.
*/
enum ViewIndex
{
- PrimaryIdx = 0,
- SecondaryIdx = 1
+ PrimaryView = 0, ///< View shown on the left side of the main window.
+ SecondaryView = 1 ///< View shown on the left side of the main window.
};
/**
* assures that all errors are shown in the status bar of Dolphin
* instead as modal error dialog with an OK button.
*/
-class UndoUiInterface : public KonqUndoManager::UiInterface
+ class UndoUiInterface : public KonqUndoManager::UiInterface
{
public:
UndoUiInterface(DolphinMainWindow* mainWin);
KNewMenu* m_newMenu;
QSplitter* m_splitter;
- DolphinView* m_activeView;
+ DolphinViewContainer* m_activeViewContainer;
int m_id;
- DolphinView* m_view[SecondaryIdx + 1];
+ DolphinViewContainer* m_viewContainer[SecondaryView + 1];
/// remember pending undo operations until they are finished
QList<KonqUndoManager::CommandType> m_undoCommandTypes;
};
+inline DolphinViewContainer* DolphinMainWindow::activeViewContainer() const
+{
+ return m_activeViewContainer;
+}
+
+inline bool DolphinMainWindow::isSplit() const
+{
+ return m_viewContainer[SecondaryView] != 0;
+}
+
+inline KNewMenu* DolphinMainWindow::newMenu() const
+{
+ return m_newMenu;
+}
+
+inline int DolphinMainWindow::getId() const
+{
+ return m_id;
+}
+
#endif // DOLPHIN_MAINWINDOW_H
projects / dolphin.git / blobdiff