git.maemo.org Git - mdictionary/blob - trunk/src/base/gui/DictManagerWidget.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 DictManagerWidget.h
  23 //! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  24
  25 #ifndef DICTMANAGERWIDGET_H
  26 #define DICTMANAGERWIDGET_H
  27
  28 #include <QWidget>
  29 #include <QtGui>
  30 #include "../../includes/GUIInterface.h"
  31
  32
  33 //! Implements dictionaries management widget
  34 /*!
  35   Shows list of loaded dictionaries and their states (active/inactive).
  36   It allows to change dicts states, add new dict, remove selected one or
  37   change settings of selected dict. All changes are saved automatically after
  38   hiding of this widget.
  39 */
  40 class DictManagerWidget : public QDialog {
  41     Q_OBJECT
  42 public:
  43     //! Constructor
  44     /*!
  45       \param parent parent of this widget, which must be subclass of
  46       GUIInterface, because it will use it to get info about loaded plugins
  47       and dicts.
  48     */
  49     explicit DictManagerWidget(GUIInterface *parent = 0);
  50
  51 protected:
  52     void showEvent(QShowEvent *e);
  53     void hideEvent(QHideEvent *e);
  54
  55 Q_SIGNALS:
  56     //! Emitted when hiding widget, it will save states of dictionaries
  57     /*!
  58         \param list of only active dictionaries
  59     */
  60     void selectedDictionaries(QList<CommonDictInterface*>);
  61
  62     //! Emitted when user wants to add new dictionary
  63     /*!
  64         \param new dictionary returned by specific plugin dialog
  65     */
  66     void addDictionary(CommonDictInterface*);
  67
  68     //! Emitted when user wants to remove dictionary
  69     /*!
  70         \param dictionary which will be removed
  71     */
  72     void removeDictionary(CommonDictInterface*);
  73
  74
  75 public Q_SLOTS:
  76     #ifndef Q_WS_MAEMO_5
  77         void save();
  78     #endif
  79
  80 private Q_SLOTS:
  81     /*!
  82         Shows plugin select dialog and then specific plugin add new dictionary
  83         dialog, which will return new CommonDictInterface* object, which is
  84         later passed as parameter of addDictionary signal
  85     */
  86     void addNewDictButtonClicked();
  87
  88     /*!
  89         Passes selected dictionary from list as parameter of removeDictionary
  90         signal
  91     */
  92     void removeButtonClicked();
  93
  94     //! user select one of items
  95     void itemSelected(QListWidgetItem*);
  96
  97     //! Shows plugin's settings dialog
  98     void settingsButtonClicked();
  99
 100     //! Each change of state (that needs to be saved) should call this to
 101     //! indicate state change
 102     void changed();
 103
 104     //! saves changes
 105     void saveChanges();
 106
 107 private:
 108     void initalizeUI();
 109     QPushButton* addNewDictButton;
 110     QPushButton* removeDictButton;
 111     QPushButton* settingsButton;
 112
 113     QVBoxLayout* verticalLayout;
 114     QHBoxLayout* buttonGroup;
 115     QListWidget* dictListWidget;
 116
 117     //holds association between items on list and CommonDictInterface objects
 118     QHash<QListWidgetItem*, CommonDictInterface*> dictsHash;
 119     GUIInterface* guiInterface;
 120
 121     bool _changed;
 122
 123     void refreshDictsList();
 124
 125     #ifndef Q_WS_MAEMO_5
 126         QPushButton* closeButton;
 127         bool _save;
 128     #endif
 129 };
 130
 131 #endif // DICTMANAGERWIDGET_H