Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeutils@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 70 insertions, 0 deletions

diff --git a/kregexpeditor/KMultiFormListBox/kmultiformlistboxfactory.h b/kregexpeditor/KMultiFormListBox/kmultiformlistboxfactory.h
new file mode 100644
index 0000000..13f6561
--- /dev/null
+++ b/kregexpeditor/KMultiFormListBox/kmultiformlistboxfactory.h
@@ -0,0 +1,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 */
+