|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.QSignalEmitter
com.trolltech.qt.QtJambiObject
com.trolltech.qt.sql.QSqlRecord
public class QSqlRecord
The QSqlRecord class encapsulates a database record. The QSqlRecord class encapsulates the functionality and characteristics of a database record (usually a row in a table or view within the database). QSqlRecord supports adding and removing fields as well as setting and retrieving field values.
The values of a record's fields' can be set by name or position with setValue()
; if you want to set a field to null use setNull()
. To find the position of a field by name use indexOf()
, and to find the name of a field at a particular position use fieldName()
. Use field()
to retrieve a QSqlField
object for a given field. Use contains()
to see if the record contains a particular field name.
When queries are generated to be executed on the database only those fields for which isGenerated()
is true are included in the generated SQL.
A record can have fields added with append()
or insert()
, replaced with replace()
, and removed with remove()
. All the fields can be removed with clear()
. The number of fields is given by count()
; all their values can be cleared (to null) using clearValues()
.
QSqlField
, and QSqlQuery::record()
.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal |
Field Summary |
---|
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
currentSender |
Constructor Summary | |
---|---|
QSqlRecord()
Constructs an empty record. |
|
QSqlRecord(QSqlRecord other)
Constructs a copy of other. |
Method Summary | |
---|---|
void |
append(QSqlField field)
Append a copy of field field to the end of the record. |
void |
clear()
Removes all the record's fields. |
void |
clearValues()
Clears the value of all fields in the record and sets each field to null. |
QSqlRecord |
clone()
This method is reimplemented for internal reasons |
boolean |
contains(java.lang.String name)
Returns true if there is a field in the record called name; otherwise returns false. |
int |
count()
Returns the number of fields in the record. |
QSqlField |
field(int i)
Returns the field at position index. |
QSqlField |
field(java.lang.String name)
This is an overloaded member function, provided for convenience. |
java.lang.String |
fieldName(int i)
Returns the name of the field at position index. |
int |
indexOf(java.lang.String name)
Returns the position of the field called name within the record, or -1 if it cannot be found. |
void |
insert(int pos,
QSqlField field)
Inserts the field field at position pos in the record. |
boolean |
isEmpty()
Returns true if there are no fields in the record; otherwise returns false. |
boolean |
isGenerated(int i)
This is an overloaded member function, provided for convenience. |
boolean |
isGenerated(java.lang.String name)
Returns true if the record has a field called name and this field is to be generated (the default); otherwise returns false. |
boolean |
isNull(int i)
This is an overloaded member function, provided for convenience. |
boolean |
isNull(java.lang.String name)
Returns true if the field called name is null or if there is no field called name; otherwise returns false. |
void |
remove(int pos)
Removes the field at position pos. |
void |
replace(int pos,
QSqlField field)
Replaces the field at position pos with the given field. |
void |
setGenerated(int i,
boolean generated)
This is an overloaded member function, provided for convenience. |
void |
setGenerated(java.lang.String name,
boolean generated)
Sets the generated flag for the field called name to generated. |
void |
setNull(int i)
Sets the value of field index to null. |
void |
setNull(java.lang.String name)
This is an overloaded member function, provided for convenience. |
void |
setValue(int i,
java.lang.Object val)
Sets the value of the field at position index to val. |
void |
setValue(java.lang.String name,
java.lang.Object val)
This is an overloaded member function, provided for convenience. |
java.lang.String |
toString()
|
java.lang.Object |
value(int i)
Returns the value of the field located at position index in the record. |
java.lang.Object |
value(java.lang.String name)
This is an overloaded member function, provided for convenience. |
Methods inherited from class com.trolltech.qt.QtJambiObject |
---|
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr |
Methods inherited from class com.trolltech.qt.QSignalEmitter |
---|
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread |
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
__qt_signalInitialization |
Methods inherited from class java.lang.Object |
---|
getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.trolltech.qt.QtJambiInterface |
---|
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership |
Constructor Detail |
---|
public QSqlRecord()
isEmpty()
, append()
, and insert()
.
public QSqlRecord(QSqlRecord other)
QSqlRecord is implicitly shared. This means you can make copies of a record in constant time.
Method Detail |
---|
public void append(QSqlField field)
insert()
, replace()
, and remove()
.
public final void clear()
clearValues()
, and isEmpty()
.
public final void clearValues()
setValue()
.
public final boolean contains(java.lang.String name)
public final int count()
isEmpty()
.
public final QSqlField field(java.lang.String name)
Returns the field called name.
public final QSqlField field(int i)
public final java.lang.String fieldName(int i)
indexOf()
.
public final int indexOf(java.lang.String name)
fieldName()
.
public final void insert(int pos, QSqlField field)
append()
, replace()
, and remove()
.
public final boolean isEmpty()
append()
, insert()
, and clear()
.
public final boolean isGenerated(java.lang.String name)
setGenerated()
.
public final boolean isGenerated(int i)
Returns true if the record has a field at position index and this field is to be generated (the default); otherwise returns false.
setGenerated()
.
public final boolean isNull(java.lang.String name)
setNull()
.
public final boolean isNull(int i)
Returns true if the field index is null or if there is no field at position index; otherwise returns false.
public final void remove(int pos)
append()
, insert()
, and replace()
.
public final void replace(int pos, QSqlField field)
append()
, insert()
, and remove()
.
public final void setGenerated(java.lang.String name, boolean generated)
QSqlQueryModel
for example. isGenerated()
.
public final void setGenerated(int i, boolean generated)
Sets the generated flag for the field index to generated.
isGenerated()
.
public final void setNull(java.lang.String name)
Sets the value of the field called name to null. If the field does not exist, nothing happens.
public final void setNull(int i)
isNull()
, and setValue()
.
public final void setValue(java.lang.String name, java.lang.Object val)
Sets the value of the field called name to val. If the field does not exist, nothing happens.
public final void setValue(int i, java.lang.Object val)
value()
, and setNull()
.
public final java.lang.Object value(java.lang.String name)
Returns the value of the field called name in the record. If field name does not exist an invalid variant is returned.
indexOf()
.
public final java.lang.Object value(int i)
QVariant
is returned. setValue()
, fieldName()
, and isNull()
.
public java.lang.String toString()
toString
in class java.lang.Object
public QSqlRecord clone()
clone
in class java.lang.Object
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |