QDataView

Section: Misc. Reference Manual Pages (3qt)
Updated: 2 February 2007
Index Return to Main Contents

NAME

QDataView - Read-only SQL forms

SYNOPSIS

Inherits QWidget.

Public Members

QDataView ( QWidget * parent = 0, const char * name = 0, WFlags fl = 0 )

~QDataView ()

virtual void setForm ( QSqlForm * form )

QSqlForm * form ()

virtual void setRecord ( QSqlRecord * record )

QSqlRecord * record ()

Public Slots

virtual void refresh ( QSqlRecord * buf )

virtual void readFields ()

virtual void writeFields ()

virtual void clearValues ()

DESCRIPTION

The QDataView class provides read-only SQL forms.

This class provides a form which displays SQL field data from a record buffer. Because QDataView does not support editing it uses less resources than a QDataBrowser. This class is well suited for displaying read-only data from a SQL database.

If you want a to present your data in an editable form use QDataBrowser; if you want a table-based presentation of your data use QDataTable.

The form is associated with the data view with setForm() and the record is associated with setRecord(). You can also pass a QSqlRecord to the refresh() function which will set the record to the given record and read the record's fields into the form.

MEMBER FUNCTION DOCUMENTATION

QDataView::QDataView ( QWidget * parent = 0, const char * name = 0, WFlags fl = 0 )

Constructs a data view which is a child of parent, called name, and with widget flags fl.

QDataView::~QDataView ()

Destroys the object and frees any allocated resources.

void QDataView::clearValues () [virtual slot]

Clears the default form's values. If there is no default form, nothing happens. All the values are set to their 'zero state', e.g. 0 for numeric fields, "" for string fields.

QSqlForm * QDataView::form ()

Returns the default form used by the data view, or 0 if there is none.

void QDataView::readFields () [virtual slot]

Causes the default form to read its fields from the record buffer. If there is no default form, or no record, nothing happens.

QSqlRecord * QDataView::record ()

Returns the default record used by the data view, or 0 if there is none.

void QDataView::refresh ( QSqlRecord * buf ) [virtual slot]

Causes the default form to display the contents of buf. If there is no default form, nothing happens.The buf also becomes the default record for all subsequent calls to readFields() and writefields(). This slot is equivalant to calling:



    myView.setRecord( record );


    myView.readFields();

void QDataView::setForm ( QSqlForm * form ) [virtual]

Sets the form used by the data view to form. If a record has already been assigned to the data view, the form will display that record's data.

void QDataView::setRecord ( QSqlRecord * record ) [virtual]

Sets the record used by the data view to record. If a form has already been assigned to the data view, the form will display the data from record in that form.

void QDataView::writeFields () [virtual slot]

Causes the default form to write its fields to the record buffer. If there is no default form, or no record, nothing happens.

COPYRIGHT

AUTHOR

Generated automatically from the source code.

BUGS

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qdataview.3qt) and the Qt version (3.3.8).