#include <QKeyEvent>
#include <QLinkedList>
#include <QListView>
+#include <QSet>
#include <QWidget>
+typedef KIO::FileUndoManager::CommandType CommandType;
+
class DolphinController;
class DolphinColumnView;
class DolphinDetailsView;
class KDirLister;
class KUrl;
class KToggleAction;
+class RevisionControlObserver;
class ToolTipManager;
class QModelIndex;
class ViewProperties;
{
/**
* The directory items are shown as icons including an
- * icon name.
+ * icon name.
*/
IconsView = 0,
*/
void setZoomLevel(int level);
int zoomLevel() const;
-
+
/**
* Returns true, if zooming in is possible. If false is returned,
* the maximum zooming level has been reached.
/** Returns the current used sort order (Qt::Ascending or Qt::Descending). */
Qt::SortOrder sortOrder() const;
+ /** Sets a separate sorting with folders first (true) or a mixed sorting of files and folders (false). */
+ void setSortFoldersFirst(bool foldersFirst);
+
+ /** Returns if files and folders are sorted separately or not. */
+ bool sortFoldersFirst() const;
+
/** Sets the additional information which should be shown for the items. */
void setAdditionalInfo(KFileItemDelegate::InformationList info);
* filtering and hierarchical previews into account.
*/
void calculateItemCount(int& fileCount, int& folderCount, KIO::filesize_t& totalFileSize) const;
-
+
/**
* Returns a textual representation of the state of the current
* folder or selected items, suitable for use in the status bar.
*/
QString statusBarText() const;
+ /**
+ * Returns the revision control actions that are provided for the items \p items.
+ * Usually the actions are presented in the context menu.
+ */
+ QList<QAction*> revisionControlActions(const KFileItemList& items) const;
+
/**
* Updates the state of the 'Additional Information' actions in \a collection.
*/
void setTabsForFilesEnabled(bool tabsForFiles);
bool isTabsForFilesEnabled() const;
+ /**
+ * Marks the item \a url as active item as soon as it has
+ * been loaded by the directory lister. This is useful mark
+ * the previously visited directory as active when going
+ * back in history (the URL is known, but the item is not
+ * loaded yet).
+ */
+ void activateItem(const KUrl& url);
+
/**
* Returns true if the current view allows folders to be expanded,
* i.e. presents a hierarchical view to the user.
/** Switches between an ascending and descending sorting order. */
void toggleSortOrder();
+ /** Switches between a separate sorting (with folders first) and a mixed sorting of files and folders. */
+ void toggleSortFoldersFirst();
+
/**
* Switches on or off the displaying of additional information
* as specified by \a action.
/** Is emitted if the sort order (ascending or descending) has been changed. */
void sortOrderChanged(Qt::SortOrder order);
+ /** Is emitted if the sorting of files and folders (separate with folders first or mixed) has been changed. */
+ void sortFoldersFirstChanged(bool foldersFirst);
+
/** Is emitted if the additional information shown for this view has been changed. */
void additionalInfoChanged();
-
+
/** Is emitted if the zoom level has been changed by zooming in or out. */
void zoomLevelChanged(int level);
/**
- * Is emitted if information of an item is requested to be shown e. g. in the sidebar.
+ * Is emitted if information of an item is requested to be shown e. g. in the panel.
* If item is null, no item information request is pending.
*/
void requestItemInfo(const KFileItem& item);
/**
* Is emitted if a context menu is requested for the item \a item,
- * which is part of \a url. If the item is 0, the context menu
- * for the URL should be shown.
+ * which is part of \a url. If the item is null, the context menu
+ * for the URL should be shown and the custom actions \a customActions
+ * will be added.
*/
- void requestContextMenu(const KFileItem& item, const KUrl& url);
+ void requestContextMenu(const KFileItem& item,
+ const KUrl& url,
+ const QList<QAction*>& customActions);
/**
* Is emitted if an information message with the content \a msg
*/
void triggerItem(const KFileItem& index);
+ /**
+ * Emits the signal \a selectionChanged() with a small delay. This is
+ * because getting all file items for the signal can be an expensive
+ * operation. Fast selection changes are collected in this case and
+ * the signal is emitted only after no selection change has been done
+ * within a small delay.
+ */
+ void emitDelayedSelectionChangedSignal();
+
+ /**
+ * Is called by emitDelayedSelectionChangedSignal() and emits the
+ * signal \a selectionChanged() with all selected file items as parameter.
+ */
void emitSelectionChangedSignal();
/**
* is used to check whether the context menu is related to an
* item or to the viewport.
*/
- void openContextMenu(const QPoint& pos);
+ void openContextMenu(const QPoint& pos, const QList<QAction*>& customActions);
/**
* Drops dragged URLs to the destination path \a destPath. If
*/
void updateSortOrder(Qt::SortOrder order);
+ /**
+ * Updates the view properties of the current URL to the
+ * sorting of files and folders (separate with folders first or mixed) given by \a foldersFirst.
+ */
+ void updateSortFoldersFirst(bool foldersFirst);
+
/**
* Updates the view properties of the current URL to the
* additional information given by \a info.
void slotRequestUrlChange(const KUrl& url);
/**
- * Restores the current item (= item that has the keyboard focus)
- * to m_currentItemUrl.
+ * Invoked when the directory lister has completed the loading of
+ * items. Assures that pasted items and renamed items get seleced.
*/
- void restoreCurrentItem();
-
+ void slotDirListerCompleted();
+
/**
- * Is connected to the enterDir() signal from the FolderExpander
- * and triggers the entering of the directory indicated by \a index.
+ * Is invoked when the KDirLister indicates refreshed items.
*/
- void enterDir(const QModelIndex& index, QAbstractItemView* view);
+ void slotRefreshItems();
+
+ /**
+ * If \a view can be positively identified as not being the source for the
+ * current drag operation, deleteLater() it immediately. Else stores
+ * it for later deletion.
+ */
+ void deleteWhenNotDragSource(QAbstractItemView* view);
+
+ /**
+ * Observes the item with the URL \a url. As soon as the directory
+ * model indicates that the item is available, the item will
+ * get selected and it is assure that the item stays visible.
+ *
+ * @see selectAndScrollToCreatedItem()
+ */
+ void observeCreatedItem(const KUrl& url);
+
+ /**
+ * Selects and scrolls to the item that got observed
+ * by observeCreatedItem().
+ */
+ void selectAndScrollToCreatedItem();
+
+ /**
+ * Restore selection after view refresh.
+ */
+ void restoreSelection();
private:
void loadDirectory(const KUrl& url, bool reload = false);
*/
QAbstractItemView* itemView() const;
- /**
- * Returns true, if the item \a item has been cut into
- * the clipboard.
- */
- bool isCutItem(const KFileItem& item) const;
-
/**
* Helper method for DolphinView::paste() and DolphinView::pasteIntoFolder().
* Pastes the clipboard data into the URL \a url.
*/
void pasteToUrl(const KUrl& url);
-
+
/**
* Checks whether the current item view has the same zoom level
* as \a oldZoomLevel. If this is not the case, the zoom level
* is emitted.
*/
void updateZoomLevel(int oldZoomLevel);
-
+
/**
* Returns a list of URLs for all selected items. The list is
* simplified, so that when the URLs are part of different tree
* this method has been introduced for convenience.
*/
bool isColumnViewActive() const;
-
+
+ /**
+ * Returns the MIME data for all selected items.
+ */
+ QMimeData* selectionMimeData() const;
+
/**
- * Deletes all views from m_expandedViews except if the view
- * is currently shown.
+ * Is invoked after a paste operation or a drag & drop
+ * operation and adds the filenames of all URLs from \a mimeData to
+ * m_newFileNames. This allows to select all newly added
+ * items in slotDirListerCompleted().
*/
- void deleteExpandedViews();
+ void addNewFileNames(const QMimeData* mimeData);
private:
bool m_active : 1;
bool m_storedCategorizedSorting : 1;
bool m_tabsForFiles : 1;
bool m_isContextMenuOpen : 1; // TODO: workaround for Qt-issue 207192
+ bool m_ignoreViewProperties : 1;
+ bool m_assureVisibleCurrentIndex : 1;
Mode m_mode;
DolphinDetailsView* m_detailsView;
DolphinColumnView* m_columnView;
DolphinFileItemDelegate* m_fileItemDelegate;
+
QItemSelectionModel* m_selectionModel;
+ QTimer* m_selectionChangedTimer;
DolphinModel* m_dolphinModel;
KDirLister* m_dirLister;
KFilePreviewGenerator* m_previewGenerator;
ToolTipManager* m_toolTipManager;
+ RevisionControlObserver* m_revisionControlObserver;
+
KUrl m_rootUrl;
- KUrl m_currentItemUrl;
-
- QList<QAbstractItemView*> m_expandedViews;
+ KUrl m_activeItemUrl;
+ KUrl m_createdItemUrl; // URL for a new item that got created by the "Create New..." menu
+ KFileItemList m_selectedItems; // this is used for making the View to remember selections after F5
+
+ /**
+ * Remembers the filenames that have been added by a paste operation
+ * or a drag & drop operation. Allows to select the items in
+ * slotDirListerCompleted().
+ */
+ QSet<QString> m_newFileNames;
+
+ QAbstractItemView* m_expandedDragSource;
};
inline bool DolphinView::isColumnViewActive() const
projects / dolphin.git / blobdiff