From 114a878c64ce6f8223cfd22d76a20eb16d177e5e Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: 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/kdevelop@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- lib/widgets/propeditor/propertywidget.h | 88 +++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 lib/widgets/propeditor/propertywidget.h (limited to 'lib/widgets/propeditor/propertywidget.h') diff --git a/lib/widgets/propeditor/propertywidget.h b/lib/widgets/propeditor/propertywidget.h new file mode 100644 index 00000000..3383a206 --- /dev/null +++ b/lib/widgets/propeditor/propertywidget.h @@ -0,0 +1,88 @@ +/*************************************************************************** + * Copyright (C) 2002-2004 by Alexander Dymo * + * cloudtemple@mskat.net * + * * + * This program 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 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 Library General Public * + * License along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ +#ifndef PROPERTYWIDGET_H +#define PROPERTYWIDGET_H + +#include +#include + +/** @file propertywidget.h +@short Contains @ref PropertyLib::PropertyWidget class. +*/ + +#include "multiproperty.h" + +namespace PropertyLib{ + +/** +@short An abstract base class of property viewer and editor vidget. + +Subclass this class to create custom property viewer and editor widget. + +Descendants should implement value() and setValue() methods. + +Hint: in case you want to implement your property editor widget using +existing widgets like QLineEdit, QComboBox, etc. you can't use multiple +inheritance from two QObject descendants due to Qt library restriction. +Therefore use line edits and combo boxes as child widgets. + +A set of predefined widgets for predefined property types are available +in the library. +*/ +class PropertyWidget: public QWidget{ + Q_OBJECT +public: + /**Constructs widget for property with name "propertyName".*/ + PropertyWidget(MultiProperty *property, QWidget *parent = 0, const char *name = 0); + virtual ~PropertyWidget() {} + + /**@return the value currently entered in the editor widget.*/ + virtual QVariant value() const = 0; + /**Sets the value shown in the editor widget. Set emitChange to false + if you don't want to emit propertyChanged signal.*/ + virtual void setValue(const QVariant &value, bool emitChange=true) = 0; + /**@return the name of edited property.*/ + virtual QString propertyName() const; + /**Sets the name of edited property.*/ + virtual void setProperty(MultiProperty *property); + /**Sets the list of possible values shown in the editor widget. This method + does not emit propertyChanged signal.*/ + virtual void setValueList(const QMap &valueList); + + /**Function to draw a property viewer when the editor isn't shown.*/ + virtual void drawViewer(QPainter *p, const QColorGroup &cg, const QRect &r, const QVariant &value); + + /**Reverts the property value to previous setting.*/ + virtual void undo(); + +signals: + /**Emit this signal when property value is changed. Probably you want + to emit it only from @ref setValue() method. + @ref PropertyLib::PropertyEditor widget will connect this to the appropriate slot which + will make updates to the @ref PropertyLib::PropertyList that hold propeties.*/ + void propertyChanged(MultiProperty *property, const QVariant &value); + +protected: + MultiProperty *m_property; +}; + +} + +#endif -- cgit v1.2.3