summaryrefslogtreecommitdiff
path: root/src/frontend/cmodulechooserdialog.h
blob: 2f1e93c03e2bf455acff464f43cda60b49661fa7 (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
/*********
*
* This file is part of BibleTime's source code, http://www.bibletime.info/.
*
* Copyright 1999-2007 by the BibleTime developers.
* The BibleTime source code is licensed under the GNU General Public License version 2.0.
*
**********/

#ifndef CMODULECHOOSERDIALOG_H
#define CMODULECHOOSERDIALOG_H

class CSwordModuleInfo;
#include "backend/btmoduletreeitem.h"

#include <QDialog>
#include <QList>
#include <QTreeWidget>


class QDialogButtonBox;


/**
* Abstract dialog which lets the user select modules with checkboxes.
* The dialog will be destroyed after closing. Connect the modulesChanged() signal
* to handle the selection before the dialog is destroyed.
*/
class CModuleChooserDialog : public QDialog
{
	Q_OBJECT
public:
	
	/**
	* Use your own constructor to set extra members.
	* Filters list is given to the module tree creator, see BTModuleTreeItem.
	* For module list see BTModuleTreeItem constructor documentation.
	* Call init() after the constructor, either in the end of your own constructor or from outside.
	*/
	CModuleChooserDialog(QWidget* parent, QString title, QString label, QList<CSwordModuleInfo*>* allModules = 0);
	
	virtual ~CModuleChooserDialog() {}
	
	/** Call this after/from the constructor.*/
	void init();
	
	/** Set the module tree grouping.
	* Initially it's taken from the CBTConfig so it needs to be set only if that default is not adequate.
	* This must be called before the tree is initialized, i.e. before init().
	*/
	void setGrouping(BTModuleTreeItem::Grouping grouping) {m_grouping = grouping;}
	
	/** Set the module tree filters. See setGrouping() for the calling convention and
	* BTModuleTreeItem for the filters. By default the filters list is empty.
	*/
	void setFilters(QList<BTModuleTreeItem::Filter*> filters) {m_filters = filters;}

	QTreeWidget* treeWidget() {return m_moduleChooser;}

	QPushButton* okButton();

signals:
	
	/** The signal is sent when the OK button is clicked. The list includes the selected (checked) modules. The tree widget can be used through the pointer for more complicated actions. */
	void modulesChanged(QList<CSwordModuleInfo*>, QTreeWidget*);

protected:

	/**
	* Initialize one tree widget item.
	* To be overridden. This is called for each QTreeWidgetItem when it is created.
	* Here you can set for example the checked status of the item.
	*/
	virtual void initModuleItem(BTModuleTreeItem* btItem, QTreeWidgetItem* widgetItem) = 0;
	

	
private slots:
	
	/** Emits the signal modulesChanged() with the list of the selected modules. */
	void slotOk();

private:
	/** Initialize the module tree.	*/
	void initTree();

	/** Initializes the view of this dialog.*/
	void initView();

	/** Call this from initTree(). */
	void createModuleTree(BTModuleTreeItem* item, QTreeWidgetItem* widgetItem);

	QTreeWidget *m_moduleChooser;
	QDialogButtonBox *m_buttonBox;
	QString m_title;
	QString m_labelText;
	QList<BTModuleTreeItem::Filter*> m_filters;
	BTModuleTreeItem::Grouping m_grouping;
	QList<CSwordModuleInfo*> m_moduleList;
};


#endif