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
|
/*
* 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.
**/
// -------------------------------- includes ------------------------------
#ifndef __kmultiformlistboxfactory
#define __kmultiformlistboxfactory
#include <qobject.h>
#include "kwidgetstreamer.h"
class KMultiFormListBoxEntry;
//-------------------------------------------------------------------------
/**
Factory use to generate elements for the @ref KMultiFormListBox widget.
To use an @ref KMultiFormListBox, one must inherit from the class KMultiFormListBoxFactory
and override the method @ref create. This method must return an empty
element for the KMultiFormListBox (that is an @ref KMultiFormListBoxEntry or a subclass of
it).
If you dislike the default separator between each of the elements or
simply do not want a separator in the KMultiFormListBox, then you may override
the method @ref separator.
**/
class KMultiFormListBoxFactory : public KWidgetStreamer
{
public:
virtual ~KMultiFormListBoxFactory() {}
/**
This method must be overridden in subclasses and must return an
``empty'' instance of the @ref KMultiFormListBoxEntry class, or perhaps rather
a subclass of this class. This instance will be owned by the caller of
this function.
@param parent A pointer to the parent of this KMultiFormListBoxEntry widget
returned.
@return A fresh @ref KMultiFormListBoxEntry to be used in an instance of the
@ref KMultiFormListBox class.
**/
virtual KMultiFormListBoxEntry *create(QWidget *parent) = 0;
/**
This method is used to get a separator between the elements in an @ref
KMultiFormListBox. The widget returned from this method will be owned by the
caller.
@param parent A pointer to the parent of the QWidget returned.
@return A widget which must be used as a separator between the @ref
KMultiFormListBoxEntry elements in an @ref KMultiFormListBox.
**/
virtual QWidget *separator(QWidget *parent);
};
#endif /* kmultiformlistbox */
|
