koffice/kexi/plugins/forms/kexidatasourcepage.h

/* This file is part of the KDE project
   Copyright (C) 2005 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 KEXIDATASOURCEPAGE_H
#define KEXIDATASOURCEPAGE_H

#include <tqwidget.h>
#include <kexidb/field.h>
#include <kexidb/utils.h>
#include <koproperty/set.h>

class KCommand;
class KexiObjectInfoLabel;
class KexiDataSourceComboBox;
class KexiFieldComboBox;
class KexiFieldListView;
class KexiProject;
class TQToolButton;
class TQLabel;
class TQFrame;

//! A page within form designer's property tabbed pane, providing data source editor
class KEXIFORMUTILS_EXPORT KexiDataSourcePage : public TQWidget
{
	TQ_OBJECT
  

	public:
		KexiDataSourcePage(TQWidget *parent, const char *name = 0);
		virtual ~KexiDataSourcePage();

		KexiDataSourceComboBox* dataSourceCombo() const { return m_dataSourceCombo; }
		KexiObjectInfoLabel* objectInfoLabel() const { return m_objectInfoLabel; }

	public slots:
		void setProject(KexiProject *prj);
		void clearDataSourceSelection(bool alsoClearComboBox = true);
		void clearWidgetDataSourceSelection();

		//! Sets data source of a currently selected form. 
		//! This is performed on form initialization and on activating.
		void setDataSource(const TQCString& mimeType, const TQCString& name);

		//! Receives a pointer to a new property \a set (from KexiFormView::managerPropertyChanged())
		void assignPropertySet(KoProperty::Set* propertySet);

	signals:
		//! Signal emitted when helper button 'go to selected data source' is clicked.
		void jumpToObjectRequested(const TQCString& mime, const TQCString& name);

		//! Signal emitted when form's data source has been changed. It's connected to the Form Manager.
		void formDataSourceChanged(const TQCString& mime, const TQCString& name);

		/*! Signal emitted when current widget's data source (field/expression)
		 has been changed. It's connected to the Form Manager. 
		 \a caption for this field is also provided (e.g. AutoField form widget use it) */
		void dataSourceFieldOrExpressionChanged(const TQString& string, const TQString& caption,
			KexiDB::Field::Type type);

		/*! Signal emitted when 'insert fields' button has been clicked */
		void insertAutoFields(const TQString& sourceMimeType, const TQString& sourceName,
			const TQStringList& fields);

	protected slots:
		void slotDataSourceTextChanged(const TQString & string);
		void slotDataSourceChanged();
		void slotFieldSelected();
		void slotGotoSelected();
		void slotInsertSelectedFields();
		void slotFieldListViewSelectionChanged();
		void slotFieldDoubleClicked(const TQString& sourceMimeType, const TQString& sourceName,
			const TQString& fieldName);

	protected:
		void updateSourceFieldWidgetsAvailability();

		KexiFieldComboBox *m_sourceFieldCombo;
		KexiObjectInfoLabel *m_objectInfoLabel;
		KexiDataSourceComboBox* m_dataSourceCombo;
		TQLabel *m_dataSourceLabel, *m_noDataSourceAvailableLabel, 
			*m_widgetDSLabel, *m_availableFieldsLabel,
			*m_mousePointerLabel, *m_availableFieldsDescriptionLabel;
		TQToolButton *m_clearWidgetDSButton, *m_clearDSButton, *m_gotoButton, *m_addField;
		TQFrame *m_dataSourceSeparator;
		TQString m_noDataSourceAvailableSingleText, m_noDataSourceAvailableMultiText;
		bool m_insideClearDataSourceSelection : 1;
#ifdef KEXI_NO_AUTOFIELD_WIDGET
		KexiDB::TableOrQuerySchema *m_tableOrQuerySchema; //!< temp.
#else
		KexiFieldListView* m_fieldListView;
#endif

		//! Used only in assignPropertySet() to check whether we already have the set assigned
		TQCString m_currentObjectName;
		//TQGuardedPtr<KoProperty::Set> m_propertySet;
};

#endif