diff options
author | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-01-20 01:29:50 +0000 |
---|---|---|
committer | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-01-20 01:29:50 +0000 |
commit | 8362bf63dea22bbf6736609b0f49c152f975eb63 (patch) | |
tree | 0eea3928e39e50fae91d4e68b21b1e6cbae25604 /kexi/formeditor/objecttree.h | |
download | koffice-8362bf63dea22bbf6736609b0f49c152f975eb63.tar.gz koffice-8362bf63dea22bbf6736609b0f49c152f975eb63.zip |
Added old abandoned KDE3 version of koffice
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/koffice@1077364 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kexi/formeditor/objecttree.h')
-rw-r--r-- | kexi/formeditor/objecttree.h | 184 |
1 files changed, 184 insertions, 0 deletions
diff --git a/kexi/formeditor/objecttree.h b/kexi/formeditor/objecttree.h new file mode 100644 index 00000000..252ee54c --- /dev/null +++ b/kexi/formeditor/objecttree.h @@ -0,0 +1,184 @@ +/* This file is part of the KDE project + Copyright (C) 2003 Lucijan Busch <lucijan@gmx.at> + Copyright (C) 2004 Cedric Pasteur <cedric.pasteur@free.fr> + Copyright (C) 2006 Jaroslaw Staniek <js@iidea.pl> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + 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 KFORMDESIGNEROBJECTTREE_H +#define KFORMDESIGNEROBJECTTREE_H + +#include <qptrlist.h> +#include <qmap.h> +#include <qdict.h> +#include <qvariant.h> +#include <qstring.h> +#include <qguardedptr.h> + +class QWidget; +class QDomElement; + +namespace KFormDesigner { + +class ObjectTreeItem; +class Container; +class EventEater; + +//! @short An list of ObjectTreeItem pointers. +typedef QPtrList<ObjectTreeItem> ObjectTreeList; + +//! @short An iterator for ObjectTreeList. +typedef QPtrListIterator<ObjectTreeItem> ObjectTreeListIterator; + +//! @short A QString-based disctionary of ObjectTreeItem pointers. +typedef QDict<ObjectTreeItem> ObjectTreeDict; + +//! @short An iterator for ObjectTreeDict. +typedef QDictIterator<ObjectTreeItem> ObjectTreeDictIterator; + +//! @short A QString -> QVarinat map. +typedef QMap<QString, QVariant> QVariantMap; + +//! @short A const iterator for QVariantMap. +typedef QMapConstIterator<QString, QVariant> QVariantMapConstIterator; + +/*! + @short An item representing a widget + Holds the properties of a widget (classname, name, parent, children ..). + @author Lucijan Busch <lucijan@kde.org> + */ +class KFORMEDITOR_EXPORT ObjectTreeItem +{ + public: + ObjectTreeItem(const QString &className, const QString &name, QWidget *widget, Container *parentContainer, Container *container=0); + virtual ~ObjectTreeItem(); + + QString name() const { return m_name; } + QString className() const { return m_className; } + QWidget* widget() const { return m_widget; } + EventEater* eventEater() const { return m_eater; } + ObjectTreeItem* parent() const { return m_parent; } + ObjectTreeList* children() { return &m_children; } + + /*! \return a QMap<QString, QVariant> of all modified properties for this widget. + The QVariant is the old value (ie first value) of the property whose name is the QString. */ + const QVariantMap* modifiedProperties() const { return &m_props;} + + //! \return the widget's Container, or 0 if the widget is not a Container. + Container* container() const { return m_container;} + + void setWidget(QWidget *w) { m_widget = w; } + void setParent(ObjectTreeItem *parent) { m_parent = parent;} + + void debug(int ident); + void rename(const QString &name); + + void addChild(ObjectTreeItem *it); + void removeChild(ObjectTreeItem *it); + + /*! Adds \a property in the list of the modified properties for this object. + These modified properties are written in the .ui files when saving the form. + */ + void addModifiedProperty(const QCString &property, const QVariant &oldValue); + void storeUnknownProperty(QDomElement &el); + + /*! Adds subproperty \a property value \a value (a property of subwidget). + Remembering it for delayed setting is needed because on loading + the subwidget could be not created yet (true e.g. for KexiDBAutoField). */ + void addSubproperty(const QCString &property, const QVariant& value); + + /*! \return subproperties for this item, added by addSubproperty() + or 0 is there are no subproperties. */ + QMap<QString, QVariant>* subproperties() const { return m_subprops; } + + void setPixmapName(const QCString &property, const QString &name); + QString pixmapName(const QCString &property); + + void setEnabled(bool enabled) { m_enabled = enabled; } + bool isEnabled() const { return m_enabled; } + + int gridRow() const { return m_row; } + int gridCol() const { return m_col; } + int gridRowSpan() const { return m_rowspan; } + int gridColSpan() const { return m_colspan; } + bool spanMultipleCells() const { return m_span; } + void setGridPos(int row, int col, int rowspan, int colspan); + + protected: + QString m_className; + QString m_name; + ObjectTreeList m_children; + QGuardedPtr<Container> m_container; + QMap<QString, QVariant> m_props; + QMap<QString, QVariant> *m_subprops; + QString m_unknownProps; + QMap<QCString, QString> m_pixmapNames; + ObjectTreeItem* m_parent; + QGuardedPtr<QWidget> m_widget; + QGuardedPtr<EventEater> m_eater; + + bool m_enabled; + + int m_row, m_col, m_rowspan, m_colspan; + bool m_span; + + friend class ObjectTree; + friend class FormIO; +}; + +/*! @short Represents all the objects available within a form. + This class holds ObjectTreeItem for each widget in a Form. */ +class KFORMEDITOR_EXPORT ObjectTree : public ObjectTreeItem +{ + public: + ObjectTree(const QString &className=QString::null, const QString &name=QString::null, + QWidget *widget=0, Container *container=0); + virtual ~ObjectTree(); + + /*! Renames the item named \a oldname to \a newname. \return false if widget named \a newname + already exists and renaming failed. */ + bool rename(const QString &oldname, const QString &newname ); + /*! Sets \a newparent as new parent for the item whose name is \a name. */ + bool reparent(const QString &name, const QString &newparent); + + /*! \return the ObjectTreeItem named \a name, or 0 if doesn't exist. */ + ObjectTreeItem* lookup(const QString &name); + + /*! \return a dict containing all ObjectTreeItem in this ObjectTree. If you want to iterate on + this dict, use ObjectTreeDictIterator. */ + ObjectTreeDict* dict() { return &m_treeDict; } + + void addItem(ObjectTreeItem *parent, ObjectTreeItem *c); + void removeItem(const QString &name); + void removeItem(ObjectTreeItem *c); + + /*! Generates a new, unique name for a new widget using prefix \a prefix + (e.g. if \a prefix is "lineEdit", "lineEdit1" is returned). + \a prefix must be a valid identifier. + If \a numberSuffixRequired is true (the default) a number suffix is mandatory. + If \a numberSuffixRequired is false and there's a widget prefix \a prefix, + then \a prefix is returned (e.g. if \a prefix is "lineEdit", and "lineEdit" doesn't exist yet, + "lineEdit" is returned). */ + QCString generateUniqueName(const QCString &prefix, bool numberSuffixRequired = true); + + private: + ObjectTreeDict m_treeDict; +}; + +} + +#endif |