// This is the SIP interface definition for TQDataBrowser.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyTQt.
// 
// This copy of PyTQt is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2, or (at your option) any later
// version.
// 
// PyTQt is supplied 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 General Public License along with
// PyTQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


%ExportedDoc
<Sect2><Title>TQDataBrowser (TQt v3+)</Title>
<FuncSynopsis>
	<FuncDef>virtual void <Function>del</Function></FuncDef>
	<ParamDef></ParamDef>
</FuncSynopsis>
<Para>
This has been renamed <Literal>delOnCursor</Literal> in Python.
</Para>
</Sect2>
%End


class TQDataBrowser : TQWidget
{
%TypeHeaderCode
#include <tqdatabrowser.h>
%End

public:
	TQDataBrowser(TQWidget * /TransferThis/ = 0,const char * = 0,WFlags = 0);

	enum Boundary {
		Unknown,
		None,
		BeforeBeginning,
		Beginning,
		End,
		AfterEnd
	};

	Boundary boundary();
	void setBoundaryChecking(bool);
	bool boundaryChecking() const;

	void setSort(const TQSqlIndex &);
	void setSort(const TQStringList &);
	TQStringList sort() const;
	void setFilter(const TQString &);
	TQString filter() const;

	virtual void setSqlCursor(TQSqlCursor * /GetWrapper/,bool = 0);
%MethodCode
		Py_BEGIN_ALLOW_THREADS
		sipSelfWasArg ? sipCpp->TQDataBrowser::setSqlCursor(a0, a1) : sipCpp->setSqlCursor(a0, a1);
		Py_END_ALLOW_THREADS

		// Transfer ownership of the cursor if the autoDelete flag is
		// set.
		if (a0 && a1)
			sipTransferTo(a0Wrapper,sipSelf);
%End

	TQSqlCursor* sqlCursor() const;
	virtual void setForm(TQSqlForm *);
	TQSqlForm* form();

	virtual void setConfirmEdits(bool);
	virtual void setConfirmInsert(bool);
	virtual void setConfirmUpdate(bool);
	virtual void setConfirmDelete(bool);
	virtual void setConfirmCancels(bool);
	bool confirmEdits() const;
	bool confirmInsert() const;
	bool confirmUpdate() const;
	bool confirmDelete() const;
	bool confirmCancels() const;

	virtual void setReadOnly(bool);
	bool isReadOnly() const;
	virtual void setAutoEdit(bool);
	bool autoEdit() const;

	virtual bool seek(int,bool = 0) /ReleaseGIL/;

signals:
	void firstRecordAvailable(bool);
	void lastRecordAvailable(bool);
	void nextRecordAvailable(bool);
	void prevRecordAvailable(bool);

	void currentChanged(const TQSqlRecord *);
	void primeInsert(TQSqlRecord *);
	void primeUpdate(TQSqlRecord *);
	void primeDelete(TQSqlRecord *);
	void beforeInsert(TQSqlRecord *);
	void beforeUpdate(TQSqlRecord *);
	void beforeDelete(TQSqlRecord *);
	void cursorChanged(TQSqlCursor::Mode);

public slots:
	virtual void refresh();

	virtual void insert() /ReleaseGIL/;
	virtual void update() /ReleaseGIL/;
	virtual void del() /PyName=delOnCursor, ReleaseGIL/;

	virtual void first() /ReleaseGIL/;
	virtual void last() /ReleaseGIL/;
	virtual void next() /ReleaseGIL/;
	virtual void prev() /ReleaseGIL/;

	virtual void readFields();
	virtual void writeFields();
	virtual void clearValues();

	void updateBoundary();

protected:
	virtual bool insertCurrent() /ReleaseGIL/;
	virtual bool updateCurrent() /ReleaseGIL/;
	virtual bool deleteCurrent() /ReleaseGIL/;
	virtual bool currentEdited();

	virtual TQSql::Confirm confirmEdit(TQSql::Op) /ReleaseGIL/;
	virtual TQSql::Confirm confirmCancel(TQSql::Op) /ReleaseGIL/;

	virtual void handleError(const TQSqlError &) /ReleaseGIL/;

private:
	TQDataBrowser(const TQDataBrowser &);
};
