You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
185 lines
6.7 KiB
185 lines
6.7 KiB
/* 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 <tqptrlist.h>
|
|
#include <tqmap.h>
|
|
#include <tqdict.h>
|
|
#include <tqvariant.h>
|
|
#include <tqstring.h>
|
|
#include <tqguardedptr.h>
|
|
|
|
class TQWidget;
|
|
class TQDomElement;
|
|
|
|
namespace KFormDesigner {
|
|
|
|
class ObjectTreeItem;
|
|
class Container;
|
|
class EventEater;
|
|
|
|
//! @short An list of ObjectTreeItem pointers.
|
|
typedef TQPtrList<ObjectTreeItem> ObjectTreeList;
|
|
|
|
//! @short An iterator for ObjectTreeList.
|
|
typedef TQPtrListIterator<ObjectTreeItem> ObjectTreeListIterator;
|
|
|
|
//! @short A TQString-based disctionary of ObjectTreeItem pointers.
|
|
typedef TQDict<ObjectTreeItem> ObjectTreeDict;
|
|
|
|
//! @short An iterator for ObjectTreeDict.
|
|
typedef TQDictIterator<ObjectTreeItem> ObjectTreeDictIterator;
|
|
|
|
//! @short A TQString -> TQVarinat map.
|
|
typedef TQMap<TQString, TQVariant> TQVariantMap;
|
|
|
|
//! @short A const iterator for TQVariantMap.
|
|
typedef TQMapConstIterator<TQString, TQVariant> TQVariantMapConstIterator;
|
|
|
|
/*!
|
|
@short An item representing a widget
|
|
Holds the properties of a widget (classname, name, tqparent, tqchildren ..).
|
|
@author Lucijan Busch <lucijan@kde.org>
|
|
*/
|
|
class KFORMEDITOR_EXPORT ObjectTreeItem
|
|
{
|
|
public:
|
|
ObjectTreeItem(const TQString &className, const TQString &name, TQWidget *widget, Container *tqparentContainer, Container *container=0);
|
|
virtual ~ObjectTreeItem();
|
|
|
|
TQString name() const { return m_name; }
|
|
TQString className() const { return m_className; }
|
|
TQWidget* widget() const { return m_widget; }
|
|
EventEater* eventEater() const { return m_eater; }
|
|
ObjectTreeItem* tqparent() const { return m_parent; }
|
|
ObjectTreeList* tqchildren() { return &m_tqchildren; }
|
|
|
|
/*! \return a TQMap<TQString, TQVariant> of all modified properties for this widget.
|
|
The TQVariant is the old value (ie first value) of the property whose name is the TQString. */
|
|
const TQVariantMap* 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(TQWidget *w) { m_widget = w; }
|
|
void setParent(ObjectTreeItem *tqparent) { m_parent = tqparent;}
|
|
|
|
void debug(int ident);
|
|
void rename(const TQString &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 TQCString &property, const TQVariant &oldValue);
|
|
void storeUnknownProperty(TQDomElement &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 TQCString &property, const TQVariant& value);
|
|
|
|
/*! \return subproperties for this item, added by addSubproperty()
|
|
or 0 is there are no subproperties. */
|
|
TQMap<TQString, TQVariant>* subproperties() const { return m_subprops; }
|
|
|
|
void setPixmapName(const TQCString &property, const TQString &name);
|
|
TQString pixmapName(const TQCString &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:
|
|
TQString m_className;
|
|
TQString m_name;
|
|
ObjectTreeList m_tqchildren;
|
|
TQGuardedPtr<Container> m_container;
|
|
TQMap<TQString, TQVariant> m_props;
|
|
TQMap<TQString, TQVariant> *m_subprops;
|
|
TQString m_unknownProps;
|
|
TQMap<TQCString, TQString> m_pixmapNames;
|
|
ObjectTreeItem* m_parent;
|
|
TQGuardedPtr<TQWidget> m_widget;
|
|
TQGuardedPtr<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 TQString &className=TQString(), const TQString &name=TQString(),
|
|
TQWidget *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 TQString &oldname, const TQString &newname );
|
|
/*! Sets \a newtqparent as new tqparent for the item whose name is \a name. */
|
|
bool reparent(const TQString &name, const TQString &newtqparent);
|
|
|
|
/*! \return the ObjectTreeItem named \a name, or 0 if doesn't exist. */
|
|
ObjectTreeItem* lookup(const TQString &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 *tqparent, ObjectTreeItem *c);
|
|
void removeItem(const TQString &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). */
|
|
TQCString generateUniqueName(const TQCString &prefix, bool numberSuffixRequired = true);
|
|
|
|
private:
|
|
ObjectTreeDict m_treeDict;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|