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
|
/*
* Copyright (c) 2002-2003 Jesper K. Pedersen <blackie@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License version 2 as published by the Free Software Foundation.
*
* 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 __kmultiformlistbox
#define __kmultiformlistbox
#include "kmultiformlistboxfactory.h"
#include "kmultiformlistbox-shower.h"
#include "kmultiformlistboxentry.h"
#include <qptrlist.h>
#include <qlayout.h>
#include <qscrollview.h>
#ifdef QT_ONLY
#include "compat.h"
#else
#include <klocale.h>
#endif
class QDataStream;
typedef QPtrList<KMultiFormListBoxEntry> KMultiFormListBoxEntryList ;
typedef QPtrList<QWidget> WidgetList;
class KMultiFormListBoxMultiVisible;
/**
The main class used to get an KMultiFormListBox widget.
The KMultiFormListBox widget consist of a sub-widget which is repeated a
number of times, it is up to the end user to determine the number of times
the sub widget is repeated, and he may require an additional copy simply
by pressing a ``Add'' or ``More Entries'' button. The KMultiFormListBox
widget has two different faces (i.e. two different end user
interfaces). One (Windowed) will show a listbox from which the end user
can access each subwidget containing data by pressing the LMB on a name
for the element. The other face (MultiVisible) shows all the subwidgets in
one huge ``Listbox''.
To use the KMultiFormListBox widget you must create a class which is inherited
from the @ref KMultiFormListBoxFactory class. This new class must override the
function `create'. This function must return a freshly made instance of
the class @ref KMultiFormListBoxEntry (or a subclass of this). The KMultiFormListBoxEntry
instance is the one inserted into the KMultiFormListBox widget (one instance for
each sub widget in the KMultiFormListBox widget).
@author Jesper Kjær Pedersen <blackie@kde.org>
**/
class KMultiFormListBox : public QWidget {
Q_OBJECT
public:
enum KMultiFormListBoxType {MultiVisible, Windowed};
/**
@param factory A factory used to generate the instances of
KMultiFormListBoxEntry class which is repeated in the KMultiFormListBox
@param parent A pointer to the parent widget
**/
KMultiFormListBox(KMultiFormListBoxFactory *factory,
KMultiFormListBoxType tp=Windowed,
QWidget *parent = 0, bool showUpDownButtons = true,
bool showHelpButton = true, QString addButtonText = i18n("Add"),
const char *name = 0);
/**
@return The elements in the KMultiFormListBox.
**/
KMultiFormListBoxEntryList elements();
const KMultiFormListBoxEntryList elements() const;
/**
TODO.
**/
void append(KMultiFormListBoxEntry *);
/** write data out to stream */
void toStream( QDataStream& stream ) const;
/** reads data in from stream */
void fromStream( QDataStream& stream );
public slots:
/**
Adds an empty element to the KMultiFormListBox.
This slot is only required for the @ref MultiVisible face. It should
be connected to a button which lets the user know that he may get more
elements in this KMultiFormListBox by pressing it. The button should
be labeled ``More Entries'' or something similar.
**/
void addElement(); // Adds an empty element to the KMultiFormListBox
/**
Changes the face of the KMultiFormListBox.
@param face The new face of the KMultiFormListBox
**/
void slotChangeFace(KMultiFormListBoxType newFace);
private:
KMultiFormListBoxShower *theWidget;
KMultiFormListBoxFactory *_factory;
};
#endif /* kmultiformlistbox */
|
