Change "Date" to "Modified" and allow access to new "Accessed" time field

[dolphin.git] / src / views / viewproperties.h

diff --git a/src/views/viewproperties.h b/src/views/viewproperties.h
index bb476dc44a16b2a77a0b4a8be8a7694af28b9a65..05b80f45551d0e3419a178360a1e360125600c2a 100644 (file)
--- a/src/views/viewproperties.h
+++ b/src/views/viewproperties.h
@@ -1,5 +1,5 @@
 /***************************************************************************
 /***************************************************************************

- *   Copyright (C) 2006-2010 by Peter Penz <peter.penz@gmx.at>             *
+ *   Copyright (C) 2006-2010 by Peter Penz <peter.penz19@gmail.com>        *

  *   Copyright (C) 2006 by Aaron J. Seigo <aseigo@kde.org>                 *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
  *   Copyright (C) 2006 by Aaron J. Seigo <aseigo@kde.org>                 *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *


@@ -22,8 +22,8 @@
 #define VIEWPROPERTIES_H
 
 #include <views/dolphinview.h>
 #define VIEWPROPERTIES_H
 
 #include <views/dolphinview.h>

-#include <kurl.h>
-#include <libdolphin_export.h>
+#include <QUrl>
+#include "dolphin_export.h"

 
 class ViewPropertySettings;
 /**
 
 class ViewPropertySettings;
 /**


@@ -35,9 +35,9 @@ class ViewPropertySettings;
  * just construct an instance by passing the path of the directory:
  *
  * \code
  * 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 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
  * \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.
  */
  * (see GeneralSettings::globalViewMode()), the values from the global .directory file
  * are used for initialization.
  */

-class LIBDOLPHINPRIVATE_EXPORT ViewProperties
+class DOLPHIN_EXPORT ViewProperties

 {
 public:
 {
 public:

-    explicit ViewProperties(const KUrl& url);
+    explicit ViewProperties(const QUrl& url);

     virtual ~ViewProperties();
 
     void setViewMode(DolphinView::Mode mode);
     DolphinView::Mode viewMode() const;
 
     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;
 
     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).
      */
      * 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<QByteArray>& 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).
      */
 
     /**
      * 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<QByteArray> visibleRoles() const;
+
+    void setHeaderColumnWidths(const QList<int>& widths);
+    QList<int> headerColumnWidths() const;

 
     /**
      * Sets the directory properties view mode, show preview,
 
     /**
      * Sets the directory properties view mode, show preview,


@@ -103,7 +106,7 @@ public:
     void setAutoSaveEnabled(bool autoSave);
     bool isAutoSaveEnabled() const;
 
     void setAutoSaveEnabled(bool autoSave);
     bool isAutoSaveEnabled() const;
 

-    void updateTimeStamp();
+    void update();

 
     /**
      * Saves the view properties for the directory specified
 
     /**
      * Saves the view properties for the directory specified


@@ -115,13 +118,12 @@ public:
     void save();
 
     /**
     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:
     /**
 
 private:
     /**


@@ -132,24 +134,41 @@ private:
     QString destinationDir(const QString& subDir) const;
 
     /**
     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)
 
 
     Q_DISABLE_COPY(ViewProperties)