src/views/additionalinfoaccessor.h

   1 /***************************************************************************
   2  *   Copyright (C) 2010 by Peter Penz <peter.penz19@gmail.com>             *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program; if not, write to the                         *
  16  *   Free Software Foundation, Inc.,                                       *
  17  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  18  ***************************************************************************/
  19
  20 #ifndef ADDITIONALINFOACCESSOR_H
  21 #define ADDITIONALINFOACCESSOR_H
  22
  23 #include <libdolphin_export.h>
  24 #include <KFileItemDelegate>
  25 #include <views/dolphinview.h>
  26
  27 #include <QList>
  28 #include <QMap>
  29
  30 /**
  31  * @brief Allows to access the information that is available by KFileItemDelegate::Information.
  32  *
  33  * The information that is available by KFileItemDelegate::Information will be shown
  34  * in Dolphin the following way:
  35  * - As additional columns in the details view
  36  * - As additional lines in the icons view
  37  * - As menu entries in the "Sort By" and "Additional Information" groups
  38  * - As popup menu entries in the details view header popup
  39  * - As checkable entries in the View Properties dialog
  40  *
  41  * The AdditionalInfoAccessor provides a central place to get all available keys,
  42  * the corresponding translations, action names, etc., so that modifications or
  43  * extensions in KFileItemDelegate only require adjustments in the implementation
  44  * of this class.
  45  */
  46 class LIBDOLPHINPRIVATE_EXPORT AdditionalInfoAccessor
  47 {
  48 public:
  49     enum ActionCollectionType {
  50         /// Action collection from "View -> Sort By"
  51         SortByType,
  52         /// Action collection from "View -> Additional Information"
  53         AdditionalInfoType
  54     };
  55
  56     static AdditionalInfoAccessor& instance();
  57
  58     /**
  59      * @return List of all available information entries of KFileItemDelegate.
  60      *         All entries of this list are keys for accessing the corresponding
  61      *         data (see actionCollectionName(), translation(), bitValue()).
  62      */
  63     KFileItemDelegate::InformationList keys() const;
  64
  65     /**
  66      * @return Key for the model column with the index \p columnIndex.
  67      */
  68     KFileItemDelegate::Information keyForColumn(int columnIndex) const;
  69
  70     QString actionCollectionName(KFileItemDelegate::Information info, ActionCollectionType type) const;
  71
  72     QString translation(KFileItemDelegate::Information info) const;
  73
  74     /**
  75      * @return String representation of the value that is stored in the .directory
  76      *         by ViewProperties.
  77      */
  78     QString value(KFileItemDelegate::Information info) const;
  79
  80     DolphinView::Sorting sorting(KFileItemDelegate::Information info) const;
  81
  82     /**
  83      * @return Bitvalue for \p info that is stored in a ViewProperties instance.
  84      *         Is required only for backward compatibility with the version 1 of
  85      *         the view-properties.
  86      */
  87     int bitValue(KFileItemDelegate::Information info) const;
  88
  89 protected:
  90     AdditionalInfoAccessor();
  91     virtual ~AdditionalInfoAccessor();
  92     friend class AdditionalInfoAccessorSingleton;
  93
  94 private:
  95     struct AdditionalInfo {
  96         const char* const actionCollectionName;
  97         const char* const context;
  98         const char* const translation;
  99         const char* const value;
 100         const DolphinView::Sorting sorting;
 101         const int bitValue; // for backward compatibility with version 1 of view-properties
 102     };
 103
 104     KFileItemDelegate::InformationList m_information;
 105     QMap<KFileItemDelegate::Information, const AdditionalInfo*> m_map;
 106 };
 107
 108 #endif
 109