diff options
Diffstat (limited to 'korn/boxcontainer.h')
-rw-r--r-- | korn/boxcontainer.h | 103 |
1 files changed, 103 insertions, 0 deletions
diff --git a/korn/boxcontainer.h b/korn/boxcontainer.h new file mode 100644 index 000000000..800fab78e --- /dev/null +++ b/korn/boxcontainer.h @@ -0,0 +1,103 @@ +/* + * Copyright (C) 2004, Mart Kelder (mart.kde@hccnet.nl) + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program 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 General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +#ifndef MK_BOXCONTAINER_H +#define MK_BOXCONTAINER_H + +#include <qobject.h> + +class BoxContainerItem; + +template< class T > class QPtrList; + +class KConfig; + +/** + * This class is the base for all BoxContainers. A BoxContainer is a place + * where BoxContainerItems can be placed. BoxContainerItems are the boxes you see. + */ +class BoxContainer : public QObject +{ Q_OBJECT +public: + /** + * Constructor: everything is passed to QObject. + * + * @param parent The parent of this object + * @param name The name of this object + */ + BoxContainer( QObject *parent = 0, const char * name = 0 ); + /** + * Destructor + */ + ~BoxContainer(); + + /** + * This method reads the config from a certain KConfig instance. + * + * @param config The KConfig-instance to read the config from. + */ + void readConfig( KConfig* config ); + + /** + * This method writes the config to a certain KConfig instance. + * + * @param config The KConfig-instance to write the config to. + */ + void writeConfig( KConfig *config ); + + /** + * Shows all childs and itself + */ + virtual void showBox(); +public slots: + /** + * This slot is triggered if the configuration window has to be shown. + * This call is passed through. + */ + void slotShowConfiguration(); + +protected: + /** + * This methos adds a child to the list. + * + * @param item The item to be added. + */ + virtual void addItem( BoxContainerItem* item ); + + /** + * This method creates a new BoxContainerItem instance of the same + * type as the BoxContainer. + * + * @return A new instance to a BoxContainerItem of the same type. + */ + virtual BoxContainerItem* newBoxInstance() const = 0; + + /** + * The list of BoxContainerItems. + */ + QPtrList< BoxContainerItem > *_items; + +signals: + /** + * This signal is used to pass the slotShowConfiguration call through + */ + void showConfiguration(); +}; + +#endif //MK_BOXCONTAINER_H + |