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

1 files changed, 104 insertions, 0 deletions

diff --git a/kexi/core/kexitabledesignerinterface.h b/kexi/core/kexitabledesignerinterface.h
new file mode 100644
index 000000000..60d7d0c77
--- /dev/null
+++ b/kexi/core/kexitabledesignerinterface.h
@@ -0,0 +1,104 @@
+/* This file is part of the KDE project
+   Copyright (C) 2006 Jaroslaw Staniek <js@iidea.pl>
+
+   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
+   Library General Public License for more details.
+
+   You should have received a copy of the GNU Library General Public License
+   along with this program; see the file COPYING.  If not, write to
+   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+*/
+
+#ifndef KEXITABLEDESIGNERINTERFACE_H
+#define KEXITABLEDESIGNERINTERFACE_H
+
+#include <koproperty/property.h>
+#include <kexiutils/tristate.h>
+
+namespace KoProperty {
+	class Set;
+}
+
+//! Interface for main Table Designer's commands
+/*! This interface has been specified to enable invoking Table Designer's commands
+ at application's level. This is used in the "altertable" test suite, available in
+ kexi/tests/altertable Kexi source code directory.
+ KexiTableDesignerInterface is implemented by KexiTableDesignerView, so it's enough
+ to use dynamic_cast:
+ \code
+ KexiDialogBase *dlg = KexiMainWindowImpl::self()->currentDialog();
+ if (dlg) {
+   KexiTableDesignerInterface* designerIface 
+     = dynamic_cast<KexiTableDesignerInterface*>( dlg->selectedView() );
+   if (designerIface) {
+     //for example, delete row #3
+     designerIface->deleteRow( 3, true );
+   }
+ }
+ \endcode
+ Methods of KexiTableDesignerInterface are also used by classes of KexiTableDesignerCommands 
+ namespace (KCommand derivatives) for implementing commands execution and unexecution.
+
+ All the methods contain addCommand argument. Set if to true to get the command added 
+ to the undo/redo buffer, what will look like real user's action. This is also needed 
+ to poperly generate arguments for commiting the "alter table" operation.
+*/
+class KEXICORE_EXPORT KexiTableDesignerInterface
+{
+	public:
+		KexiTableDesignerInterface();
+
+		virtual ~KexiTableDesignerInterface();
+
+		/*! Clears field information entered for row. 
+		 This is performed by removing values from caption and data type columns. */
+		virtual void clearRow(int row, bool addCommand = false) = 0;
+
+		/*! Inserts a new field with \a caption for \a row. 
+		 Property set is also created. 
+		 Existing field will be overwritten, so use insertEmptyRow() 
+		 is you want to move subsequent fields down. */
+		virtual void insertField(int row, const QString& caption, bool addCommand = false) = 0;
+
+		/*! Inserts a new \a field for \a row. 
+		 Property set is also created. \a set will be deeply-copied into the new set.
+		 Existing field will be overwritten, so use insertEmptyRow() 
+		 is you want to move subsequent fields down. */
+		virtual void insertField(int row, KoProperty::Set& set, bool addCommand = false) = 0;
+
+		/*! Inserts a new empty row at position \a row. */
+		virtual void insertEmptyRow( int row, bool addCommand = false ) = 0;
+
+		/*! Deletes \a row from the table view. Property set is also deleted.
+		 All the subsequent fields are moved up. */
+		virtual void deleteRow( int row, bool addCommand = false ) = 0;
+
+		/*! Changes property \a propertyName to \a newValue for a field pointed by \a fieldUID.
+		 If \a listData is not NULL and not empty, a deep copy of it is passed to Property::setListData().
+		 If \a listData \a nlist if not NULL but empty, Property::setListData(0) is called. */
+		virtual void changeFieldPropertyForRow( int fieldUID, const QCString& propertyName, 
+			const QVariant& newValue, KoProperty::Property::ListData* const listData = 0, 
+			bool addCommand = false ) = 0;
+
+		/*! Creates temporary table for the current design and returns debug string for it. */
+		virtual QString debugStringForCurrentTableSchema(tristate& result) = 0;
+
+		/*! Simulates execution of alter table, and puts debug into \a debugTarget. 
+		 A case when debugTarget is not 0 is true for the alter table test suite. */
+		virtual tristate simulateAlterTableExecution(QString *debugTarget) = 0;
+
+		/*! Real execution of the Alter Table. For debugging of the real alter table. 
+		 \return true on success, false on failure and cancelled if user has cancelled 
+		 execution. */
+		virtual tristate executeRealAlterTable() = 0;
+};
+
+#endif