X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/a5cf21ff06aff44cde563eaceae3c6cef452ee48..0aed243bebae72d85aa06032bdf2d6ba2b58141d:/src/views/viewproperties.h diff --git a/src/views/viewproperties.h b/src/views/viewproperties.h index bb476dc44..05b80f455 100644 --- a/src/views/viewproperties.h +++ b/src/views/viewproperties.h @@ -1,5 +1,5 @@ /*************************************************************************** - * Copyright (C) 2006-2010 by Peter Penz * + * Copyright (C) 2006-2010 by Peter Penz * * Copyright (C) 2006 by Aaron J. Seigo * * * * This program is free software; you can redistribute it and/or modify * @@ -22,8 +22,8 @@ #define VIEWPROPERTIES_H #include -#include -#include +#include +#include "dolphin_export.h" class ViewPropertySettings; /** @@ -35,9 +35,9 @@ class ViewPropertySettings; * just construct an instance by passing the path of the directory: * * \code - * ViewProperties props(KUrl("/home/peter/Documents")); + * ViewProperties props(QUrl::fromLocalFile("/home/peter/Documents")); * const DolphinView::Mode mode = props.viewMode(); - * const bool showHiddenFiles = props.isShowHiddenFilesEnabled(); + * const bool hiddenFilesShown = props.hiddenFilesShown(); * \endcode * * When modifying a view property, the '.directory' file is automatically updated @@ -47,26 +47,26 @@ class ViewPropertySettings; * (see GeneralSettings::globalViewMode()), the values from the global .directory file * are used for initialization. */ -class LIBDOLPHINPRIVATE_EXPORT ViewProperties +class DOLPHIN_EXPORT ViewProperties { public: - explicit ViewProperties(const KUrl& url); + explicit ViewProperties(const QUrl& url); virtual ~ViewProperties(); void setViewMode(DolphinView::Mode mode); DolphinView::Mode viewMode() const; - void setShowPreview(bool show); - bool showPreview() const; + void setPreviewsShown(bool show); + bool previewsShown() const; - void setShowHiddenFiles(bool show); - bool showHiddenFiles() const; + void setHiddenFilesShown(bool show); + bool hiddenFilesShown() const; - void setCategorizedSorting(bool categorized); - bool categorizedSorting() const; + void setGroupedSorting(bool grouped); + bool groupedSorting() const; - void setSorting(DolphinView::Sorting sorting); - DolphinView::Sorting sorting() const; + void setSortRole(const QByteArray& role); + QByteArray sortRole() const; void setSortOrder(Qt::SortOrder sortOrder); Qt::SortOrder sortOrder() const; @@ -79,14 +79,17 @@ public: * Note that the additional-info property is the only property where * the value is dependent from another property (in this case the view-mode). */ - void setAdditionalInfo(const KFileItemDelegate::InformationList& info); + void setVisibleRoles(const QList& info); /** * Returns the additional information for the current set view-mode. * Note that the additional-info property is the only property where * the value is dependent from another property (in this case the view-mode). */ - KFileItemDelegate::InformationList additionalInfo() const; + QList visibleRoles() const; + + void setHeaderColumnWidths(const QList& widths); + QList headerColumnWidths() const; /** * Sets the directory properties view mode, show preview, @@ -103,7 +106,7 @@ public: void setAutoSaveEnabled(bool autoSave); bool isAutoSaveEnabled() const; - void updateTimeStamp(); + void update(); /** * Saves the view properties for the directory specified @@ -115,13 +118,12 @@ public: void save(); /** - * Returns the URL of the directory, where the mirrored view properties - * are stored into. Mirrored view properties are used if: - * - there is no write access for storing the view properties into - * the original directory - * - for non local directories + * @return True if properties for the given URL exist: + * As soon as the properties for an URL have been saved with + * ViewProperties::save(), true will be returned. If false is + * returned, the default view-properties are used. */ - static KUrl mirroredDirectory(); + bool exist() const; private: /** @@ -132,24 +134,41 @@ private: QString destinationDir(const QString& subDir) const; /** - * Returns the encoded additional information that can be stored - * in the .directory file. See ViewProperties::decodedAdditionalInfo() - * for the coding format. - * @param info Additional information for the current view mode. + * Returns the view-mode prefix when storing additional properties for + * a view-mode. + */ + QString viewModePrefix() const; + + /** + * Provides backward compatibility with .directory files created with + * Dolphin < 2.0: Converts the old additionalInfo-property into + * the visibleRoles-property and clears the additionalInfo-property. + */ + void convertAdditionalInfo(); + + /** + * Provides backward compatibility with .directory files created with + * Dolphin < 2.1: Converts the old name-role "name" to the generic + * role "text". + */ + void convertNameRoleToTextRole(); + + /** + * Provides backward compatibility with .directory files created with + * Dolphin < 16.11.70: Converts the old name-role "date" to "modificationtime" + */ + + void convertDateRoleToModificationTimeRole(); + /** + * Returns true, if \a filePath is part of the home-path (see QDir::homePath()). */ - int encodedAdditionalInfo(int info) const; + static bool isPartOfHome(const QString& filePath); /** - * Returns the decoded additional information from the .directory - * file by respecting the current set view mode. The additional - * information from the .directory file is an integer value, where: - * - Byte 0 stores the additional info for the details view - * - Byte 1 stores the additional info for the icons view - * - Byte 2 stores the additional info for the column view - * The additional information property is the only property that is - * dependent from another property (in this case the view-mode). + * @return A hash-value for an URL that can be used as directory name. + * Is used to be able to remember view-properties for long baloo-URLs. */ - int decodedAdditionalInfo() const; + static QString directoryHashForUrl(const QUrl &url); Q_DISABLE_COPY(ViewProperties)