Add comments and translations for xdxf downloading dialog
[mdictionary] / src / plugins / xdxf / XdxfDictSelectDialog.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 /*!
23   \file XdxfDictSelectDialog.h
24   \author Mateusz Półrola <mateusz.polrola@comarch.com>
25   */
26
27 #ifndef XDXFDICTSELECTDIALOG_H
28 #define XDXFDICTSELECTDIALOG_H
29
30 #include <QDialog>
31 #include <QtGui>
32 #include "DownloadDict.h"
33 #include "DictsModel.h"
34 #include "DictsProxyModel.h"
35
36
37 /*!
38   Shows dialog with list of dictionaries and informations about them, allowing user to filter data based on dictionaries languages, and to select one of them.
39   */
40 class XdxfDictSelectDialog : public QDialog {
41     Q_OBJECT
42 public:
43     /*!
44       Constructor
45       \param dicts list of DownloadDict objects describing dictionaries.
46       */
47     XdxfDictSelectDialog(QList<DownloadDict> dicts,
48                                   QWidget *parent = 0);
49
50     /*!
51       Returns download link of dictionary selected by user. This string is set
52       only when user select any dictionary (dialog was accepted), otherwise it
53      is empty.
54       */
55     QString link() { return _link;}
56
57 private:
58     QTreeView* treeView;
59     DictsModel* model;
60     //used by treeView to allow filtering and sorting
61     DictsProxyModel *proxyModel;
62     QVBoxLayout* layout;
63     QHBoxLayout* checkBoxLayout;
64     QComboBox* langFrom;
65     QComboBox* langTo;
66     QLabel* langFromLabel;
67     QLabel* langToLabel;
68
69 private Q_SLOTS:
70     //creates items for comboboxes and creates model with dicts info
71     void initializeDicts();
72
73     //filters dicts after filtering settings change
74     void refreshDictList();
75
76     //accept dialog and sets download link of clicked dictionary
77     void itemClicked(QModelIndex);
78
79 private:
80     QList<DownloadDict>* dictList;
81     QString _link;
82 };
83
84 #endif // XDXFDICTSELECTDIALOG_H