summaryrefslogtreecommitdiffstats
path: root/src/sql/qsqlpropertymap.cpp
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-11-08 12:31:36 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-11-08 12:31:36 -0600
commitd796c9dd933ab96ec83b9a634feedd5d32e1ba3f (patch)
tree6e3dcca4f77e20ec8966c666aac7c35bd4704053 /src/sql/qsqlpropertymap.cpp
downloadtqt3-d796c9dd933ab96ec83b9a634feedd5d32e1ba3f.tar.gz
tqt3-d796c9dd933ab96ec83b9a634feedd5d32e1ba3f.zip
Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731
Diffstat (limited to 'src/sql/qsqlpropertymap.cpp')
-rw-r--r--src/sql/qsqlpropertymap.cpp304
1 files changed, 304 insertions, 0 deletions
diff --git a/src/sql/qsqlpropertymap.cpp b/src/sql/qsqlpropertymap.cpp
new file mode 100644
index 000000000..55699e569
--- /dev/null
+++ b/src/sql/qsqlpropertymap.cpp
@@ -0,0 +1,304 @@
+/****************************************************************************
+**
+** Definition of TQSqlPropertyMap class
+**
+** Created : 2000-11-20
+**
+** Copyright (C) 2005-2008 Trolltech ASA. All rights reserved.
+**
+** This file is part of the sql module of the TQt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General
+** Public License versions 2.0 or 3.0 as published by the Free
+** Software Foundation and appearing in the files LICENSE.GPL2
+** and LICENSE.GPL3 included in the packaging of this file.
+** Alternatively you may (at your option) use any later version
+** of the GNU General Public License if such license has been
+** publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free TQt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing retquirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at sales@trolltech.com.
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.TQPL
+** included in the packaging of this file. Licensees holding valid TQt
+** Commercial licenses may use this file in accordance with the TQt
+** Commercial License Agreement provided with the Software.
+**
+** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
+** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+#include "qsqlpropertymap.h"
+
+#ifndef QT_NO_SQL_FORM
+
+#include "qwidget.h"
+#include "qcleanuphandler.h"
+#include "qmetaobject.h"
+#include "qmap.h"
+
+class TQSqlPropertyMapPrivate
+{
+public:
+ TQSqlPropertyMapPrivate() {}
+ TQMap< TQString, TQString > propertyMap;
+};
+
+/*!
+ \class TQSqlPropertyMap qsqlpropertymap.h
+ \brief The TQSqlPropertyMap class is used to map widgets to SQL fields.
+
+ \ingroup database
+ \module sql
+
+ The SQL module uses TQt \link properties.html object
+ properties\endlink to insert and extract values from editor
+ widgets.
+
+ This class is used to map editors to SQL fields. This works by
+ associating SQL editor class names to the properties used to
+ insert and extract values to/from the editor.
+
+ For example, a TQLineEdit can be used to edit text strings and
+ other data types in TQDataTables or TQSqlForms. Several properties
+ are defined in TQLineEdit, but only the \e text property is used to
+ insert and extract text from a TQLineEdit. Both TQDataTable and
+ TQSqlForm use the global TQSqlPropertyMap for inserting and
+ extracting values to and from an editor widget. The global
+ property map defines several common widgets and properties that
+ are suitable for many applications. You can add and remove widget
+ properties to suit your specific needs.
+
+ If you want to use custom editors with your TQDataTable or
+ TQSqlForm, you must install your own TQSqlPropertyMap for that table
+ or form. Example:
+
+ \code
+ TQSqlPropertyMap *myMap = new TQSqlPropertyMap();
+ TQSqlForm *myForm = new TQSqlForm( this );
+ MyEditor myEditor( this );
+
+ // Set the TQSqlForm's record buffer to the update buffer of
+ // a pre-existing TQSqlCursor called 'cur'.
+ myForm->setRecord( cur->primeUpdate() );
+
+ // Install the customized map
+ myMap->insert( "MyEditor", "content" );
+ myForm->installPropertyMap( myMap ); // myForm now owns myMap
+ ...
+ // Insert a field into the form that uses a myEditor to edit the
+ // field 'somefield'
+ myForm->insert( &myEditor, "somefield" );
+
+ // Update myEditor with the value from the mapped database field
+ myForm->readFields();
+ ...
+ // Let the user edit the form
+ ...
+ // Update the database fields with the values in the form
+ myForm->writeFields();
+ ...
+ \endcode
+
+ You can also replace the global TQSqlPropertyMap that is used by
+ default. (Bear in mind that TQSqlPropertyMap takes ownership of the
+ new default map.)
+
+ \code
+ TQSqlPropertyMap *myMap = new TQSqlPropertyMap;
+
+ myMap->insert( "MyEditor", "content" );
+ TQSqlPropertyMap::installDefaultMap( myMap );
+ ...
+ \endcode
+
+ \sa TQDataTable, TQSqlForm, TQSqlEditorFactory
+*/
+
+/*!
+
+Constructs a TQSqlPropertyMap.
+
+The default property mappings used by TQt widgets are:
+\table
+\header \i Widgets \i Property
+\row \i \l TQCheckBox,
+ \l TQRadioButton
+ \i checked
+\row \i \l TQComboBox,
+ \l TQListBox
+ \i currentItem
+\row \i \l TQDateEdit
+ \i date
+\row \i \l TQDateTimeEdit
+ \i dateTime
+\row \i \l TQTextBrowser
+ \i source
+\row \i \l TQButton,
+ \l TQDial,
+ \l TQLabel,
+ \l TQLineEdit,
+ \l TQMultiLineEdit,
+ \l TQPushButton,
+ \l TQTextEdit,
+ \i text
+\row \i \l TQTimeEdit
+ \i time
+\row \i \l TQLCDNumber,
+ \l TQScrollBar
+ \l TQSlider,
+ \l TQSpinBox
+ \i value
+\endtable
+*/
+
+TQSqlPropertyMap::TQSqlPropertyMap()
+{
+ d = new TQSqlPropertyMapPrivate();
+ const struct MapData {
+ const char *classname;
+ const char *property;
+ } mapData[] = {
+ { "TQButton", "text" },
+ { "TQCheckBox", "checked" },
+ { "TQRadioButton", "checked" },
+ { "TQComboBox", "currentItem" },
+ { "TQDateEdit", "date" },
+ { "TQDateTimeEdit", "dateTime" },
+ { "TQDial", "value" },
+ { "TQLabel", "text" },
+ { "TQLCDNumber", "value" },
+ { "TQLineEdit", "text" },
+ { "TQListBox", "currentItem" },
+ { "TQMultiLineEdit", "text" },
+ { "TQPushButton", "text" },
+ { "TQScrollBar", "value" },
+ { "TQSlider", "value" },
+ { "TQSpinBox", "value" },
+ { "TQTextBrowser", "source" },
+ { "TQTextEdit", "text" },
+ { "TQTextView", "text" },
+ { "TQTimeEdit", "time" }
+ };
+
+ const MapData *m = mapData;
+ for ( uint i = 0; i < sizeof(mapData)/sizeof(MapData); i++, m++ )
+ d->propertyMap.insert( m->classname, m->property );
+}
+
+/*!
+ Destroys the TQSqlPropertyMap.
+
+ Note that if the TQSqlPropertyMap is installed with
+ installPropertyMap() the object it was installed into, e.g. the
+ TQSqlForm, takes ownership and will delete the TQSqlPropertyMap when
+ necessary.
+*/
+TQSqlPropertyMap::~TQSqlPropertyMap()
+{
+ delete d;
+}
+
+/*!
+ Returns the mapped property of \a widget as a TQVariant.
+*/
+TQVariant TQSqlPropertyMap::property( TQWidget * widget )
+{
+ if( !widget ) return TQVariant();
+ const TQMetaObject* mo = widget->metaObject();
+ while ( mo && !d->propertyMap.contains( TQString( mo->className() ) ) )
+ mo = mo->superClass();
+
+ if ( !mo ) {
+#ifdef QT_CHECK_RANGE
+ qWarning("TQSqlPropertyMap::property: %s does not exist", widget->metaObject()->className() );
+#endif
+ return TQVariant();
+ }
+ return widget->property( d->propertyMap[ mo->className() ] );
+}
+
+/*!
+ Sets the property of \a widget to \a value.
+*/
+void TQSqlPropertyMap::setProperty( TQWidget * widget, const TQVariant & value )
+{
+ if( !widget ) return;
+
+ TQMetaObject* mo = widget->metaObject();
+ while ( mo && !d->propertyMap.contains( TQString( mo->className() ) ) )
+ mo = mo->superClass();
+ if ( !mo ) {
+#ifdef QT_CHECK_RANGE
+ qWarning("TQSqlPropertyMap::setProperty: %s not handled by TQSqlPropertyMap", widget->metaObject()->className() );
+#endif
+ return;
+ }
+
+ widget->setProperty( d->propertyMap[ mo->className() ], value );
+}
+
+/*!
+ Insert a new classname/property pair, which is used for custom SQL
+ field editors. There \e must be a \c Q_PROPERTY clause in the \a
+ classname class declaration for the \a property.
+*/
+void TQSqlPropertyMap::insert( const TQString & classname,
+ const TQString & property )
+{
+ d->propertyMap[ classname ] = property;
+}
+
+/*!
+ Removes \a classname from the map.
+*/
+void TQSqlPropertyMap::remove( const TQString & classname )
+{
+ d->propertyMap.remove( classname );
+}
+
+static TQSqlPropertyMap * defaultmap = 0;
+static TQCleanupHandler< TQSqlPropertyMap > qsql_cleanup_property_map;
+
+/*!
+ Returns the application global TQSqlPropertyMap.
+*/
+TQSqlPropertyMap * TQSqlPropertyMap::defaultMap()
+{
+ if( defaultmap == 0 ){
+ defaultmap = new TQSqlPropertyMap();
+ qsql_cleanup_property_map.add( &defaultmap );
+ }
+ return defaultmap;
+}
+
+/*!
+ Replaces the global default property map with \a map. All
+ TQDataTable and TQSqlForm instantiations will use this new map for
+ inserting and extracting values to and from editors.
+ \e{TQSqlPropertyMap takes ownership of \a map, and destroys it
+ when it is no longer needed.}
+*/
+void TQSqlPropertyMap::installDefaultMap( TQSqlPropertyMap * map )
+{
+ if( map == 0 ) return;
+
+ if( defaultmap != 0 ){
+ qsql_cleanup_property_map.remove( &defaultmap );
+ delete defaultmap;
+ }
+ defaultmap = map;
+ qsql_cleanup_property_map.add( &defaultmap );
+}
+
+#endif // QT_NO_SQL_FORM