1 /*******************************************************************************
3 This file is part of mDictionary.
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.
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.
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/>.
18 Copyright 2010 Comarch S.A.
20 *******************************************************************************/
22 // Created by Bartosz Szatkowski
24 #ifndef COMMONDICTINTERFACE_H
25 #define COMMONDICTINTERFACE_H
31 #include "translation.h"
34 Q_DECLARE_INTERFACE (CommonDictInterface, "xdxfInterface")
36 //! Interface for dict engines plugins
37 class CommonDictInterface : public QObject {
40 CommonDictInterface(QObject *parent = 0):QObject(parent) {}
42 //! returns source language code iso 639-2
43 virtual QString langFrom() const = 0;
45 //! returns destination language code iso 639-2
46 virtual QString langTo() const = 0;
48 //! returns dictionary name (like "old english" or so
49 virtual QString name() const = 0;
51 //! returns dictionary type (xdxf, google translate, etc)
52 virtual QString type() const = 0;
54 //! returns information about dictionary in html (name, authors, etc)
55 virtual QString infoNote() const = 0;
57 //! return dialog that creates new dictionary and fills necesary options
58 //! QDialog should returns Setting* object after being showed
59 virtual QDialog* loadDialog() = 0;
61 //! return dialog with dictionary settings
62 virtual QDialog* settingsDialog() = 0;
64 //! return new, clean copy of plugin with setting set as in Settings*
65 virtual CommonDictInterface* getNew(const Settings*) const = 0;
67 //! returns whether plugin can start searching
68 virtual bool isAvailable() const = 0;
70 //! returns the actual translation of a word given in key
71 virtual QString search(QString key) = 0;
73 //! \returns unique value (unique for every dictionary not plugin
74 virtual uint hash() const = 0;
77 /*! performs search in dictionary
78 \param word word to search in dictionary
79 \param limit limit on number of results
81 After finishing search it have to emit
82 \see CommonDictInterface:finalTranslation finalTranslation
85 virtual void searchWordList(QString word, int limit) = 0;
87 //! stop current operation
88 virtual void stop() = 0;
91 //! emit list of found Translations
92 void finalTranslation(QList<Translation*>);
94 //! emited after dictionary is ready to use afer being loaded
95 void loaded(CommonDictInterface*);
98 Q_DECLARE_INTERFACE(CommonDictInterface, "CommonDictInterface/0.1");