Classes - Annotated - Tree - Functions - Home - Structure

qsqlcursor.h

This is the verbatim text of the qsqlcursor.h include file. It is provided only for illustration; the copyright remains with Trolltech.


/****************************************************************************
**
** Definition of QSqlCursor class
**
** Created : 2000-11-03
**
** Copyright (C) 2000 Trolltech AS.  All rights reserved.
**
** This file is part of the sql module of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Trolltech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.
**
** Licensees holding valid Qt Enterprise Edition licenses may use this
** file in accordance with the Qt Commercial License Agreement provided
** with the Software.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
**   information about Qt Commercial License Agreements.
** See http://www.trolltech.com/qpl/ for QPL licensing information.
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/

#ifndef QSQLCURSOR_H
#define QSQLCURSOR_H

#include "qfeatures.h"

#if !defined( QT_MODULE_SQL ) || defined( QT_LICENSE_PROFESSIONAL )
#define QM_EXPORT_SQL
#else
#define QM_EXPORT_SQL Q_EXPORT
#endif

#ifndef QT_NO_SQL

#ifndef QT_H
#include "qsqlrecord.h"
#include "qstringlist.h"
#include "qsqlquery.h"
#include "qsqlindex.h"
#endif // QT_H

class QSqlDatabase;
class QSqlCursorPrivate;

class QM_EXPORT_SQL QSqlCursor : public QSqlRecord, public QSqlQuery
{
public:
    QSqlCursor( const QString & name = QString::null, bool autopopulate = TRUE, QSqlDatabase* db = 0 );
    QSqlCursor( const QSqlCursor & other );
    QSqlCursor& operator=( const QSqlCursor& other );
    ~QSqlCursor();

    enum Mode {
	ReadOnly = 0,
	Insert = 1,
	Update = 2,
	Delete = 4,
	Writable = 7
    };

    QVariant            value( int i ) const;
    QVariant            value( const QString& name ) const;
    virtual QSqlIndex   primaryIndex( bool prime = TRUE ) const;
    virtual QSqlIndex   index( const QStringList& fieldNames ) const;
    QSqlIndex           index( const QString& fieldName ) const;
    QSqlIndex           index( const char* fieldName ) const;
    virtual void        setPrimaryIndex( const QSqlIndex& idx );

    void                append( const QSqlField& field );
    void                insert( int pos, const QSqlField& field );
    void                remove( int pos );

    virtual QSqlRecord* editBuffer( bool copy = FALSE );
    virtual QSqlRecord* primeInsert();
    virtual QSqlRecord* primeUpdate();
    virtual QSqlRecord* primeDelete();
    virtual int         insert( bool invalidate = TRUE );
    virtual int         update( bool invalidate = TRUE );
    virtual int         del( bool invalidate = TRUE );

    virtual void        setMode( int flags );
    int                 mode() const;
    virtual void        setCalculated( const QString& name, bool calculated );
    bool                isCalculated( const QString& name ) const;
    virtual void        setTrimmed( const QString& name, bool trim );
    bool                isTrimmed( const QString& name ) const;

    bool                isReadOnly() const;
    bool                canInsert() const;
    bool                canUpdate() const;
    bool                canDelete() const;

    bool                select();
    bool                select( const QSqlIndex& sort );
    bool                select( const QSqlIndex & filter, const QSqlIndex & sort );
    virtual bool        select( const QString & filter, const QSqlIndex & sort = QSqlIndex() );

    virtual void        setSort( const QSqlIndex& sort );
    QSqlIndex           sort() const;
    virtual void        setFilter( const QString& filter );
    QString             filter() const;
    virtual void        setName( const QString& name, bool autopopulate = TRUE );
    QString             name() const;
    QString             toString( const QString& prefix = QString::null,
				const QString& sep = "," ) const;

protected:
    void              afterSeek();
    bool              exec( const QString & sql );

    virtual QVariant  calculateField( const QString& name );
    virtual int       update( const QString & filter, bool invalidate = TRUE );
    virtual int       del( const QString & filter, bool invalidate = TRUE );

    virtual QString   toString( const QString& prefix, QSqlField* field, const QString& fieldSep ) const;
    virtual QString   toString( QSqlRecord* rec, const QString& prefix, const QString& fieldSep,
				const QString& sep ) const;
    virtual QString   toString( const QSqlIndex& i, QSqlRecord* rec, const QString& prefix,
				const QString& fieldSep, const QString& sep ) const;

private:
    void              sync();
    int               apply( const QString& q, bool invalidate );
    QSqlRecord&       operator=( const QSqlRecord & list );

    QSqlCursorPrivate*  d;
};




#endif	// QT_NO_SQL
#endif


Copyright © 2001 TrolltechTrademarks
Qt version 3.0.0-beta2