If an information entry will be added to KFileItemDelegate (like done recently), adjusting the corresponding code in Dolphin is a real pain, as the new information will be shown in Dolphin the following way:

 - As additional columns in the details view
 - As additional lines in the icons view
 - As menu entries in the "Sort By" and "Additional Information" groups
 - As popup menu entries in the details view header popup
 - As checkable entries in the View Properties dialog

To prevent similar painful transitions in future, the class AdditionalInfoManager has been introduced. All parts in Dolphin that access/show/store additional information, use the AdditionalInfoManager now. If a new information entry will be added in KFileItemDelegate in future, only a small adjustment in AdditionalInfoManager will be required.

Still open currently:
- AdditionalInfoDialog does not use AdditionalInfoManager yet
- DolphinView::Sorting should be replaced by KFileItemDelegate::Information, so that the sorting can also be done in a generic way.
- The data for KFileItemDelegate::PathOrUrl is not determined

The open issues will get fixed during the next days.

Kudos to the brave warriors Sebastian and Frank, that tried to add a new information ;-)

CCMAIL: [email protected]
CCMAIL: [email protected]

svn path=/trunk/KDE/kdebase/apps/; revision=1126410

1 files changed, 88 insertions, 0 deletions

diff --git a/src/additionalinfomanager.h b/src/additionalinfomanager.h
new file mode 100644
index 000000000..83b62c158
--- /dev/null
+++ b/src/additionalinfomanager.h
@@ -0,0 +1,88 @@
+/***************************************************************************
+ *   Copyright (C) 2010 by Peter Penz <[email protected]>             *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
+ ***************************************************************************/
+
+#ifndef ADDITIONALINFOMANAGER_H
+#define ADDITIONALINFOMANAGER_H
+
+#include <libdolphin_export.h>
+#include <kfileitemdelegate.h>
+
+#include <QList>
+#include <QMap>
+
+/**
+ * @brief Manages the information that is available by KFileItemDelegate::Information.
+ *
+ * The information that is available by KFileItemDelegate::Information will be shown
+ * in Dolphin the following way:
+ * - As additional columns in the details view
+ * - As additional lines in the icons view
+ * - As menu entries in the "Sort By" and "Additional Information" groups
+ * - As popup menu entries in the details view header popup
+ * - As checkable entries in the View Properties dialog
+ *
+ * The AdditionalInfoManager provides a central place to get all available keys,
+ * the corresponding translations, action names, etc., so that modifications or
+ * extensions in KFileItemDelegate only require adjustments in the implementation
+ * of this class.
+ */
+class LIBDOLPHINPRIVATE_EXPORT AdditionalInfoManager
+{
+public:
+    static AdditionalInfoManager& instance();
+
+    /**
+     * @return List of all available information entries of KFileItemDelegate.
+     *         All entries of this list are keys for accessing the corresponding
+     *         data (see actionCollectionName(), translation(), bitValue()).
+     */
+    KFileItemDelegate::InformationList keys() const;
+
+    /**
+     * @return Key for the model column with the index \p columnIndex.
+     */
+    KFileItemDelegate::Information keyForColumn(int columnIndex) const;
+
+    QString actionCollectionName(KFileItemDelegate::Information info) const;
+
+    QString translation(KFileItemDelegate::Information info) const;
+
+    /**
+     * @return Bitvalue for \p info that is stored in a ViewProperties instance.
+     */
+    int bitValue(KFileItemDelegate::Information info) const;
+
+protected:
+    AdditionalInfoManager();
+    virtual ~AdditionalInfoManager();
+    friend class AdditionalInfoManagerSingleton;
+
+private:
+    struct AdditionalInfo {
+        const char* const actionCollectionName;
+        const char* const translation;
+        const int bitValue;
+    };
+
+    KFileItemDelegate::InformationList m_informations;
+    QMap<KFileItemDelegate::Information, const AdditionalInfo*> m_map;
+};
+
+#endif
+