source: trunk/doc/html/qsqldatabase-h.html@ 204

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

reference documentation added
File size: 7.3 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/qsqldatabase.h:1 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>qsqldatabase.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>qsqldatabase.h</h1>
33
34<p>This is the verbatim text of the qsqldatabase.h include file. It is provided only for illustration; the copyright remains with Trolltech.
35<hr>
36<pre>
37/****************************************************************************
38**
39** Definition of QSqlDatabase 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 QSQLDATABASE_H
74#define QSQLDATABASE_H
75
76#ifndef QT_H
77#include "qobject.h"
78#include "qstring.h"
79#include "qsqlquery.h"
80#include "qstringlist.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 QSqlError;
92class QSqlDriver;
93class QSqlIndex;
94class QSqlRecord;
95class QSqlRecordInfo;
96class QSqlDatabasePrivate;
97
98class QM_EXPORT_SQL QSqlDriverCreatorBase
99{
100public:
101 virtual QSqlDriver* createObject() = 0;
102};
103
104template &lt;class type&gt;
105class QM_EXPORT_SQL QSqlDriverCreator: public QSqlDriverCreatorBase
106{
107public:
108 QSqlDriver* createObject() { return new type; }
109};
110
111class QM_EXPORT_SQL QSqlDatabase : public QObject
112{
113 Q_OBJECT
114 Q_PROPERTY( QString databaseName READ databaseName WRITE setDatabaseName )
115 Q_PROPERTY( QString userName READ userName WRITE setUserName )
116 Q_PROPERTY( QString password READ password WRITE setPassword )
117 Q_PROPERTY( QString hostName READ hostName WRITE setHostName )
118 Q_PROPERTY( int port READ port WRITE setPort )
119 Q_PROPERTY( QString connectOptions READ connectOptions WRITE setConnectOptions )
120
121public:
122 ~QSqlDatabase();
123
124 bool open();
125 bool open( const QString&amp; user, const QString&amp; password );
126 void close();
127 bool isOpen() const;
128 bool isOpenError() const;
129 QStringList tables() const;
130 QStringList tables( QSql::TableType type ) const;
131 QSqlIndex primaryIndex( const QString&amp; tablename ) const;
132 QSqlRecord record( const QString&amp; tablename ) const;
133 QSqlRecord record( const QSqlQuery&amp; query ) const;
134 QSqlRecordInfo recordInfo( const QString&amp; tablename ) const;
135 QSqlRecordInfo recordInfo( const QSqlQuery&amp; query ) const;
136 QSqlQuery exec( const QString&amp; query = QString::null ) const;
137 QSqlError lastError() const;
138
139 bool transaction();
140 bool commit();
141 bool rollback();
142
143 virtual void setDatabaseName( const QString&amp; name );
144 virtual void setUserName( const QString&amp; name );
145 virtual void setPassword( const QString&amp; password );
146 virtual void setHostName( const QString&amp; host );
147 virtual void setPort( int p );
148 void setConnectOptions( const QString&amp; options = QString::null );
149 QString databaseName() const;
150 QString userName() const;
151 QString password() const;
152 QString hostName() const;
153 QString driverName() const;
154 int port() const;
155 QString connectOptions() const;
156
157 QSqlDriver* driver() const;
158
159 // MOC_SKIP_BEGIN
160 QT_STATIC_CONST char * const defaultConnection;
161 // MOC_SKIP_END
162
163 static QSqlDatabase* addDatabase( const QString&amp; type, const QString&amp; connectionName = defaultConnection );
164 static QSqlDatabase* addDatabase( QSqlDriver* driver, const QString&amp; connectionName = defaultConnection );
165 static QSqlDatabase* database( const QString&amp; connectionName = defaultConnection, bool open = TRUE );
166 static void removeDatabase( const QString&amp; connectionName );
167 static void removeDatabase( QSqlDatabase* db );
168 static bool contains( const QString&amp; connectionName = defaultConnection );
169 static QStringList drivers();
170 static void registerSqlDriver( const QString&amp; name, const QSqlDriverCreatorBase* creator ); // ### 4.0: creator should not be const
171 static bool isDriverAvailable( const QString&amp; name );
172
173protected:
174 QSqlDatabase( const QString&amp; type, const QString&amp; name, QObject * parent=0, const char * objname=0 );
175 QSqlDatabase( QSqlDriver* driver, QObject * parent=0, const char * objname=0 );
176private:
177 void init( const QString&amp; type, const QString&amp; name );
178 QSqlDatabasePrivate* d;
179#if defined(Q_DISABLE_COPY) // Disabled copy constructor and operator=
180 QSqlDatabase( const QSqlDatabase &amp; );
181 QSqlDatabase &amp;operator=( const QSqlDatabase &amp; );
182#endif
183
184};
185
186#endif // QT_NO_SQL
187#endif
188</pre>
189<!-- eof -->
190<p><address><hr><div align=center>
191<table width=100% cellspacing=0 border=0><tr>
192<td>Copyright &copy; 2007
193<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
194<td align=right><div align=right>Qt 3.3.8</div>
195</table></div></address></body>
196</html>
Note: See TracBrowser for help on using the repository browser.