git.maemo.org Git - mdictionary/blob - src/include/translation.h

   1 /*******************************************************************************
   2
   3     This file is part of mDictionary.
   4
   5     mDictionary is free software: you can redistribute it and/or modify
   6     it under the terms of the GNU General Public License as published by
   7     the Free Software Foundation, either version 3 of the License, or
   8     (at your option) any later version.
   9
  10     mDictionary is distributed in the hope that it will be useful,
  11     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13     GNU General Public License for more details.
  14
  15     You should have received a copy of the GNU General Public License
  16     along with mDictionary.  If not, see <http://www.gnu.org/licenses/>.
  17
  18     Copyright 2010 Comarch S.A.
  19
  20 *******************************************************************************/
  21
  22 /*! \file translation.h
  23 \brief Interface for translation instances \see Translation
  24
  25 \author Bartosz Szatkowski <bulislaw@linux.com>
  26 */
  27
  28 #ifndef TRANSLATION_H
  29 #define TRANSLATION_H
  30
  31 #include <QString>
  32 #include <QMetaType>
  33 #include <QDebug>
  34
  35 class CommonDictInterface;
  36
  37
  38 /*! Translation is kind of GoF proxy, it stores key:translation pair and
  39   provides it in lazy way -> key is available always, but translation is fetched
  40   as late as possible*/
  41 class Translation {
  42   public:
  43     Translation  () { _bookmark = 0;}
  44     virtual ~Translation () {}
  45     //! \return word to be translated
  46     virtual QString key() const = 0;
  47
  48     bool operator==(Translation* translation) {
  49         return this->key()==translation->key();
  50     }
  51
  52     /*! \returns dictionary information (plugin name, languages, <logo> etc)\
  53          to be displayed in translation table header */
  54     virtual QString dictionaryInfo() const = 0;
  55
  56     //! \return parsed raw format into html
  57     virtual QString toHtml() const = 0;
  58
  59     //! \return whether given translation is taken from bookmarks
  60     virtual bool isBookmark() const {
  61         return _bookmark;
  62    }
  63
  64    //! \param b if true then translation is from bookmarks
  65    void setBookmark(bool b) {
  66        _bookmark = b;
  67    }
  68
  69     //! returns coresponding dict object
  70    virtual uint dict() const {return 0;}
  71
  72    protected:
  73        bool _bookmark;
  74
  75 };
  76
  77 Q_DECLARE_METATYPE(Translation*);
  78 Q_DECLARE_METATYPE(QList<Translation*>);
  79
  80 #endif