|
|
/*
|
|
|
* 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 <tqptrlist.h>
|
|
|
#include <tqlayout.h>
|
|
|
#include <tqscrollview.h>
|
|
|
|
|
|
#ifdef QT_ONLY
|
|
|
#include "compat.h"
|
|
|
#else
|
|
|
#include <klocale.h>
|
|
|
#endif
|
|
|
|
|
|
class QDataStream;
|
|
|
|
|
|
|
|
|
typedef TQPtrList<KMultiFormListBoxEntry> KMultiFormListBoxEntryList ;
|
|
|
typedef TQPtrList<TQWidget> 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<4B>r Pedersen <blackie@kde.org>
|
|
|
**/
|
|
|
class KMultiFormListBox : public TQWidget {
|
|
|
|
|
|
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,
|
|
|
TQWidget *parent = 0, bool showUpDownButtons = true,
|
|
|
bool showHelpButton = true, TQString 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( TQDataStream& stream ) const;
|
|
|
|
|
|
/** reads data in from stream */
|
|
|
void fromStream( TQDataStream& 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 */
|
|
|
|
