source: trunk/doc/html/qsqlcursor-h.html

Last change on this file was 190, checked in by rudi, 14 years ago

reference documentation added

File size: 7.4 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qsqlcursor.h:1 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>qsqlcursor.h Include File</title>
7<style type="text/css"><!--
8fn { margin-left: 1cm; text-indent: -1cm; }
9a:link { color: #004faf; text-decoration: none }
10a:visited { color: #672967; text-decoration: none }
11body { background: #ffffff; color: black; }
12--></style>
13</head>
14<body>
15
16<table border="0" cellpadding="0" cellspacing="0" width="100%">
17<tr bgcolor="#E5E5E5">
18<td valign=center>
19 <a href="index.html">
20<font color="#004faf">Home</font></a>
21 | <a href="classes.html">
22<font color="#004faf">All&nbsp;Classes</font></a>
23 | <a href="mainclasses.html">
24<font color="#004faf">Main&nbsp;Classes</font></a>
25 | <a href="annotated.html">
26<font color="#004faf">Annotated</font></a>
27 | <a href="groups.html">
28<font color="#004faf">Grouped&nbsp;Classes</font></a>
29 | <a href="functions.html">
30<font color="#004faf">Functions</font></a>
31</td>
32<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qsqlcursor.h</h1>
33
34<p>This is the verbatim text of the qsqlcursor.h include file. It is provided only for illustration; the copyright remains with Trolltech.
35<hr>
36<pre>
37/****************************************************************************
38**
39** Definition of QSqlCursor class
40**
41** Created : 2000-11-03
42**
43** Copyright (C) 2005-2007 Trolltech ASA. All rights reserved.
44**
45** This file is part of the sql module of the Qt GUI Toolkit.
46**
47** This file may be distributed under the terms of the Q Public License
48** as defined by Trolltech ASA of Norway and appearing in the file
49** LICENSE.QPL included in the packaging of this file.
50**
51** This file may be distributed and/or modified under the terms of the
52** GNU General Public License version 2 as published by the Free Software
53** Foundation and appearing in the file LICENSE.GPL included in the
54** packaging of this file.
55**
56** Licensees holding valid Qt Enterprise Edition licenses may use this
57** file in accordance with the Qt Commercial License Agreement provided
58** with the Software.
59**
60** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
61** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
62**
63** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
64** information about Qt Commercial License Agreements.
65** See http://www.trolltech.com/qpl/ for QPL licensing information.
66** See http://www.trolltech.com/gpl/ for GPL licensing information.
67**
68** Contact info@trolltech.com if any conditions of this licensing are
69** not clear to you.
70**
71**********************************************************************/
72
73#ifndef QSQLCURSOR_H
74#define QSQLCURSOR_H
75
76#ifndef QT_H
77#include "qsqlrecord.h"
78#include "qstringlist.h"
79#include "qsqlquery.h"
80#include "qsqlindex.h"
81#endif // QT_H
82
83#if !defined( QT_MODULE_SQL ) || defined( QT_LICENSE_PROFESSIONAL )
84#define QM_EXPORT_SQL
85#else
86#define QM_EXPORT_SQL Q_EXPORT
87#endif
88
89#ifndef QT_NO_SQL
90
91class QSqlDatabase;
92class QSqlCursorPrivate;
93
94class QM_EXPORT_SQL QSqlCursor : public QSqlRecord, public QSqlQuery
95{
96public:
97 QSqlCursor( const QString &amp; name = QString::null, bool autopopulate = TRUE, QSqlDatabase* db = 0 );
98 QSqlCursor( const QSqlCursor &amp; other );
99 QSqlCursor&amp; operator=( const QSqlCursor&amp; other );
100 ~QSqlCursor();
101
102 enum Mode {
103 ReadOnly = 0,
104 Insert = 1,
105 Update = 2,
106 Delete = 4,
107 Writable = 7
108 };
109
110 QVariant value( int i ) const;
111 QVariant value( const QString&amp; name ) const;
112 void setValue( int i, const QVariant&amp; val );
113 void setValue( const QString&amp; name, const QVariant&amp; val );
114 virtual QSqlIndex primaryIndex( bool prime = TRUE ) const;
115 virtual QSqlIndex index( const QStringList&amp; fieldNames ) const;
116 QSqlIndex index( const QString&amp; fieldName ) const;
117 QSqlIndex index( const char* fieldName ) const;
118 virtual void setPrimaryIndex( const QSqlIndex&amp; idx );
119
120 virtual void append( const QSqlFieldInfo&amp; fieldInfo );
121 virtual void insert( int pos, const QSqlFieldInfo&amp; fieldInfo );
122 void remove( int pos );
123 void clear();
124 void setGenerated( const QString&amp; name, bool generated );
125 void setGenerated( int i, bool generated );
126
127 virtual QSqlRecord* editBuffer( bool copy = FALSE );
128 virtual QSqlRecord* primeInsert();
129 virtual QSqlRecord* primeUpdate();
130 virtual QSqlRecord* primeDelete();
131 virtual int insert( bool invalidate = TRUE );
132 virtual int update( bool invalidate = TRUE );
133 virtual int del( bool invalidate = TRUE );
134
135 virtual void setMode( int flags );
136 int mode() const;
137 virtual void setCalculated( const QString&amp; name, bool calculated );
138 bool isCalculated( const QString&amp; name ) const;
139 virtual void setTrimmed( const QString&amp; name, bool trim );
140 bool isTrimmed( const QString&amp; name ) const;
141
142 bool isReadOnly() const;
143 bool canInsert() const;
144 bool canUpdate() const;
145 bool canDelete() const;
146
147 bool select();
148 bool select( const QSqlIndex&amp; sort );
149 bool select( const QSqlIndex &amp; filter, const QSqlIndex &amp; sort );
150 virtual bool select( const QString &amp; filter, const QSqlIndex &amp; sort = QSqlIndex() );
151
152 virtual void setSort( const QSqlIndex&amp; sort );
153 QSqlIndex sort() const;
154 virtual void setFilter( const QString&amp; filter );
155 QString filter() const;
156 virtual void setName( const QString&amp; name, bool autopopulate = TRUE );
157 QString name() const;
158 QString toString( const QString&amp; prefix = QString::null,
159 const QString&amp; sep = "," ) const;
160 bool isNull( int i ) const;
161 bool isNull( const QString&amp; name ) const;
162
163protected:
164 void afterSeek();
165 bool exec( const QString &amp; sql );
166
167 virtual QVariant calculateField( const QString&amp; name );
168 virtual int update( const QString &amp; filter, bool invalidate = TRUE );
169 virtual int del( const QString &amp; filter, bool invalidate = TRUE );
170
171 virtual QString toString( const QString&amp; prefix, QSqlField* field, const QString&amp; fieldSep ) const;
172 virtual QString toString( QSqlRecord* rec, const QString&amp; prefix, const QString&amp; fieldSep,
173 const QString&amp; sep ) const;
174 virtual QString toString( const QSqlIndex&amp; i, QSqlRecord* rec, const QString&amp; prefix,
175 const QString&amp; fieldSep, const QString&amp; sep ) const;
176
177private:
178 void sync();
179 int apply( const QString&amp; q, bool invalidate );
180 int applyPrepared( const QString&amp; q, bool invalidate );
181 QSqlRecord&amp; operator=( const QSqlRecord &amp; list );
182 void append( const QSqlField&amp; field );
183 void insert( int pos, const QSqlField&amp; field );
184
185 QSqlCursorPrivate* d;
186};
187
188
189
190
191#endif // QT_NO_SQL
192#endif
193</pre>
194<!-- eof -->
195<p><address><hr><div align=center>
196<table width=100% cellspacing=0 border=0><tr>
197<td>Copyright &copy; 2007
198<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
199<td align=right><div align=right>Qt 3.3.8</div>
200</table></div></address></body>
201</html>
Note: See TracBrowser for help on using the repository browser.