1 /***************************************************************************
2 * Copyright (C) 2006-2009 by Peter Penz <peter.penz@gmx.at> *
3 * Copyright (C) 2006 by Gregor Kališnik <gregor@podnapisi.net> *
5 * This program is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation; either version 2 of the License, or *
8 * (at your option) any later version. *
10 * This program is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with this program; if not, write to the *
17 * Free Software Foundation, Inc., *
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
19 ***************************************************************************/
25 #include <config-nepomuk.h>
27 #include "libdolphin_export.h"
29 #include <kparts/part.h>
30 #include <kfileitem.h>
31 #include <kfileitemdelegate.h>
32 #include <kio/fileundomanager.h>
37 #include <QLinkedList>
42 typedef KIO::FileUndoManager::CommandType CommandType
;
44 class DolphinColumnViewContainer
;
45 class DolphinDetailsView
;
46 class DolphinIconsView
;
48 class DolphinSortFilterProxyModel
;
49 class DolphinViewController
;
51 class KActionCollection
;
54 class ViewModeController
;
56 class DolphinDetailsViewExpander
;
59 * @short Represents a view for the directory content.
61 * View modes for icons, details and columns are supported. It's
68 * @see DolphinIconsView
69 * @see DolphinDetailsView
70 * @see DolphinColumnView
72 class LIBDOLPHINPRIVATE_EXPORT DolphinView
: public QWidget
78 * Defines the view mode for a directory. The view mode
79 * can be defined when constructing a DolphinView. The
80 * view mode is automatically updated if the directory itself
81 * defines a view mode (see class ViewProperties for details).
86 * The directory items are shown as icons including an
92 * The icon, the name and at least the size of the directory
93 * items are shown in a table. It is possible to add columns
94 * for date, group and permissions.
99 * Each folder is shown in a separate column.
102 MaxModeEnum
= ColumnView
105 /** Defines the sort order for the items of a directory. */
117 MaxSortingEnum
= SortByPath
121 * @param parent Parent widget of the view.
122 * @param url Specifies the content which should be shown.
123 * @param proxyModel Used proxy model which specifies the sorting. The
124 * model is not owned by the view and won't get
127 DolphinView(QWidget
* parent
,
129 DolphinSortFilterProxyModel
* proxyModel
);
131 virtual ~DolphinView();
134 * Returns the current active URL, where all actions are applied.
135 * The URL navigator is synchronized with this URL.
140 * Returns the root URL of the view, which is defined as the first
141 * visible path of DolphinView::url(). Usually the root URL is
142 * equal to DolphinView::url(), but in the case of the column view
143 * when 2 columns are shown, the root URL might be:
144 * /home/peter/Documents
145 * and DolphinView::url() might return
146 * /home/peter/Documents/Music/
148 KUrl
rootUrl() const;
151 * If \a active is true, the view will marked as active. The active
152 * view is defined as view where all actions are applied to.
154 void setActive(bool active
);
155 bool isActive() const;
158 * Changes the view mode for the current directory to \a mode.
159 * If the view properties should be remembered for each directory
160 * (GeneralSettings::globalViewProps() returns false), then the
161 * changed view mode will be stored automatically.
163 void setMode(Mode mode
);
166 /** See setShowPreview */
167 bool showPreview() const;
169 /** See setShowHiddenFiles */
170 bool showHiddenFiles() const;
172 /** See setCategorizedSorting */
173 bool categorizedSorting() const;
176 * Returns true, if the categorized sorting is supported by the current
177 * used mode (see DolphinView::setMode()). Currently only DolphinView::IconsView
178 * supports categorizations. To check whether the categorized
179 * sorting is set, use DolphinView::categorizedSorting().
181 bool supportsCategorizedSorting() const;
184 * Marks the items indicated by \p urls to get selected after the
185 * directory DolphinView::url() has been loaded. Note that nothing
186 * gets selected if no loading of a directory has been triggered
187 * by DolphinView::setUrl() or DolphinView::reload().
189 void markUrlsAsSelected(const QList
<KUrl
>& urls
);
192 * Returns the selected items. The list is empty if no item has been
194 * @see DolphinView::selectedUrls()
196 KFileItemList
selectedItems() const;
199 * Returns the number of selected items (this is faster than
200 * invoking selectedItems().count()).
202 int selectedItemsCount() const;
204 QItemSelectionModel
* selectionModel() const;
207 * Sets the zoom level to \a level. It is assured that the used
208 * level is adjusted to be inside the range ZoomLevelInfo::minimumLevel() and
209 * ZoomLevelInfo::maximumLevel().
211 void setZoomLevel(int level
);
212 int zoomLevel() const;
215 * Returns true, if zooming in is possible. If false is returned,
216 * the maximum zooming level has been reached.
218 bool isZoomInPossible() const;
221 * Returns true, if zooming out is possible. If false is returned,
222 * the minimum zooming level has been reached.
224 bool isZoomOutPossible() const;
226 /** Sets the sort order of the items inside a directory (see DolphinView::Sorting). */
227 void setSorting(Sorting sorting
);
229 /** Returns the sort order of the items inside a directory (see DolphinView::Sorting). */
230 Sorting
sorting() const;
232 /** Sets the sort order (Qt::Ascending or Qt::Descending) for the items. */
233 void setSortOrder(Qt::SortOrder order
);
235 /** Returns the current used sort order (Qt::Ascending or Qt::Descending). */
236 Qt::SortOrder
sortOrder() const;
238 /** Sets a separate sorting with folders first (true) or a mixed sorting of files and folders (false). */
239 void setSortFoldersFirst(bool foldersFirst
);
241 /** Returns if files and folders are sorted separately or not. */
242 bool sortFoldersFirst() const;
244 /** Sets the additional information which should be shown for the items. */
245 void setAdditionalInfo(KFileItemDelegate::InformationList info
);
247 /** Returns the additional information which should be shown for the items. */
248 KFileItemDelegate::InformationList
additionalInfo() const;
250 /** Reloads the current directory. */
256 * Refreshes the view to get synchronized with the (updated) Dolphin settings.
257 * This method only needs to get invoked if the view settings for the Icons View,
258 * Details View or Columns View have been changed.
263 * Filters the currently shown items by \a nameFilter. All items
264 * which contain the given filter string will be shown.
266 void setNameFilter(const QString
& nameFilter
);
269 * Calculates the number of currently shown files into
270 * \a fileCount and the number of folders into \a folderCount.
271 * The size of all files is written into \a totalFileSize.
272 * It is recommend using this method instead of asking the
273 * directory lister or the model directly, as it takes
274 * filtering and hierarchical previews into account.
276 void calculateItemCount(int& fileCount
, int& folderCount
, KIO::filesize_t
& totalFileSize
) const;
279 * Returns a textual representation of the state of the current
280 * folder or selected items, suitable for use in the status bar.
282 QString
statusBarText() const;
285 * Returns the version control actions that are provided for the items \p items.
286 * Usually the actions are presented in the context menu.
288 QList
<QAction
*> versionControlActions(const KFileItemList
& items
) const;
291 * Updates the state of the 'Additional Information' actions in \a collection.
293 void updateAdditionalInfoActions(KActionCollection
* collection
);
296 * Returns the state of the paste action:
297 * first is whether the action should be enabled
298 * second is the text for the action
300 QPair
<bool, QString
> pasteInfo() const;
303 * If \a tabsForFiles is true, the signal tabRequested() will also
304 * emitted also for files. Per default tabs for files is disabled
305 * and hence the signal tabRequested() will only be emitted for
308 void setTabsForFilesEnabled(bool tabsForFiles
);
309 bool isTabsForFilesEnabled() const;
312 * Returns true if the current view allows folders to be expanded,
313 * i.e. presents a hierarchical view to the user.
315 bool itemsExpandable() const;
318 * Restores the view state (current item, contents position, details view expansion state)
320 void restoreState(QDataStream
& stream
);
323 * Saves the view state (current item, contents position, details view expansion state)
325 void saveState(QDataStream
& stream
);
329 * Changes the directory to \a url. If the current directory is equal to
330 * \a url, nothing will be done (use DolphinView::reload() instead).
332 void setUrl(const KUrl
& url
);
336 * @see DolphinView::selectedItems()
341 * Inverts the current selection: selected items get unselected,
342 * unselected items get selected.
343 * @see DolphinView::selectedItems()
345 void invertSelection();
347 /** Returns true, if at least one item is selected. */
348 bool hasSelection() const;
350 void clearSelection();
353 * Triggers the renaming of the currently selected items, where
354 * the user must input a new name for the items.
356 void renameSelectedItems();
359 * Moves all selected items to the trash.
361 void trashSelectedItems();
364 * Deletes all selected items.
366 void deleteSelectedItems();
369 * Copies all selected items to the clipboard and marks
372 void cutSelectedItems();
374 /** Copies all selected items to the clipboard. */
375 void copySelectedItems();
377 /** Pastes the clipboard data to this view. */
381 * Pastes the clipboard data into the currently selected
382 * folder. If the current selection is not exactly one folder, no
383 * paste operation is done.
385 void pasteIntoFolder();
388 * Turns on the file preview for the all files of the current directory,
389 * if \a show is true.
390 * If the view properties should be remembered for each directory
391 * (GeneralSettings::globalViewProps() returns false), then the
392 * preview setting will be stored automatically.
394 void setShowPreview(bool show
);
397 * Shows all hidden files of the current directory,
398 * if \a show is true.
399 * If the view properties should be remembered for each directory
400 * (GeneralSettings::globalViewProps() returns false), then the
401 * show hidden file setting will be stored automatically.
403 void setShowHiddenFiles(bool show
);
406 * Summarizes all sorted items by their category \a categorized
408 * If the view properties should be remembered for each directory
409 * (GeneralSettings::globalViewProps() returns false), then the
410 * categorized sorting setting will be stored automatically.
412 void setCategorizedSorting(bool categorized
);
416 * Is emitted if the view has been activated by e. g. a mouse click.
420 /** Is emitted if URL of the view has been changed to \a url. */
421 void urlChanged(const KUrl
& url
);
424 * Is emitted when clicking on an item with the left mouse button.
426 void itemTriggered(const KFileItem
& item
);
429 * Is emitted if a new tab should be opened for the URL \a url.
431 void tabRequested(const KUrl
& url
);
434 * Is emitted if the view mode (IconsView, DetailsView,
435 * PreviewsView) has been changed.
439 /** Is emitted if the 'show preview' property has been changed. */
440 void showPreviewChanged();
442 /** Is emitted if the 'show hidden files' property has been changed. */
443 void showHiddenFilesChanged();
445 /** Is emitted if the 'categorized sorting' property has been changed. */
446 void categorizedSortingChanged();
448 /** Is emitted if the sorting by name, size or date has been changed. */
449 void sortingChanged(DolphinView::Sorting sorting
);
451 /** Is emitted if the sort order (ascending or descending) has been changed. */
452 void sortOrderChanged(Qt::SortOrder order
);
454 /** Is emitted if the sorting of files and folders (separate with folders first or mixed) has been changed. */
455 void sortFoldersFirstChanged(bool foldersFirst
);
457 /** Is emitted if the additional information shown for this view has been changed. */
458 void additionalInfoChanged();
460 /** Is emitted if the zoom level has been changed by zooming in or out. */
461 void zoomLevelChanged(int level
);
464 * Is emitted if information of an item is requested to be shown e. g. in the panel.
465 * If item is null, no item information request is pending.
467 void requestItemInfo(const KFileItem
& item
);
470 * Is emitted whenever the selection has been changed.
472 void selectionChanged(const KFileItemList
& selection
);
475 * Is emitted if a context menu is requested for the item \a item,
476 * which is part of \a url. If the item is null, the context menu
477 * for the URL should be shown and the custom actions \a customActions
480 void requestContextMenu(const KFileItem
& item
,
482 const QList
<QAction
*>& customActions
);
485 * Is emitted if an information message with the content \a msg
488 void infoMessage(const QString
& msg
);
491 * Is emitted if an error message with the content \a msg
494 void errorMessage(const QString
& msg
);
497 * Is emitted if an "operation completed" message with the content \a msg
500 void operationCompletedMessage(const QString
& msg
);
503 * Is emitted after DolphinView::setUrl() has been invoked and
504 * the path \a url is currently loaded. If this signal is emitted,
505 * it is assured that the view contains already the correct root
506 * URL and property settings.
508 void startedPathLoading(const KUrl
& url
);
511 * Is emitted after the path triggered by DolphinView::setUrl()
514 void finishedPathLoading(const KUrl
& url
);
517 * Emitted when KDirLister emits redirection.
518 * Testcase: fish://localhost
520 void redirection(const KUrl
& oldUrl
, const KUrl
& newUrl
);
523 /** @see QWidget::mouseReleaseEvent */
524 virtual void mouseReleaseEvent(QMouseEvent
* event
);
525 virtual bool eventFilter(QObject
* watched
, QEvent
* event
);
529 * Marks the view as active (DolphinView:isActive() will return true)
530 * and emits the 'activated' signal if it is not already active.
535 * If the item \a item is a directory, then this
536 * directory will be loaded. If the item is a file, the corresponding
537 * application will get started.
539 void triggerItem(const KFileItem
& index
);
542 * Emits the signal \a selectionChanged() with a small delay. This is
543 * because getting all file items for the signal can be an expensive
544 * operation. Fast selection changes are collected in this case and
545 * the signal is emitted only after no selection change has been done
546 * within a small delay.
548 void slotSelectionChanged(const QItemSelection
& selected
, const QItemSelection
& deselected
);
551 * Is called by emitDelayedSelectionChangedSignal() and emits the
552 * signal \a selectionChanged() with all selected file items as parameter.
554 void emitSelectionChangedSignal();
557 * Opens the context menu on position \a pos. The position
558 * is used to check whether the context menu is related to an
559 * item or to the viewport.
561 void openContextMenu(const QPoint
& pos
, const QList
<QAction
*>& customActions
);
564 * Drops dragged URLs to the destination path \a destPath. If
565 * the URLs are dropped above an item inside the destination path,
566 * the item is indicated by \a destItem.
568 void dropUrls(const KFileItem
& destItem
,
569 const KUrl
& destPath
,
573 * Updates the view properties of the current URL to the
574 * sorting given by \a sorting.
576 void updateSorting(DolphinView::Sorting sorting
);
579 * Updates the view properties of the current URL to the
580 * sort order given by \a order.
582 void updateSortOrder(Qt::SortOrder order
);
585 * Updates the view properties of the current URL to the
586 * sorting of files and folders (separate with folders first or mixed) given by \a foldersFirst.
588 void updateSortFoldersFirst(bool foldersFirst
);
591 * Updates the view properties of the current URL to the
592 * additional information given by \a info.
594 void updateAdditionalInfo(const KFileItemDelegate::InformationList
& info
);
597 * Updates the status bar to show hover information for the
598 * item \a item. If currently other items are selected,
599 * no hover information is shown.
600 * @see DolphinView::clearHoverInformation()
602 void showHoverInformation(const KFileItem
& item
);
605 * Clears the hover information shown in the status bar.
606 * @see DolphinView::showHoverInformation().
608 void clearHoverInformation();
611 * Indicates in the status bar that the delete operation
612 * of the job \a job has been finished.
614 void slotDeleteFileFinished(KJob
* job
);
617 * Invoked when the directory lister has completed the loading of
618 * items. Assures that pasted items and renamed items get seleced.
620 void slotDirListerCompleted();
623 * Invoked when the loading of the directory is finished.
624 * Restores the active item and the scroll position if possible.
626 void slotLoadingCompleted();
629 * Is invoked when the KDirLister indicates refreshed items.
631 void slotRefreshItems();
634 * Observes the item with the URL \a url. As soon as the directory
635 * model indicates that the item is available, the item will
636 * get selected and it is assure that the item stays visible.
638 * @see selectAndScrollToCreatedItem()
640 void observeCreatedItem(const KUrl
& url
);
643 * Selects and scrolls to the item that got observed
644 * by observeCreatedItem().
646 void selectAndScrollToCreatedItem();
649 * Called when a redirection happens.
650 * Testcase: fish://localhost
652 void slotRedirection(const KUrl
& oldUrl
, const KUrl
& newUrl
);
655 * Restores the contents position, if history information about the old position is available.
657 void restoreContentsPosition();
660 void loadDirectory(const KUrl
& url
, bool reload
= false);
663 * Applies the view properties which are defined by the current URL
664 * to the DolphinView properties.
666 void applyViewProperties();
669 * Creates a new view representing the given view mode (DolphinView::mode()).
670 * The current view will get deleted.
677 * Helper method for DolphinView::paste() and DolphinView::pasteIntoFolder().
678 * Pastes the clipboard data into the URL \a url.
680 void pasteToUrl(const KUrl
& url
);
683 * Checks whether the current item view has the same zoom level
684 * as \a oldZoomLevel. If this is not the case, the zoom level
685 * of the controller is updated and a zoomLevelChanged() signal
688 void updateZoomLevel(int oldZoomLevel
);
691 * Returns a list of URLs for all selected items. The list is
692 * simplified, so that when the URLs are part of different tree
693 * levels, only the parent is returned.
695 KUrl::List
simplifiedSelectedUrls() const;
698 * Returns the MIME data for all selected items.
700 QMimeData
* selectionMimeData() const;
703 * Is invoked after a paste operation or a drag & drop
704 * operation and adds the filenames of all URLs from \a mimeData to
705 * m_newFileNames. This allows to select all newly added
706 * items in slotDirListerCompleted().
708 void addNewFileNames(const QMimeData
* mimeData
);
712 * Abstracts the access to the different view implementations
713 * for icons-, details- and column-view.
718 ViewAccessor(DolphinSortFilterProxyModel
* proxyModel
);
721 void createView(QWidget
* parent
,
722 DolphinViewController
* dolphinViewController
,
723 const ViewModeController
* viewModeController
,
728 * Must be invoked before the URL has been changed and allows view implementations
729 * like the column view to create a new column.
731 void prepareUrlChange(const KUrl
& url
);
733 QAbstractItemView
* itemView() const;
734 KFileItemDelegate
* itemDelegate() const;
737 * Returns the widget that should be added to the layout as target. Usually
738 * the item view itself is returned, but in the case of the column view
739 * a container widget is returned.
741 QWidget
* layoutTarget() const;
743 KUrl
rootUrl() const;
745 bool supportsCategorizedSorting() const;
746 bool itemsExpandable() const;
747 QSet
<KUrl
> expandedUrls() const;
748 const DolphinDetailsViewExpander
* setExpandedUrls(const QSet
<KUrl
>& urlsToExpand
);
751 * Returns true, if a reloading of the items is required
752 * when the additional information properties have been changed
755 bool reloadOnAdditionalInfoChange() const;
757 DolphinModel
* dirModel() const;
758 DolphinSortFilterProxyModel
* proxyModel() const;
759 KDirLister
* dirLister() const;
762 DolphinIconsView
* m_iconsView
;
763 DolphinDetailsView
* m_detailsView
;
764 DolphinColumnViewContainer
* m_columnsContainer
;
765 DolphinSortFilterProxyModel
* m_proxyModel
;
766 QAbstractItemView
* m_dragSource
;
767 QPointer
<DolphinDetailsViewExpander
> m_detailsViewExpander
;
771 bool m_showPreview
: 1;
772 bool m_storedCategorizedSorting
: 1;
773 bool m_tabsForFiles
: 1;
774 bool m_isContextMenuOpen
: 1; // TODO: workaround for Qt-issue 207192
775 bool m_assureVisibleCurrentIndex
: 1;
776 bool m_expanderActive
: 1;
780 QVBoxLayout
* m_topLayout
;
782 DolphinViewController
* m_dolphinViewController
;
783 ViewModeController
* m_viewModeController
;
784 ViewAccessor m_viewAccessor
;
786 QTimer
* m_selectionChangedTimer
;
789 KUrl m_activeItemUrl
;
790 QPoint m_restoredContentsPosition
;
791 KUrl m_createdItemUrl
; // URL for a new item that got created by the "Create New..." menu
792 KFileItemList m_selectedItems
; // this is used for making the View to remember selections after F5
795 * Remembers the filenames that have been added by a paste operation
796 * or a drag & drop operation. Allows to select the items in
797 * slotDirListerCompleted().
799 QSet
<QString
> m_newFileNames
;
802 friend class TestHelper
;
805 /// Allow using DolphinView::Mode in QVariant
806 Q_DECLARE_METATYPE(DolphinView::Mode
)
808 #endif // DOLPHINVIEW_H