summaryrefslogtreecommitdiff
path: root/src/bibletime_dbus_adaptor.h
blob: 0f9f301c5ec7d95c17752ff6a38b8d5b6b9db8b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/*********
*
* This file is part of BibleTime's source code, http://www.bibletime.info/.
*
* Copyright 1999-2011 by the BibleTime developers.
* The BibleTime source code is licensed under the GNU General Public License version 2.0.
*
**********/

#ifndef NO_DBUS

#ifndef BIBLETIME_DBUS_ADAPTOR_H
#define BIBLETIME_DBUS_ADAPTOR_H

#include "bibletime.h"

#ifndef NO_DBUS
#include <QDBusAbstractAdaptor>
#endif
#include <QString>
#include <QStringList>


class BibleTimeDBusAdaptor : QDBusAbstractAdaptor {
        Q_OBJECT
        Q_CLASSINFO("D-Bus Interface", "info.bibletime.BibleTime")

    private:
        BibleTime* m_bibletime;

    public:
        BibleTimeDBusAdaptor(BibleTime *bibletime_ptr);

    public slots:
        /** Sync all open Bible windows to the key.
         * @param key The key which is set to all Bible windows.
         */
        void syncAllBibles(const QString& key);
        /** Sync all open commentary windows to the key.
        * @param key The key which is set to all Commentary windows.
        */
        void syncAllCommentaries(const QString& key);
        /** Sync all open lexicon windows to the key.
        * @param key The key which is set to all Lexicon windows.
        */
        void syncAllLexicons(const QString& key);
        /** Sync all open verse based (i.e. Bibles and commentaries) windows to the key.
        * @param key The key which is set to all Bible and Commentary windows.
        */
        void syncAllVerseBasedModules(const QString& key);

        /** Open a new read window for the module moduleName using the given key
        * @param moduleName The name of the module which is opened in a new module window.
        * @param key The key to set to the newly opened window.
        */
        void openWindow(const QString& moduleName, const QString& key);
        /** Open a new read window for the default Bible module using the given key
        * @param key The key to set to the newly opened window.
        */
        void openDefaultBible(const QString& key);
        /** Close all open windows.
        */
        void closeAllModuleWindows();
        /** Returns the reference used in the current window.
        * The format of the returned reference is
        *    [Module] [Type] OSIS_Reference,
        * wtih type one of BIBLE/COMMENTARY/BOOK/LEXICON/UNSUPPORTED
        * If the type is BIBLE or COMMENTARY the reference is an OSIS ref
        * in the other cases it's the key name, for books /Chapter/Subsection
        * for Lexicons just the plain key, e.g. "ADAM".
        * e.g.
        *        [KJV] [BIBLE]    Gen.1.1
        *         [MHC] [COMMENTARY]  Gen.1.1
        *         [ISBE] [LEXICON]  REDEMPTION
        * @return The reference displayed in the currently active module window. Empty if none is active.
        */
        QString getCurrentReference();
        /** Search the searchText in the specified module.
        * @param moduleName The module to search in
        * @param searchText Search for this in the modules
        * @return The search result. It's in the format [modulename] osis_ref_of_the_found_key. For example "[KJV] Gen.1.1".
        */
        QStringList searchInModule(const QString& moduleName, const QString& searchText) ;
        /** Search in all open modules and return the search result.
        * The result is in the same format as searchInModule
        * @param searchText Search for this in the modules
        * @return The search result for a searchin all opened module windows
        * @see searchInModule For the search result format.
        */
        QStringList searchInOpenModules(const QString& searchText);
        /** Search in the default Bible module and return the search result.
        * The result is in the same format as searchInModule
        * @param searchText Search for this in the modules
        * @return The search result for a search in the default Bible
        * @see searchInModule
        */
        QStringList searchInDefaultBible(const QString& searchText);
        /** Return a list of modules of the given type.
        * @param type One of BIBLES, COMMENTARIES, LEXICONS, BOOKS
        * @return The list of modules of the given type, may be empty
        */
        QStringList getModulesOfType(const QString& type);
};

#endif

#endif //NO_DBUS