X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/4062c4cf2d9c3a6716ced8686fa2e2324261c0ec..093efca22dfd247f06e2a669ad968300e71ef08d:/src/dolphinview.h diff --git a/src/dolphinview.h b/src/dolphinview.h index 223c52dbf..99a5233e9 100644 --- a/src/dolphinview.h +++ b/src/dolphinview.h @@ -24,6 +24,8 @@ #include +#include "libdolphin_export.h" + #include #include #include @@ -39,7 +41,7 @@ class DolphinController; class KDirLister; class KFileItemDelegate; class KUrl; -class KDirModel; +class DolphinModel; class DolphinColumnView; class DolphinDetailsView; class DolphinIconsView; @@ -62,7 +64,7 @@ class ViewProperties; * @see DolphinDetailsView * @see DolphinColumnView */ -class DolphinView : public QWidget +class LIBDOLPHINPRIVATE_EXPORT DolphinView : public QWidget { Q_OBJECT @@ -114,7 +116,7 @@ public: * @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 dirModel Used directory model. The model is not owned + * @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 @@ -123,7 +125,7 @@ public: DolphinView(QWidget* parent, const KUrl& url, KDirLister* dirLister, - KDirModel* dirModel, + DolphinModel* dolphinModel, DolphinSortFilterProxyModel* proxyModel); virtual ~DolphinView(); @@ -222,7 +224,7 @@ public: * selected. * @see DolphinView::selectedUrls() */ - KFileItemList selectedItems() const; + QList selectedItems() const; /** * Returns a list of URLs for all selected items. An empty list @@ -234,7 +236,7 @@ public: /** * Returns the file item for the given model index \a index. */ - KFileItem* fileItem(const QModelIndex index) const; + KFileItem fileItem(const QModelIndex& index) const; /** * Sets the upper left position of the view content @@ -286,12 +288,22 @@ public: void reload(); /** - * Refreshs the view to get synchronized with the (updated) Dolphin settings. + * Refreshes the view to get synchronized with the (updated) Dolphin settings. * This method only needs to get invoked if the view settings for the Icons View, * Details View or Columns View have been changed. */ void refresh(); + /** + * Changes the directory of the view to \a url. If \a rootUrl is empty, the view + * properties from \a url are used for adjusting the view mode and the other properties. + * If \a rootUrl is not empty, the view properties from the root URL are considered + * instead. Specifying a root URL is only required if a view having a different root URL + * (e. g. the column view) should be restored. Usually using DolphinView::setUrl() + * is enough for changing the current URL. + */ + void updateView(const KUrl& url, const KUrl& rootUrl); + public slots: /** * Changes the directory to \a url. If the current directory is equal to @@ -305,7 +317,7 @@ public slots: * will actually get selected. The view will e.g. not select items which * are not in the currently displayed folder. */ - void changeSelection(const KFileItemList& selection); + void changeSelection(const QList& selection); signals: /** @@ -316,6 +328,11 @@ signals: /** Is emitted if URL of the view has been changed to \a url. */ void urlChanged(const KUrl& url); + /** + * Is emitted when clicking on an item + */ + void itemTriggered(const KFileItem& item); + /** * Is emitted if the view mode (IconsView, DetailsView, * PreviewsView) has been changed. @@ -342,9 +359,9 @@ signals: /** * Is emitted if information of an item is requested to be shown e. g. in the sidebar. - * It the URL is empty, no item information request is pending. + * If item is null, no item information request is pending. */ - void requestItemInfo(const KUrl& url); + void requestItemInfo(const KFileItem& item); /** Is emitted if the contents has been moved to \a x, \a y. */ void contentsMoved(int x, int y); @@ -352,14 +369,14 @@ signals: /** * Is emitted whenever the selection has been changed. */ - void selectionChanged(const KFileItemList& selection); + void selectionChanged(const QList& selection); /** * 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. */ - void requestContextMenu(KFileItem* item, const KUrl& url); + void requestContextMenu(const KFileItem& item, const KUrl& url); /** * Is emitted if the URLs \a are dropped to the destination URL @@ -381,6 +398,14 @@ signals: */ void errorMessage(const QString& msg); + /** + * Is emitted after DolphinView::setUrl() has been invoked and + * the path \a url is currently loaded. If this signal is emitted, + * it is assured that the view contains already the correct root + * URL and property settings. + */ + void startedPathLoading(const KUrl& url); + protected: /** @see QWidget::mouseReleaseEvent */ virtual void mouseReleaseEvent(QMouseEvent* event); @@ -404,7 +429,7 @@ private slots: * The current preview settings (maximum size, 'Show Preview' menu) * are respected. */ - void generatePreviews(const KFileItemList& items); + void generatePreviews(const QList& items); /** * Replaces the icon of the item \a item by the preview pixmap @@ -422,11 +447,14 @@ private slots: void openContextMenu(const QPoint& pos); /** - * Drops the URLs \a urls to the index \a index. \a source + * Drops the URLs \a 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 destIndex. \a source * indicates the widget where the dragging has been started from. */ void dropUrls(const KUrl::List& urls, - const QModelIndex& index, + const KUrl& destPath, + const QModelIndex& destIndex, QWidget* source); /** @@ -473,6 +501,15 @@ private slots: private: void startDirLister(const KUrl& url, bool reload = false); + /** + * Returns the URL where the view properties should be stored. Usually + * DolphinView::url() is returned, but in the case of a Column View the + * view properties are always stored in the directory represented by the + * first column. It is recommendend whenever using the ViewProperties class + * to use DolphinView::viewPropertiesUrl() as URL. + */ + KUrl viewPropertiesUrl() const; + /** * Applies the view properties which are defined by the current URL * m_url to the DolphinView properties. @@ -485,12 +522,6 @@ private: */ void createView(); - /** - * Selects all items by using the selection flags \a flags. This is a helper - * method for the slots DolphinView::selectAll() and DolphinView::invertSelection(). - */ - void selectAll(QItemSelectionModel::SelectionFlags flags); - /** * Returns a pointer to the currently used item view, which is either * a ListView or a TreeView. @@ -499,7 +530,7 @@ private: /** * Returns true if the index is valid and represents - * the column KDirModel::Name. + * the column DolphinModel::Name. */ bool isValidNameIndex(const QModelIndex& index) const; @@ -512,6 +543,12 @@ private: /** Applies an item effect to all cut items. */ void applyCutItemEffect(); + /** + * Updates the color of the viewport depending from the + * activation state (see DolphinView::isActive()). + */ + void updateViewportColor(); + /** * Returns true, if the ColumnView is activated. As the column view * requires some special handling for iterating through directories, @@ -547,11 +584,13 @@ private: DolphinColumnView* m_columnView; KFileItemDelegate* m_fileItemDelegate; - KDirModel* m_dirModel; + DolphinModel* m_dolphinModel; KDirLister* m_dirLister; DolphinSortFilterProxyModel* m_proxyModel; QList m_cutItemsCache; + + KUrl m_rootUrl; }; #endif // DOLPHINVIEW_H