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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/***************************************************************************
copyright : (C) 2001-2006 by Robby Stephenson
email : robby@periapsis.org
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of version 2 of the GNU General Public License as *
* published by the Free Software Foundation; *
* *
***************************************************************************/
#ifndef ENTRYEDITDIALOG_H
#define ENTRYEDITDIALOG_H
class KPushButton;
#include "observer.h"
#include "gui/fieldwidget.h"
#include <kdialogbase.h>
#include <tqdict.h>
namespace Tellico {
namespace GUI {
class TabControl;
}
/**
* @author Robby Stephenson
*/
class EntryEditDialog : public KDialogBase, public Observer {
Q_OBJECT
TQ_OBJECT
// needed for completion object support
friend class GUI::FieldWidget;
public:
EntryEditDialog(TQWidget* parent, const char* name);
/**
* Checks to see if any data needs to be saved. Returns @p true if it's ok to continue with
* saving or closing the widget.
*
* @return Returns @p true if either the data has not been modified or the user to save or discard the new data.
*/
bool queryModified();
/**
* Deletes and resets the tqlayout of the tabs.
*
* @param coll A pointer to the collection whose fields should be used for setting up the tqlayout
*/
void setLayout(Data::CollPtr coll);
/**
* Sets the contents of the input controls to match the contents of a list of entries.
*
* @param list A list of the entries. The data in the first one will be inserted in the controls, and
* the widgets will be enabled or not, depending on whether the rest of the entries match the first one.
*/
void setContents(Data::EntryVec entries);
/**
* Clears all of the input controls in the widget. The pointer to the
* current entry is nullified, but not the pointer to the current collection.
*/
void clear();
virtual void addEntries(Data::EntryVec entries);
virtual void modifyEntries(Data::EntryVec entries);
virtual void addField(Data::CollPtr coll, Data::FieldPtr) { setLayout(coll); }
/**
* Updates a widget when its field has been modified. The category may have changed, completions may have
* been added or removed, or what-have-you.
*
* @param coll A pointer to the parent collection
* @param oldField A pointer to the old field, which should have the same name as the new one
* @param newField A pointer to the new field
*/
virtual void modifyField(Data::CollPtr coll, Data::FieldPtr oldField, Data::FieldPtr newField);
/**
* Removes a field from the editor.
*
* @param field The field to be removed
*/
virtual void removeField(Data::CollPtr, Data::FieldPtr field);
public slots:
/**
* Called when the Close button is clicked. It just hides the dialog.
*/
virtual void slotClose();
/**
* Resets the widget, deleting all of its contents
*/
void slotReset();
/**
* Handles clicking the New button. The old entry pointer is destroyed and a
* new one is created, but not added to any collection.
*/
void slotHandleNew();
/**
* Handles clicking the Save button. All the values in the entry widgets are
* copied into the entry object. @ref signalSaveEntry is made. The widget is cleared,
* and the first tab is shown.
*/
void slotHandleSave();
/**
* This slot is called whenever anything is modified. It's public so I can call it
* from a @ref FieldEditWidget.
*/
void slotSetModified(bool modified=true);
private slots:
void slotGoPrevEntry();
void slotGoNextEntry();
private:
/**
* Sets the contents of the input controls to match the contents of a entry.
*
* @param entry A pointer to the entry
* @param highlight An optional string to highlight
*/
void setContents(Data::EntryPtr entry);
/**
* Updates the completion objects in the edit boxes to include values
* contained in a certain entry.
*
* @param entry A pointer to the entry
*/
void updateCompletions(Data::EntryPtr entry);
Data::CollPtr m_currColl;
Data::EntryVec m_currEntries;
GUI::TabControl* m_tabs;
TQDict<GUI::FieldWidget> m_widgetDict;
ButtonCode m_saveBtn, m_newBtn, m_nextBtn, m_prevBtn;
bool m_modified;
bool m_isOrphan;
bool m_isWorking;
bool m_needReset;
};
} // end namespace
#endif
|
