// This is the SIP interface definition for QDataBrowser.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyQt.
// 
// This copy of PyQt 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.
// 
// PyQt 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
// PyQt; 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>QDataBrowser (Qt 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


%If (Qt_3_0_0 -)

class QDataBrowser : QWidget
{
%TypeHeaderCode
#include <qdatabrowser.h>
%End

public:
	QDataBrowser(QWidget * /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 QSqlIndex &);
	void setSort(const QStringList &);
	QStringList sort() const;
	void setFilter(const QString &);
	QString filter() const;

	virtual void setSqlCursor(QSqlCursor * /GetWrapper/,bool = 0);
%MethodCode
		Py_BEGIN_ALLOW_THREADS
		sipSelfWasArg ? sipCpp->QDataBrowser::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

	QSqlCursor* sqlCursor() const;
	virtual void setForm(QSqlForm *);
	QSqlForm* 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 QSqlRecord *);
	void primeInsert(QSqlRecord *);
	void primeUpdate(QSqlRecord *);
	void primeDelete(QSqlRecord *);
	void beforeInsert(QSqlRecord *);
	void beforeUpdate(QSqlRecord *);
	void beforeDelete(QSqlRecord *);
	void cursorChanged(QSqlCursor::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 QSql::Confirm confirmEdit(QSql::Op) /ReleaseGIL/;
	virtual QSql::Confirm confirmCancel(QSql::Op) /ReleaseGIL/;

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

private:
%If (Qt_3_1_0 -)
	QDataBrowser(const QDataBrowser &);
%End
};

%End
