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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
/* This file is part of the KDE project
Copyright (C) 2003-2007 Jaroslaw Staniek <js@iidea.pl>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KexiStartupDialog_h
#define KexiStartupDialog_h
#include <kdialogbase.h>
#include <kicondialog.h>
#include <kiconview.h>
#include <kfileiconview.h>
#include <kfiledialog.h>
#include <tqlabel.h>
#include <tqsplitter.h>
#include <kexidb/connectiondata.h>
#include <core/kexiprojectdata.h>
class KexiStartupDialogPrivate;
class KexiProjectData;
class KexiProjectSet;
class KexiDBConnectionSet;
class ConnectionDataLVItem;
/*!
This class is used to show the template/open-existing/open-recent tabbed dialog
on Kexi startup. If only one page is shown, tab is no displayed, so dialog
becomes a normal "plain" type dialog.
*/
class KEXIMAIN_EXPORT KexiStartupDialog : public KDialogBase
{
Q_OBJECT
public:
/*! The Dialog returns one of these values depending
on the input of the user.
CancelResult The user pressed 'Cancel'
CreateBlankResult The user selected a template
CreateFromTemplateResult The user selected a template
ImportResult The user selected a template
OpenExistingResult The user has chosen an existing connection or db file
OpenRecentResult The user selected one of recently used databases
*/
enum Result {
CancelResult, //!< The user has pressed 'Cancel'
CreateBlankResult, //!< The user has selected a template
CreateFromTemplateResult, //!< The user has selected a template to be used for creating a new db
ImportResult, //!< The user has chosen to import db
OpenExistingResult, //!< The user has chosen an existing connection or db file
OpenRecentResult //!< The user has selected one of recently used databases
};
/*!
To configure the dialog you have to use this enum
(any !=0 or'ed value is ok)
- Templates Show "Templates" tab
- OpenExisting Show "Open existing" tab
- OpenRecent Show "Recent" tab
- Everything Show everything above
*/
enum DialogType { Templates = 1, OpenExisting = 2, OpenRecent = 4, Everything = (1+2+4) };
/*! Options for a dialog
(any or'ed value or 0 is ok)
- CheckBoxDoNotShowAgain Adds "do not show this window" checkbox at the bottom
*/
enum DialogOptions { CheckBoxDoNotShowAgain = 1 };
/*! Creates a dialog.
@param dialogType see DialogType description
@param dialogOptions see dialogOptions description
@param recentProjects a set of recent projects' info, used for "Open recent" tab
@param connSet conenction set used to present available conenctions
in "Open Existing" tab. Pass an empty object is this tab is not used.
@param parent parent widget, if any.
@param name name of this object.
*/
KexiStartupDialog(
int dialogType,
int dialogOptions,
KexiDBConnectionSet& connSet,
KexiProjectSet& recentProjects,
TQWidget *parent = 0, const char *name = 0 );
~KexiStartupDialog();
/*! \return true if startup dialog should be shown (info is taken from kexi config)
*/
static bool shouldBeShown();
/*! Executes dialog.
\return one of Result values. Use this after dialog is closed. */
int result() const;
/*! \return data of selected Kexi project (if "Open Recent" tab was selected).
Returns NULL if no selection has been made or other tab was selected.
*/
KexiProjectData* selectedProjectData() const;
/*! \return name of selected Kexi project file
(if result() == OpenExistingResult)
or name of template file to be used for creating a new database.
(if result() == CreateFromTemplateResult).
Returns empty string if no such selection has been made or other tab was selected.
*/
TQString selectedFileName() const;
/*! \return "autoopen" objects defined for selected template.
Only makes sense if template was used. */
TQValueList<KexiProjectData::ObjectInfo> autoopenObjects() const;
/*! \return a pointer to selected Kexi connection data.
(if "Open Existing" tab was selected and this connection data was clicked).
Returns NULL if no such selection has been made or other tab was selected.
*/
KexiDB::ConnectionData* selectedExistingConnection() const;
/*! Reimplemented for internal reasons */
virtual void show();
public slots:
protected slots:
virtual void done(int r);
virtual void reject();
virtual void slotOk();
//! slot activated when one of page in templates window is shown
void slotPageShown(TQWidget *page);
/*
//! Any icon view item has been executed (dblclicked)
void templateItemExecuted(TQIconViewItem *item);
//! Any icon view item has been selected
void templateItemSelected(TQIconViewItem *item);*/
//! Any tab has been selected
void tabShown(TQWidget *w);
void templateSelected(const TQString& fileName);
//! helper
void recentProjectItemExecuted(KexiProjectData *data);
void existingFileSelected(const TQString &f);
void showSimpleConnForOpenExisting();
void showAdvancedConnForOpenExisting();
void connectionItemForOpenExistingExecuted(ConnectionDataLVItem *item);
void connectionItemForOpenExistingHighlighted(ConnectionDataLVItem *item);
protected:
virtual bool eventFilter( TQObject *o, TQEvent *e );
//! helper: updates a state of dialog's OK button
void updateDialogOKButton(TQWidget *w);
//! internal reimplementation
int activePageIndex() const;
private:
void setupPageTemplates();
void setupPageOpenExisting();
void setupPageOpenRecent();
//! used internally on accepting templates selection
// void updateSelectedTemplateKeyInfo();
KexiStartupDialogPrivate *d;
};
#endif
|
