src/Qtx/QtxResourceMgr.h

   1 // Copyright (C) 2007-2019  CEA/DEN, EDF R&D, OPEN CASCADE
   2 //
   3 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
   4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
   5 //
   6 // This library is free software; you can redistribute it and/or
   7 // modify it under the terms of the GNU Lesser General Public
   8 // License as published by the Free Software Foundation; either
   9 // version 2.1 of the License, or (at your option) any later version.
  10 //
  11 // This library is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 // Lesser General Public License for more details.
  15 //
  16 // You should have received a copy of the GNU Lesser General Public
  17 // License along with this library; if not, write to the Free Software
  18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  19 //
  20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  21 //
  22
  23 // File:      QtxResourceMgr.h
  24 // Author:    Alexander SOLOVYOV, Sergey TELKOV
  25 //
  26 #ifndef QTXRESOURCEMGR_H
  27 #define QTXRESOURCEMGR_H
  28
  29 #include "Qtx.h"
  30
  31 #ifndef QTX_NO_INDEXED_MAP
  32 #include "QtxMap.h"
  33 #endif
  34
  35 #include <QMap>
  36 #include <QList>
  37 #include <QFont>
  38 #include <QColor>
  39 #include <QPixmap>
  40 #include <QByteArray>
  41 #include <QStringList>
  42 #include <QLinearGradient>
  43 #include <QRadialGradient>
  44 #include <QConicalGradient>
  45
  46 class QTranslator;
  47
  48 #ifdef WIN32
  49 #pragma warning( disable:4251 )
  50 #endif
  51
  52 class QTX_EXPORT QtxResourceMgr
  53 {
  54   class IniFormat;
  55   class XmlFormat;
  56   class Resources;
  57
  58 public:
  59   class Format;
  60
  61 #ifdef QTX_NO_INDEXED_MAP
  62   typedef QMap<QString, QString> Section;   //!< resource section
  63 #else
  64   typedef IMap<QString, QString> Section;   //!< resource section
  65 #endif
  66
  67   //! Working mode; defines a way how resource manager handles user preferences
  68   typedef enum {
  69     AllowUserValues,       //!< User values are processed by the resource manager
  70     IgnoreUserValues       //!< User values are ignored by the resource manager
  71   } WorkingMode;
  72
  73 public:
  74   QtxResourceMgr( const QString&, const QString& = QString() );
  75   virtual ~QtxResourceMgr();
  76
  77   QString          appName() const;
  78   QStringList      dirList() const;
  79
  80   bool             checkExisting() const;
  81   virtual void     setCheckExisting( const bool );
  82
  83   bool             isPixmapCached() const;
  84   void             setIsPixmapCached( const bool );
  85
  86   void             clear();
  87
  88   WorkingMode      workingMode() const;
  89   WorkingMode      setWorkingMode( WorkingMode );
  90
  91   bool             value( const QString&, const QString&, int& ) const;
  92   bool             value( const QString&, const QString&, double& ) const;
  93   bool             value( const QString&, const QString&, bool& ) const;
  94   bool             value( const QString&, const QString&, QColor& ) const;
  95   bool             value( const QString&, const QString&, QFont& ) const;
  96   bool             value( const QString&, const QString&, QByteArray& ) const;
  97   bool             value( const QString&, const QString&, QLinearGradient& ) const;
  98   bool             value( const QString&, const QString&, QRadialGradient& ) const;
  99   bool             value( const QString&, const QString&, QConicalGradient& ) const;
 100   bool             value( const QString&, const QString&, Qtx::BackgroundData& ) const;
 101   bool             value( const QString&, const QString&, QString&, const bool = true ) const;
 102
 103   int              integerValue( const QString&, const QString&, const int = 0 ) const;
 104   double           doubleValue( const QString&, const QString&, const double = 0 ) const;
 105   bool             booleanValue( const QString&, const QString&, const bool = false ) const;
 106   QFont            fontValue( const QString&, const QString&, const QFont& = QFont() ) const;
 107   QColor           colorValue( const QString&, const QString&, const QColor& = QColor() ) const;
 108   QString          stringValue( const QString&, const QString&, const QString& = QString(), const bool = true ) const;
 109   QByteArray       byteArrayValue( const QString&, const QString&, const QByteArray& = QByteArray() ) const;
 110   QLinearGradient  linearGradientValue( const QString&, const QString&, const QLinearGradient& = QLinearGradient() ) const;
 111   QRadialGradient  radialGradientValue( const QString&, const QString&, const QRadialGradient& = QRadialGradient() ) const;
 112   QConicalGradient conicalGradientValue( const QString&, const QString&, const QConicalGradient& = QConicalGradient() ) const;
 113   Qtx::BackgroundData backgroundValue( const QString&, const QString&, const Qtx::BackgroundData& = Qtx::BackgroundData() ) const;
 114
 115   bool             hasSection( const QString& ) const;
 116   bool             hasValue( const QString&, const QString& ) const;
 117
 118   void             setValue( const QString&, const QString&, const int );
 119   void             setValue( const QString&, const QString&, const double );
 120   void             setValue( const QString&, const QString&, const bool );
 121   void             setValue( const QString&, const QString&, const QFont& );
 122   void             setValue( const QString&, const QString&, const QColor& );
 123   void             setValue( const QString&, const QString&, const QString& );
 124   void             setValue( const QString&, const QString&, const QByteArray& );
 125   void             setValue( const QString&, const QString&, const QLinearGradient& );
 126   void             setValue( const QString&, const QString&, const QRadialGradient& );
 127   void             setValue( const QString&, const QString&, const QConicalGradient& );
 128   void             setValue( const QString&, const QString&, const Qtx::BackgroundData& );
 129
 130   void             remove( const QString& );
 131   void             remove( const QString&, const QString& );
 132
 133   QString          currentFormat() const;
 134   void             setCurrentFormat( const QString& );
 135
 136   Format*          format( const QString& ) const;
 137   void             installFormat( Format* );
 138   void             removeFormat( Format* );
 139
 140   QStringList      options() const;
 141   QString          option( const QString& ) const;
 142   void             setOption( const QString&, const QString& );
 143
 144   QStringList      constants() const;
 145   QString          constant( const QString& ) const;
 146   void             setConstant( const QString&, const QString& );
 147
 148   QPixmap          defaultPixmap() const;
 149   virtual void     setDefaultPixmap( const QPixmap& );
 150
 151   QString          resSection() const;
 152   QString          langSection() const;
 153   QString          sectionsToken() const;
 154
 155   QPixmap          loadPixmap( const QString&, const QString& ) const;
 156   QPixmap          loadPixmap( const QString&, const QString&, const bool ) const;
 157   QPixmap          loadPixmap( const QString&, const QString&, const QPixmap& ) const;
 158   void             loadLanguage( const QString& = QString(), const QString& = QString() );
 159
 160   void             raiseTranslators( const QString& );
 161   void             removeTranslators( const QString& );
 162   void             loadTranslator( const QString&, const QString& );
 163   void             loadTranslators( const QString&, const QStringList& );
 164   void             addTranslator( const QString&, QTranslator* );
 165
 166   QString          path( const QString&, const QString&, const QString& ) const;
 167
 168   bool             load();
 169   bool             import( const QString& );
 170   bool             save();
 171
 172   QStringList      sections() const;
 173   QStringList      sections(const QRegExp&) const;
 174   QStringList      sections(const QStringList&) const;
 175   QStringList      subSections(const QString&, const bool = true) const;
 176   QStringList      parameters( const QString& ) const;
 177   QStringList      parameters( const QStringList& ) const;
 178
 179   void             refresh();
 180
 181 protected:
 182   virtual QString  defaultLanguage() const;
 183
 184   virtual void     setDirList( const QStringList& );
 185   virtual void     setResource( const QString&, const QString&, const QString& );
 186
 187   virtual QString  userFileName( const QString&, const bool = true ) const;
 188   virtual QString  globalFileName( const QString& ) const;
 189
 190   virtual void     saved();
 191
 192 private:
 193   void             initialize( const bool = true ) const;
 194   QString          substMacro( const QString&, const QMap<QChar, QString>& ) const;
 195
 196 private:
 197   typedef QList<Resources*>        ResList;
 198   typedef QList<QTranslator*>      TransList;
 199   typedef QList<Format*>           FormatList;
 200   typedef QMap<QString, QString>   OptionsMap;
 201   typedef QMap<QString, TransList> TransListMap;
 202
 203 private:
 204   QString          myAppName;                 //!< application name
 205   QStringList      myDirList;                 //!< list of resources directories
 206   FormatList       myFormats;                 //!< list of formats
 207   OptionsMap       myOptions;                 //!< options map
 208   OptionsMap       myConstants;               //!< constants map
 209   ResList          myResources;               //!< resources list
 210   bool             myCheckExist;              //!< "check existance" flag
 211   TransListMap     myTranslator;              //!< map of loaded translators
 212   QPixmap*         myDefaultPix;              //!< default icon
 213   bool             myIsPixmapCached;          //!< "cached pixmaps" flag
 214
 215   bool             myHasUserValues;           //!< \c true if user preferences has been read
 216   WorkingMode      myWorkingMode;             //!< working mode
 217
 218   friend class QtxResourceMgr::Format;
 219 };
 220
 221 class QTX_EXPORT QtxResourceMgr::Format
 222 {
 223 public:
 224   Format( const QString& );
 225   virtual ~Format();
 226
 227   QString                format() const;
 228
 229   QStringList            options() const;
 230   QString                option( const QString& ) const;
 231   void                   setOption( const QString&, const QString& );
 232
 233   bool                   load( Resources* );
 234   bool                   save( Resources* );
 235
 236 protected:
 237   virtual bool           load( const QString&, QMap<QString, Section>& ) = 0;
 238   virtual bool           save( const QString&, const QMap<QString, Section>& ) = 0;
 239
 240 private:
 241   QString                myFmt;    //!< format name
 242   QMap<QString, QString> myOpt;    //!< options map
 243 };
 244
 245 #endif // QTXRESOURCEMGR_H