X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/d9f5e191a6bd32a4dc15b3a3eb34795cda7697dd..e1d76541ba62e2eec5874ace02049be96bf3378e:/src/dolphinview.h diff --git a/src/dolphinview.h b/src/dolphinview.h index 593209e06..63afaba58 100644 --- a/src/dolphinview.h +++ b/src/dolphinview.h @@ -29,6 +29,7 @@ #include #include #include +#include #include #include @@ -37,17 +38,21 @@ #include #include -class KToggleAction; class DolphinController; -class KDirLister; -class KFileItemDelegate; -class KUrl; -class DolphinModel; class DolphinColumnView; class DolphinDetailsView; class DolphinIconsView; class DolphinMainWindow; +class DolphinModel; class DolphinSortFilterProxyModel; +class IconManager; +class KAction; +class KActionCollection; +class KDirLister; +class KFileItemDelegate; +class KUrl; +class KToggleAction; +class ToolTipManager; class QModelIndex; class ViewProperties; @@ -71,11 +76,11 @@ 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 { /** @@ -113,15 +118,15 @@ public: }; /** - * @param parent Parent widget of the view. - * @param url Specifies the content which should be shown. - * @param dirLister Used directory lister. The lister is not owned - * by the view and won't get deleted. - * @param dolphinModel Used directory model. The model is not owned - * by the view and won't get deleted. - * @param proxyModel Used proxy model which specifies the sorting. The - * model is not owned by the view and won't get - * deleted. + * @param parent Parent widget of the view. + * @param url Specifies the content which should be shown. + * @param dirLister Used directory lister. The lister is not owned + * by the view and won't get deleted. + * @param dolphinModel Used directory model. The model is not owned + * by the view and won't get deleted. + * @param proxyModel Used proxy model which specifies the sorting. The + * model is not owned by the view and won't get + * deleted. */ DolphinView(QWidget* parent, const KUrl& url, @@ -159,39 +164,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; /** @@ -235,9 +219,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 @@ -249,12 +234,17 @@ 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 DolphinView::zoomLevelMinimum() and + * DolphinView::zoomLevelMaximum(). + */ + void setZoomLevel(int level); + int zoomLevel() const; + + int zoomLevelMinimum() const; + int zoomLevelMaximum() const; + /** * Returns true, if zooming in is possible. If false is returned, * the minimal zoom size is possible. @@ -321,27 +311,25 @@ public: void calculateItemCount(int& fileCount, int& folderCount); /** - * Returns the "switch to icons mode" action. - * This code is here to share it between the mainwindow and the part - */ - static KToggleAction* iconsModeAction(KActionCollection* collection); - - /** - * Returns the "switch to details 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* detailsModeAction(KActionCollection* collection); + void updateAdditionalInfoActions(KActionCollection* collection); /** - * Returns the "switch to columns mode" 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 KToggleAction* columnsModeAction(KActionCollection* collection); + QPair pasteInfo() const; /** - * Returns the action name corresponding to the current view mode + * 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. */ - QString currentViewModeActionName() const; + void setTabsForFilesEnabled(bool tabsForFiles); + bool isTabsForFilesEnabled() const; public slots: /** @@ -358,6 +346,76 @@ public slots: */ void changeSelection(const KFileItemList& selection); + /** + * Triggers the renaming of the currently selected items, where + * the user must input a new name for the items. + */ + void renameSelectedItems(); + + /** + * Moves all selected items to the trash. + */ + void trashSelectedItems(); + + /** + * Deletes all selected items. + */ + void deleteSelectedItems(); + + /** + * Copies all selected items to the clipboard and marks + * the items as cutted. + */ + void cutSelectedItems(); + + /** Copies all selected items to the clipboard. */ + void copySelectedItems(); + + /** 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 on or off the displaying of additional information + * as specified by \a action. + */ + void toggleAdditionalInfo(QAction* action); signals: /** @@ -369,10 +427,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. @@ -394,8 +463,11 @@ 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 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. @@ -418,14 +490,6 @@ signals: */ void requestContextMenu(const KFileItem& item, const KUrl& url); - /** - * Is emitted if the URLs \a are dropped to the destination URL - * \a destination. No operation is done within the DolphinView, the - * receiver of the signal has to take care about the corresponding - * operation. - */ - void urlsDropped(const KUrl::List& urls, const KUrl& destination); - /** * Is emitted if an information message with the content \a msg * should be shown. @@ -438,6 +502,12 @@ signals: */ void errorMessage(const QString& msg); + /** + * Is emitted if an "operation completed" message with the content \a msg + * should be shown. + */ + void operationCompletedMessage(const QString& msg); + /** * Is emitted after DolphinView::setUrl() has been invoked and * the path \a url is currently loaded. If this signal is emitted, @@ -446,9 +516,17 @@ signals: */ void startedPathLoading(const KUrl& url); + /** + * Is emitted when renaming, copying, moving, linking etc. + * Used for feedback in the mainwindow. + */ + void doingOperation(KIO::FileUndoManager::CommandType type); + protected: /** @see QWidget::mouseReleaseEvent */ virtual void mouseReleaseEvent(QMouseEvent* event); + virtual void wheelEvent(QWheelEvent* event); + virtual bool eventFilter(QObject* watched, QEvent* event); private slots: /** @@ -464,19 +542,6 @@ private slots: */ void triggerItem(const KFileItem& index); - /** - * Generates a preview image for each file item in \a items. - * The current preview settings (maximum size, 'Show Preview' menu) - * are respected. - */ - void generatePreviews(const KFileItemList& items); - - /** - * Replaces the icon of the item \a item by the preview pixmap - * \a pixmap. - */ - void showPreview(const KFileItem& item, const QPixmap& pixmap); - void emitSelectionChangedSignal(); /** @@ -495,12 +560,6 @@ private slots: const KUrl& destPath, const KFileItem& destItem); - /** - * Drops the URLs \a urls at the - * destination \a destination. - */ - void dropUrls(const KUrl::List& urls, - const KUrl& destination); /** * Updates the view properties of the current URL to the * sorting given by \a sorting. @@ -515,7 +574,7 @@ private slots: /** * Updates the view properties of the current URL to the - * additional informations given by \a info. + * additional information given by \a info. */ void updateAdditionalInfo(const KFileItemDelegate::InformationList& info); @@ -525,9 +584,6 @@ private slots: */ void emitContentsMoved(); - /** Applies an item effect to all cut items of the clipboard. */ - void updateCutItems(); - /** * Updates the status bar to show hover information for the * item \a item. If currently other items are selected, @@ -542,6 +598,30 @@ private slots: */ void clearHoverInformation(); + /** + * Indicates in the status bar that the delete operation + * of the job \a job has been finished. + */ + void slotDeleteFileFinished(KJob* job); + + /** + * Called when KDirLister emits redirection. + * Testcase: fish://localhost + */ + void slotRedirection(const KUrl& oldUrl, const KUrl& newUrl); + + /** + * Is emitted if the controller requests a changing of the current + * URL to \a url + */ + void slotRequestUrlChange(const KUrl& url); + + /** + * Restores the current item (= item that has the keyboard focus) + * to m_currentItemUrl. + */ + void restoreCurrentItem(); + private: void loadDirectory(const KUrl& url, bool reload = false); @@ -566,6 +646,8 @@ private: */ void createView(); + void deleteView(); + /** * Returns a pointer to the currently used item view, which is either * a ListView or a TreeView. @@ -578,8 +660,19 @@ private: */ bool isCutItem(const KFileItem& item) const; - /** Applies an item effect to all cut items. */ - void applyCutItemEffect(); + /** + * 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 true, if the ColumnView is activated. As the column view @@ -592,20 +685,13 @@ private: } private: - /** - * Remembers the original pixmap for an item before - * the cut effect is applied. - */ - struct CutItem - { - KUrl url; - QPixmap pixmap; - }; + 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_active; - bool m_showPreview; - bool m_loadingDirectory; - bool m_storedCategorizedSorting; Mode m_mode; DolphinMainWindow* m_mainWindow; @@ -616,14 +702,17 @@ private: DolphinDetailsView* m_detailsView; DolphinColumnView* m_columnView; KFileItemDelegate* m_fileItemDelegate; + QItemSelectionModel* m_selectionModel; DolphinModel* m_dolphinModel; KDirLister* m_dirLister; DolphinSortFilterProxyModel* m_proxyModel; - QList m_cutItemsCache; + IconManager* m_iconManager; + ToolTipManager* m_toolTipManager; KUrl m_rootUrl; + KUrl m_currentItemUrl; }; /// Allow using DolphinView::Mode in QVariant