Qt Reference Documentation

Q3SqlSelectCursor Class Reference

The Q3SqlSelectCursor class provides browsing of general SQL SELECT statements. More...

 #include <Q3SqlSelectCursor>

This class is part of the Qt 3 support library. It is provided to keep old source code working. We strongly advise against using it in new code. See Porting to Qt 4 for more information.

Inherits: Q3SqlCursor.

Public Functions

Q3SqlSelectCursor ( const QString & query = QString(), QSqlDatabase db = QSqlDatabase() )
Q3SqlSelectCursor ( const Q3SqlSelectCursor & other )
~Q3SqlSelectCursor ()

Reimplemented Protected Functions

virtual int update ( const QString & filter, bool invalidate = true )

Detailed Description

The Q3SqlSelectCursor class provides browsing of general SQL SELECT statements.

Q3SqlSelectCursor is a convenience class that makes it possible to display result sets from general SQL SELECT statements in data-aware Qt widgets. Q3SqlSelectCursor is read-only and does not support INSERT, UPDATE or DELETE operations.

Pass the query in at construction time, or use the Q3SqlSelectCursor::exec() function.

Example:

 ...
 Q3SqlSelectCursor* cur = new Q3SqlSelectCursor("SELECT id, firstname, lastname FROM author");
 Q3DataTable* table = new Q3DataTable(this);
 table->setSqlCursor(cur, true, true);
 table->refresh();
 ...
 cur->exec("SELECT * FROM books");
 table->refresh();
 ...

Member Function Documentation

Q3SqlSelectCursor::Q3SqlSelectCursor ( const QString & query = QString(), QSqlDatabase db = QSqlDatabase() )

Constructs a read only cursor on database db using the query query.

Q3SqlSelectCursor::Q3SqlSelectCursor ( const Q3SqlSelectCursor & other )

Constructs a copy of other

Q3SqlSelectCursor::~Q3SqlSelectCursor ()

Destroys the object and frees any allocated resources

int Q3SqlSelectCursor::update ( const QString & filter, bool invalidate = true ) [virtual protected]

Reimplemented from Q3SqlCursor::update().

This is an overloaded function.

Updates the database with the current contents of the cursor edit buffer using the specified filter. Returns the number of records which were updated. For error information, use lastError().

Only records which meet the filter criteria are updated, otherwise all records in the table are updated.

If invalidate is true (the default), the cursor can no longer be navigated. A new select() call must be made before you can move to a valid record.

See also Q3SqlCursor::update(), primeUpdate(), setMode(), and lastError().