X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/1daef0dc52a18b03e2bc5b4ce85944356b6b5da3..d84909dc36acbd91c37de76e793f81dca9b2ace9:/src/dolphinview.h diff --git a/src/dolphinview.h b/src/dolphinview.h index b42f57007..58924697e 100644 --- a/src/dolphinview.h +++ b/src/dolphinview.h @@ -29,30 +29,33 @@ #include #include #include -#include +#include #include #include #include #include #include +#include #include +typedef KIO::FileUndoManager::CommandType CommandType; + class DolphinController; class DolphinColumnView; class DolphinDetailsView; +class DolphinFileItemDelegate; class DolphinIconsView; class DolphinMainWindow; class DolphinModel; class DolphinSortFilterProxyModel; -class IconManager; +class KFilePreviewGenerator; class KAction; class KActionCollection; class KDirLister; -class KFileItemDelegate; class KUrl; -class KToggleAction; -class QModelIndex; +class ToolTipManager; +class VersionControlObserver; class ViewProperties; /** @@ -75,16 +78,17 @@ class LIBDOLPHINPRIVATE_EXPORT DolphinView : public QWidget public: /** - * Defines the view mode for a directory. The view mode - * can be defined when constructing a DolphinView. The - * view mode is automatically updated if the directory itself - * defines a view mode (see class ViewProperties for details). - */ + * Defines the view mode for a directory. The view mode + * can be defined when constructing a DolphinView. The + * view mode is automatically updated if the directory itself + * defines a view mode (see class ViewProperties for details). + */ enum Mode { /** * The directory items are shown as icons including an - * icon name. */ + * icon name. + */ IconsView = 0, /** @@ -126,14 +130,12 @@ public: * @param proxyModel Used proxy model which specifies the sorting. The * model is not owned by the view and won't get * deleted. - * @param actionCollection Action collection which contains the menu actions. */ DolphinView(QWidget* parent, const KUrl& url, KDirLister* dirLister, DolphinModel* dolphinModel, - DolphinSortFilterProxyModel* proxyModel, - KActionCollection* actionCollection); + DolphinSortFilterProxyModel* proxyModel); virtual ~DolphinView(); @@ -165,39 +167,18 @@ public: * Changes the view mode for the current directory to \a mode. * If the view properties should be remembered for each directory * (GeneralSettings::globalViewProps() returns false), then the - * changed view mode will be be stored automatically. + * changed view mode will be stored automatically. */ void setMode(Mode mode); Mode mode() const; - /** - * Turns on the file preview for the all files of the current directory, - * if \a show is true. - * If the view properties should be remembered for each directory - * (GeneralSettings::globalViewProps() returns false), then the - * preview setting will be be stored automatically. - */ - void setShowPreview(bool show); + /** See setShowPreview */ bool showPreview() const; - /** - * Shows all hidden files of the current directory, - * if \a show is true. - * If the view properties should be remembered for each directory - * (GeneralSettings::globalViewProps() returns false), then the - * show hidden file setting will be be stored automatically. - */ - void setShowHiddenFiles(bool show); + /** See setShowHiddenFiles */ bool showHiddenFiles() const; - /** - * Summarizes all sorted items by their category \a categorized - * is true. - * If the view properties should be remembered for each directory - * (GeneralSettings::globalViewProps() returns false), then the - * categorized sorting setting will be be stored automatically. - */ - void setCategorizedSorting(bool categorized); + /** See setCategorizedSorting */ bool categorizedSorting() const; /** @@ -241,9 +222,10 @@ public: KUrl::List selectedUrls() const; /** - * Returns the file item for the given model index \a index. + * Returns the number of selected items (this is faster than + * invoking selectedItems().count()). */ - KFileItem fileItem(const QModelIndex& index) const; + int selectedItemsCount() const; /** * Sets the upper left position of the view content @@ -255,21 +237,23 @@ public: /** Returns the upper left position of the view content. */ QPoint contentsPosition() const; - /** Increases the size of the current set view mode. */ - void zoomIn(); - - /** Decreases the size of the current set view mode. */ - void zoomOut(); + /** + * Sets the zoom level to \a level. It is assured that the used + * level is adjusted to be inside the range ZoomLevelInfo::minimumLevel() and + * ZoomLevelInfo::maximumLevel(). + */ + void setZoomLevel(int level); + int zoomLevel() const; /** * Returns true, if zooming in is possible. If false is returned, - * the minimal zoom size is possible. + * the maximum zooming level has been reached. */ bool isZoomInPossible() const; /** * Returns true, if zooming out is possible. If false is returned, - * the maximum zoom size is possible. + * the minimum zooming level has been reached. */ bool isZoomOutPossible() const; @@ -285,6 +269,12 @@ public: /** 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); @@ -320,59 +310,60 @@ public: /** * Calculates the number of currently shown files into * \a fileCount and the number of folders into \a folderCount. + * The size of all files is written into \a totalFileSize. * It is recommend using this method instead of asking the * directory lister or the model directly, as it takes * filtering and hierarchical previews into account. */ - void calculateItemCount(int& fileCount, int& folderCount); + void calculateItemCount(int& fileCount, int& folderCount, KIO::filesize_t& totalFileSize) const; /** - * Returns the "switch to icons mode" action. - * This code is here to share it between the mainwindow and the part + * Returns a textual representation of the state of the current + * folder or selected items, suitable for use in the status bar. */ - static KToggleAction* iconsModeAction(KActionCollection* collection); + QString statusBarText() const; /** - * Returns the "switch to details mode" action. - * This code is here to share it between the mainwindow and the part + * Returns the version control actions that are provided for the items \p items. + * Usually the actions are presented in the context menu. */ - static KToggleAction* detailsModeAction(KActionCollection* collection); + QList versionControlActions(const KFileItemList& items) const; /** - * Returns the "switch to columns mode" action. - * This code is here to share it between the mainwindow and the part + * Updates the state of the 'Additional Information' actions in \a collection. */ - static KToggleAction* columnsModeAction(KActionCollection* collection); + void updateAdditionalInfoActions(KActionCollection* collection); /** - * Creates the rename action. - * This code is here to share it between the mainwindow and the part - */ - static KAction* createRenameAction(KActionCollection* collection); - - /** - * Creates the "move to trash" action. - * This code is here to share it between the mainwindow and the part + * Returns the state of the paste action: + * first is whether the action should be enabled + * second is the text for the action */ - static KAction* createMoveToTrashAction(KActionCollection* collection); + QPair pasteInfo() const; /** - * Creates the delete action. - * This code is here to share it between the mainwindow and the part + * If \a tabsForFiles is true, the signal tabRequested() will also + * emitted also for files. Per default tabs for files is disabled + * and hence the signal tabRequested() will only be emitted for + * directories. */ - static KAction* createDeleteAction(KActionCollection* collection); + void setTabsForFilesEnabled(bool tabsForFiles); + bool isTabsForFilesEnabled() const; /** - * Returns the action name corresponding to the current view mode + * 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). */ - QString currentViewModeActionName() const; + void activateItem(const KUrl& url); /** - * Returns the state of the paste action: - * first is whether the action should be enabled - * second is the text for the action + * Returns true if the current view allows folders to be expanded, + * i.e. presents a hierarchical view to the user. */ - QPair pasteInfo() const; + bool itemsExpandable() const; public slots: /** @@ -417,6 +408,52 @@ public slots: /** Pastes the clipboard data to this view. */ void paste(); + /** + * Pastes the clipboard data into the currently selected + * folder. If the current selection is not exactly one folder, no + * paste operation is done. + */ + void pasteIntoFolder(); + + /** + * Turns on the file preview for the all files of the current directory, + * if \a show is true. + * If the view properties should be remembered for each directory + * (GeneralSettings::globalViewProps() returns false), then the + * preview setting will be stored automatically. + */ + void setShowPreview(bool show); + + /** + * Shows all hidden files of the current directory, + * if \a show is true. + * If the view properties should be remembered for each directory + * (GeneralSettings::globalViewProps() returns false), then the + * show hidden file setting will be stored automatically. + */ + void setShowHiddenFiles(bool show); + + /** + * Summarizes all sorted items by their category \a categorized + * is true. + * If the view properties should be remembered for each directory + * (GeneralSettings::globalViewProps() returns false), then the + * categorized sorting setting will be stored automatically. + */ + void setCategorizedSorting(bool categorized); + + /** 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. + */ + void toggleAdditionalInfo(QAction* action); + signals: /** * Is emitted if the view has been activated by e. g. a mouse click. @@ -427,10 +464,21 @@ signals: void urlChanged(const KUrl& url); /** - * Is emitted when clicking on an item + * Is emitted if the view requests a changing of the current + * URL to \a url (see DolphinController::triggerUrlChangeRequest()). + */ + void requestUrlChange(const KUrl& url); + + /** + * Is emitted when clicking on an item with the left mouse button. */ void itemTriggered(const KFileItem& item); + /** + * Is emitted if a new tab should be opened for the URL \a url. + */ + void tabRequested(const KUrl& url); + /** * Is emitted if the view mode (IconsView, DetailsView, * PreviewsView) has been changed. @@ -452,11 +500,17 @@ signals: /** Is emitted if the sort order (ascending or descending) has been changed. */ void sortOrderChanged(Qt::SortOrder order); - /** Is emitted if the additional information for an item has been changed. */ - void additionalInfoChanged(const KFileItemDelegate::InformationList& info); + /** 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); @@ -471,10 +525,13 @@ signals: /** * 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& customActions); /** * Is emitted if an information message with the content \a msg @@ -503,14 +560,16 @@ signals: void startedPathLoading(const KUrl& url); /** - * Is emitted when renaming, copying, moving, linking etc. - * Used for feedback in the mainwindow. + * Emitted when KDirLister emits redirection. + * Testcase: fish://localhost */ - void doingOperation(KonqFileUndoManager::CommandType type); + void redirection(const KUrl& oldUrl, const KUrl& newUrl); protected: /** @see QWidget::mouseReleaseEvent */ virtual void mouseReleaseEvent(QMouseEvent* event); + virtual void wheelEvent(QWheelEvent* event); + virtual bool eventFilter(QObject* watched, QEvent* event); private slots: /** @@ -526,6 +585,19 @@ private slots: */ 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(); /** @@ -533,23 +605,17 @@ private slots: * 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& customActions); /** - * Drops the URLs \a urls to the destination path \a destPath. If + * Drops dragged URLs to the destination path \a destPath. If * the URLs are dropped above an item inside the destination path, * the item is indicated by \a destItem. */ - void dropUrls(const KUrl::List& urls, + void dropUrls(const KFileItem& destItem, const KUrl& destPath, - const KFileItem& destItem); + QDropEvent* event); - /** - * Handles the dropping of URLs to the given destination. - * @see DolphinDropController - */ - void dropUrls(const KUrl::List& urls, - const KUrl& destination); /** * Updates the view properties of the current URL to the * sorting given by \a sorting. @@ -562,6 +628,12 @@ private slots: */ 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. @@ -595,10 +667,48 @@ private slots: void slotDeleteFileFinished(KJob* job); /** - * Opens the dialog for creating a directory. Is connected - * with the key shortcut for "new directory" (F10). + * Is emitted if the controller requests a changing of the current + * URL to \a url */ - void createDir(); + void slotRequestUrlChange(const KUrl& url); + + /** + * Invoked when the directory lister has completed the loading of + * items. Assures that pasted items and renamed items get seleced. + */ + void slotDirListerCompleted(); + + /** + * Is invoked when the KDirLister indicates refreshed items. + */ + 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); @@ -633,26 +743,56 @@ private: QAbstractItemView* itemView() const; /** - * Returns true, if the item \a item has been cut into - * the clipboard. + * 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 + * of the controller is updated and a zoomLevelChanged() signal + * 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 + * levels, only the parent is returned. */ - bool isCutItem(const KFileItem& item) const; + KUrl::List simplifiedSelectedUrls() const; /** * Returns true, if the ColumnView is activated. As the column view * requires some special handling for iterating through directories, * this method has been introduced for convenience. */ - bool isColumnViewActive() const - { - return m_columnView != 0; - } + bool isColumnViewActive() const; + + /** + * Returns the MIME data for all selected items. + */ + QMimeData* selectionMimeData() const; + + /** + * 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 addNewFileNames(const QMimeData* mimeData); private: - bool m_active; - bool m_showPreview; - bool m_loadingDirectory; - bool m_storedCategorizedSorting; + bool m_active : 1; + bool m_showPreview : 1; + bool m_loadingDirectory : 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; DolphinMainWindow* m_mainWindow; @@ -662,18 +802,40 @@ private: DolphinIconsView* m_iconsView; DolphinDetailsView* m_detailsView; DolphinColumnView* m_columnView; - KFileItemDelegate* m_fileItemDelegate; + DolphinFileItemDelegate* m_fileItemDelegate; + QItemSelectionModel* m_selectionModel; + QTimer* m_selectionChangedTimer; DolphinModel* m_dolphinModel; KDirLister* m_dirLister; DolphinSortFilterProxyModel* m_proxyModel; - IconManager* m_iconManager; + KFilePreviewGenerator* m_previewGenerator; + ToolTipManager* m_toolTipManager; + + VersionControlObserver* m_versionControlObserver; KUrl m_rootUrl; + 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 m_newFileNames; + + QAbstractItemView* m_expandedDragSource; }; +inline bool DolphinView::isColumnViewActive() const +{ + return m_columnView != 0; +} + /// Allow using DolphinView::Mode in QVariant Q_DECLARE_METATYPE(DolphinView::Mode)