diff options
Diffstat (limited to 'doc/man/man3')
24 files changed, 981 insertions, 981 deletions
diff --git a/doc/man/man3/tqdatabrowser.3qt b/doc/man/man3/tqdatabrowser.3qt index 76a5b49a6..4ac8e2b7f 100644 --- a/doc/man/man3/tqdatabrowser.3qt +++ b/doc/man/man3/tqdatabrowser.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDataBrowser 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDataBrowser 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QDataBrowser \- Data manipulation and navigation for data entry forms +TQDataBrowser \- Data manipulation and navigation for data entry forms .SH SYNOPSIS -\fC#include <ntqdatabrowser.h>\fR +\fC#include <tqdatabrowser.h>\fR .PP Inherits TQWidget. .PP @@ -19,7 +19,7 @@ Inherits TQWidget. .BI "\fBQDataBrowser\fR ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" .br .ti -1c -.BI "\fB~QDataBrowser\fR ()" +.BI "\fB~TQDataBrowser\fR ()" .br .ti -1c .BI "enum \fBBoundary\fR { Unknown, None, BeforeBeginning, Beginning, End, AfterEnd }" @@ -34,7 +34,7 @@ Inherits TQWidget. .BI "bool \fBboundaryChecking\fR () const" .br .ti -1c -.BI "void \fBsetSort\fR ( const QSqlIndex & sort )" +.BI "void \fBsetSort\fR ( const TQSqlIndex & sort )" .br .ti -1c .BI "void \fBsetSort\fR ( const QStringList & sort )" @@ -49,16 +49,16 @@ Inherits TQWidget. .BI "TQString \fBfilter\fR () const" .br .ti -1c -.BI "virtual void \fBsetSqlCursor\fR ( QSqlCursor * cursor, bool autoDelete = FALSE )" +.BI "virtual void \fBsetSqlCursor\fR ( TQSqlCursor * cursor, bool autoDelete = FALSE )" .br .ti -1c -.BI "QSqlCursor * \fBsqlCursor\fR () const" +.BI "TQSqlCursor * \fBsqlCursor\fR () const" .br .ti -1c -.BI "virtual void \fBsetForm\fR ( QSqlForm * form )" +.BI "virtual void \fBsetForm\fR ( TQSqlForm * form )" .br .ti -1c -.BI "QSqlForm * \fBform\fR ()" +.BI "TQSqlForm * \fBform\fR ()" .br .ti -1c .BI "virtual void \fBsetConfirmEdits\fR ( bool confirm )" @@ -160,28 +160,28 @@ Inherits TQWidget. .BI "void \fBprevRecordAvailable\fR ( bool available )" .br .ti -1c -.BI "void \fBcurrentChanged\fR ( const QSqlRecord * record )" +.BI "void \fBcurrentChanged\fR ( const TQSqlRecord * record )" .br .ti -1c -.BI "void \fBprimeInsert\fR ( QSqlRecord * buf )" +.BI "void \fBprimeInsert\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBprimeUpdate\fR ( QSqlRecord * buf )" +.BI "void \fBprimeUpdate\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBprimeDelete\fR ( QSqlRecord * buf )" +.BI "void \fBprimeDelete\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBbeforeInsert\fR ( QSqlRecord * buf )" +.BI "void \fBbeforeInsert\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBbeforeUpdate\fR ( QSqlRecord * buf )" +.BI "void \fBbeforeUpdate\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBbeforeDelete\fR ( QSqlRecord * buf )" +.BI "void \fBbeforeDelete\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBcursorChanged\fR ( QSqlCursor::Mode mode )" +.BI "void \fBcursorChanged\fR ( TQSqlCursor::Mode mode )" .br .in -1c .SS "Properties" @@ -232,23 +232,23 @@ Inherits TQWidget. .BI "virtual bool \fBcurrentEdited\fR ()" .br .ti -1c -.BI "virtual QSql::Confirm \fBconfirmEdit\fR ( QSql::Op m )" +.BI "virtual TQSql::Confirm \fBconfirmEdit\fR ( TQSql::Op m )" .br .ti -1c -.BI "virtual QSql::Confirm \fBconfirmCancel\fR ( QSql::Op m )" +.BI "virtual TQSql::Confirm \fBconfirmCancel\fR ( TQSql::Op m )" .br .ti -1c -.BI "virtual void \fBhandleError\fR ( const QSqlError & error )" +.BI "virtual void \fBhandleError\fR ( const TQSqlError & error )" .br .in -1c .SH DESCRIPTION -The QDataBrowser class provides data manipulation and navigation for data entry forms. +The TQDataBrowser class provides data manipulation and navigation for data entry forms. .PP A high-level API is provided for navigating through data records in a cursor, for inserting, updating and deleting records, and for refreshing data in the display. .PP -If you want a read-only form to present database data use QDataView; if you want a table-based presentation of your data use QDataTable. +If you want a read-only form to present database data use TQDataView; if you want a table-based presentation of your data use TQDataTable. .PP -A QDataBrowser is used to associate a dataset with a form in much the same way as a QDataTable associates a dataset with a table. Once the data browser has been constructed it can be associated with a dataset with setSqlCursor(), and with a form with setForm(). Boundary checking, sorting and filtering can be set with setBoundaryChecking(), setSort() and setFilter(), respectively. +A TQDataBrowser is used to associate a dataset with a form in much the same way as a TQDataTable associates a dataset with a table. Once the data browser has been constructed it can be associated with a dataset with setSqlCursor(), and with a form with setForm(). Boundary checking, sorting and filtering can be set with setBoundaryChecking(), setSort() and setFilter(), respectively. .PP The insertCurrent() function reads the fields from the default form into the default cursor and performs the insert. The updateCurrent() and deleteCurrent() functions perform similarly to update and delete the current record respectively. .PP @@ -268,7 +268,7 @@ The form is populated with data from the database with readFields(). If the user .PP See also Database Classes. .SS "Member Type Documentation" -.SH "QDataBrowser::Boundary" +.SH "TQDataBrowser::Boundary" This enum describes where the data browser is positioned. .TP \fCQDataBrowser::Unknown\fR - the boundary cannot be determined (usually because there is no default cursor, or the default cursor is not active). @@ -283,73 +283,73 @@ This enum describes where the data browser is positioned. .TP \fCQDataBrowser::AfterEnd\fR - the browser is positioned after the last available record. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDataBrowser::QDataBrowser ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" +.SH "TQDataBrowser::TQDataBrowser ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" Constructs a data browser which is a child of \fIparent\fR, with the name \fIname\fR and widget flags set to \fIfl\fR. -.SH "QDataBrowser::~QDataBrowser ()" +.SH "TQDataBrowser::~TQDataBrowser ()" Destroys the object and frees any allocated resources. -.SH "bool QDataBrowser::autoEdit () const" +.SH "bool TQDataBrowser::autoEdit () const" Returns TRUE if the browser automatically applies edits; otherwise returns FALSE. See the "autoEdit" property for details. -.SH "void QDataBrowser::beforeDelete ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataBrowser::beforeDelete ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted just before the cursor's edit buffer is deleted from the database. The \fIbuf\fR parameter points to the edit buffer being deleted. You might connect to this signal to capture some auditing information about the deletion. -.SH "void QDataBrowser::beforeInsert ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataBrowser::beforeInsert ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted just before the cursor's edit buffer is inserted into the database. The \fIbuf\fR parameter points to the edit buffer being inserted. You might connect to this signal to populate a generated primary key for example. -.SH "void QDataBrowser::beforeUpdate ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataBrowser::beforeUpdate ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted just before the cursor's edit buffer is updated in the database. The \fIbuf\fR parameter points to the edit buffer being updated. You might connect to this signal to capture some auditing information about the update. -.SH "Boundary QDataBrowser::boundary ()" +.SH "Boundary TQDataBrowser::boundary ()" Returns an enum indicating the boundary status of the browser. .PP -This is achieved by moving the default cursor and checking the position, however the current default form values will not be altered. After checking for the boundary, the cursor is moved back to its former position. See QDataBrowser::Boundary. +This is achieved by moving the default cursor and checking the position, however the current default form values will not be altered. After checking for the boundary, the cursor is moved back to its former position. See TQDataBrowser::Boundary. .PP See also Boundary. -.SH "bool QDataBrowser::boundaryChecking () const" +.SH "bool TQDataBrowser::boundaryChecking () const" Returns TRUE if boundary checking is active; otherwise returns FALSE. See the "boundaryChecking" property for details. -.SH "void QDataBrowser::clearValues ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::clearValues ()\fC [virtual slot]\fR" Clears all the values in the form. .PP -All the edit buffer field values are set to their 'zero state', e.g. 0 for numeric fields and "" for string fields. Then the widgets are updated using the property map. For example, a combobox that is property-mapped to integers would scroll to the first item. See the QSqlPropertyMap constructor for the default mappings of widgets to properties. -.SH "QSql::Confirm QDataBrowser::confirmCancel ( QSql::Op m )\fC [virtual protected]\fR" +All the edit buffer field values are set to their 'zero state', e.g. 0 for numeric fields and "" for string fields. Then the widgets are updated using the property map. For example, a combobox that is property-mapped to integers would scroll to the first item. See the TQSqlPropertyMap constructor for the default mappings of widgets to properties. +.SH "TQSql::Confirm TQDataBrowser::confirmCancel ( TQSql::Op m )\fC [virtual protected]\fR" Protected virtual function which returns a confirmation for cancelling an edit mode \fIm\fR. Derived classes can reimplement this function and provide their own confirmation dialog. The default implementation uses a message box which prompts the user to confirm the edit action. -.SH "bool QDataBrowser::confirmCancels () const" +.SH "bool TQDataBrowser::confirmCancels () const" Returns TRUE if the browser confirms cancel operations; otherwise returns FALSE. See the "confirmCancels" property for details. -.SH "bool QDataBrowser::confirmDelete () const" +.SH "bool TQDataBrowser::confirmDelete () const" Returns TRUE if the browser confirms deletions; otherwise returns FALSE. See the "confirmDelete" property for details. -.SH "QSql::Confirm QDataBrowser::confirmEdit ( QSql::Op m )\fC [virtual protected]\fR" +.SH "TQSql::Confirm TQDataBrowser::confirmEdit ( TQSql::Op m )\fC [virtual protected]\fR" Protected virtual function which returns a confirmation for an edit of mode \fIm\fR. Derived classes can reimplement this function and provide their own confirmation dialog. The default implementation uses a message box which prompts the user to confirm the edit action. -.SH "bool QDataBrowser::confirmEdits () const" +.SH "bool TQDataBrowser::confirmEdits () const" Returns TRUE if the browser confirms edits; otherwise returns FALSE. See the "confirmEdits" property for details. -.SH "bool QDataBrowser::confirmInsert () const" +.SH "bool TQDataBrowser::confirmInsert () const" Returns TRUE if the data browser confirms insertions; otherwise returns FALSE. See the "confirmInsert" property for details. -.SH "bool QDataBrowser::confirmUpdate () const" +.SH "bool TQDataBrowser::confirmUpdate () const" Returns TRUE if the browser confirms updates; otherwise returns FALSE. See the "confirmUpdate" property for details. -.SH "void QDataBrowser::currentChanged ( const QSqlRecord * record )\fC [signal]\fR" +.SH "void TQDataBrowser::currentChanged ( const TQSqlRecord * record )\fC [signal]\fR" This signal is emitted whenever the current cursor position changes. The \fIrecord\fR parameter points to the contents of the current cursor's record. -.SH "bool QDataBrowser::currentEdited ()\fC [virtual protected]\fR" +.SH "bool TQDataBrowser::currentEdited ()\fC [virtual protected]\fR" Returns TRUE if the form's edit buffer differs from the current cursor buffer; otherwise returns FALSE. -.SH "void QDataBrowser::cursorChanged ( QSqlCursor::Mode mode )\fC [signal]\fR" -This signal is emitted whenever the cursor record was changed due to navigation. The \fImode\fR parameter is the edit that just took place, e.g. Insert, Update or Delete. See QSqlCursor::Mode. -.SH "void QDataBrowser::del ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::cursorChanged ( TQSqlCursor::Mode mode )\fC [signal]\fR" +This signal is emitted whenever the cursor record was changed due to navigation. The \fImode\fR parameter is the edit that just took place, e.g. Insert, Update or Delete. See TQSqlCursor::Mode. +.SH "void TQDataBrowser::del ()\fC [virtual slot]\fR" Performs a delete operation on the data browser's cursor. If there is no default cursor or no default form, nothing happens. .PP Otherwise, the following happens: .PP The current form's record is deleted from the database, providing that the data browser is not in insert mode. If the data browser is actively inserting a record (see insert()), the insert action is canceled, and the browser navigates to the last valid record that was current. If there is an error, handleError() is called. -.SH "bool QDataBrowser::deleteCurrent ()\fC [virtual protected]\fR" +.SH "bool TQDataBrowser::deleteCurrent ()\fC [virtual protected]\fR" Performs a delete on the default cursor using the values from the default form and updates the default form. If there is no default form or no default cursor, nothing happens. If the deletion was successful, the cursor is repositioned to the nearest record and TRUE is returned. The nearest record is the next record if there is one otherwise the previous record if there is one. If an error occurred during the deletion from the database, handleError() is called and FALSE is returned. .PP See also cursor, form(), and handleError(). -.SH "TQString QDataBrowser::filter () const" +.SH "TQString TQDataBrowser::filter () const" Returns the data browser's filter. See the "filter" property for details. -.SH "void QDataBrowser::first ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::first ()\fC [virtual slot]\fR" Moves the default cursor to the first record and refreshes the default form to display this record. If there is no default form or no default cursor, nothing happens. If the data browser successfully navigated to the first record, the default cursor is primed for update and the primeUpdate() signal is emitted. .PP If the browser is already positioned on the first record nothing happens. -.SH "void QDataBrowser::firstRecordAvailable ( bool available )\fC [signal]\fR" +.SH "void TQDataBrowser::firstRecordAvailable ( bool available )\fC [signal]\fR" This signal is emitted whenever the position of the cursor changes. The \fIavailable\fR parameter indicates whether or not the first record in the default cursor is available. -.SH "QSqlForm * QDataBrowser::form ()" +.SH "TQSqlForm * TQDataBrowser::form ()" Returns the data browser's default form or 0 if no form has been set. -.SH "void QDataBrowser::handleError ( const QSqlError & error )\fC [virtual protected]\fR" +.SH "void TQDataBrowser::handleError ( const TQSqlError & error )\fC [virtual protected]\fR" Virtual function which handles the error \fIerror\fR. The default implementation warns the user with a message box. -.SH "void QDataBrowser::insert ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::insert ()\fC [virtual slot]\fR" Performs an insert operation on the data browser's cursor. If there is no default cursor or no default form, nothing happens. .PP If auto-editing is on (see setAutoEdit()), the following happens: @@ -362,106 +362,106 @@ If there is an error handling any of the above auto-edit actions, handleError() .PP If no error occurred, or auto-editing is not enabled, the data browser begins actively inserting a record into the database by performing the following actions: .TP -The default cursor is primed for insert using QSqlCursor::primeInsert(). +The default cursor is primed for insert using TQSqlCursor::primeInsert(). .TP The primeInsert() signal is emitted. .TP The form is updated with the values in the default cursor's. edit buffer so that the user can fill in the values to be inserted. -.SH "bool QDataBrowser::insertCurrent ()\fC [virtual protected]\fR" +.SH "bool TQDataBrowser::insertCurrent ()\fC [virtual protected]\fR" Reads the fields from the default form into the default cursor and performs an insert on the default cursor. If there is no default form or no default cursor, nothing happens. If an error occurred during the insert into the database, handleError() is called and FALSE is returned. If the insert was successfull, the cursor is refreshed and relocated to the newly inserted record, the cursorChanged() signal is emitted, and TRUE is returned. .PP See also cursorChanged(), sqlCursor(), form(), and handleError(). -.SH "bool QDataBrowser::isReadOnly () const" +.SH "bool TQDataBrowser::isReadOnly () const" Returns TRUE if the browser is read-only; otherwise returns FALSE. See the "readOnly" property for details. -.SH "void QDataBrowser::last ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::last ()\fC [virtual slot]\fR" Moves the default cursor to the last record and refreshes the default form to display this record. If there is no default form or no default cursor, nothing happens. If the data browser successfully navigated to the last record, the default cursor is primed for update and the primeUpdate() signal is emitted. .PP If the browser is already positioned on the last record nothing happens. -.SH "void QDataBrowser::lastRecordAvailable ( bool available )\fC [signal]\fR" +.SH "void TQDataBrowser::lastRecordAvailable ( bool available )\fC [signal]\fR" This signal is emitted whenever the position of the cursor changes. The \fIavailable\fR parameter indicates whether or not the last record in the default cursor is available. -.SH "void QDataBrowser::next ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::next ()\fC [virtual slot]\fR" Moves the default cursor to the next record and refreshes the default form to display this record. If there is no default form or no default cursor, nothing happens. If the data browser successfully navigated to the next record, the default cursor is primed for update and the primeUpdate() signal is emitted. .PP If the browser is positioned on the last record nothing happens. -.SH "void QDataBrowser::nextRecordAvailable ( bool available )\fC [signal]\fR" +.SH "void TQDataBrowser::nextRecordAvailable ( bool available )\fC [signal]\fR" This signal is emitted whenever the position of the cursor changes. The \fIavailable\fR parameter indicates whether or not the next record in the default cursor is available. -.SH "void QDataBrowser::prev ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::prev ()\fC [virtual slot]\fR" Moves the default cursor to the previous record and refreshes the default form to display this record. If there is no default form or no default cursor, nothing happens. If the data browser successfully navigated to the previous record, the default cursor is primed for update and the primeUpdate() signal is emitted. .PP If the browser is positioned on the first record nothing happens. -.SH "void QDataBrowser::prevRecordAvailable ( bool available )\fC [signal]\fR" +.SH "void TQDataBrowser::prevRecordAvailable ( bool available )\fC [signal]\fR" This signal is emitted whenever the position of the cursor changes. The \fIavailable\fR parameter indicates whether or not the previous record in the default cursor is available. -.SH "void QDataBrowser::primeDelete ( QSqlRecord * buf )\fC [signal]\fR" -This signal is emitted when the data browser enters deletion mode. The \fIbuf\fR parameter points to the record buffer being deleted. (Note that QSqlCursor::primeDelete() is \fInot\fR called on the default cursor, as this would corrupt values in the form.) Connect to this signal in order to, for example, save a copy of the deleted record for auditing purposes. +.SH "void TQDataBrowser::primeDelete ( TQSqlRecord * buf )\fC [signal]\fR" +This signal is emitted when the data browser enters deletion mode. The \fIbuf\fR parameter points to the record buffer being deleted. (Note that TQSqlCursor::primeDelete() is \fInot\fR called on the default cursor, as this would corrupt values in the form.) Connect to this signal in order to, for example, save a copy of the deleted record for auditing purposes. .PP See also del(). -.SH "void QDataBrowser::primeInsert ( QSqlRecord * buf )\fC [signal]\fR" -This signal is emitted when the data browser enters insertion mode. The \fIbuf\fR parameter points to the record buffer that is to be inserted. Connect to this signal to, for example, prime the record buffer with default data values, auto-numbered fields etc. (Note that QSqlCursor::primeInsert() is \fInot\fR called on the default cursor, as this would corrupt values in the form.) +.SH "void TQDataBrowser::primeInsert ( TQSqlRecord * buf )\fC [signal]\fR" +This signal is emitted when the data browser enters insertion mode. The \fIbuf\fR parameter points to the record buffer that is to be inserted. Connect to this signal to, for example, prime the record buffer with default data values, auto-numbered fields etc. (Note that TQSqlCursor::primeInsert() is \fInot\fR called on the default cursor, as this would corrupt values in the form.) .PP See also insert(). -.SH "void QDataBrowser::primeUpdate ( QSqlRecord * buf )\fC [signal]\fR" -This signal is emitted when the data browser enters update mode. Note that during navigation (first(), last(), next(), prev()), each record that is shown in the default form is primed for update. The \fIbuf\fR parameter points to the record buffer being updated. (Note that QSqlCursor::primeUpdate() is \fInot\fR called on the default cursor, as this would corrupt values in the form.) Connect to this signal in order to, for example, keep track of which records have been updated, perhaps for auditing purposes. +.SH "void TQDataBrowser::primeUpdate ( TQSqlRecord * buf )\fC [signal]\fR" +This signal is emitted when the data browser enters update mode. Note that during navigation (first(), last(), next(), prev()), each record that is shown in the default form is primed for update. The \fIbuf\fR parameter points to the record buffer being updated. (Note that TQSqlCursor::primeUpdate() is \fInot\fR called on the default cursor, as this would corrupt values in the form.) Connect to this signal in order to, for example, keep track of which records have been updated, perhaps for auditing purposes. .PP See also update(). -.SH "void QDataBrowser::readFields ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::readFields ()\fC [virtual slot]\fR" Reads the fields from the default cursor's edit buffer and displays them in the form. If there is no default cursor or no default form, nothing happens. -.SH "void QDataBrowser::refresh ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::refresh ()\fC [virtual slot]\fR" Refreshes the data browser's data using the default cursor. The browser's current filter and sort are applied if they have been set. .PP See also filter and sort. -.SH "bool QDataBrowser::seek ( int i, bool relative = FALSE )\fC [virtual]\fR" +.SH "bool TQDataBrowser::seek ( int i, bool relative = FALSE )\fC [virtual]\fR" Moves the default cursor to the record specified by the index \fIi\fR and refreshes the default form to display this record. If there is no default form or no default cursor, nothing happens. If \fIrelative\fR is TRUE (the default is FALSE), the cursor is moved relative to its current position. If the data browser successfully navigated to the desired record, the default cursor is primed for update and the primeUpdate() signal is emitted. .PP If the browser is already positioned on the desired record nothing happens. -.SH "void QDataBrowser::setAutoEdit ( bool autoEdit )\fC [virtual]\fR" +.SH "void TQDataBrowser::setAutoEdit ( bool autoEdit )\fC [virtual]\fR" Sets whether the browser automatically applies edits to \fIautoEdit\fR. See the "autoEdit" property for details. -.SH "void QDataBrowser::setBoundaryChecking ( bool active )" +.SH "void TQDataBrowser::setBoundaryChecking ( bool active )" Sets whether boundary checking is active to \fIactive\fR. See the "boundaryChecking" property for details. -.SH "void QDataBrowser::setConfirmCancels ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataBrowser::setConfirmCancels ( bool confirm )\fC [virtual]\fR" Sets whether the browser confirms cancel operations to \fIconfirm\fR. See the "confirmCancels" property for details. -.SH "void QDataBrowser::setConfirmDelete ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataBrowser::setConfirmDelete ( bool confirm )\fC [virtual]\fR" Sets whether the browser confirms deletions to \fIconfirm\fR. See the "confirmDelete" property for details. -.SH "void QDataBrowser::setConfirmEdits ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataBrowser::setConfirmEdits ( bool confirm )\fC [virtual]\fR" Sets whether the browser confirms edits to \fIconfirm\fR. See the "confirmEdits" property for details. -.SH "void QDataBrowser::setConfirmInsert ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataBrowser::setConfirmInsert ( bool confirm )\fC [virtual]\fR" Sets whether the data browser confirms insertions to \fIconfirm\fR. See the "confirmInsert" property for details. -.SH "void QDataBrowser::setConfirmUpdate ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataBrowser::setConfirmUpdate ( bool confirm )\fC [virtual]\fR" Sets whether the browser confirms updates to \fIconfirm\fR. See the "confirmUpdate" property for details. -.SH "void QDataBrowser::setFilter ( const TQString & filter )" +.SH "void TQDataBrowser::setFilter ( const TQString & filter )" Sets the data browser's filter to \fIfilter\fR. See the "filter" property for details. -.SH "void QDataBrowser::setForm ( QSqlForm * form )\fC [virtual]\fR" +.SH "void TQDataBrowser::setForm ( TQSqlForm * form )\fC [virtual]\fR" Sets the browser's default form to \fIform\fR. The cursor and all navigation and data manipulation functions that the browser provides become available to the \fIform\fR. -.SH "void QDataBrowser::setReadOnly ( bool active )\fC [virtual]\fR" +.SH "void TQDataBrowser::setReadOnly ( bool active )\fC [virtual]\fR" Sets whether the browser is read-only to \fIactive\fR. See the "readOnly" property for details. -.SH "void QDataBrowser::setSort ( const QStringList & sort )" +.SH "void TQDataBrowser::setSort ( const QStringList & sort )" Sets the data browser's sort to \fIsort\fR. See the "sort" property for details. -.SH "void QDataBrowser::setSort ( const QSqlIndex & sort )" +.SH "void TQDataBrowser::setSort ( const TQSqlIndex & sort )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Sets the data browser's sort to the QSqlIndex \fIsort\fR. To apply the new sort, use refresh(). -.SH "void QDataBrowser::setSqlCursor ( QSqlCursor * cursor, bool autoDelete = FALSE )\fC [virtual]\fR" +Sets the data browser's sort to the TQSqlIndex \fIsort\fR. To apply the new sort, use refresh(). +.SH "void TQDataBrowser::setSqlCursor ( TQSqlCursor * cursor, bool autoDelete = FALSE )\fC [virtual]\fR" Sets the default cursor used by the data browser to \fIcursor\fR. If \fIautoDelete\fR is TRUE (the default is FALSE), the data browser takes ownership of the \fIcursor\fR pointer, which will be deleted when the browser is destroyed, or when setSqlCursor() is called again. To activate the \fIcursor\fR use refresh(). The cursor's edit buffer is used in the default form to browse and edit records. .PP See also sqlCursor(), form(), and setForm(). -.SH "QStringList QDataBrowser::sort () const" +.SH "QStringList TQDataBrowser::sort () const" Returns the data browser's sort. See the "sort" property for details. -.SH "QSqlCursor * QDataBrowser::sqlCursor () const" +.SH "TQSqlCursor * TQDataBrowser::sqlCursor () const" Returns the default cursor used for navigation, or 0 if there is no default cursor. .PP See also setSqlCursor(). -.SH "void QDataBrowser::update ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::update ()\fC [virtual slot]\fR" Performs an update operation on the data browser's cursor. .PP If there is no default cursor or no default form, nothing happens. Otherwise, the following happens: .PP If the data browser is actively inserting a record (see insert()), that record is inserted into the database using insertCurrent(). Otherwise, the database is updated with the current form's data using updateCurrent(). If there is an error handling either action, handleError() is called. -.SH "void QDataBrowser::updateBoundary ()\fC [slot]\fR" +.SH "void TQDataBrowser::updateBoundary ()\fC [slot]\fR" If boundaryChecking() is TRUE, checks the boundary of the current default cursor and emits signals which indicate the position of the cursor. -.SH "bool QDataBrowser::updateCurrent ()\fC [virtual protected]\fR" +.SH "bool TQDataBrowser::updateCurrent ()\fC [virtual protected]\fR" Reads the fields from the default form into the default cursor and performs an update on the default cursor. If there is no default form or no default cursor, nothing happens. If an error occurred during the update on the database, handleError() is called and FALSE is returned. If the update was successfull, the cursor is refreshed and relocated to the updated record, the cursorChanged() signal is emitted, and TRUE is returned. .PP See also cursor, form(), and handleError(). -.SH "void QDataBrowser::writeFields ()\fC [virtual slot]\fR" +.SH "void TQDataBrowser::writeFields ()\fC [virtual slot]\fR" Writes the form's data to the default cursor's edit buffer. If there is no default cursor or no default form, nothing happens. .SS "Property Documentation" .SH "bool autoEdit" @@ -568,7 +568,7 @@ Note that if you want to iterate over the list, you should iterate over a copy, Set this property's value with setSort() and get this property's value with sort(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqdatabrowser.html +.BR http://doc.trolltech.com/tqdatabrowser.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqdatatable.3qt b/doc/man/man3/tqdatatable.3qt index 88358f581..866cd07a0 100644 --- a/doc/man/man3/tqdatatable.3qt +++ b/doc/man/man3/tqdatatable.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDataTable 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDataTable 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QDataTable \- Flexible SQL table widget that supports browsing and editing +TQDataTable \- Flexible SQL table widget that supports browsing and editing .SH SYNOPSIS -\fC#include <ntqdatatable.h>\fR +\fC#include <tqdatatable.h>\fR .PP Inherits QTable. .PP @@ -19,10 +19,10 @@ Inherits QTable. .BI "\fBQDataTable\fR ( TQWidget * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fBQDataTable\fR ( QSqlCursor * cursor, bool autoPopulate = FALSE, TQWidget * parent = 0, const char * name = 0 )" +.BI "\fBQDataTable\fR ( TQSqlCursor * cursor, bool autoPopulate = FALSE, TQWidget * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QDataTable\fR ()" +.BI "\fB~TQDataTable\fR ()" .br .ti -1c .BI "virtual void \fBaddColumn\fR ( const TQString & fieldName, const TQString & label = TQString::null, int width = -1, const QIconSet & iconset = QIconSet ( ) )" @@ -73,10 +73,10 @@ Inherits QTable. .BI "QStringList \fBsort\fR () const" .br .ti -1c -.BI "virtual void \fBsetSqlCursor\fR ( QSqlCursor * cursor = 0, bool autoPopulate = FALSE, bool autoDelete = FALSE )" +.BI "virtual void \fBsetSqlCursor\fR ( TQSqlCursor * cursor = 0, bool autoPopulate = FALSE, bool autoDelete = FALSE )" .br .ti -1c -.BI "QSqlCursor * \fBsqlCursor\fR () const" +.BI "TQSqlCursor * \fBsqlCursor\fR () const" .br .ti -1c .BI "virtual void \fBsetNullText\fR ( const TQString & nullText )" @@ -118,7 +118,7 @@ Inherits QTable. .BI "virtual void \fBsetSort\fR ( const QStringList & sort )" .br .ti -1c -.BI "virtual void \fBsetSort\fR ( const QSqlIndex & sort )" +.BI "virtual void \fBsetSort\fR ( const TQSqlIndex & sort )" .br .ti -1c .BI "enum \fBRefresh\fR { RefreshData = 1, RefreshColumns = 2, RefreshAll = 3 }" @@ -136,13 +136,13 @@ Inherits QTable. .BI "QVariant \fBvalue\fR ( int row, int col ) const" .br .ti -1c -.BI "QSqlRecord * \fBcurrentRecord\fR () const" +.BI "TQSqlRecord * \fBcurrentRecord\fR () const" .br .ti -1c -.BI "void \fBinstallEditorFactory\fR ( QSqlEditorFactory * f )" +.BI "void \fBinstallEditorFactory\fR ( TQSqlEditorFactory * f )" .br .ti -1c -.BI "void \fBinstallPropertyMap\fR ( QSqlPropertyMap * m )" +.BI "void \fBinstallPropertyMap\fR ( TQSqlPropertyMap * m )" .br .ti -1c .BI "virtual int \fBnumCols\fR () const" @@ -175,28 +175,28 @@ Inherits QTable. .SS "Signals" .in +1c .ti -1c -.BI "void \fBcurrentChanged\fR ( QSqlRecord * record )" +.BI "void \fBcurrentChanged\fR ( TQSqlRecord * record )" .br .ti -1c -.BI "void \fBprimeInsert\fR ( QSqlRecord * buf )" +.BI "void \fBprimeInsert\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBprimeUpdate\fR ( QSqlRecord * buf )" +.BI "void \fBprimeUpdate\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBprimeDelete\fR ( QSqlRecord * buf )" +.BI "void \fBprimeDelete\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBbeforeInsert\fR ( QSqlRecord * buf )" +.BI "void \fBbeforeInsert\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBbeforeUpdate\fR ( QSqlRecord * buf )" +.BI "void \fBbeforeUpdate\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBbeforeDelete\fR ( QSqlRecord * buf )" +.BI "void \fBbeforeDelete\fR ( TQSqlRecord * buf )" .br .ti -1c -.BI "void \fBcursorChanged\fR ( QSql::Op mode )" +.BI "void \fBcursorChanged\fR ( TQSql::Op mode )" .br .in -1c .SS "Properties" @@ -256,13 +256,13 @@ Inherits QTable. .BI "virtual bool \fBdeleteCurrent\fR ()" .br .ti -1c -.BI "virtual QSql::Confirm \fBconfirmEdit\fR ( QSql::Op m )" +.BI "virtual TQSql::Confirm \fBconfirmEdit\fR ( TQSql::Op m )" .br .ti -1c -.BI "virtual QSql::Confirm \fBconfirmCancel\fR ( QSql::Op m )" +.BI "virtual TQSql::Confirm \fBconfirmCancel\fR ( TQSql::Op m )" .br .ti -1c -.BI "virtual void \fBhandleError\fR ( const QSqlError & e )" +.BI "virtual void \fBhandleError\fR ( const TQSqlError & e )" .br .ti -1c .BI "virtual bool \fBbeginInsert\fR ()" @@ -277,33 +277,33 @@ Inherits QTable. .BI "void \fBreset\fR ()" .br .ti -1c -.BI "void \fBsetSize\fR ( QSqlCursor * sql )" +.BI "void \fBsetSize\fR ( TQSqlCursor * sql )" .br .ti -1c -.BI "virtual void \fBpaintField\fR ( QPainter * p, const QSqlField * field, const QRect & cr, bool selected )" +.BI "virtual void \fBpaintField\fR ( QPainter * p, const TQSqlField * field, const QRect & cr, bool selected )" .br .ti -1c -.BI "virtual int \fBfieldAlignment\fR ( const QSqlField * field )" +.BI "virtual int \fBfieldAlignment\fR ( const TQSqlField * field )" .br .in -1c .SH DESCRIPTION -The QDataTable class provides a flexible SQL table widget that supports browsing and editing. +The TQDataTable class provides a flexible SQL table widget that supports browsing and editing. .PP -QDataTable supports various functions for presenting and editing SQL data from a QSqlCursor in a table. +TQDataTable supports various functions for presenting and editing SQL data from a TQSqlCursor in a table. .PP -If you want a to present your data in a form use QDataBrowser, or for read-only forms, QDataView. +If you want a to present your data in a form use TQDataBrowser, or for read-only forms, TQDataView. .PP -When displaying data, QDataTable only retrieves data for visible rows. If the driver supports the 'query size' property the QDataTable will have the correct number of rows and the vertical scrollbar will accurately reflect the number of rows displayed in proportion to the number of rows in the dataset. If the driver does not support the 'query size' property, rows are dynamically fetched from the database on an as-needed basis with the scrollbar becoming more accurate as the user scrolls down through the records. This allows extremely large queries to be displayed as quickly as possible, with minimum memory usage. +When displaying data, TQDataTable only retrieves data for visible rows. If the driver supports the 'query size' property the TQDataTable will have the correct number of rows and the vertical scrollbar will accurately reflect the number of rows displayed in proportion to the number of rows in the dataset. If the driver does not support the 'query size' property, rows are dynamically fetched from the database on an as-needed basis with the scrollbar becoming more accurate as the user scrolls down through the records. This allows extremely large queries to be displayed as quickly as possible, with minimum memory usage. .PP -QDataTable inherits QTable's API and extends it with functions to sort and filter the data and sort columns. See setSqlCursor(), setFilter(), setSort(), setSorting(), sortColumn() and refresh(). +TQDataTable inherits QTable's API and extends it with functions to sort and filter the data and sort columns. See setSqlCursor(), setFilter(), setSort(), setSorting(), sortColumn() and refresh(). .PP -When displaying editable cursors, cell editing will be enabled. (For more information on editable cursors, see QSqlCursor). QDataTable can be used to modify existing data and to add new records. When a user makes changes to a field in the table, the cursor's edit buffer is used. The table will not send changes in the edit buffer to the database until the user moves to a different record in the grid or presses Enter. Cell editing is initiated by pressing F2 (or right clicking and then clicking the appropriate popup menu item) and canceled by pressing Esc. If there is a problem updating or adding data, errors are handled automatically (see handleError() to change this behavior). Note that if autoEdit() is FALSE navigating to another record will cancel the insert or update. +When displaying editable cursors, cell editing will be enabled. (For more information on editable cursors, see TQSqlCursor). TQDataTable can be used to modify existing data and to add new records. When a user makes changes to a field in the table, the cursor's edit buffer is used. The table will not send changes in the edit buffer to the database until the user moves to a different record in the grid or presses Enter. Cell editing is initiated by pressing F2 (or right clicking and then clicking the appropriate popup menu item) and canceled by pressing Esc. If there is a problem updating or adding data, errors are handled automatically (see handleError() to change this behavior). Note that if autoEdit() is FALSE navigating to another record will cancel the insert or update. .PP -The user can be asked to confirm all edits with setConfirmEdits(). For more precise control use setConfirmInsert(), setConfirmUpdate(), setConfirmDelete() and setConfirmCancels(). Use setAutoEdit() to control the behaviour of the table when the user edits a record and then navigates. (Note that setAutoDelete() is unrelated; it is used to set whether the QSqlCursor is deleted when the table is deleted.) +The user can be asked to confirm all edits with setConfirmEdits(). For more precise control use setConfirmInsert(), setConfirmUpdate(), setConfirmDelete() and setConfirmCancels(). Use setAutoEdit() to control the behaviour of the table when the user edits a record and then navigates. (Note that setAutoDelete() is unrelated; it is used to set whether the TQSqlCursor is deleted when the table is deleted.) .PP Since the data table can perform edits, it must be able to uniquely identify every record so that edits are correctly applied. Because of this the underlying cursor must have a valid primary index to ensure that a unique record is inserted, updated or deleted within the database otherwise the database may be changed to an inconsistent state. .PP -QDataTable creates editors using the default QSqlEditorFactory. Different editor factories can be used by calling installEditorFactory(). A property map is used to map between the cell's value and the editor. You can use your own property map with installPropertyMap(). +TQDataTable creates editors using the default TQSqlEditorFactory. Different editor factories can be used by calling installEditorFactory(). A property map is used to map between the cell's value and the editor. You can use your own property map with installPropertyMap(). .PP The contents of a cell is available as a TQString with text() or as a QVariant with value(). The current record is returned by currentRecord(). Use the find() function to search for a string in the table. .PP @@ -311,7 +311,7 @@ Editing actions can be applied programatically. For example, the insertCurrent() .PP Columns in the table can be created automatically based on the cursor (see setSqlCursor()). Columns can be manipulated manually using addColumn(), removeColumn() and setColumn(). .PP -The table automatically copies many of the properties of the cursor to format the display of data within cells (alignment, visibility, etc.). The cursor can be changed with setSqlCursor(). The filter (see setFilter()) and sort defined within the table are used instead of the filter and sort set on the cursor. For sorting options see setSort(), sortColumn(), sortAscending() and sortDescending(). Note that sorting operations will not behave as expected if you are using a QSqlSelectCursor because it uses user-defined SQL queries to obtain data. +The table automatically copies many of the properties of the cursor to format the display of data within cells (alignment, visibility, etc.). The cursor can be changed with setSqlCursor(). The filter (see setFilter()) and sort defined within the table are used instead of the filter and sort set on the cursor. For sorting options see setSort(), sortColumn(), sortAscending() and sortDescending(). Note that sorting operations will not behave as expected if you are using a TQSqlSelectCursor because it uses user-defined SQL queries to obtain data. .PP The text used to represent NULL, TRUE and FALSE values can be changed with setNullText(), setTrueText() and setFalseText() respectively. You can change the appearance of cells by reimplementing paintField(). .PP @@ -319,7 +319,7 @@ Whenever a new row is selected in the table the currentChanged() signal is emitt .PP See also Database Classes. .SS "Member Type Documentation" -.SH "QDataTable::Refresh" +.SH "TQDataTable::Refresh" This enum describes the refresh options. .TP \fCQDataTable::RefreshData\fR - refresh the data, i.e. read it from the database @@ -328,17 +328,17 @@ This enum describes the refresh options. .TP \fCQDataTable::RefreshAll\fR - refresh both the data and the list of fields .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDataTable::QDataTable ( TQWidget * parent = 0, const char * name = 0 )" +.SH "TQDataTable::TQDataTable ( TQWidget * parent = 0, const char * name = 0 )" Constructs a data table which is a child of \fIparent\fR, called name \fIname\fR. -.SH "QDataTable::QDataTable ( QSqlCursor * cursor, bool autoPopulate = FALSE, TQWidget * parent = 0, const char * name = 0 )" +.SH "TQDataTable::TQDataTable ( TQSqlCursor * cursor, bool autoPopulate = FALSE, TQWidget * parent = 0, const char * name = 0 )" Constructs a data table which is a child of \fIparent\fR, called name \fIname\fR using the cursor \fIcursor\fR. .PP If \fIautoPopulate\fR is TRUE (the default is FALSE), columns are automatically created based upon the fields in the \fIcursor\fR record. Note that \fIautoPopulate\fR only governs the creation of columns; to load the cursor's data into the table use refresh(). .PP If the \fIcursor\fR is read-only, the table also becomes read-only. In addition, the table adopts the cursor's driver's definition for representing NULL values as strings. -.SH "QDataTable::~QDataTable ()" +.SH "TQDataTable::~TQDataTable ()" Destroys the object and frees any allocated resources. -.SH "void QDataTable::addColumn ( const TQString & fieldName, const TQString & label = TQString::null, int width = -1, const QIconSet & iconset = QIconSet ( ) )\fC [virtual]\fR" +.SH "void TQDataTable::addColumn ( const TQString & fieldName, const TQString & label = TQString::null, int width = -1, const QIconSet & iconset = QIconSet ( ) )\fC [virtual]\fR" Adds the next column to be displayed using the field \fIfieldName\fR, column label \fIlabel\fR, width \fIwidth\fR and iconset \fIiconset\fR. .PP If \fIlabel\fR is specified, it is used as the column's header label, otherwise the field's display label is used when setSqlCursor() is called. The \fIiconset\fR is used to set the icon used by the column header; by default there is no icon. @@ -347,206 +347,206 @@ See also setSqlCursor() and refresh(). .PP Examples: .)l sql/overview/subclass1/main.cpp, sql/overview/subclass3/main.cpp, sql/overview/table2/main.cpp, and sql/sqltable/main.cpp. -.SH "void QDataTable::adjustColumn ( int col )\fC [virtual slot]\fR" -Resizes column \fIcol\fR so that the column width is wide enough to display the widest item the column contains (including the column label). If the table's QSqlCursor is not currently active, the cursor will be refreshed before the column width is calculated. Be aware that this function may be slow on tables that contain large result sets. +.SH "void TQDataTable::adjustColumn ( int col )\fC [virtual slot]\fR" +Resizes column \fIcol\fR so that the column width is wide enough to display the widest item the column contains (including the column label). If the table's TQSqlCursor is not currently active, the cursor will be refreshed before the column width is calculated. Be aware that this function may be slow on tables that contain large result sets. .PP Reimplemented from QTable. -.SH "bool QDataTable::autoDelete () const" +.SH "bool TQDataTable::autoDelete () const" Returns TRUE if the table will automatically delete the cursor specified by setSqlCursor(); otherwise returns FALSE. -.SH "bool QDataTable::autoEdit () const" +.SH "bool TQDataTable::autoEdit () const" Returns TRUE if the data table automatically applies edits; otherwise returns FALSE. See the "autoEdit" property for details. -.SH "void QDataTable::beforeDelete ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataTable::beforeDelete ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted just before the currently selected record is deleted from the database. The \fIbuf\fR parameter points to the edit buffer being deleted. Connect to this signal to, for example, copy some of the fields for later use. -.SH "void QDataTable::beforeInsert ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataTable::beforeInsert ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted just before the cursor's edit buffer is inserted into the database. The \fIbuf\fR parameter points to the edit buffer being inserted. Connect to this signal to, for example, populate a key field with a unique sequence number. -.SH "void QDataTable::beforeUpdate ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataTable::beforeUpdate ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted just before the cursor's edit buffer is updated in the database. The \fIbuf\fR parameter points to the edit buffer being updated. Connect to this signal when you want to transform the user's data behind-the-scenes. -.SH "bool QDataTable::beginInsert ()\fC [virtual protected]\fR" +.SH "bool TQDataTable::beginInsert ()\fC [virtual protected]\fR" Protected virtual function called when editing is about to begin on a new record. If the table is read-only, or if there's no cursor or the cursor does not allow inserts, nothing happens. .PP -Editing takes place using the cursor's edit buffer(see QSqlCursor::editBuffer()). +Editing takes place using the cursor's edit buffer(see TQSqlCursor::editBuffer()). .PP When editing begins, a new row is created in the table marked with an asterisk '*' in the row's vertical header column, i.e. at the left of the row. -.SH "TQWidget * QDataTable::beginUpdate ( int row, int col, bool replace )\fC [virtual protected]\fR" +.SH "TQWidget * TQDataTable::beginUpdate ( int row, int col, bool replace )\fC [virtual protected]\fR" Protected virtual function called when editing is about to begin on an existing row. If the table is read-only, or if there's no cursor, nothing happens. .PP -Editing takes place using the cursor's edit buffer (see QSqlCursor::editBuffer()). +Editing takes place using the cursor's edit buffer (see TQSqlCursor::editBuffer()). .PP -\fIrow\fR and \fIcol\fR refer to the row and column in the QDataTable. +\fIrow\fR and \fIcol\fR refer to the row and column in the TQDataTable. .PP (\fIreplace\fR is provided for reimplementors and reflects the API of QTable::beginEdit().) -.SH "QSql::Confirm QDataTable::confirmCancel ( QSql::Op m )\fC [virtual protected]\fR" +.SH "TQSql::Confirm TQDataTable::confirmCancel ( TQSql::Op m )\fC [virtual protected]\fR" Protected virtual function which returns a confirmation for cancelling an edit mode of \fIm\fR. Derived classes can reimplement this function to provide their own cancel dialog. The default implementation uses a message box which prompts the user to confirm the cancel. -.SH "bool QDataTable::confirmCancels () const" +.SH "bool TQDataTable::confirmCancels () const" Returns TRUE if the data table confirms cancel operations; otherwise returns FALSE. See the "confirmCancels" property for details. -.SH "bool QDataTable::confirmDelete () const" +.SH "bool TQDataTable::confirmDelete () const" Returns TRUE if the data table confirms delete operations; otherwise returns FALSE. See the "confirmDelete" property for details. -.SH "QSql::Confirm QDataTable::confirmEdit ( QSql::Op m )\fC [virtual protected]\fR" +.SH "TQSql::Confirm TQDataTable::confirmEdit ( TQSql::Op m )\fC [virtual protected]\fR" Protected virtual function which returns a confirmation for an edit of mode \fIm\fR. Derived classes can reimplement this function to provide their own confirmation dialog. The default implementation uses a message box which prompts the user to confirm the edit action. -.SH "bool QDataTable::confirmEdits () const" +.SH "bool TQDataTable::confirmEdits () const" Returns TRUE if the data table confirms edit operations; otherwise returns FALSE. See the "confirmEdits" property for details. -.SH "bool QDataTable::confirmInsert () const" +.SH "bool TQDataTable::confirmInsert () const" Returns TRUE if the data table confirms insert operations; otherwise returns FALSE. See the "confirmInsert" property for details. -.SH "bool QDataTable::confirmUpdate () const" +.SH "bool TQDataTable::confirmUpdate () const" Returns TRUE if the data table confirms update operations; otherwise returns FALSE. See the "confirmUpdate" property for details. -.SH "void QDataTable::currentChanged ( QSqlRecord * record )\fC [signal]\fR" +.SH "void TQDataTable::currentChanged ( TQSqlRecord * record )\fC [signal]\fR" This signal is emitted whenever a new row is selected in the table. The \fIrecord\fR parameter points to the contents of the newly selected record. -.SH "QSqlRecord * QDataTable::currentRecord () const" +.SH "TQSqlRecord * TQDataTable::currentRecord () const" Returns the currently selected record, or 0 if there is no current selection. The table owns the pointer, so do \fInot\fR delete it or otherwise modify it or the cursor it points to. -.SH "void QDataTable::cursorChanged ( QSql::Op mode )\fC [signal]\fR" +.SH "void TQDataTable::cursorChanged ( TQSql::Op mode )\fC [signal]\fR" This signal is emitted whenever the cursor record was changed due to an edit. The \fImode\fR parameter is the type of edit that just took place. -.SH "DateFormat QDataTable::dateFormat () const" +.SH "DateFormat TQDataTable::dateFormat () const" Returns the format used for displaying date/time values. See the "dateFormat" property for details. -.SH "bool QDataTable::deleteCurrent ()\fC [virtual protected]\fR" +.SH "bool TQDataTable::deleteCurrent ()\fC [virtual protected]\fR" For an editable table, issues a delete on the current cursor's primary index using the values of the currently selected row. If there is no current cursor or there is no current selection, nothing happens. If confirmEdits() or confirmDelete() is TRUE, confirmEdit() is called to confirm the delete. Returns TRUE if the delete succeeded; otherwise FALSE. .PP The underlying cursor must have a valid primary index to ensure that a unique record is deleted within the database otherwise the database may be changed to an inconsistent state. -.SH "TQString QDataTable::falseText () const" +.SH "TQString TQDataTable::falseText () const" Returns the text used to represent false values. See the "falseText" property for details. -.SH "int QDataTable::fieldAlignment ( const QSqlField * field )\fC [virtual protected]\fR" +.SH "int TQDataTable::fieldAlignment ( const TQSqlField * field )\fC [virtual protected]\fR" Returns the alignment for \fIfield\fR. -.SH "TQString QDataTable::filter () const" +.SH "TQString TQDataTable::filter () const" Returns the data filter for the data table. See the "filter" property for details. -.SH "void QDataTable::find ( const TQString & str, bool caseSensitive, bool backwards )\fC [virtual slot]\fR" +.SH "void TQDataTable::find ( const TQString & str, bool caseSensitive, bool backwards )\fC [virtual slot]\fR" Searches the current cursor for a cell containing the string \fIstr\fR starting at the current cell and working forwards (or backwards if \fIbackwards\fR is TRUE). If the string is found, the cell containing the string is set as the current cell. If \fIcaseSensitive\fR is FALSE the case of \fIstr\fR will be ignored. .PP The search will wrap, i.e. if the first (or if backwards is TRUE, last) cell is reached without finding \fIstr\fR the search will continue until it reaches the starting cell. If \fIstr\fR is not found the search will fail and the current cell will remain unchanged. -.SH "void QDataTable::handleError ( const QSqlError & e )\fC [virtual protected]\fR" +.SH "void TQDataTable::handleError ( const TQSqlError & e )\fC [virtual protected]\fR" Protected virtual function which is called when an error \fIe\fR has occurred on the current cursor(). The default implementation displays a warning message to the user with information about the error. -.SH "int QDataTable::indexOf ( uint i ) const\fC [protected]\fR" +.SH "int TQDataTable::indexOf ( uint i ) const\fC [protected]\fR" Returns the index of the field within the current SQL query that is displayed in column \fIi\fR. -.SH "bool QDataTable::insertCurrent ()\fC [virtual protected]\fR" +.SH "bool TQDataTable::insertCurrent ()\fC [virtual protected]\fR" For an editable table, issues an insert on the current cursor using the values in the cursor's edit buffer. If there is no current cursor or there is no current "insert" row, nothing happens. If confirmEdits() or confirmInsert() is TRUE, confirmEdit() is called to confirm the insert. Returns TRUE if the insert succeeded; otherwise returns FALSE. .PP The underlying cursor must have a valid primary index to ensure that a unique record is inserted within the database otherwise the database may be changed to an inconsistent state. -.SH "void QDataTable::installEditorFactory ( QSqlEditorFactory * f )" -Installs a new SQL editor factory \fIf\fR. This enables the user to create and instantiate their own editors for use in cell editing. Note that QDataTable takes ownership of this pointer, and will delete it when it is no longer needed or when installEditorFactory() is called again. +.SH "void TQDataTable::installEditorFactory ( TQSqlEditorFactory * f )" +Installs a new SQL editor factory \fIf\fR. This enables the user to create and instantiate their own editors for use in cell editing. Note that TQDataTable takes ownership of this pointer, and will delete it when it is no longer needed or when installEditorFactory() is called again. .PP -See also QSqlEditorFactory. -.SH "void QDataTable::installPropertyMap ( QSqlPropertyMap * m )" -Installs a new property map \fIm\fR. This enables the user to create and instantiate their own property maps for use in cell editing. Note that QDataTable takes ownership of this pointer, and will delete it when it is no longer needed or when installPropertMap() is called again. +See also TQSqlEditorFactory. +.SH "void TQDataTable::installPropertyMap ( TQSqlPropertyMap * m )" +Installs a new property map \fIm\fR. This enables the user to create and instantiate their own property maps for use in cell editing. Note that TQDataTable takes ownership of this pointer, and will delete it when it is no longer needed or when installPropertMap() is called again. .PP -See also QSqlPropertyMap. -.SH "TQString QDataTable::nullText () const" +See also TQSqlPropertyMap. +.SH "TQString TQDataTable::nullText () const" Returns the text used to represent NULL values. See the "nullText" property for details. -.SH "int QDataTable::numCols () const\fC [virtual]\fR" +.SH "int TQDataTable::numCols () const\fC [virtual]\fR" Returns the number of columns in the table. See the "numCols" property for details. .PP Reimplemented from QTable. -.SH "int QDataTable::numRows () const\fC [virtual]\fR" +.SH "int TQDataTable::numRows () const\fC [virtual]\fR" Returns the number of rows in the table. See the "numRows" property for details. .PP Reimplemented from QTable. -.SH "void QDataTable::paintField ( QPainter * p, const QSqlField * field, const QRect & cr, bool selected )\fC [virtual protected]\fR" +.SH "void TQDataTable::paintField ( QPainter * p, const TQSqlField * field, const QRect & cr, bool selected )\fC [virtual protected]\fR" Paints the \fIfield\fR on the painter \fIp\fR. The painter has already been translated to the appropriate cell's origin where the \fIfield\fR is to be rendered. \fIcr\fR describes the cell coordinates in the content coordinate system. The \fIselected\fR parameter is ignored. .PP If you want to draw custom field content you must reimplement paintField() to do the custom drawing. The default implementation renders the \fIfield\fR value as text. If the field is NULL, nullText() is displayed in the cell. If the field is Boolean, trueText() or falseText() is displayed as appropriate. .PP Example: sql/overview/table4/main.cpp. -.SH "void QDataTable::primeDelete ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataTable::primeDelete ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted after the cursor is primed for delete by the table, when a delete action is beginning on the table. The \fIbuf\fR parameter points to the edit buffer being deleted. Connect to this signal in order to, for example, record auditing information on deletions. -.SH "void QDataTable::primeInsert ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataTable::primeInsert ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted after the cursor is primed for insert by the table, when an insert action is beginning on the table. The \fIbuf\fR parameter points to the edit buffer being inserted. Connect to this signal in order to, for example, prime the record buffer with default data values. -.SH "void QDataTable::primeUpdate ( QSqlRecord * buf )\fC [signal]\fR" +.SH "void TQDataTable::primeUpdate ( TQSqlRecord * buf )\fC [signal]\fR" This signal is emitted after the cursor is primed for update by the table, when an update action is beginning on the table. The \fIbuf\fR parameter points to the edit buffer being updated. Connect to this signal in order to, for example, provide some visual feedback that the user is in 'edit mode'. -.SH "void QDataTable::refresh ()\fC [virtual slot]\fR" -Refreshes the table. The cursor is refreshed using the current filter, the current sort, and the currently defined columns. Equivalent to calling refresh( QDataTable::RefreshData ). +.SH "void TQDataTable::refresh ()\fC [virtual slot]\fR" +Refreshes the table. The cursor is refreshed using the current filter, the current sort, and the currently defined columns. Equivalent to calling refresh( TQDataTable::RefreshData ). .PP Examples: .)l sql/overview/subclass1/main.cpp, sql/overview/table1/main.cpp, sql/overview/table2/main.cpp, and sql/sqltable/main.cpp. -.SH "void QDataTable::refresh ( Refresh mode )" +.SH "void TQDataTable::refresh ( Refresh mode )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Refreshes the table. If there is no currently defined cursor (see setSqlCursor()), nothing happens. The \fImode\fR parameter determines which type of refresh will take place. .PP See also Refresh, setSqlCursor(), and addColumn(). -.SH "void QDataTable::removeColumn ( uint col )\fC [virtual]\fR" +.SH "void TQDataTable::removeColumn ( uint col )\fC [virtual]\fR" Removes column \fIcol\fR from the list of columns to be displayed. If \fIcol\fR does not exist, nothing happens. .PP -See also QSqlField. -.SH "void QDataTable::reset ()\fC [protected]\fR" +See also TQSqlField. +.SH "void TQDataTable::reset ()\fC [protected]\fR" Resets the table so that it displays no data. .PP See also setSqlCursor(). -.SH "void QDataTable::setAutoDelete ( bool enable )\fC [virtual]\fR" +.SH "void TQDataTable::setAutoDelete ( bool enable )\fC [virtual]\fR" Sets the cursor auto-delete flag to \fIenable\fR. If \fIenable\fR is TRUE, the table will automatically delete the cursor specified by setSqlCursor(). If \fIenable\fR is FALSE (the default), the cursor will not be deleted. -.SH "void QDataTable::setAutoEdit ( bool autoEdit )\fC [virtual]\fR" +.SH "void TQDataTable::setAutoEdit ( bool autoEdit )\fC [virtual]\fR" Sets whether the data table automatically applies edits to \fIautoEdit\fR. See the "autoEdit" property for details. -.SH "void QDataTable::setColumn ( uint col, const TQString & fieldName, const TQString & label = TQString::null, int width = -1, const QIconSet & iconset = QIconSet ( ) )\fC [virtual]\fR" +.SH "void TQDataTable::setColumn ( uint col, const TQString & fieldName, const TQString & label = TQString::null, int width = -1, const QIconSet & iconset = QIconSet ( ) )\fC [virtual]\fR" Sets the \fIcol\fR column to display using the field \fIfieldName\fR, column label \fIlabel\fR, width \fIwidth\fR and iconset \fIiconset\fR. .PP If \fIlabel\fR is specified, it is used as the column's header label, otherwise the field's display label is used when setSqlCursor() is called. The \fIiconset\fR is used to set the icon used by the column header; by default there is no icon. .PP See also setSqlCursor() and refresh(). -.SH "void QDataTable::setColumnWidth ( int col, int w )\fC [virtual slot]\fR" -Sets the column \fIcol\fR to the width \fIw\fR. Note that unlike QTable the QDataTable is not immediately redrawn, you must call refresh(QDataTable::RefreshColumns) yourself. +.SH "void TQDataTable::setColumnWidth ( int col, int w )\fC [virtual slot]\fR" +Sets the column \fIcol\fR to the width \fIw\fR. Note that unlike QTable the TQDataTable is not immediately redrawn, you must call refresh(TQDataTable::RefreshColumns) yourself. .PP See also refresh(). .PP Reimplemented from QTable. -.SH "void QDataTable::setConfirmCancels ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataTable::setConfirmCancels ( bool confirm )\fC [virtual]\fR" Sets whether the data table confirms cancel operations to \fIconfirm\fR. See the "confirmCancels" property for details. -.SH "void QDataTable::setConfirmDelete ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataTable::setConfirmDelete ( bool confirm )\fC [virtual]\fR" Sets whether the data table confirms delete operations to \fIconfirm\fR. See the "confirmDelete" property for details. -.SH "void QDataTable::setConfirmEdits ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataTable::setConfirmEdits ( bool confirm )\fC [virtual]\fR" Sets whether the data table confirms edit operations to \fIconfirm\fR. See the "confirmEdits" property for details. -.SH "void QDataTable::setConfirmInsert ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataTable::setConfirmInsert ( bool confirm )\fC [virtual]\fR" Sets whether the data table confirms insert operations to \fIconfirm\fR. See the "confirmInsert" property for details. -.SH "void QDataTable::setConfirmUpdate ( bool confirm )\fC [virtual]\fR" +.SH "void TQDataTable::setConfirmUpdate ( bool confirm )\fC [virtual]\fR" Sets whether the data table confirms update operations to \fIconfirm\fR. See the "confirmUpdate" property for details. -.SH "void QDataTable::setDateFormat ( const DateFormat f )\fC [virtual]\fR" +.SH "void TQDataTable::setDateFormat ( const DateFormat f )\fC [virtual]\fR" Sets the format used for displaying date/time values to \fIf\fR. See the "dateFormat" property for details. -.SH "void QDataTable::setFalseText ( const TQString & falseText )\fC [virtual]\fR" +.SH "void TQDataTable::setFalseText ( const TQString & falseText )\fC [virtual]\fR" Sets the text used to represent false values to \fIfalseText\fR. See the "falseText" property for details. -.SH "void QDataTable::setFilter ( const TQString & filter )\fC [virtual]\fR" +.SH "void TQDataTable::setFilter ( const TQString & filter )\fC [virtual]\fR" Sets the data filter for the data table to \fIfilter\fR. See the "filter" property for details. -.SH "void QDataTable::setNullText ( const TQString & nullText )\fC [virtual]\fR" +.SH "void TQDataTable::setNullText ( const TQString & nullText )\fC [virtual]\fR" Sets the text used to represent NULL values to \fInullText\fR. See the "nullText" property for details. -.SH "void QDataTable::setSize ( QSqlCursor * sql )\fC [protected]\fR" +.SH "void TQDataTable::setSize ( TQSqlCursor * sql )\fC [protected]\fR" If the cursor's \fIsql\fR driver supports query sizes, the number of rows in the table is set to the size of the query. Otherwise, the table dynamically resizes itself as it is scrolled. If \fIsql\fR is not active, it is made active by issuing a select() on the cursor using the \fIsql\fR cursor's current filter and current sort. -.SH "void QDataTable::setSort ( const QStringList & sort )\fC [virtual]\fR" +.SH "void TQDataTable::setSort ( const QStringList & sort )\fC [virtual]\fR" Sets the data table's sort to \fIsort\fR. See the "sort" property for details. -.SH "void QDataTable::setSort ( const QSqlIndex & sort )\fC [virtual]\fR" +.SH "void TQDataTable::setSort ( const TQSqlIndex & sort )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Sets the sort to be applied to the displayed data to \fIsort\fR. If there is no current cursor, nothing happens. A QSqlIndex contains field names and their ordering (ASC or DESC); these are used to compose the ORDER BY clause. +Sets the sort to be applied to the displayed data to \fIsort\fR. If there is no current cursor, nothing happens. A TQSqlIndex contains field names and their ordering (ASC or DESC); these are used to compose the ORDER BY clause. .PP See also sort. -.SH "void QDataTable::setSqlCursor ( QSqlCursor * cursor = 0, bool autoPopulate = FALSE, bool autoDelete = FALSE )\fC [virtual]\fR" +.SH "void TQDataTable::setSqlCursor ( TQSqlCursor * cursor = 0, bool autoPopulate = FALSE, bool autoDelete = FALSE )\fC [virtual]\fR" Sets \fIcursor\fR as the data source for the table. To force the display of the data from \fIcursor\fR, use refresh(). If \fIautoPopulate\fR is TRUE, columns are automatically created based upon the fields in the \fIcursor\fR record. If \fIautoDelete\fR is TRUE (the default is FALSE), the table will take ownership of the \fIcursor\fR and delete it when appropriate. If the \fIcursor\fR is read-only, the table becomes read-only. The table adopts the cursor's driver's definition for representing NULL values as strings. .PP -See also refresh(), readOnly, setAutoDelete(), and QSqlDriver::nullText(). -.SH "void QDataTable::setTrueText ( const TQString & trueText )\fC [virtual]\fR" +See also refresh(), readOnly, setAutoDelete(), and TQSqlDriver::nullText(). +.SH "void TQDataTable::setTrueText ( const TQString & trueText )\fC [virtual]\fR" Sets the text used to represent true values to \fItrueText\fR. See the "trueText" property for details. -.SH "QStringList QDataTable::sort () const" +.SH "QStringList TQDataTable::sort () const" Returns the data table's sort. See the "sort" property for details. -.SH "void QDataTable::sortAscending ( int col )\fC [virtual slot]\fR" +.SH "void TQDataTable::sortAscending ( int col )\fC [virtual slot]\fR" Sorts column \fIcol\fR in ascending order. .PP See also sorting. -.SH "void QDataTable::sortColumn ( int col, bool ascending = TRUE, bool wholeRows = FALSE )\fC [virtual]\fR" +.SH "void TQDataTable::sortColumn ( int col, bool ascending = TRUE, bool wholeRows = FALSE )\fC [virtual]\fR" Sorts column \fIcol\fR in ascending order if \fIascending\fR is TRUE (the default); otherwise sorts in descending order. .PP -The \fIwholeRows\fR parameter is ignored; QDataTable always sorts whole rows by the specified column. +The \fIwholeRows\fR parameter is ignored; TQDataTable always sorts whole rows by the specified column. .PP Reimplemented from QTable. -.SH "void QDataTable::sortDescending ( int col )\fC [virtual slot]\fR" +.SH "void TQDataTable::sortDescending ( int col )\fC [virtual slot]\fR" Sorts column \fIcol\fR in descending order. .PP See also sorting. -.SH "QSqlCursor * QDataTable::sqlCursor () const" +.SH "TQSqlCursor * TQDataTable::sqlCursor () const" Returns the cursor used by the data table. -.SH "TQString QDataTable::text ( int row, int col ) const\fC [virtual]\fR" +.SH "TQString TQDataTable::text ( int row, int col ) const\fC [virtual]\fR" Returns the text in cell \fIrow\fR, \fIcol\fR, or an empty string if the cell is empty. If the cell's value is NULL then nullText() will be returned. If the cell does not exist then TQString::null is returned. .PP Reimplemented from QTable. -.SH "TQString QDataTable::trueText () const" +.SH "TQString TQDataTable::trueText () const" Returns the text used to represent true values. See the "trueText" property for details. -.SH "bool QDataTable::updateCurrent ()\fC [virtual protected]\fR" +.SH "bool TQDataTable::updateCurrent ()\fC [virtual protected]\fR" For an editable table, issues an update using the cursor's edit buffer. If there is no current cursor or there is no current selection, nothing happens. If confirmEdits() or confirmUpdate() is TRUE, confirmEdit() is called to confirm the update. Returns TRUE if the update succeeded; otherwise returns FALSE. .PP The underlying cursor must have a valid primary index to ensure that a unique record is updated within the database otherwise the database may be changed to an inconsistent state. -.SH "QVariant QDataTable::value ( int row, int col ) const" +.SH "QVariant TQDataTable::value ( int row, int col ) const" Returns the value in cell \fIrow\fR, \fIcol\fR, or an invalid value if the cell does not exist or has no value. .SS "Property Documentation" .SH "bool autoEdit" @@ -675,7 +675,7 @@ The trueText property will be used to represent NULL values in the table. The de Set this property's value with setTrueText() and get this property's value with trueText(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqdatatable.html +.BR http://doc.trolltech.com/tqdatatable.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqdataview.3qt b/doc/man/man3/tqdataview.3qt index ea1a3d410..1608c79f6 100644 --- a/doc/man/man3/tqdataview.3qt +++ b/doc/man/man3/tqdataview.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDataView 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDataView 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QDataView \- Read-only SQL forms +TQDataView \- Read-only SQL forms .SH SYNOPSIS -\fC#include <ntqdataview.h>\fR +\fC#include <tqdataview.h>\fR .PP Inherits TQWidget. .PP @@ -19,25 +19,25 @@ Inherits TQWidget. .BI "\fBQDataView\fR ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" .br .ti -1c -.BI "\fB~QDataView\fR ()" +.BI "\fB~TQDataView\fR ()" .br .ti -1c -.BI "virtual void \fBsetForm\fR ( QSqlForm * form )" +.BI "virtual void \fBsetForm\fR ( TQSqlForm * form )" .br .ti -1c -.BI "QSqlForm * \fBform\fR ()" +.BI "TQSqlForm * \fBform\fR ()" .br .ti -1c -.BI "virtual void \fBsetRecord\fR ( QSqlRecord * record )" +.BI "virtual void \fBsetRecord\fR ( TQSqlRecord * record )" .br .ti -1c -.BI "QSqlRecord * \fBrecord\fR ()" +.BI "TQSqlRecord * \fBrecord\fR ()" .br .in -1c .SS "Public Slots" .in +1c .ti -1c -.BI "virtual void \fBrefresh\fR ( QSqlRecord * buf )" +.BI "virtual void \fBrefresh\fR ( TQSqlRecord * buf )" .br .ti -1c .BI "virtual void \fBreadFields\fR ()" @@ -50,35 +50,35 @@ Inherits TQWidget. .br .in -1c .SH DESCRIPTION -The QDataView class provides read-only SQL forms. +The TQDataView class provides read-only SQL forms. .PP -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. +This class provides a form which displays SQL field data from a record buffer. Because TQDataView does not support editing it uses less resources than a TQDataBrowser. This class is well suited for displaying read-only data from a SQL database. .PP -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. +If you want a to present your data in an editable form use TQDataBrowser; if you want a table-based presentation of your data use TQDataTable. .PP -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. +The form is associated with the data view with setForm() and the record is associated with setRecord(). You can also pass a TQSqlRecord to the refresh() function which will set the record to the given record and read the record's fields into the form. .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDataView::QDataView ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" +.SH "TQDataView::TQDataView ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" Constructs a data view which is a child of \fIparent\fR, called \fIname\fR, and with widget flags \fIfl\fR. -.SH "QDataView::~QDataView ()" +.SH "TQDataView::~TQDataView ()" Destroys the object and frees any allocated resources. -.SH "void QDataView::clearValues ()\fC [virtual slot]\fR" +.SH "void TQDataView::clearValues ()\fC [virtual slot]\fR" 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. -.SH "QSqlForm * QDataView::form ()" +.SH "TQSqlForm * TQDataView::form ()" Returns the default form used by the data view, or 0 if there is none. .PP See also setForm(). -.SH "void QDataView::readFields ()\fC [virtual slot]\fR" +.SH "void TQDataView::readFields ()\fC [virtual slot]\fR" Causes the default form to read its fields from the record buffer. If there is no default form, or no record, nothing happens. .PP See also setForm(). -.SH "QSqlRecord * QDataView::record ()" +.SH "TQSqlRecord * TQDataView::record ()" Returns the default record used by the data view, or 0 if there is none. .PP See also setRecord(). -.SH "void QDataView::refresh ( QSqlRecord * buf )\fC [virtual slot]\fR" +.SH "void TQDataView::refresh ( TQSqlRecord * buf )\fC [virtual slot]\fR" Causes the default form to display the contents of \fIbuf\fR. If there is no default form, nothing happens.The \fIbuf\fR also becomes the default record for all subsequent calls to readFields() and writefields(). This slot is equivalant to calling: .PP .nf @@ -90,21 +90,21 @@ Causes the default form to display the contents of \fIbuf\fR. If there is no def .fi .PP See also setRecord() and readFields(). -.SH "void QDataView::setForm ( QSqlForm * form )\fC [virtual]\fR" +.SH "void TQDataView::setForm ( TQSqlForm * form )\fC [virtual]\fR" Sets the form used by the data view to \fIform\fR. If a record has already been assigned to the data view, the form will display that record's data. .PP See also form(). -.SH "void QDataView::setRecord ( QSqlRecord * record )\fC [virtual]\fR" +.SH "void TQDataView::setRecord ( TQSqlRecord * record )\fC [virtual]\fR" Sets the record used by the data view to \fIrecord\fR. If a form has already been assigned to the data view, the form will display the data from \fIrecord\fR in that form. .PP See also record(). -.SH "void QDataView::writeFields ()\fC [virtual slot]\fR" +.SH "void TQDataView::writeFields ()\fC [virtual slot]\fR" Causes the default form to write its fields to the record buffer. If there is no default form, or no record, nothing happens. .PP See also setForm(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqdataview.html +.BR http://doc.trolltech.com/tqdataview.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqeditorfactory.3qt b/doc/man/man3/tqeditorfactory.3qt index 840b06e53..aa86941ab 100644 --- a/doc/man/man3/tqeditorfactory.3qt +++ b/doc/man/man3/tqeditorfactory.3qt @@ -1,5 +1,5 @@ '\" t -.TH QEditorFactory 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQEditorFactory 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,13 +7,13 @@ .ad l .nh .SH NAME -QEditorFactory \- Used to create editor widgets for QVariant data types +TQEditorFactory \- Used to create editor widgets for QVariant data types .SH SYNOPSIS -\fC#include <ntqeditorfactory.h>\fR +\fC#include <tqeditorfactory.h>\fR .PP Inherits TQObject. .PP -Inherited by QSqlEditorFactory. +Inherited by TQSqlEditorFactory. .PP .SS "Public Members" .in +1c @@ -21,7 +21,7 @@ Inherited by QSqlEditorFactory. .BI "\fBQEditorFactory\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QEditorFactory\fR ()" +.BI "\fB~TQEditorFactory\fR ()" .br .ti -1c .BI "virtual TQWidget * \fBcreateEditor\fR ( TQWidget * parent, const QVariant & v )" @@ -30,37 +30,37 @@ Inherited by QSqlEditorFactory. .SS "Static Public Members" .in +1c .ti -1c -.BI "QEditorFactory * \fBdefaultFactory\fR ()" +.BI "TQEditorFactory * \fBdefaultFactory\fR ()" .br .ti -1c -.BI "void \fBinstallDefaultFactory\fR ( QEditorFactory * factory )" +.BI "void \fBinstallDefaultFactory\fR ( TQEditorFactory * factory )" .br .in -1c .SH DESCRIPTION -The QEditorFactory class is used to create editor widgets for QVariant data types. +The TQEditorFactory class is used to create editor widgets for QVariant data types. .PP Each editor factory provides the createEditor() function which given a QVariant will create and return a TQWidget that can edit that QVariant. For example if you have a QVariant::String type, a QLineEdit would be the default editor returned, whereas a QVariant::Int's default editor would be a QSpinBox. .PP -If you want to create different editors for fields with the same data type, subclass QEditorFactory and reimplement the createEditor() function. +If you want to create different editors for fields with the same data type, subclass TQEditorFactory and reimplement the createEditor() function. .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QEditorFactory::QEditorFactory ( TQObject * parent = 0, const char * name = 0 )" +.SH "TQEditorFactory::TQEditorFactory ( TQObject * parent = 0, const char * name = 0 )" Constructs an editor factory with parent \fIparent\fR, called \fIname\fR. -.SH "QEditorFactory::~QEditorFactory ()" +.SH "TQEditorFactory::~TQEditorFactory ()" Destroys the object and frees any allocated resources. -.SH "TQWidget * QEditorFactory::createEditor ( TQWidget * parent, const QVariant & v )\fC [virtual]\fR" +.SH "TQWidget * TQEditorFactory::createEditor ( TQWidget * parent, const QVariant & v )\fC [virtual]\fR" Creates and returns the appropriate editor for the QVariant \fIv\fR. If the QVariant is invalid, 0 is returned. The \fIparent\fR is passed to the appropriate editor's constructor. .PP -Reimplemented in QSqlEditorFactory. -.SH "QEditorFactory * QEditorFactory::defaultFactory ()\fC [static]\fR" +Reimplemented in TQSqlEditorFactory. +.SH "TQEditorFactory * TQEditorFactory::defaultFactory ()\fC [static]\fR" Returns an instance of a default editor factory. -.SH "void QEditorFactory::installDefaultFactory ( QEditorFactory * factory )\fC [static]\fR" +.SH "void TQEditorFactory::installDefaultFactory ( TQEditorFactory * factory )\fC [static]\fR" Replaces the default editor factory with \fIfactory\fR. \fIQEditorFactory takes ownership of factory, and destroys it when it is no longer needed.\fR .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqeditorfactory.html +.BR http://doc.trolltech.com/tqeditorfactory.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqobject.3qt b/doc/man/man3/tqobject.3qt index 49b13fad1..cef63f88a 100644 --- a/doc/man/man3/tqobject.3qt +++ b/doc/man/man3/tqobject.3qt @@ -15,7 +15,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .PP Inherits Qt. .PP -Inherited by QAccel, QAccessibleObject, QAction, QApplication, QAssistantClient, QDataPump, QAxObject, QAxScript, QAxScriptManager, TQWidget, QCanvas, QStyle, QClipboard, QCopChannel, QDns, QLayout, QDragObject, QEditorFactory, QEventLoop, QFileIconProvider, QNetworkProtocol, QWSKeyboardHandler, QNetworkOperation, QNPInstance, TQObjectCleanupHandler, QProcess, QServerSocket, QSessionManager, QSignal, QSignalMapper, QSocket, QSocketNotifier, QSound, QSqlDatabase, QSqlDriver, QSqlForm, QStyleSheet, QTimer, QToolTipGroup, QTranslator, QUrlOperator, and QValidator. +Inherited by QAccel, QAccessibleObject, QAction, QApplication, QAssistantClient, QDataPump, QAxObject, QAxScript, QAxScriptManager, TQWidget, QCanvas, QStyle, QClipboard, QCopChannel, QDns, QLayout, QDragObject, TQEditorFactory, QEventLoop, QFileIconProvider, QNetworkProtocol, QWSKeyboardHandler, QNetworkOperation, QNPInstance, TQObjectCleanupHandler, QProcess, QServerSocket, QSessionManager, QSignal, QSignalMapper, QSocket, QSocketNotifier, QSound, TQSqlDatabase, TQSqlDriver, TQSqlForm, QStyleSheet, QTimer, QToolTipGroup, QTranslator, QUrlOperator, and QValidator. .PP .SS "Public Members" .in +1c diff --git a/doc/man/man3/tqsql.3qt b/doc/man/man3/tqsql.3qt index 717afad85..d6c8d1254 100644 --- a/doc/man/man3/tqsql.3qt +++ b/doc/man/man3/tqsql.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSql 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSql 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSql \- Namespace for TQt SQL identifiers that need to be global-like +TQSql \- Namespace for TQt SQL identifiers that need to be global-like .SH SYNOPSIS -\fC#include <ntqsql.h>\fR +\fC#include <tqsql.h>\fR .PP .SS "Public Members" .in +1c @@ -33,13 +33,13 @@ QSql \- Namespace for TQt SQL identifiers that need to be global-like .br .in -1c .SH DESCRIPTION -The QSql class is a namespace for TQt SQL identifiers that need to be global-like. +The TQSql class is a namespace for TQt SQL identifiers that need to be global-like. .PP Normally, you can ignore this class. Several TQt SQL classes inherit it, so all the identifiers in the TQt SQL namespace are visible without qualification. .PP See also Database Classes. .SS "Member Type Documentation" -.SH "QSql::Confirm" +.SH "TQSql::Confirm" This enum type describes edit confirmations. .TP \fCQSql::Yes\fR @@ -47,13 +47,13 @@ This enum type describes edit confirmations. \fCQSql::No\fR .TP \fCQSql::Cancel\fR -.SH "QSql::Location" +.SH "TQSql::Location" This enum type describes SQL navigation locations. .TP \fCQSql::BeforeFirst\fR .TP \fCQSql::AfterLast\fR -.SH "QSql::Op" +.SH "TQSql::Op" This enum type describes edit operations. .TP \fCQSql::None\fR @@ -63,7 +63,7 @@ This enum type describes edit operations. \fCQSql::Update\fR .TP \fCQSql::Delete\fR -.SH "QSql::ParameterType" +.SH "TQSql::ParameterType" This enum is used to set the type of a bind parameter .TP \fCQSql::In\fR - the bind parameter is used to put data into the database @@ -71,7 +71,7 @@ This enum is used to set the type of a bind parameter \fCQSql::Out\fR - the bind parameter is used to receive data from the database .TP \fCQSql::InOut\fR - the bind parameter is used to put data into the database; it will be overwritten with output data on executing a query. -.SH "QSql::TableType" +.SH "TQSql::TableType" This enum type describes types of tables .TP \fCQSql::Tables\fR - All the tables visible to the user @@ -82,11 +82,11 @@ This enum type describes types of tables .TP \fCQSql::AllTables\fR - All of the above .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSql::QSql ()" +.SH "TQSql::TQSql ()" Constructs a TQt SQL namespace class .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsql.html +.BR http://doc.trolltech.com/tqsql.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlcursor.3qt b/doc/man/man3/tqsqlcursor.3qt index a4ba66093..cd78d63c4 100644 --- a/doc/man/man3/tqsqlcursor.3qt +++ b/doc/man/man3/tqsqlcursor.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlCursor 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlCursor 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,51 +7,51 @@ .ad l .nh .SH NAME -QSqlCursor \- Browsing and editing of SQL tables and views +TQSqlCursor \- Browsing and editing of SQL tables and views .SH SYNOPSIS -\fC#include <ntqsqlcursor.h>\fR +\fC#include <tqsqlcursor.h>\fR .PP -Inherits QSqlRecord and QSqlQuery. +Inherits TQSqlRecord and TQSqlQuery. .PP -Inherited by QSqlSelectCursor. +Inherited by TQSqlSelectCursor. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQSqlCursor\fR ( const TQString & name = TQString::null, bool autopopulate = TRUE, QSqlDatabase * db = 0 )" +.BI "\fBQSqlCursor\fR ( const TQString & name = TQString::null, bool autopopulate = TRUE, TQSqlDatabase * db = 0 )" .br .ti -1c -.BI "\fBQSqlCursor\fR ( const QSqlCursor & other )" +.BI "\fBQSqlCursor\fR ( const TQSqlCursor & other )" .br .ti -1c -.BI "QSqlCursor & \fBoperator=\fR ( const QSqlCursor & other )" +.BI "TQSqlCursor & \fBoperator=\fR ( const TQSqlCursor & other )" .br .ti -1c -.BI "\fB~QSqlCursor\fR ()" +.BI "\fB~TQSqlCursor\fR ()" .br .ti -1c .BI "enum \fBMode\fR { ReadOnly = 0, Insert = 1, Update = 2, Delete = 4, Writable = 7 }" .br .ti -1c -.BI "virtual QSqlIndex \fBprimaryIndex\fR ( bool setFromCursor = TRUE ) const" +.BI "virtual TQSqlIndex \fBprimaryIndex\fR ( bool setFromCursor = TRUE ) const" .br .ti -1c -.BI "virtual QSqlIndex \fBindex\fR ( const QStringList & fieldNames ) const" +.BI "virtual TQSqlIndex \fBindex\fR ( const QStringList & fieldNames ) const" .br .ti -1c -.BI "QSqlIndex \fBindex\fR ( const TQString & fieldName ) const" +.BI "TQSqlIndex \fBindex\fR ( const TQString & fieldName ) const" .br .ti -1c -.BI "QSqlIndex \fBindex\fR ( const char * fieldName ) const" +.BI "TQSqlIndex \fBindex\fR ( const char * fieldName ) const" .br .ti -1c -.BI "virtual void \fBsetPrimaryIndex\fR ( const QSqlIndex & idx )" +.BI "virtual void \fBsetPrimaryIndex\fR ( const TQSqlIndex & idx )" .br .ti -1c -.BI "virtual void \fBappend\fR ( const QSqlFieldInfo & fieldInfo )" +.BI "virtual void \fBappend\fR ( const TQSqlFieldInfo & fieldInfo )" .br .ti -1c -.BI "virtual void \fBinsert\fR ( int pos, const QSqlFieldInfo & fieldInfo )" +.BI "virtual void \fBinsert\fR ( int pos, const TQSqlFieldInfo & fieldInfo )" .br .ti -1c .BI "virtual void \fBremove\fR ( int pos )" @@ -66,16 +66,16 @@ Inherited by QSqlSelectCursor. .BI "virtual void \fBsetGenerated\fR ( int i, bool generated )" .br .ti -1c -.BI "virtual QSqlRecord * \fBeditBuffer\fR ( bool copy = FALSE )" +.BI "virtual TQSqlRecord * \fBeditBuffer\fR ( bool copy = FALSE )" .br .ti -1c -.BI "virtual QSqlRecord * \fBprimeInsert\fR ()" +.BI "virtual TQSqlRecord * \fBprimeInsert\fR ()" .br .ti -1c -.BI "virtual QSqlRecord * \fBprimeUpdate\fR ()" +.BI "virtual TQSqlRecord * \fBprimeUpdate\fR ()" .br .ti -1c -.BI "virtual QSqlRecord * \fBprimeDelete\fR ()" +.BI "virtual TQSqlRecord * \fBprimeDelete\fR ()" .br .ti -1c .BI "virtual int \fBinsert\fR ( bool invalidate = TRUE )" @@ -120,19 +120,19 @@ Inherited by QSqlSelectCursor. .BI "bool \fBselect\fR ()" .br .ti -1c -.BI "bool \fBselect\fR ( const QSqlIndex & sort )" +.BI "bool \fBselect\fR ( const TQSqlIndex & sort )" .br .ti -1c -.BI "bool \fBselect\fR ( const QSqlIndex & filter, const QSqlIndex & sort )" +.BI "bool \fBselect\fR ( const TQSqlIndex & filter, const TQSqlIndex & sort )" .br .ti -1c -.BI "virtual bool \fBselect\fR ( const TQString & filter, const QSqlIndex & sort = QSqlIndex ( ) )" +.BI "virtual bool \fBselect\fR ( const TQString & filter, const TQSqlIndex & sort = TQSqlIndex ( ) )" .br .ti -1c -.BI "virtual void \fBsetSort\fR ( const QSqlIndex & sort )" +.BI "virtual void \fBsetSort\fR ( const TQSqlIndex & sort )" .br .ti -1c -.BI "QSqlIndex \fBsort\fR () const" +.BI "TQSqlIndex \fBsort\fR () const" .br .ti -1c .BI "virtual void \fBsetFilter\fR ( const TQString & filter )" @@ -165,19 +165,19 @@ Inherited by QSqlSelectCursor. .BI "virtual int \fBdel\fR ( const TQString & filter, bool invalidate = TRUE )" .br .ti -1c -.BI "virtual TQString \fBtoString\fR ( const TQString & prefix, QSqlField * field, const TQString & fieldSep ) const" +.BI "virtual TQString \fBtoString\fR ( const TQString & prefix, TQSqlField * field, const TQString & fieldSep ) const" .br .ti -1c -.BI "virtual TQString \fBtoString\fR ( QSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const" +.BI "virtual TQString \fBtoString\fR ( TQSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const" .br .ti -1c -.BI "virtual TQString \fBtoString\fR ( const QSqlIndex & i, QSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const" +.BI "virtual TQString \fBtoString\fR ( const TQSqlIndex & i, TQSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const" .br .in -1c .SH DESCRIPTION -The QSqlCursor class provides browsing and editing of SQL tables and views. +The TQSqlCursor class provides browsing and editing of SQL tables and views. .PP -A QSqlCursor is a database record (see QSqlRecord) that corresponds to a table or view within an SQL database (see QSqlDatabase). There are two buffers in a cursor, one used for browsing and one used for editing records. Each buffer contains a list of fields which correspond to the fields in the table or view. +A TQSqlCursor is a database record (see TQSqlRecord) that corresponds to a table or view within an SQL database (see TQSqlDatabase). There are two buffers in a cursor, one used for browsing and one used for editing records. Each buffer contains a list of fields which correspond to the fields in the table or view. .PP When positioned on a valid record, the browse buffer contains the values of the current record's fields from the database. The edit buffer is separate, and is used for editing existing records and inserting new records. .PP @@ -187,7 +187,7 @@ For example: .PP .nf .br - QSqlCursor cur( "staff" ); // Specify the table/view name + TQSqlCursor cur( "staff" ); // Specify the table/view name .br cur.select(); // We'll retrieve every record .br @@ -210,13 +210,13 @@ For example: .PP .nf .br - QSqlCursor cur( "prices" ); + TQSqlCursor cur( "prices" ); .br cur.select( "id=202" ); .br if ( cur.next() ) { .br - QSqlRecord *buffer = cur.primeUpdate(); + TQSqlRecord *buffer = cur.primeUpdate(); .br double price = buffer->value( "price" ).toDouble(); .br @@ -237,14 +237,14 @@ To insert a new record, call primeInsert() to get the pointer to the edit buffer .PP After calling insert(), update() or del(), the cursor is no longer positioned on a valid record and can no longer be navigated (isValid() return FALSE). The reason for this is that any changes made to the database will not be visible until select() is called to refresh the cursor. You can change this behavior by passing FALSE to insert(), update() or del() which will prevent the cursor from becoming invalid. The edits will still not be visible when navigating the cursor until select() is called. .PP -QSqlCursor contains virtual methods which allow editing behavior to be customized by subclasses. This allows custom cursors to be created that encapsulate the editing behavior of a database table for an entire application. For example, a cursor can be customized to always auto-number primary index fields, or provide fields with suitable default values, when inserting new records. QSqlCursor generates SQL statements which are sent to the database engine; you can control which fields are included in these statements using setGenerated(). +TQSqlCursor contains virtual methods which allow editing behavior to be customized by subclasses. This allows custom cursors to be created that encapsulate the editing behavior of a database table for an entire application. For example, a cursor can be customized to always auto-number primary index fields, or provide fields with suitable default values, when inserting new records. TQSqlCursor generates SQL statements which are sent to the database engine; you can control which fields are included in these statements using setGenerated(). .PP -Note that QSqlCursor does not inherit from TQObject. This means that you are responsible for destroying instances of this class yourself. However if you create a QSqlCursor and use it in a QDataTable, QDataBrowser or a QDataView these classes will usually take ownership of the cursor and destroy it when they don't need it anymore. The documentation for QDataTable, QDataBrowser and QDataView explicitly states which calls take ownership of the cursor. +Note that TQSqlCursor does not inherit from TQObject. This means that you are responsible for destroying instances of this class yourself. However if you create a TQSqlCursor and use it in a TQDataTable, TQDataBrowser or a TQDataView these classes will usually take ownership of the cursor and destroy it when they don't need it anymore. The documentation for TQDataTable, TQDataBrowser and TQDataView explicitly states which calls take ownership of the cursor. .PP See also Database Classes. .SS "Member Type Documentation" -.SH "QSqlCursor::Mode" -This enum type describes how QSqlCursor operates on records in the database. +.SH "TQSqlCursor::Mode" +This enum type describes how TQSqlCursor operates on records in the database. .TP \fCQSqlCursor::ReadOnly\fR - the cursor can only SELECT records from the database. .TP @@ -256,53 +256,53 @@ This enum type describes how QSqlCursor operates on records in the database. .TP \fCQSqlCursor::Writable\fR - the cursor can INSERT, UPDATE and DELETE records in the database. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlCursor::QSqlCursor ( const TQString & name = TQString::null, bool autopopulate = TRUE, QSqlDatabase * db = 0 )" +.SH "TQSqlCursor::TQSqlCursor ( const TQString & name = TQString::null, bool autopopulate = TRUE, TQSqlDatabase * db = 0 )" Constructs a cursor on database \fIdb\fR using table or view \fIname\fR. .PP If \fIautopopulate\fR is TRUE (the default), the \fIname\fR of the cursor must correspond to an existing table or view name in the database so that field information can be automatically created. If the table or view does not exist, the cursor will not be functional. .PP -The cursor is created with an initial mode of QSqlCursor::Writable (meaning that records can be inserted, updated or deleted using the cursor). If the cursor does not have a unique primary index, update and deletes cannot be performed. +The cursor is created with an initial mode of TQSqlCursor::Writable (meaning that records can be inserted, updated or deleted using the cursor). If the cursor does not have a unique primary index, update and deletes cannot be performed. .PP Note that \fIautopopulate\fR refers to populating the cursor with meta-data, e.g. the names of the table's fields, not with retrieving data. The select() function is used to populate the cursor with data. .PP See also setName() and setMode(). -.SH "QSqlCursor::QSqlCursor ( const QSqlCursor & other )" +.SH "TQSqlCursor::TQSqlCursor ( const TQSqlCursor & other )" Constructs a copy of \fIother\fR. -.SH "QSqlCursor::~QSqlCursor ()" +.SH "TQSqlCursor::~TQSqlCursor ()" Destroys the object and frees any allocated resources. -.SH "void QSqlCursor::append ( const QSqlFieldInfo & fieldInfo )\fC [virtual]\fR" +.SH "void TQSqlCursor::append ( const TQSqlFieldInfo & fieldInfo )\fC [virtual]\fR" Append a copy of field \fIfieldInfo\fR to the end of the cursor. Note that all references to the cursor edit buffer become invalidated. -.SH "QVariant QSqlCursor::calculateField ( const TQString & name )\fC [virtual protected]\fR" +.SH "QVariant TQSqlCursor::calculateField ( const TQString & name )\fC [virtual protected]\fR" Protected virtual function which is called whenever a field needs to be calculated. If calculated fields are being used, derived classes must reimplement this function and return the appropriate value for field \fIname\fR. The default implementation returns an invalid QVariant. .PP See also setCalculated(). .PP Examples: .)l sql/overview/subclass3/main.cpp and sql/overview/subclass4/main.cpp. -.SH "bool QSqlCursor::canDelete () const" +.SH "bool TQSqlCursor::canDelete () const" Returns TRUE if the cursor will perform deletes; otherwise returns FALSE. .PP See also setMode(). -.SH "bool QSqlCursor::canInsert () const" +.SH "bool TQSqlCursor::canInsert () const" Returns TRUE if the cursor will perform inserts; otherwise returns FALSE. .PP See also setMode(). -.SH "bool QSqlCursor::canUpdate () const" +.SH "bool TQSqlCursor::canUpdate () const" Returns TRUE if the cursor will perform updates; otherwise returns FALSE. .PP See also setMode(). -.SH "void QSqlCursor::clear ()\fC [virtual]\fR" +.SH "void TQSqlCursor::clear ()\fC [virtual]\fR" Removes all fields from the cursor. Note that all references to the cursor edit buffer become invalidated. .PP -Reimplemented from QSqlRecord. -.SH "int QSqlCursor::del ( bool invalidate = TRUE )\fC [virtual]\fR" +Reimplemented from TQSqlRecord. +.SH "int TQSqlCursor::del ( bool invalidate = TRUE )\fC [virtual]\fR" Deletes a record from the database using the cursor's primary index and the contents of the cursor edit buffer. Returns the number of records which were deleted. For error information, use lastError(). .PP Only records which meet the filter criteria specified by the cursor's primary index are deleted. If the cursor does not contain a primary index, no delete is performed and 0 is returned. If \fIinvalidate\fR is TRUE (the default), the current cursor can no longer be navigated. A new select() call must be made before you can move to a valid record. For example: .PP .nf .br - QSqlCursor cur( "prices" ); + TQSqlCursor cur( "prices" ); .br cur.select( "id=999" ); .br @@ -320,7 +320,7 @@ In the above example, a cursor is created on the 'prices' table and positioned t See also primeDelete(), setMode(), and lastError(). .PP Example: sql/overview/delete/main.cpp. -.SH "int QSqlCursor::del ( const TQString & filter, bool invalidate = TRUE )\fC [virtual protected]\fR" +.SH "int TQSqlCursor::del ( const TQString & filter, bool invalidate = TRUE )\fC [virtual protected]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Deletes the current cursor record from the database using the filter \fIfilter\fR. Only records which meet the filter criteria are deleted. Returns the number of records which were deleted. If \fIinvalidate\fR is TRUE (the default), the current cursor can no longer be navigated. A new select() call must be made before you can move to a valid record. For error information, use lastError(). @@ -328,33 +328,33 @@ Deletes the current cursor record from the database using the filter \fIfilter\f The \fIfilter\fR is an SQL \fCWHERE\fR clause, e.g. \fCid=500\fR. .PP See also setMode() and lastError(). -.SH "QSqlRecord * QSqlCursor::editBuffer ( bool copy = FALSE )\fC [virtual]\fR" +.SH "TQSqlRecord * TQSqlCursor::editBuffer ( bool copy = FALSE )\fC [virtual]\fR" Returns the current internal edit buffer. If \fIcopy\fR is TRUE (the default is FALSE), the current cursor field values are first copied into the edit buffer. The edit buffer is valid as long as the cursor remains valid. The cursor retains ownership of the returned pointer, so it must not be deleted or modified. .PP See also primeInsert(), primeUpdate(), and primeDelete(). -.SH "TQString QSqlCursor::filter () const" +.SH "TQString TQSqlCursor::filter () const" Returns the current filter, or an empty string if there is no current filter. -.SH "QSqlIndex QSqlCursor::index ( const QStringList & fieldNames ) const\fC [virtual]\fR" +.SH "TQSqlIndex TQSqlCursor::index ( const QStringList & fieldNames ) const\fC [virtual]\fR" Returns an index composed of \fIfieldNames\fR, all in ASCending order. Note that all field names must exist in the cursor, otherwise an empty index is returned. .PP -See also QSqlIndex. +See also TQSqlIndex. .PP Examples: .)l sql/overview/extract/main.cpp, sql/overview/order1/main.cpp, sql/overview/order2/main.cpp, and sql/overview/table3/main.cpp. -.SH "QSqlIndex QSqlCursor::index ( const TQString & fieldName ) const" +.SH "TQSqlIndex TQSqlCursor::index ( const TQString & fieldName ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns an index based on \fIfieldName\fR. -.SH "QSqlIndex QSqlCursor::index ( const char * fieldName ) const" +.SH "TQSqlIndex TQSqlCursor::index ( const char * fieldName ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns an index based on \fIfieldName\fR. -.SH "void QSqlCursor::insert ( int pos, const QSqlFieldInfo & fieldInfo )\fC [virtual]\fR" +.SH "void TQSqlCursor::insert ( int pos, const TQSqlFieldInfo & fieldInfo )\fC [virtual]\fR" Insert a copy of \fIfieldInfo\fR at position \fIpos\fR. If a field already exists at \fIpos\fR, it is removed. Note that all references to the cursor edit buffer become invalidated. .PP Examples: .)l sql/overview/insert/main.cpp and sql/overview/insert2/main.cpp. -.SH "int QSqlCursor::insert ( bool invalidate = TRUE )\fC [virtual]\fR" +.SH "int TQSqlCursor::insert ( bool invalidate = TRUE )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Inserts the current contents of the cursor's edit record buffer into the database, if the cursor allows inserts. Returns the number of rows affected by the insert. For error information, use lastError(). @@ -363,9 +363,9 @@ If \fIinvalidate\fR is TRUE (the default), the cursor will no longer be position .PP .nf .br - QSqlCursor cur( "prices" ); + TQSqlCursor cur( "prices" ); .br - QSqlRecord *buffer = cur.primeInsert(); + TQSqlRecord *buffer = cur.primeInsert(); .br buffer->setValue( "id", 53981 ); .br @@ -379,65 +379,65 @@ If \fIinvalidate\fR is TRUE (the default), the cursor will no longer be position In the above example, a cursor is created on the 'prices' table and a pointer to the insert buffer is acquired using primeInsert(). Each field's value is set to the desired value and then insert() is called to insert the data into the database. Remember: all edit operations (insert(), update() and delete()) operate on the contents of the cursor edit buffer and not on the contents of the cursor itself. .PP See also setMode() and lastError(). -.SH "bool QSqlCursor::isCalculated ( const TQString & name ) const" +.SH "bool TQSqlCursor::isCalculated ( const TQString & name ) const" Returns TRUE if the field \fIname\fR exists and is calculated; otherwise returns FALSE. .PP See also setCalculated(). -.SH "bool QSqlCursor::isNull ( int i ) const" +.SH "bool TQSqlCursor::isNull ( int i ) const" Returns TRUE if the field \fIi\fR is NULL or if there is no field at position \fIi\fR; otherwise returns FALSE. .PP -This is the same as calling QSqlRecord::isNull( \fIi\fR ) -.SH "bool QSqlCursor::isNull ( const TQString & name ) const" +This is the same as calling TQSqlRecord::isNull( \fIi\fR ) +.SH "bool TQSqlCursor::isNull ( const TQString & name ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns TRUE if the field called \fIname\fR is NULL or if there is no field called \fIname\fR; otherwise returns FALSE. .PP -This is the same as calling QSqlRecord::isNull( \fIname\fR ) -.SH "bool QSqlCursor::isReadOnly () const" +This is the same as calling TQSqlRecord::isNull( \fIname\fR ) +.SH "bool TQSqlCursor::isReadOnly () const" Returns TRUE if the cursor is read-only; otherwise returns FALSE. The default is FALSE. Read-only cursors cannot be edited using insert(), update() or del(). .PP See also setMode(). -.SH "bool QSqlCursor::isTrimmed ( const TQString & name ) const" +.SH "bool TQSqlCursor::isTrimmed ( const TQString & name ) const" Returns TRUE if the field \fIname\fR exists and is trimmed; otherwise returns FALSE. .PP When a trimmed field of type string or cstring is read from the database any trailing (right-most) spaces are removed. .PP See also setTrimmed(). -.SH "int QSqlCursor::mode () const" +.SH "int TQSqlCursor::mode () const" Returns the current cursor mode. .PP See also setMode(). -.SH "TQString QSqlCursor::name () const" +.SH "TQString TQSqlCursor::name () const" Returns the name of the cursor. -.SH "QSqlCursor & QSqlCursor::operator= ( const QSqlCursor & other )" +.SH "TQSqlCursor & TQSqlCursor::operator= ( const TQSqlCursor & other )" Sets the cursor equal to \fIother\fR. -.SH "QSqlIndex QSqlCursor::primaryIndex ( bool setFromCursor = TRUE ) const\fC [virtual]\fR" +.SH "TQSqlIndex TQSqlCursor::primaryIndex ( bool setFromCursor = TRUE ) const\fC [virtual]\fR" Returns the primary index associated with the cursor as defined in the database, or an empty index if there is no primary index. If \fIsetFromCursor\fR is TRUE (the default), the index fields are populated with the corresponding values in the cursor's current record. -.SH "QSqlRecord * QSqlCursor::primeDelete ()\fC [virtual]\fR" +.SH "TQSqlRecord * TQSqlCursor::primeDelete ()\fC [virtual]\fR" This function primes the edit buffer's field values for delete and returns the edit buffer. The default implementation copies the field values from the current cursor record into the edit buffer (therefore, this function is equivalent to calling editBuffer( TRUE ) ). The cursor retains ownership of the returned pointer, so it must not be deleted or modified. .PP See also editBuffer() and del(). .PP Example: sql/overview/delete/main.cpp. -.SH "QSqlRecord * QSqlCursor::primeInsert ()\fC [virtual]\fR" +.SH "TQSqlRecord * TQSqlCursor::primeInsert ()\fC [virtual]\fR" This function primes the edit buffer's field values for insert and returns the edit buffer. The default implementation clears all field values in the edit buffer. The cursor retains ownership of the returned pointer, so it must not be deleted or modified. .PP See also editBuffer() and insert(). .PP Examples: .)l sql/overview/insert/main.cpp, sql/overview/insert2/main.cpp, sql/overview/subclass5/main.cpp, and sql/sqltable/main.cpp. -.SH "QSqlRecord * QSqlCursor::primeUpdate ()\fC [virtual]\fR" +.SH "TQSqlRecord * TQSqlCursor::primeUpdate ()\fC [virtual]\fR" This function primes the edit buffer's field values for update and returns the edit buffer. The default implementation copies the field values from the current cursor record into the edit buffer (therefore, this function is equivalent to calling editBuffer( TRUE ) ). The cursor retains ownership of the returned pointer, so it must not be deleted or modified. .PP See also editBuffer() and update(). .PP Examples: .)l sql/overview/custom1/main.cpp, sql/overview/form1/main.cpp, and sql/overview/update/main.cpp. -.SH "void QSqlCursor::remove ( int pos )\fC [virtual]\fR" +.SH "void TQSqlCursor::remove ( int pos )\fC [virtual]\fR" Removes the field at \fIpos\fR. If \fIpos\fR does not exist, nothing happens. Note that all references to the cursor edit buffer become invalidated. .PP -Reimplemented from QSqlRecord. -.SH "bool QSqlCursor::select ( const TQString & filter, const QSqlIndex & sort = QSqlIndex ( ) )\fC [virtual]\fR" +Reimplemented from TQSqlRecord. +.SH "bool TQSqlCursor::select ( const TQString & filter, const TQSqlIndex & sort = TQSqlIndex ( ) )\fC [virtual]\fR" Selects all fields in the cursor from the database matching the filter criteria \fIfilter\fR. The data is returned in the order specified by the index \fIsort\fR. Returns TRUE if the data was successfully selected; otherwise returns FALSE. .PP The \fIfilter\fR is a string containing a SQL \fCWHERE\fR clause but without the 'WHERE' keyword. The cursor is initially positioned at an invalid row after this function is called. To move to a valid row, use seek(), first(), last(), prev() or next(). @@ -446,7 +446,7 @@ Example: .PP .nf .br - QSqlCursor cur( "Employee" ); // Use the Employee table or view + TQSqlCursor cur( "Employee" ); // Use the Employee table or view .br cur.select( "deptno=10" ); // select all records in department 10 .br @@ -470,7 +470,7 @@ The filter will apply to any subsequent select() calls that do not explicitly sp .PP .nf .br - QSqlCursor cur( "Employee" ); + TQSqlCursor cur( "Employee" ); .br cur.select( "deptno=10" ); // select all records in department 10 .br @@ -490,26 +490,26 @@ The filter will apply to any subsequent select() calls that do not explicitly sp .PP Examples: .)l sql/overview/delete/main.cpp, sql/overview/extract/main.cpp, sql/overview/order1/main.cpp, sql/overview/order2/main.cpp, sql/overview/retrieve2/main.cpp, sql/overview/table3/main.cpp, and sql/overview/update/main.cpp. -.SH "bool QSqlCursor::select ()" +.SH "bool TQSqlCursor::select ()" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Selects all fields in the cursor from the database. The rows are returned in the order specified by the last call to setSort() or the last call to select() that specified a sort, whichever is the most recent. If there is no current sort, the order in which the rows are returned is undefined. The records are filtered according to the filter specified by the last call to setFilter() or the last call to select() that specified a filter, whichever is the most recent. If there is no current filter, all records are returned. The cursor is initially positioned at an invalid row. To move to a valid row, use seek(), first(), last(), prev() or next(). .PP See also setSort() and setFilter(). -.SH "bool QSqlCursor::select ( const QSqlIndex & sort )" +.SH "bool TQSqlCursor::select ( const TQSqlIndex & sort )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Selects all fields in the cursor from the database. The data is returned in the order specified by the index \fIsort\fR. The records are filtered according to the filter specified by the last call to setFilter() or the last call to select() that specified a filter, whichever is the most recent. The cursor is initially positioned at an invalid row. To move to a valid row, use seek(), first(), last(), prev() or next(). -.SH "bool QSqlCursor::select ( const QSqlIndex & filter, const QSqlIndex & sort )" +.SH "bool TQSqlCursor::select ( const TQSqlIndex & filter, const TQSqlIndex & sort )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Selects all fields in the cursor matching the filter index \fIfilter\fR. The data is returned in the order specified by the index \fIsort\fR. The \fIfilter\fR index works by constructing a WHERE clause using the names of the fields from the \fIfilter\fR and their values from the current cursor record. The cursor is initially positioned at an invalid row. To move to a valid row, use seek(), first(), last(), prev() or next(). This function is useful, for example, for retrieving data based upon a table's primary index: .PP .nf .br - QSqlCursor cur( "Employee" ); + TQSqlCursor cur( "Employee" ); .br - QSqlIndex pk = cur.primaryIndex(); + TQSqlIndex pk = cur.primaryIndex(); .br cur.setValue( "id", 10 ); .br @@ -519,77 +519,77 @@ Selects all fields in the cursor matching the filter index \fIfilter\fR. The dat .br .fi .PP -In this example the QSqlIndex, pk, is used for two different purposes. When used as the filter (first) argument, the field names it contains are used to construct the WHERE clause, each set to the current cursor value, \fCWHERE id=10\fR, in this case. When used as the sort (second) argument the field names it contains are used for the ORDER BY clause, \fCORDER BY id\fR in this example. -.SH "void QSqlCursor::setCalculated ( const TQString & name, bool calculated )\fC [virtual]\fR" +In this example the TQSqlIndex, pk, is used for two different purposes. When used as the filter (first) argument, the field names it contains are used to construct the WHERE clause, each set to the current cursor value, \fCWHERE id=10\fR, in this case. When used as the sort (second) argument the field names it contains are used for the ORDER BY clause, \fCORDER BY id\fR in this example. +.SH "void TQSqlCursor::setCalculated ( const TQString & name, bool calculated )\fC [virtual]\fR" Sets field \fIname\fR to \fIcalculated\fR. If the field \fIname\fR does not exist, nothing happens. The value of a calculated field is set by the calculateField() virtual function which you must reimplement (or the field value will be an invalid QVariant). Calculated fields do not appear in generated SQL statements sent to the database. .PP -See also calculateField() and QSqlRecord::setGenerated(). -.SH "void QSqlCursor::setFilter ( const TQString & filter )\fC [virtual]\fR" +See also calculateField() and TQSqlRecord::setGenerated(). +.SH "void TQSqlCursor::setFilter ( const TQString & filter )\fC [virtual]\fR" Sets the current filter to \fIfilter\fR. Note that no new records are selected. To select new records, use select(). The \fIfilter\fR will apply to any subsequent select() calls that do not explicitly specify a filter. .PP The filter is a SQL \fCWHERE\fR clause without the keyword 'WHERE', e.g. \fCname='Dave'\fR which will be processed by the DBMS. -.SH "void QSqlCursor::setGenerated ( const TQString & name, bool generated )\fC [virtual]\fR" +.SH "void TQSqlCursor::setGenerated ( const TQString & name, bool generated )\fC [virtual]\fR" Sets the generated flag for the field \fIname\fR to \fIgenerated\fR. If the field does not exist, nothing happens. Only fields that have \fIgenerated\fR set to TRUE are included in the SQL that is generated by insert(), update() or del(). .PP See also isGenerated(). .PP -Reimplemented from QSqlRecord. -.SH "void QSqlCursor::setGenerated ( int i, bool generated )\fC [virtual]\fR" +Reimplemented from TQSqlRecord. +.SH "void TQSqlCursor::setGenerated ( int i, bool generated )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the generated flag for the field \fIi\fR to \fIgenerated\fR. .PP See also isGenerated(). .PP -Reimplemented from QSqlRecord. -.SH "void QSqlCursor::setMode ( int mode )\fC [virtual]\fR" -Sets the cursor mode to \fImode\fR. This value can be an OR'ed combination of QSqlCursor::Mode values. The default mode for a cursor is QSqlCursor::Writable. +Reimplemented from TQSqlRecord. +.SH "void TQSqlCursor::setMode ( int mode )\fC [virtual]\fR" +Sets the cursor mode to \fImode\fR. This value can be an OR'ed combination of TQSqlCursor::Mode values. The default mode for a cursor is TQSqlCursor::Writable. .PP .nf .br - QSqlCursor cur( "Employee" ); + TQSqlCursor cur( "Employee" ); .br - cur.setMode( QSqlCursor::Writable ); // allow insert/update/delete + cur.setMode( TQSqlCursor::Writable ); // allow insert/update/delete .br ... .br - cur.setMode( QSqlCursor::Insert | QSqlCursor::Update ); // allow inserts and updates only + cur.setMode( TQSqlCursor::Insert | TQSqlCursor::Update ); // allow inserts and updates only .br ... .br - cur.setMode( QSqlCursor::ReadOnly ); // no inserts/updates/deletes allowed + cur.setMode( TQSqlCursor::ReadOnly ); // no inserts/updates/deletes allowed .br .br .fi -.SH "void QSqlCursor::setName ( const TQString & name, bool autopopulate = TRUE )\fC [virtual]\fR" -Sets the name of the cursor to \fIname\fR. If \fIautopopulate\fR is TRUE (the default), the \fIname\fR must correspond to a valid table or view name in the database. Also, note that all references to the cursor edit buffer become invalidated when fields are auto-populated. See the QSqlCursor constructor documentation for more information. -.SH "void QSqlCursor::setPrimaryIndex ( const QSqlIndex & idx )\fC [virtual]\fR" +.SH "void TQSqlCursor::setName ( const TQString & name, bool autopopulate = TRUE )\fC [virtual]\fR" +Sets the name of the cursor to \fIname\fR. If \fIautopopulate\fR is TRUE (the default), the \fIname\fR must correspond to a valid table or view name in the database. Also, note that all references to the cursor edit buffer become invalidated when fields are auto-populated. See the TQSqlCursor constructor documentation for more information. +.SH "void TQSqlCursor::setPrimaryIndex ( const TQSqlIndex & idx )\fC [virtual]\fR" Sets the primary index associated with the cursor to the index \fIidx\fR. Note that this index must contain a field or set of fields which identify a unique record within the underlying database table or view so that update() and del() will execute as expected. .PP See also update() and del(). -.SH "void QSqlCursor::setSort ( const QSqlIndex & sort )\fC [virtual]\fR" +.SH "void TQSqlCursor::setSort ( const TQSqlIndex & sort )\fC [virtual]\fR" Sets the current sort to \fIsort\fR. Note that no new records are selected. To select new records, use select(). The \fIsort\fR will apply to any subsequent select() calls that do not explicitly specify a sort. -.SH "void QSqlCursor::setTrimmed ( const TQString & name, bool trim )\fC [virtual]\fR" +.SH "void TQSqlCursor::setTrimmed ( const TQString & name, bool trim )\fC [virtual]\fR" Sets field \fIname\fR's trimmed status to \fItrim\fR. If the field \fIname\fR does not exist, nothing happens. .PP When a trimmed field of type string or cstring is read from the database any trailing (right-most) spaces are removed. .PP See also isTrimmed() and QVariant. -.SH "QSqlIndex QSqlCursor::sort () const" +.SH "TQSqlIndex TQSqlCursor::sort () const" Returns the current sort, or an empty index if there is no current sort. -.SH "TQString QSqlCursor::toString ( QSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const\fC [virtual protected]\fR" +.SH "TQString TQSqlCursor::toString ( TQSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const\fC [virtual protected]\fR" Returns a formatted string composed of all the fields in \fIrec\fR. Each field is composed of the \fIprefix\fR (e.g. table or view name)," .", the field name, the \fIfieldSep\fR and the field value. If the \fIprefix\fR is empty then each field will begin with the field name. The fields are then joined together separated by \fIsep\fR. Fields where isGenerated() returns FALSE are not included. This function is useful for generating SQL statements. -.SH "TQString QSqlCursor::toString ( const TQString & prefix, QSqlField * field, const TQString & fieldSep ) const\fC [virtual protected]\fR" +.SH "TQString TQSqlCursor::toString ( const TQString & prefix, TQSqlField * field, const TQString & fieldSep ) const\fC [virtual protected]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns a formatted string composed of the \fIprefix\fR (e.g. table or view name), ".", the \fIfield\fR name, the \fIfieldSep\fR and the field value. If the \fIprefix\fR is empty then the string will begin with the \fIfield\fR name. This function is useful for generating SQL statements. -.SH "TQString QSqlCursor::toString ( const QSqlIndex & i, QSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const\fC [virtual protected]\fR" +.SH "TQString TQSqlCursor::toString ( const TQSqlIndex & i, TQSqlRecord * rec, const TQString & prefix, const TQString & fieldSep, const TQString & sep ) const\fC [virtual protected]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns a formatted string composed of all the fields in the index \fIi\fR. Each field is composed of the \fIprefix\fR (e.g. table or view name), ".", the field name, the \fIfieldSep\fR and the field value. If the \fIprefix\fR is empty then each field will begin with the field name. The field values are taken from \fIrec\fR. The fields are then joined together separated by \fIsep\fR. Fields where isGenerated() returns FALSE are ignored. This function is useful for generating SQL statements. -.SH "int QSqlCursor::update ( bool invalidate = TRUE )\fC [virtual]\fR" +.SH "int TQSqlCursor::update ( bool invalidate = TRUE )\fC [virtual]\fR" Updates the database with the current contents of the edit buffer. Returns the number of records which were updated. For error information, use lastError(). .PP Only records which meet the filter criteria specified by the cursor's primary index are updated. If the cursor does not contain a primary index, no update is performed and 0 is returned. @@ -598,13 +598,13 @@ If \fIinvalidate\fR is TRUE (the default), the current cursor can no longer be n .PP .nf .br - QSqlCursor cur( "prices" ); + TQSqlCursor cur( "prices" ); .br cur.select( "id=202" ); .br if ( cur.next() ) { .br - QSqlRecord *buffer = cur.primeUpdate(); + TQSqlRecord *buffer = cur.primeUpdate(); .br double price = buffer->value( "price" ).toDouble(); .br @@ -624,7 +624,7 @@ Note that if the primary index does not uniquely distinguish records the databas See also setMode() and lastError(). .PP Example: sql/overview/update/main.cpp. -.SH "int QSqlCursor::update ( const TQString & filter, bool invalidate = TRUE )\fC [virtual protected]\fR" +.SH "int TQSqlCursor::update ( const TQString & filter, bool invalidate = TRUE )\fC [virtual protected]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Updates the database with the current contents of the cursor edit buffer using the specified \fIfilter\fR. Returns the number of records which were updated. For error information, use lastError(). @@ -636,7 +636,7 @@ If \fIinvalidate\fR is TRUE (the default), the cursor can no longer be navigated See also primeUpdate(), setMode(), and lastError(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlcursor.html +.BR http://doc.trolltech.com/tqsqlcursor.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqldatabase.3qt b/doc/man/man3/tqsqldatabase.3qt index e062f530b..8e9e795e6 100644 --- a/doc/man/man3/tqsqldatabase.3qt +++ b/doc/man/man3/tqsqldatabase.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlDatabase 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlDatabase 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,16 +7,16 @@ .ad l .nh .SH NAME -QSqlDatabase \- Used to create SQL database connections and to provide transaction handling +TQSqlDatabase \- Used to create SQL database connections and to provide transaction handling .SH SYNOPSIS -\fC#include <ntqsqldatabase.h>\fR +\fC#include <tqsqldatabase.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fB~QSqlDatabase\fR ()" +.BI "\fB~TQSqlDatabase\fR ()" .br .ti -1c .BI "bool \fBopen\fR ()" @@ -37,28 +37,28 @@ Inherits TQObject. .BI "QStringList \fBtables\fR () const" .br .ti -1c -.BI "QStringList \fBtables\fR ( QSql::TableType type ) const" +.BI "QStringList \fBtables\fR ( TQSql::TableType type ) const" .br .ti -1c -.BI "QSqlIndex \fBprimaryIndex\fR ( const TQString & tablename ) const" +.BI "TQSqlIndex \fBprimaryIndex\fR ( const TQString & tablename ) const" .br .ti -1c -.BI "QSqlRecord \fBrecord\fR ( const TQString & tablename ) const" +.BI "TQSqlRecord \fBrecord\fR ( const TQString & tablename ) const" .br .ti -1c -.BI "QSqlRecord \fBrecord\fR ( const QSqlQuery & query ) const" +.BI "TQSqlRecord \fBrecord\fR ( const TQSqlQuery & query ) const" .br .ti -1c -.BI "QSqlRecordInfo \fBrecordInfo\fR ( const TQString & tablename ) const" +.BI "TQSqlRecordInfo \fBrecordInfo\fR ( const TQString & tablename ) const" .br .ti -1c -.BI "QSqlRecordInfo \fBrecordInfo\fR ( const QSqlQuery & query ) const" +.BI "TQSqlRecordInfo \fBrecordInfo\fR ( const TQSqlQuery & query ) const" .br .ti -1c -.BI "QSqlQuery \fBexec\fR ( const TQString & query = TQString::null ) const" +.BI "TQSqlQuery \fBexec\fR ( const TQString & query = TQString::null ) const" .br .ti -1c -.BI "QSqlError \fBlastError\fR () const" +.BI "TQSqlError \fBlastError\fR () const" .br .ti -1c .BI "bool \fBtransaction\fR ()" @@ -109,25 +109,25 @@ Inherits TQObject. .BI "TQString \fBconnectOptions\fR () const" .br .ti -1c -.BI "QSqlDriver * \fBdriver\fR () const" +.BI "TQSqlDriver * \fBdriver\fR () const" .br .in -1c .SS "Static Public Members" .in +1c .ti -1c -.BI "QSqlDatabase * \fBaddDatabase\fR ( const TQString & type, const TQString & connectionName = defaultConnection )" +.BI "TQSqlDatabase * \fBaddDatabase\fR ( const TQString & type, const TQString & connectionName = defaultConnection )" .br .ti -1c -.BI "QSqlDatabase * \fBaddDatabase\fR ( QSqlDriver * driver, const TQString & connectionName = defaultConnection )" +.BI "TQSqlDatabase * \fBaddDatabase\fR ( TQSqlDriver * driver, const TQString & connectionName = defaultConnection )" .br .ti -1c -.BI "QSqlDatabase * \fBdatabase\fR ( const TQString & connectionName = defaultConnection, bool open = TRUE )" +.BI "TQSqlDatabase * \fBdatabase\fR ( const TQString & connectionName = defaultConnection, bool open = TRUE )" .br .ti -1c .BI "void \fBremoveDatabase\fR ( const TQString & connectionName )" .br .ti -1c -.BI "void \fBremoveDatabase\fR ( QSqlDatabase * db )" +.BI "void \fBremoveDatabase\fR ( TQSqlDatabase * db )" .br .ti -1c .BI "bool \fBcontains\fR ( const TQString & connectionName = defaultConnection )" @@ -136,7 +136,7 @@ Inherits TQObject. .BI "QStringList \fBdrivers\fR ()" .br .ti -1c -.BI "void \fBregisterSqlDriver\fR ( const TQString & name, const QSqlDriverCreatorBase * creator )" +.BI "void \fBregisterSqlDriver\fR ( const TQString & name, const TQSqlDriverCreatorBase * creator )" .br .ti -1c .BI "bool \fBisDriverAvailable\fR ( const TQString & name )" @@ -169,20 +169,20 @@ Inherits TQObject. .BI "\fBQSqlDatabase\fR ( const TQString & type, const TQString & name, TQObject * parent = 0, const char * objname = 0 )" .br .ti -1c -.BI "\fBQSqlDatabase\fR ( QSqlDriver * driver, TQObject * parent = 0, const char * objname = 0 )" +.BI "\fBQSqlDatabase\fR ( TQSqlDriver * driver, TQObject * parent = 0, const char * objname = 0 )" .br .in -1c .SH DESCRIPTION -The QSqlDatabase class is used to create SQL database connections and to provide transaction handling. +The TQSqlDatabase class is used to create SQL database connections and to provide transaction handling. .PP -Note that transaction handling is not supported by every SQL database. You can find out whether transactions are supported using QSqlDriver::hasFeature(). +Note that transaction handling is not supported by every SQL database. You can find out whether transactions are supported using TQSqlDriver::hasFeature(). .PP -The QSqlDatabase class provides an abstract interface for accessing many types of database backends. Database-specific drivers are used internally to actually access and manipulate data, (see QSqlDriver). Result set objects provide the interface for executing and manipulating SQL queries (see QSqlQuery). +The TQSqlDatabase class provides an abstract interface for accessing many types of database backends. Database-specific drivers are used internally to actually access and manipulate data, (see TQSqlDriver). Result set objects provide the interface for executing and manipulating SQL queries (see TQSqlQuery). .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlDatabase::QSqlDatabase ( const TQString & type, const TQString & name, TQObject * parent = 0, const char * objname = 0 )\fC [protected]\fR" -Creates a QSqlDatabase connection called \fIname\fR that uses the driver referred to by \fItype\fR, with the parent \fIparent\fR and the object name \fIobjname\fR. If the \fItype\fR is not recognized, the database connection will have no functionality. +.SH "TQSqlDatabase::TQSqlDatabase ( const TQString & type, const TQString & name, TQObject * parent = 0, const char * objname = 0 )\fC [protected]\fR" +Creates a TQSqlDatabase connection called \fIname\fR that uses the driver referred to by \fItype\fR, with the parent \fIparent\fR and the object name \fIobjname\fR. If the \fItype\fR is not recognized, the database connection will have no functionality. .PP The currently available drivers are: .PP @@ -196,18 +196,18 @@ l - l. Driver Type Description QODBC3 ODBC Driver (includes Microsoft SQL Server Additional third party drivers, including your own custom drivers, can be loaded dynamically. .PP See also registerSqlDriver(). -.SH "QSqlDatabase::QSqlDatabase ( QSqlDriver * driver, TQObject * parent = 0, const char * objname = 0 )\fC [protected]\fR" +.SH "TQSqlDatabase::TQSqlDatabase ( TQSqlDriver * driver, TQObject * parent = 0, const char * objname = 0 )\fC [protected]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Creates a database connection using the driver \fIdriver\fR, with the parent \fIparent\fR and the object name \fIobjname\fR. .PP \fBWarning:\fR The framework takes ownership of the \fIdriver\fR pointer, so it should not be deleted. -.SH "QSqlDatabase::~QSqlDatabase ()" +.SH "TQSqlDatabase::~TQSqlDatabase ()" Destroys the object and frees any allocated resources. -.SH "QSqlDatabase * QSqlDatabase::addDatabase ( const TQString & type, const TQString & connectionName = defaultConnection )\fC [static]\fR" +.SH "TQSqlDatabase * TQSqlDatabase::addDatabase ( const TQString & type, const TQString & connectionName = defaultConnection )\fC [static]\fR" Adds a database to the list of database connections using the driver \fItype\fR and the connection name \fIconnectionName\fR. .PP -The database connection is referred to by \fIconnectionName\fR. The newly added database connection is returned. This pointer is owned by QSqlDatabase and will be deleted on program exit or when removeDatabase() is called. +The database connection is referred to by \fIconnectionName\fR. The newly added database connection is returned. This pointer is owned by TQSqlDatabase and will be deleted on program exit or when removeDatabase() is called. .PP If \fIconnectionName\fR is not specified, the newly added database connection becomes the default database connection for the application, and subsequent calls to database() (without a database name parameter) will return a pointer to it. If \fIconnectionName\fR is given, use database(connectionName) to retrieve a pointer to the database connection. .PP @@ -217,14 +217,14 @@ See also database() and removeDatabase(). .PP Examples: .)l sql/overview/connect1/main.cpp, sql/overview/connection.cpp, and sql/sqltable/main.cpp. -.SH "QSqlDatabase * QSqlDatabase::addDatabase ( QSqlDriver * driver, const TQString & connectionName = defaultConnection )\fC [static]\fR" +.SH "TQSqlDatabase * TQSqlDatabase::addDatabase ( TQSqlDriver * driver, const TQString & connectionName = defaultConnection )\fC [static]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP This function is useful if you need to set up the database connection and instantiate the driver yourself. If you do this, it is recommended that you include the driver code in your own application. For example, setting up a custom PostgreSQL connection and instantiating the QPSQL7 driver can be done the following way: .PP .nf .br - #include "qtdir/src/sql/drivers/psql/qsql_psql.cpp" + #include "qtdir/src/sql/drivers/psql/tqsql_psql.cpp" .br .fi (We assume that \fCqtdir\fR is the directory where TQt is installed.) This will pull in the code that is needed to use the PostgreSQL client library and to instantiate a QPSQLDriver object, assuming that you have the PostgreSQL headers somewhere in your include search path. @@ -235,9 +235,9 @@ This function is useful if you need to set up the database connection and instan .br QPSQLDriver* drv = new QPSQLDriver( con ); .br - QSqlDatabase* db = QSqlDatabase::addDatabase( drv ); // becomes the new default connection + TQSqlDatabase* db = TQSqlDatabase::addDatabase( drv ); // becomes the new default connection .br - QSqlQuery q; + TQSqlQuery q; .br q.exec( "SELECT * FROM people" ); .br @@ -268,44 +268,44 @@ l - l. Driver Class name Constructor arguments File to include QPSQL7 QPSQLDrive .fi </center> .PP -Note: The host name (or service name) is needed when constructing the QTDSDriver for creating new connections for internal queries. This is to prevent the simultaneous usage of several QSqlQuery/QSqlCursor objects from blocking each other. +Note: The host name (or service name) is needed when constructing the QTDSDriver for creating new connections for internal queries. This is to prevent the simultaneous usage of several TQSqlQuery/TQSqlCursor objects from blocking each other. .PP -\fBWarning:\fR The SQL framework takes ownership of the \fIdriver\fR pointer, and it should not be deleted. The returned QSqlDatabase object is owned by the framework and must not be deleted. If you want to explicitly remove the connection, use removeDatabase() +\fBWarning:\fR The SQL framework takes ownership of the \fIdriver\fR pointer, and it should not be deleted. The returned TQSqlDatabase object is owned by the framework and must not be deleted. If you want to explicitly remove the connection, use removeDatabase() .PP See also drivers(). -.SH "void QSqlDatabase::close ()" +.SH "void TQSqlDatabase::close ()" Closes the database connection, freeing any resources acquired. .PP See also removeDatabase(). -.SH "bool QSqlDatabase::commit ()" +.SH "bool TQSqlDatabase::commit ()" Commits a transaction to the database if the driver supports transactions. Returns TRUE if the operation succeeded; otherwise returns FALSE. .PP -See also QSqlDriver::hasFeature() and rollback(). -.SH "TQString QSqlDatabase::connectOptions () const" +See also TQSqlDriver::hasFeature() and rollback(). +.SH "TQString TQSqlDatabase::connectOptions () const" Returns the database connect options. See the "connectOptions" property for details. -.SH "bool QSqlDatabase::contains ( const TQString & connectionName = defaultConnection )\fC [static]\fR" +.SH "bool TQSqlDatabase::contains ( const TQString & connectionName = defaultConnection )\fC [static]\fR" Returns TRUE if the list of database connections contains \fIconnectionName\fR; otherwise returns FALSE. -.SH "QSqlDatabase * QSqlDatabase::database ( const TQString & connectionName = defaultConnection, bool open = TRUE )\fC [static]\fR" -Returns the database connection called \fIconnectionName\fR. The database connection must have been previously added with addDatabase(). If \fIopen\fR is TRUE (the default) and the database connection is not already open it is opened now. If no \fIconnectionName\fR is specified the default connection is used. If \fIconnectionName\fR does not exist in the list of databases, 0 is returned. The pointer returned is owned by QSqlDatabase and should \fInot\fR be deleted. +.SH "TQSqlDatabase * TQSqlDatabase::database ( const TQString & connectionName = defaultConnection, bool open = TRUE )\fC [static]\fR" +Returns the database connection called \fIconnectionName\fR. The database connection must have been previously added with addDatabase(). If \fIopen\fR is TRUE (the default) and the database connection is not already open it is opened now. If no \fIconnectionName\fR is specified the default connection is used. If \fIconnectionName\fR does not exist in the list of databases, 0 is returned. The pointer returned is owned by TQSqlDatabase and should \fInot\fR be deleted. .PP \fBWarning:\fR There are restrictions on the use of database connections in threaded applications. Please see the Thread Support in TQt document for more information about threading and SQL databases. .PP Examples: .)l sql/overview/basicbrowsing/main.cpp and sql/overview/create_connections/main.cpp. -.SH "TQString QSqlDatabase::databaseName () const" +.SH "TQString TQSqlDatabase::databaseName () const" Returns the name of the database. See the "databaseName" property for details. -.SH "QSqlDriver * QSqlDatabase::driver () const" +.SH "TQSqlDriver * TQSqlDatabase::driver () const" Returns the database driver used to access the database connection. -.SH "TQString QSqlDatabase::driverName () const" +.SH "TQString TQSqlDatabase::driverName () const" Returns the name of the driver used by the database connection. -.SH "QStringList QSqlDatabase::drivers ()\fC [static]\fR" +.SH "QStringList TQSqlDatabase::drivers ()\fC [static]\fR" Returns a list of all the available database drivers. .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. .PP .nf .br - QStringList list = QSqlDatabase::drivers(); + QStringList list = TQSqlDatabase::drivers(); .br QStringList::Iterator it = list.begin(); .br @@ -318,33 +318,33 @@ Note that if you want to iterate over the list, you should iterate over a copy, } .br .fi -.SH "QSqlQuery QSqlDatabase::exec ( const TQString & query = TQString::null ) const" -Executes a SQL statement (e.g. an \fCINSERT\fR, \fCUPDATE\fR or \fCDELETE\fR statement) on the database, and returns a QSqlQuery object. Use lastError() to retrieve error information. If \fIquery\fR is TQString::null, an empty, invalid query is returned and lastError() is not affected. +.SH "TQSqlQuery TQSqlDatabase::exec ( const TQString & query = TQString::null ) const" +Executes a SQL statement (e.g. an \fCINSERT\fR, \fCUPDATE\fR or \fCDELETE\fR statement) on the database, and returns a TQSqlQuery object. Use lastError() to retrieve error information. If \fIquery\fR is TQString::null, an empty, invalid query is returned and lastError() is not affected. .PP -See also QSqlQuery and lastError(). -.SH "TQString QSqlDatabase::hostName () const" +See also TQSqlQuery and lastError(). +.SH "TQString TQSqlDatabase::hostName () const" Returns the host name where the database resides. See the "hostName" property for details. -.SH "bool QSqlDatabase::isDriverAvailable ( const TQString & name )\fC [static]\fR" +.SH "bool TQSqlDatabase::isDriverAvailable ( const TQString & name )\fC [static]\fR" Returns TRUE if a driver called \fIname\fR is available; otherwise returns FALSE. .PP See also drivers(). -.SH "bool QSqlDatabase::isOpen () const" +.SH "bool TQSqlDatabase::isOpen () const" Returns TRUE if the database connection is currently open; otherwise returns FALSE. -.SH "bool QSqlDatabase::isOpenError () const" +.SH "bool TQSqlDatabase::isOpenError () const" Returns TRUE if there was an error opening the database connection; otherwise returns FALSE. Error information can be retrieved using the lastError() function. -.SH "QSqlError QSqlDatabase::lastError () const" -Returns information about the last error that occurred on the database. See QSqlError for more information. +.SH "TQSqlError TQSqlDatabase::lastError () const" +Returns information about the last error that occurred on the database. See TQSqlError for more information. .PP Examples: .)l sql/overview/connection.cpp and sql/sqltable/main.cpp. -.SH "bool QSqlDatabase::open ()" +.SH "bool TQSqlDatabase::open ()" Opens the database connection using the current connection values. Returns TRUE on success; otherwise returns FALSE. Error information can be retrieved using the lastError() function. .PP See also lastError(). .PP Examples: .)l sql/overview/connect1/main.cpp, sql/overview/connection.cpp, and sql/sqltable/main.cpp. -.SH "bool QSqlDatabase::open ( const TQString & user, const TQString & password )" +.SH "bool TQSqlDatabase::open ( const TQString & user, const TQString & password )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Opens the database connection using the given \fIuser\fR name and \fIpassword\fR. Returns TRUE on success; otherwise returns FALSE. Error information can be retrieved using the lastError() function. @@ -352,82 +352,82 @@ Opens the database connection using the given \fIuser\fR name and \fIpassword\fR This function does not store the password it is given. Instead, the password is passed directly to the driver for opening a connection and is then discarded. .PP See also lastError(). -.SH "TQString QSqlDatabase::password () const" +.SH "TQString TQSqlDatabase::password () const" Returns the password used to connect to the database. See the "password" property for details. -.SH "int QSqlDatabase::port () const" +.SH "int TQSqlDatabase::port () const" Returns the port used to connect to the database. See the "port" property for details. -.SH "QSqlIndex QSqlDatabase::primaryIndex ( const TQString & tablename ) const" -Returns the primary index for table \fItablename\fR. If no primary index exists an empty QSqlIndex will be returned. -.SH "QSqlRecord QSqlDatabase::record ( const TQString & tablename ) const" -Returns a QSqlRecord populated with the names of all the fields in the table (or view) called \fItablename\fR. The order in which the fields appear in the record is undefined. If no such table (or view) exists, an empty record is returned. +.SH "TQSqlIndex TQSqlDatabase::primaryIndex ( const TQString & tablename ) const" +Returns the primary index for table \fItablename\fR. If no primary index exists an empty TQSqlIndex will be returned. +.SH "TQSqlRecord TQSqlDatabase::record ( const TQString & tablename ) const" +Returns a TQSqlRecord populated with the names of all the fields in the table (or view) called \fItablename\fR. The order in which the fields appear in the record is undefined. If no such table (or view) exists, an empty record is returned. .PP See also recordInfo(). -.SH "QSqlRecord QSqlDatabase::record ( const QSqlQuery & query ) const" +.SH "TQSqlRecord TQSqlDatabase::record ( const TQSqlQuery & query ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Returns a QSqlRecord populated with the names of all the fields used in the SQL \fIquery\fR. If the query is a "SELECT *" the order in which fields appear in the record is undefined. +Returns a TQSqlRecord populated with the names of all the fields used in the SQL \fIquery\fR. If the query is a "SELECT *" the order in which fields appear in the record is undefined. .PP See also recordInfo(). -.SH "QSqlRecordInfo QSqlDatabase::recordInfo ( const TQString & tablename ) const" -Returns a QSqlRecordInfo populated with meta data about the table or view \fItablename\fR. If no such table (or view) exists, an empty record is returned. +.SH "TQSqlRecordInfo TQSqlDatabase::recordInfo ( const TQString & tablename ) const" +Returns a TQSqlRecordInfo populated with meta data about the table or view \fItablename\fR. If no such table (or view) exists, an empty record is returned. .PP -See also QSqlRecordInfo, QSqlFieldInfo, and record(). -.SH "QSqlRecordInfo QSqlDatabase::recordInfo ( const QSqlQuery & query ) const" +See also TQSqlRecordInfo, TQSqlFieldInfo, and record(). +.SH "TQSqlRecordInfo TQSqlDatabase::recordInfo ( const TQSqlQuery & query ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Returns a QSqlRecordInfo object with meta data for the QSqlQuery \fIquery\fR. Note that this overloaded function may return less information than the recordInfo() function which takes the name of a table as parameter. +Returns a TQSqlRecordInfo object with meta data for the TQSqlQuery \fIquery\fR. Note that this overloaded function may return less information than the recordInfo() function which takes the name of a table as parameter. .PP -See also QSqlRecordInfo, QSqlFieldInfo, and record(). -.SH "void QSqlDatabase::registerSqlDriver ( const TQString & name, const QSqlDriverCreatorBase * creator )\fC [static]\fR" +See also TQSqlRecordInfo, TQSqlFieldInfo, and record(). +.SH "void TQSqlDatabase::registerSqlDriver ( const TQString & name, const TQSqlDriverCreatorBase * creator )\fC [static]\fR" This function registers a new SQL driver called \fIname\fR, within the SQL framework. This is useful if you have a custom SQL driver and don't want to compile it as a plugin. .PP Example usage: .PP .nf .br - QSqlDatabase::registerSqlDriver( "MYDRIVER", new QSqlDriverCreator<MyDatabaseDriver> ); + TQSqlDatabase::registerSqlDriver( "MYDRIVER", new TQSqlDriverCreator<MyDatabaseDriver> ); .br - QSqlDatabase* db = QSqlDatabase::addDatabase( "MYDRIVER" ); + TQSqlDatabase* db = TQSqlDatabase::addDatabase( "MYDRIVER" ); .br ... .br .fi .PP \fBWarning:\fR The framework takes ownership of the \fIcreator\fR pointer, so it should not be deleted. -.SH "void QSqlDatabase::removeDatabase ( const TQString & connectionName )\fC [static]\fR" +.SH "void TQSqlDatabase::removeDatabase ( const TQString & connectionName )\fC [static]\fR" Removes the database connection \fIconnectionName\fR from the list of database connections. .PP \fBWarning:\fR There should be no open queries on the database connection when this function is called, otherwise a resource leak will occur. -.SH "void QSqlDatabase::removeDatabase ( QSqlDatabase * db )\fC [static]\fR" +.SH "void TQSqlDatabase::removeDatabase ( TQSqlDatabase * db )\fC [static]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Removes the database connection \fIdb\fR from the list of database connections. The QSqlDatabase object is destroyed when it is removed from the list. +Removes the database connection \fIdb\fR from the list of database connections. The TQSqlDatabase object is destroyed when it is removed from the list. .PP \fBWarning:\fR The \fIdb\fR pointer is not valid after this function has been called. There should be no open queries on the database connection when this function is called, otherwise a resource leak will occur. -.SH "bool QSqlDatabase::rollback ()" +.SH "bool TQSqlDatabase::rollback ()" Rolls a transaction back on the database if the driver supports transactions. Returns TRUE if the operation succeeded; otherwise returns FALSE. .PP -See also QSqlDriver::hasFeature(), commit(), and transaction(). -.SH "void QSqlDatabase::setConnectOptions ( const TQString & options = TQString::null )" +See also TQSqlDriver::hasFeature(), commit(), and transaction(). +.SH "void TQSqlDatabase::setConnectOptions ( const TQString & options = TQString::null )" Sets the database connect options to \fIoptions\fR. See the "connectOptions" property for details. -.SH "void QSqlDatabase::setDatabaseName ( const TQString & name )\fC [virtual]\fR" +.SH "void TQSqlDatabase::setDatabaseName ( const TQString & name )\fC [virtual]\fR" Sets the name of the database to \fIname\fR. See the "databaseName" property for details. -.SH "void QSqlDatabase::setHostName ( const TQString & host )\fC [virtual]\fR" +.SH "void TQSqlDatabase::setHostName ( const TQString & host )\fC [virtual]\fR" Sets the host name where the database resides to \fIhost\fR. See the "hostName" property for details. -.SH "void QSqlDatabase::setPassword ( const TQString & password )\fC [virtual]\fR" +.SH "void TQSqlDatabase::setPassword ( const TQString & password )\fC [virtual]\fR" Sets the password used to connect to the database to \fIpassword\fR. See the "password" property for details. -.SH "void QSqlDatabase::setPort ( int p )\fC [virtual]\fR" +.SH "void TQSqlDatabase::setPort ( int p )\fC [virtual]\fR" Sets the port used to connect to the database to \fIp\fR. See the "port" property for details. -.SH "void QSqlDatabase::setUserName ( const TQString & name )\fC [virtual]\fR" +.SH "void TQSqlDatabase::setUserName ( const TQString & name )\fC [virtual]\fR" Sets the user name connected to the database to \fIname\fR. See the "userName" property for details. -.SH "QStringList QSqlDatabase::tables ( QSql::TableType type ) const" +.SH "QStringList TQSqlDatabase::tables ( TQSql::TableType type ) const" Returns a list of the database's tables, system tables and views, as specified by the parameter \fItype\fR. .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. .PP .nf .br - QStringList list = myDatabase.tables( QSql::Tables | QSql::Views ); + QStringList list = myDatabase.tables( TQSql::Tables | TQSql::Views ); .br QStringList::Iterator it = list.begin(); .br @@ -442,7 +442,7 @@ Note that if you want to iterate over the list, you should iterate over a copy, .fi .PP Example: sql/sqltable/main.cpp. -.SH "QStringList QSqlDatabase::tables () const" +.SH "QStringList TQSqlDatabase::tables () const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns a list of the database's tables that are visible to the user. To include views or system tables, use the version of this function that takes a table \fCtype\fR parameter. @@ -464,11 +464,11 @@ Note that if you want to iterate over the list, you should iterate over a copy, } .br .fi -.SH "bool QSqlDatabase::transaction ()" +.SH "bool TQSqlDatabase::transaction ()" Begins a transaction on the database if the driver supports transactions. Returns TRUE if the operation succeeded; otherwise returns FALSE. .PP -See also QSqlDriver::hasFeature(), commit(), and rollback(). -.SH "TQString QSqlDatabase::userName () const" +See also TQSqlDriver::hasFeature(), commit(), and rollback(). +.SH "TQString TQSqlDatabase::userName () const" Returns the user name connected to the database. See the "userName" property for details. .SS "Property Documentation" .SH "TQString connectOptions" @@ -593,7 +593,7 @@ For the QODBC3 driver it can either be a DSN, a DSN filename (the file must have .br ... .br - db = QSqlDatabase::addDatabase( "QODBC3" ); + db = TQSqlDatabase::addDatabase( "QODBC3" ); .br db->setDatabaseName( "DRIVER={Microsoft Access Driver (*.mdb)};FIL={MS Access};DBQ=myaccessfile.mdb" ); .br @@ -641,7 +641,7 @@ There is no default value. Set this property's value with setUserName() and get this property's value with userName(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqldatabase.html +.BR http://doc.trolltech.com/tqsqldatabase.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqldriver.3qt b/doc/man/man3/tqsqldriver.3qt index f06a6189f..e0757f1cb 100644 --- a/doc/man/man3/tqsqldriver.3qt +++ b/doc/man/man3/tqsqldriver.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlDriver 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlDriver 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlDriver \- Abstract base class for accessing SQL databases +TQSqlDriver \- Abstract base class for accessing SQL databases .SH SYNOPSIS -\fC#include <ntqsqldriver.h>\fR +\fC#include <tqsqldriver.h>\fR .PP Inherits TQObject. .PP @@ -22,7 +22,7 @@ Inherits TQObject. .BI "\fBQSqlDriver\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QSqlDriver\fR ()" +.BI "\fB~TQSqlDriver\fR ()" .br .ti -1c .BI "bool \fBisOpen\fR () const" @@ -43,28 +43,28 @@ Inherits TQObject. .BI "virtual QStringList \fBtables\fR ( const TQString & tableType ) const" .br .ti -1c -.BI "virtual QSqlIndex \fBprimaryIndex\fR ( const TQString & tableName ) const" +.BI "virtual TQSqlIndex \fBprimaryIndex\fR ( const TQString & tableName ) const" .br .ti -1c -.BI "virtual QSqlRecord \fBrecord\fR ( const TQString & tableName ) const" +.BI "virtual TQSqlRecord \fBrecord\fR ( const TQString & tableName ) const" .br .ti -1c -.BI "virtual QSqlRecord \fBrecord\fR ( const QSqlQuery & query ) const" +.BI "virtual TQSqlRecord \fBrecord\fR ( const TQSqlQuery & query ) const" .br .ti -1c -.BI "virtual QSqlRecordInfo \fBrecordInfo\fR ( const TQString & tablename ) const" +.BI "virtual TQSqlRecordInfo \fBrecordInfo\fR ( const TQString & tablename ) const" .br .ti -1c -.BI "virtual QSqlRecordInfo \fBrecordInfo\fR ( const QSqlQuery & query ) const" +.BI "virtual TQSqlRecordInfo \fBrecordInfo\fR ( const TQSqlQuery & query ) const" .br .ti -1c .BI "virtual TQString \fBnullText\fR () const" .br .ti -1c -.BI "virtual TQString \fBformatValue\fR ( const QSqlField * field, bool trimStrings = FALSE ) const" +.BI "virtual TQString \fBformatValue\fR ( const TQSqlField * field, bool trimStrings = FALSE ) const" .br .ti -1c -.BI "QSqlError \fBlastError\fR () const" +.BI "TQSqlError \fBlastError\fR () const" .br .ti -1c .BI "virtual bool \fBhasFeature\fR ( DriverFeature f ) const = 0" @@ -76,7 +76,7 @@ Inherits TQObject. .BI "virtual void \fBclose\fR () = 0" .br .ti -1c -.BI "virtual QSqlQuery \fBcreateQuery\fR () const = 0" +.BI "virtual TQSqlQuery \fBcreateQuery\fR () const = 0" .br .ti -1c .BI "bool \fBopen\fR ( const TQString & db, const TQString & user, const TQString & password, const TQString & host, int port, const TQString & connOpts )" @@ -91,22 +91,22 @@ Inherits TQObject. .BI "virtual void \fBsetOpenError\fR ( bool e )" .br .ti -1c -.BI "virtual void \fBsetLastError\fR ( const QSqlError & e )" +.BI "virtual void \fBsetLastError\fR ( const TQSqlError & e )" .br .in -1c .SH DESCRIPTION -The QSqlDriver class is an abstract base class for accessing SQL databases. +The TQSqlDriver class is an abstract base class for accessing SQL databases. .PP -This class should not be used directly. Use QSqlDatabase instead. +This class should not be used directly. Use TQSqlDatabase instead. .PP See also Database Classes. .SS "Member Type Documentation" -.SH "QSqlDriver::DriverFeature" +.SH "TQSqlDriver::DriverFeature" This enum contains a list of features a driver may support. Use hasFeature() to query whether a feature is supported or not. .TP \fCQSqlDriver::Transactions\fR - whether the driver supports SQL transactions .TP -\fCQSqlDriver::QuerySize\fR - whether the database is capable of reporting the size of a query. Note that some databases do not support returning the size (i.e. number of rows returned) of a query, in which case QSqlQuery::size() will return -1 +\fCQSqlDriver::QuerySize\fR - whether the database is capable of reporting the size of a query. Note that some databases do not support returning the size (i.e. number of rows returned) of a query, in which case TQSqlQuery::size() will return -1 .TP \fCQSqlDriver::BLOB\fR - whether the driver supports Binary Large Object fields .TP @@ -122,25 +122,25 @@ More information about supported features can be found in the TQt SQL driver doc .PP See also hasFeature(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlDriver::QSqlDriver ( TQObject * parent = 0, const char * name = 0 )" +.SH "TQSqlDriver::TQSqlDriver ( TQObject * parent = 0, const char * name = 0 )" Default constructor. Creates a new driver with parent \fIparent\fR, called \fIname\fR. -.SH "QSqlDriver::~QSqlDriver ()" +.SH "TQSqlDriver::~TQSqlDriver ()" Destroys the object and frees any allocated resources. -.SH "bool QSqlDriver::beginTransaction ()\fC [virtual]\fR" +.SH "bool TQSqlDriver::beginTransaction ()\fC [virtual]\fR" Protected function which derived classes can reimplement to begin a transaction. If successful, return TRUE, otherwise return FALSE. The default implementation returns FALSE. .PP See also commitTransaction() and rollbackTransaction(). -.SH "void QSqlDriver::close ()\fC [pure virtual]\fR" +.SH "void TQSqlDriver::close ()\fC [pure virtual]\fR" Derived classes must reimplement this abstract virtual function in order to close the database connection. Return TRUE on success, FALSE on failure. .PP See also setOpen(). -.SH "bool QSqlDriver::commitTransaction ()\fC [virtual]\fR" +.SH "bool TQSqlDriver::commitTransaction ()\fC [virtual]\fR" Protected function which derived classes can reimplement to commit a transaction. If successful, return TRUE, otherwise return FALSE. The default implementation returns FALSE. .PP See also beginTransaction() and rollbackTransaction(). -.SH "QSqlQuery QSqlDriver::createQuery () const\fC [pure virtual]\fR" -Creates an empty SQL result on the database. Derived classes must reimplement this function and return a QSqlQuery object appropriate for their database to the caller. -.SH "TQString QSqlDriver::formatValue ( const QSqlField * field, bool trimStrings = FALSE ) const\fC [virtual]\fR" +.SH "TQSqlQuery TQSqlDriver::createQuery () const\fC [pure virtual]\fR" +Creates an empty SQL result on the database. Derived classes must reimplement this function and return a TQSqlQuery object appropriate for their database to the caller. +.SH "TQString TQSqlDriver::formatValue ( const TQSqlField * field, bool trimStrings = FALSE ) const\fC [virtual]\fR" Returns a string representation of the \fIfield\fR value for the database. This is used, for example, when constructing INSERT and UPDATE statements. .PP The default implementation returns the value formatted as a string according to the following rules: @@ -162,27 +162,27 @@ For any other field type toString() will be called on its value and the result r .IP .PP See also QVariant::toString(). -.SH "bool QSqlDriver::hasFeature ( DriverFeature f ) const\fC [pure virtual]\fR" +.SH "bool TQSqlDriver::hasFeature ( DriverFeature f ) const\fC [pure virtual]\fR" Returns TRUE if the driver supports feature \fIf\fR; otherwise returns FALSE. .PP Note that some databases need to be open() before this can be determined. .PP See also DriverFeature. -.SH "bool QSqlDriver::isOpen () const" +.SH "bool TQSqlDriver::isOpen () const" Returns TRUE if the database connection is open; otherwise returns FALSE. -.SH "bool QSqlDriver::isOpenError () const" +.SH "bool TQSqlDriver::isOpenError () const" Returns TRUE if the there was an error opening the database connection; otherwise returns FALSE. -.SH "QSqlError QSqlDriver::lastError () const" -Returns a QSqlError object which contains information about the last error that occurred on the database. -.SH "TQString QSqlDriver::nullText () const\fC [virtual]\fR" +.SH "TQSqlError TQSqlDriver::lastError () const" +Returns a TQSqlError object which contains information about the last error that occurred on the database. +.SH "TQString TQSqlDriver::nullText () const\fC [virtual]\fR" Returns a string representation of the NULL value for the database. This is used, for example, when constructing INSERT and UPDATE statements. The default implementation returns the string" NULL". -.SH "bool QSqlDriver::open ( const TQString & db, const TQString & user = TQString::null, const TQString & password = TQString::null, const TQString & host = TQString::null, int port = -1 )\fC [pure virtual]\fR" +.SH "bool TQSqlDriver::open ( const TQString & db, const TQString & user = TQString::null, const TQString & password = TQString::null, const TQString & host = TQString::null, int port = -1 )\fC [pure virtual]\fR" Derived classes must reimplement this abstract virtual function in order to open a database connection on database \fIdb\fR, using user name \fIuser\fR, password \fIpassword\fR, host \fIhost\fR and port \fIport\fR. .PP The function \fImust\fR return TRUE on success and FALSE on failure. .PP See also setOpen(). -.SH "bool QSqlDriver::open ( const TQString & db, const TQString & user, const TQString & password, const TQString & host, int port, const TQString & connOpts )" +.SH "bool TQSqlDriver::open ( const TQString & db, const TQString & user, const TQString & password, const TQString & host, int port, const TQString & connOpts )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Open a database connection on database \fIdb\fR, using user name \fIuser\fR, password \fIpassword\fR, host \fIhost\fR, port \fIport\fR and connection options \fIconnOpts\fR. @@ -190,45 +190,45 @@ Open a database connection on database \fIdb\fR, using user name \fIuser\fR, pas Returns TRUE on success and FALSE on failure. .PP See also setOpen(). -.SH "QSqlIndex QSqlDriver::primaryIndex ( const TQString & tableName ) const\fC [virtual]\fR" -Returns the primary index for table \fItableName\fR. Returns an empty QSqlIndex if the table doesn't have a primary index. The default implementation returns an empty index. -.SH "QSqlRecord QSqlDriver::record ( const TQString & tableName ) const\fC [virtual]\fR" -Returns a QSqlRecord populated with the names of the fields in table \fItableName\fR. If no such table exists, an empty record is returned. The default implementation returns an empty record. -.SH "QSqlRecord QSqlDriver::record ( const QSqlQuery & query ) const\fC [virtual]\fR" +.SH "TQSqlIndex TQSqlDriver::primaryIndex ( const TQString & tableName ) const\fC [virtual]\fR" +Returns the primary index for table \fItableName\fR. Returns an empty TQSqlIndex if the table doesn't have a primary index. The default implementation returns an empty index. +.SH "TQSqlRecord TQSqlDriver::record ( const TQString & tableName ) const\fC [virtual]\fR" +Returns a TQSqlRecord populated with the names of the fields in table \fItableName\fR. If no such table exists, an empty record is returned. The default implementation returns an empty record. +.SH "TQSqlRecord TQSqlDriver::record ( const TQSqlQuery & query ) const\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Returns a QSqlRecord populated with the names of the fields in the SQL \fIquery\fR. The default implementation returns an empty record. -.SH "QSqlRecordInfo QSqlDriver::recordInfo ( const TQString & tablename ) const\fC [virtual]\fR" -Returns a QSqlRecordInfo object with meta data about the table \fItablename\fR. -.SH "QSqlRecordInfo QSqlDriver::recordInfo ( const QSqlQuery & query ) const\fC [virtual]\fR" +Returns a TQSqlRecord populated with the names of the fields in the SQL \fIquery\fR. The default implementation returns an empty record. +.SH "TQSqlRecordInfo TQSqlDriver::recordInfo ( const TQString & tablename ) const\fC [virtual]\fR" +Returns a TQSqlRecordInfo object with meta data about the table \fItablename\fR. +.SH "TQSqlRecordInfo TQSqlDriver::recordInfo ( const TQSqlQuery & query ) const\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Returns a QSqlRecordInfo object with meta data for the QSqlQuery \fIquery\fR. Note that this overloaded function may return less information than the recordInfo() function which takes the name of a table as parameter. -.SH "bool QSqlDriver::rollbackTransaction ()\fC [virtual]\fR" +Returns a TQSqlRecordInfo object with meta data for the TQSqlQuery \fIquery\fR. Note that this overloaded function may return less information than the recordInfo() function which takes the name of a table as parameter. +.SH "bool TQSqlDriver::rollbackTransaction ()\fC [virtual]\fR" Protected function which derived classes can reimplement to rollback a transaction. If successful, return TRUE, otherwise return FALSE. The default implementation returns FALSE. .PP See also beginTransaction() and commitTransaction(). -.SH "void QSqlDriver::setLastError ( const QSqlError & e )\fC [virtual protected]\fR" +.SH "void TQSqlDriver::setLastError ( const TQSqlError & e )\fC [virtual protected]\fR" Protected function which allows derived classes to set the value of the last error, \fIe\fR, that occurred on the database. .PP See also lastError(). -.SH "void QSqlDriver::setOpen ( bool o )\fC [virtual protected]\fR" +.SH "void TQSqlDriver::setOpen ( bool o )\fC [virtual protected]\fR" Protected function which sets the open state of the database to \fIo\fR. Derived classes can use this function to report the status of open(). .PP See also open() and setOpenError(). -.SH "void QSqlDriver::setOpenError ( bool e )\fC [virtual protected]\fR" +.SH "void TQSqlDriver::setOpenError ( bool e )\fC [virtual protected]\fR" Protected function which sets the open error state of the database to \fIe\fR. Derived classes can use this function to report the status of open(). Note that if \fIe\fR is TRUE the open state of the database is set to closed (i.e. isOpen() returns FALSE). .PP See also open(). -.SH "QStringList QSqlDriver::tables ( const TQString & tableType ) const\fC [virtual]\fR" +.SH "QStringList TQSqlDriver::tables ( const TQString & tableType ) const\fC [virtual]\fR" Returns a list of tables in the database. The default implementation returns an empty list. .PP -The \fItableType\fR argument describes what types of tables should be returned. Due to binary compatibility, the string contains the value of the enum QSql::TableTypes as text. An empty string should be treated as QSql::Tables for downward compatibility. +The \fItableType\fR argument describes what types of tables should be returned. Due to binary compatibility, the string contains the value of the enum TQSql::TableTypes as text. An empty string should be treated as TQSql::Tables for downward compatibility. .PP -See also QSql::TableType. +See also TQSql::TableType. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqldriver.html +.BR http://doc.trolltech.com/tqsqldriver.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqldriverplugin.3qt b/doc/man/man3/tqsqldriverplugin.3qt index 95abb8b6b..c190a9937 100644 --- a/doc/man/man3/tqsqldriverplugin.3qt +++ b/doc/man/man3/tqsqldriverplugin.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlDriverPlugin 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlDriverPlugin 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlDriverPlugin \- Abstract base for custom QSqlDriver plugins +TQSqlDriverPlugin \- Abstract base for custom TQSqlDriver plugins .SH SYNOPSIS -\fC#include <ntqsqldriverplugin.h>\fR +\fC#include <tqsqldriverplugin.h>\fR .PP .SS "Public Members" .in +1c @@ -17,17 +17,17 @@ QSqlDriverPlugin \- Abstract base for custom QSqlDriver plugins .BI "\fBQSqlDriverPlugin\fR ()" .br .ti -1c -.BI "\fB~QSqlDriverPlugin\fR ()" +.BI "\fB~TQSqlDriverPlugin\fR ()" .br .ti -1c .BI "virtual QStringList \fBkeys\fR () const = 0" .br .ti -1c -.BI "virtual QSqlDriver * \fBcreate\fR ( const TQString & key ) = 0" +.BI "virtual TQSqlDriver * \fBcreate\fR ( const TQString & key ) = 0" .br .in -1c .SH DESCRIPTION -The QSqlDriverPlugin class provides an abstract base for custom QSqlDriver plugins. +The TQSqlDriverPlugin class provides an abstract base for custom TQSqlDriver plugins. .PP The SQL driver plugin is a simple plugin interface that makes it easy to create your own SQL driver plugins that can be loaded dynamically by Qt. .PP @@ -35,17 +35,17 @@ Writing a SQL plugin is achieved by subclassing this base class, reimplementing .PP See also Plugins. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlDriverPlugin::QSqlDriverPlugin ()" +.SH "TQSqlDriverPlugin::TQSqlDriverPlugin ()" Constructs a SQL driver plugin. This is invoked automatically by the \fCQ_EXPORT_PLUGIN\fR macro. -.SH "QSqlDriverPlugin::~QSqlDriverPlugin ()" +.SH "TQSqlDriverPlugin::~TQSqlDriverPlugin ()" Destroys the SQL driver plugin. .PP You never have to call this explicitly. TQt destroys a plugin automatically when it is no longer used. -.SH "QSqlDriver * QSqlDriverPlugin::create ( const TQString & key )\fC [pure virtual]\fR" -Creates and returns a QSqlDriver object for the driver key \fIkey\fR. The driver key is usually the class name of the required driver. +.SH "TQSqlDriver * TQSqlDriverPlugin::create ( const TQString & key )\fC [pure virtual]\fR" +Creates and returns a TQSqlDriver object for the driver key \fIkey\fR. The driver key is usually the class name of the required driver. .PP See also keys(). -.SH "QStringList QSqlDriverPlugin::keys () const\fC [pure virtual]\fR" +.SH "QStringList TQSqlDriverPlugin::keys () const\fC [pure virtual]\fR" Returns the list of drivers (keys) this plugin supports. .PP These keys are usually the class names of the custom drivers that are implemented in the plugin. @@ -53,7 +53,7 @@ These keys are usually the class names of the custom drivers that are implemente See also create(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqldriverplugin.html +.BR http://doc.trolltech.com/tqsqldriverplugin.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqleditorfactory.3qt b/doc/man/man3/tqsqleditorfactory.3qt index 272e4f7b1..3e3093b0e 100644 --- a/doc/man/man3/tqsqleditorfactory.3qt +++ b/doc/man/man3/tqsqleditorfactory.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlEditorFactory 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlEditorFactory 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,11 +7,11 @@ .ad l .nh .SH NAME -QSqlEditorFactory \- Used to create the editors used by QDataTable and QSqlForm +TQSqlEditorFactory \- Used to create the editors used by TQDataTable and TQSqlForm .SH SYNOPSIS -\fC#include <ntqsqleditorfactory.h>\fR +\fC#include <tqsqleditorfactory.h>\fR .PP -Inherits QEditorFactory. +Inherits TQEditorFactory. .PP .SS "Public Members" .in +1c @@ -19,56 +19,56 @@ Inherits QEditorFactory. .BI "\fBQSqlEditorFactory\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QSqlEditorFactory\fR ()" +.BI "\fB~TQSqlEditorFactory\fR ()" .br .ti -1c .BI "virtual TQWidget * \fBcreateEditor\fR ( TQWidget * parent, const QVariant & variant )" .br .ti -1c -.BI "virtual TQWidget * \fBcreateEditor\fR ( TQWidget * parent, const QSqlField * field )" +.BI "virtual TQWidget * \fBcreateEditor\fR ( TQWidget * parent, const TQSqlField * field )" .br .in -1c .SS "Static Public Members" .in +1c .ti -1c -.BI "QSqlEditorFactory * \fBdefaultFactory\fR ()" +.BI "TQSqlEditorFactory * \fBdefaultFactory\fR ()" .br .ti -1c -.BI "void \fBinstallDefaultFactory\fR ( QSqlEditorFactory * factory )" +.BI "void \fBinstallDefaultFactory\fR ( TQSqlEditorFactory * factory )" .br .in -1c .SH DESCRIPTION -The QSqlEditorFactory class is used to create the editors used by QDataTable and QSqlForm. +The TQSqlEditorFactory class is used to create the editors used by TQDataTable and TQSqlForm. .PP -QSqlEditorFactory is used by QDataTable and QSqlForm to automatically create appropriate editors for a given QSqlField. For example if the field is a QVariant::String a QLineEdit would be the default editor, whereas a QVariant::Int's default editor would be a QSpinBox. +TQSqlEditorFactory is used by TQDataTable and TQSqlForm to automatically create appropriate editors for a given TQSqlField. For example if the field is a QVariant::String a QLineEdit would be the default editor, whereas a QVariant::Int's default editor would be a QSpinBox. .PP -If you want to create different editors for fields with the same data type, subclass QSqlEditorFactory and reimplement the createEditor() function. +If you want to create different editors for fields with the same data type, subclass TQSqlEditorFactory and reimplement the createEditor() function. .PP -See also QDataTable, QSqlForm, and Database Classes. +See also TQDataTable, TQSqlForm, and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlEditorFactory::QSqlEditorFactory ( TQObject * parent = 0, const char * name = 0 )" +.SH "TQSqlEditorFactory::TQSqlEditorFactory ( TQObject * parent = 0, const char * name = 0 )" Constructs a SQL editor factory with parent \fIparent\fR, called \fIname\fR. -.SH "QSqlEditorFactory::~QSqlEditorFactory ()" +.SH "TQSqlEditorFactory::~TQSqlEditorFactory ()" Destroys the object and frees any allocated resources. -.SH "TQWidget * QSqlEditorFactory::createEditor ( TQWidget * parent, const QVariant & variant )\fC [virtual]\fR" +.SH "TQWidget * TQSqlEditorFactory::createEditor ( TQWidget * parent, const QVariant & variant )\fC [virtual]\fR" Creates and returns the appropriate editor widget for the QVariant \fIvariant\fR. .PP The widget that is returned has the parent \fIparent\fR (which may be zero). If \fIvariant\fR is invalid, 0 is returned. .PP -Reimplemented from QEditorFactory. -.SH "TQWidget * QSqlEditorFactory::createEditor ( TQWidget * parent, const QSqlField * field )\fC [virtual]\fR" +Reimplemented from TQEditorFactory. +.SH "TQWidget * TQSqlEditorFactory::createEditor ( TQWidget * parent, const TQSqlField * field )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Creates and returns the appropriate editor for the QSqlField \fIfield\fR. -.SH "QSqlEditorFactory * QSqlEditorFactory::defaultFactory ()\fC [static]\fR" +Creates and returns the appropriate editor for the TQSqlField \fIfield\fR. +.SH "TQSqlEditorFactory * TQSqlEditorFactory::defaultFactory ()\fC [static]\fR" Returns an instance of a default editor factory. -.SH "void QSqlEditorFactory::installDefaultFactory ( QSqlEditorFactory * factory )\fC [static]\fR" +.SH "void TQSqlEditorFactory::installDefaultFactory ( TQSqlEditorFactory * factory )\fC [static]\fR" Replaces the default editor factory with \fIfactory\fR. All -QDataTable and QSqlForm instantiations will use this new factory +TQDataTable and TQSqlForm instantiations will use this new factory for creating field editors. \fIQSqlEditorFactory takes ownership of \a factory, and destroys it when it is no longer needed.\fR .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqleditorfactory.html +.BR http://doc.trolltech.com/tqsqleditorfactory.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlerror.3qt b/doc/man/man3/tqsqlerror.3qt index 5b609aa21..ad846e4a9 100644 --- a/doc/man/man3/tqsqlerror.3qt +++ b/doc/man/man3/tqsqlerror.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlError 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlError 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlError \- SQL database error information +TQSqlError \- SQL database error information .SH SYNOPSIS -\fC#include <ntqsqlerror.h>\fR +\fC#include <tqsqlerror.h>\fR .PP .SS "Public Members" .in +1c @@ -17,16 +17,16 @@ QSqlError \- SQL database error information .BI "enum \fBType\fR { None, Connection, Statement, Transaction, Unknown }" .br .ti -1c -.BI "\fBQSqlError\fR ( const TQString & driverText = TQString::null, const TQString & databaseText = TQString::null, int type = QSqlError::None, int number = -1 )" +.BI "\fBQSqlError\fR ( const TQString & driverText = TQString::null, const TQString & databaseText = TQString::null, int type = TQSqlError::None, int number = -1 )" .br .ti -1c -.BI "\fBQSqlError\fR ( const QSqlError & other )" +.BI "\fBQSqlError\fR ( const TQSqlError & other )" .br .ti -1c -.BI "QSqlError & \fBoperator=\fR ( const QSqlError & other )" +.BI "TQSqlError & \fBoperator=\fR ( const TQSqlError & other )" .br .ti -1c -.BI "virtual \fB~QSqlError\fR ()" +.BI "virtual \fB~TQSqlError\fR ()" .br .ti -1c .BI "TQString \fBdriverText\fR () const" @@ -60,13 +60,13 @@ QSqlError \- SQL database error information .br .in -1c .SH DESCRIPTION -The QSqlError class provides SQL database error information. +The TQSqlError class provides SQL database error information. .PP This class is used to report database-specific errors. An error description and (if appropriate) a database-specific error number can be obtained using this class. .PP See also Database Classes. .SS "Member Type Documentation" -.SH "QSqlError::Type" +.SH "TQSqlError::Type" This enum type describes the type of SQL error that occurred. .TP \fCQSqlError::None\fR - no error occurred @@ -79,45 +79,45 @@ This enum type describes the type of SQL error that occurred. .TP \fCQSqlError::Unknown\fR - unknown error .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlError::QSqlError ( const TQString & driverText = TQString::null, const TQString & databaseText = TQString::null, int type = QSqlError::None, int number = -1 )" +.SH "TQSqlError::TQSqlError ( const TQString & driverText = TQString::null, const TQString & databaseText = TQString::null, int type = TQSqlError::None, int number = -1 )" Constructs an error containing the driver error text \fIdriverText\fR, the database-specific error text \fIdatabaseText\fR, the type \fItype\fR and the optional error number \fInumber\fR. -.SH "QSqlError::QSqlError ( const QSqlError & other )" +.SH "TQSqlError::TQSqlError ( const TQSqlError & other )" Creates a copy of \fIother\fR. -.SH "QSqlError::~QSqlError ()\fC [virtual]\fR" +.SH "TQSqlError::~TQSqlError ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "TQString QSqlError::databaseText () const" +.SH "TQString TQSqlError::databaseText () const" Returns the text of the error as reported by the database. This may contain database-specific descriptions. -.SH "TQString QSqlError::driverText () const" +.SH "TQString TQSqlError::driverText () const" Returns the text of the error as reported by the driver. This may contain database-specific descriptions. -.SH "int QSqlError::number () const" +.SH "int TQSqlError::number () const" Returns the database-specific error number, or -1 if it cannot be determined. -.SH "QSqlError & QSqlError::operator= ( const QSqlError & other )" +.SH "TQSqlError & TQSqlError::operator= ( const TQSqlError & other )" Sets the error equal to \fIother\fR. -.SH "void QSqlError::setDatabaseText ( const TQString & databaseText )\fC [virtual]\fR" +.SH "void TQSqlError::setDatabaseText ( const TQString & databaseText )\fC [virtual]\fR" Sets the database error text to the value of \fIdatabaseText\fR. -.SH "void QSqlError::setDriverText ( const TQString & driverText )\fC [virtual]\fR" +.SH "void TQSqlError::setDriverText ( const TQString & driverText )\fC [virtual]\fR" Sets the driver error text to the value of \fIdriverText\fR. -.SH "void QSqlError::setNumber ( int number )\fC [virtual]\fR" +.SH "void TQSqlError::setNumber ( int number )\fC [virtual]\fR" Sets the database-specific error number to \fInumber\fR. -.SH "void QSqlError::setType ( int type )\fC [virtual]\fR" +.SH "void TQSqlError::setType ( int type )\fC [virtual]\fR" Sets the error type to the value of \fItype\fR. -.SH "void QSqlError::showMessage ( const TQString & msg = TQString::null ) const" +.SH "void TQSqlError::showMessage ( const TQString & msg = TQString::null ) const" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP This is a convenience function that pops up a QMessageBox containing the message returned by text(). An additional string can be passed in via the \fImsg\fR parameter, which will be concatenated with the text() message. .PP See also text(), driverText(), and databaseText(). -.SH "TQString QSqlError::text () const" +.SH "TQString TQSqlError::text () const" This is a convenience function that returns databaseText() and driverText() concatenated into a single string. .PP See also showMessage(), driverText(), and databaseText(). -.SH "int QSqlError::type () const" +.SH "int TQSqlError::type () const" Returns the error type, or -1 if the type cannot be determined. .PP -See also QSqlError::Type. +See also TQSqlError::Type. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlerror.html +.BR http://doc.trolltech.com/tqsqlerror.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlfield.3qt b/doc/man/man3/tqsqlfield.3qt index dfb18cb16..c5c484b09 100644 --- a/doc/man/man3/tqsqlfield.3qt +++ b/doc/man/man3/tqsqlfield.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlField 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlField 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlField \- Manipulates the fields in SQL database tables and views +TQSqlField \- Manipulates the fields in SQL database tables and views .SH SYNOPSIS -\fC#include <ntqsqlfield.h>\fR +\fC#include <tqsqlfield.h>\fR .PP .SS "Public Members" .in +1c @@ -17,16 +17,16 @@ QSqlField \- Manipulates the fields in SQL database tables and views .BI "\fBQSqlField\fR ( const TQString & fieldName = TQString::null, QVariant::Type type = QVariant::Invalid )" .br .ti -1c -.BI "\fBQSqlField\fR ( const QSqlField & other )" +.BI "\fBQSqlField\fR ( const TQSqlField & other )" .br .ti -1c -.BI "QSqlField & \fBoperator=\fR ( const QSqlField & other )" +.BI "TQSqlField & \fBoperator=\fR ( const TQSqlField & other )" .br .ti -1c -.BI "bool \fBoperator==\fR ( const QSqlField & other ) const" +.BI "bool \fBoperator==\fR ( const TQSqlField & other ) const" .br .ti -1c -.BI "virtual \fB~QSqlField\fR ()" +.BI "virtual \fB~TQSqlField\fR ()" .br .ti -1c .BI "virtual void \fBsetValue\fR ( const QVariant & value )" @@ -60,15 +60,15 @@ QSqlField \- Manipulates the fields in SQL database tables and views .br .in -1c .SH DESCRIPTION -The QSqlField class manipulates the fields in SQL database tables and views. +The TQSqlField class manipulates the fields in SQL database tables and views. .PP -QSqlField represents the characteristics of a single column in a database table or view, such as the data type and column name. A field also contains the value of the database column, which can be viewed or changed. +TQSqlField represents the characteristics of a single column in a database table or view, such as the data type and column name. A field also contains the value of the database column, which can be viewed or changed. .PP Field data values are stored as QVariants. Using an incompatible type is not permitted. For example: .PP .nf .br - QSqlField f( "myfield", QVariant::Int ); + TQSqlField f( "myfield", QVariant::Int ); .br f.setValue( QPixmap() ); // will not work .br @@ -78,19 +78,19 @@ However, the field will attempt to cast certain data types to the field data typ .PP .nf .br - QSqlField f( "myfield", QVariant::Int ); + TQSqlField f( "myfield", QVariant::Int ); .br f.setValue( TQString("123") ); // casts TQString to int .br .fi .PP -QSqlField objects are rarely created explicitly in application code. They are usually accessed indirectly through QSqlRecord or QSqlCursor which already contain a list of fields. For example: +TQSqlField objects are rarely created explicitly in application code. They are usually accessed indirectly through TQSqlRecord or TQSqlCursor which already contain a list of fields. For example: .PP .nf .br - QSqlCursor cur( "Employee" ); // create cursor using the 'Employee' table + TQSqlCursor cur( "Employee" ); // create cursor using the 'Employee' table .br - QSqlField* f = cur.field( "name" ); // use the 'name' field + TQSqlField* f = cur.field( "name" ); // use the 'name' field .br f->setValue( "Dave" ); // set field value .br @@ -102,7 +102,7 @@ In practice we rarely need to extract a pointer to a field at all. The previous .PP .nf .br - QSqlCursor cur( "Employee" ); + TQSqlCursor cur( "Employee" ); .br cur.setValue( "name", "Dave" ); .br @@ -112,25 +112,25 @@ In practice we rarely need to extract a pointer to a field at all. The previous .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlField::QSqlField ( const TQString & fieldName = TQString::null, QVariant::Type type = QVariant::Invalid )" +.SH "TQSqlField::TQSqlField ( const TQString & fieldName = TQString::null, QVariant::Type type = QVariant::Invalid )" Constructs an empty field called \fIfieldName\fR of type \fItype\fR. -.SH "QSqlField::QSqlField ( const QSqlField & other )" +.SH "TQSqlField::TQSqlField ( const TQSqlField & other )" Constructs a copy of \fIother\fR. -.SH "QSqlField::~QSqlField ()\fC [virtual]\fR" +.SH "TQSqlField::~TQSqlField ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "void QSqlField::clear ( bool nullify = TRUE )" +.SH "void TQSqlField::clear ( bool nullify = TRUE )" Clears the value of the field. If the field is read-only, nothing happens. If \fInullify\fR is TRUE (the default), the field is set to NULL. -.SH "bool QSqlField::isNull () const" +.SH "bool TQSqlField::isNull () const" Returns TRUE if the field is currently NULL; otherwise returns FALSE. -.SH "bool QSqlField::isReadOnly () const" +.SH "bool TQSqlField::isReadOnly () const" Returns TRUE if the field's value is read only; otherwise returns FALSE. -.SH "TQString QSqlField::name () const" +.SH "TQString TQSqlField::name () const" Returns the name of the field. .PP Example: sql/overview/table4/main.cpp. -.SH "QSqlField & QSqlField::operator= ( const QSqlField & other )" +.SH "TQSqlField & TQSqlField::operator= ( const TQSqlField & other )" Sets the field equal to \fIother\fR. -.SH "bool QSqlField::operator== ( const QSqlField & other ) const" +.SH "bool TQSqlField::operator== ( const TQSqlField & other ) const" Returns TRUE if the field is equal to \fIother\fR; otherwise returns FALSE. Fields are considered equal when the following field properties are the same: .TP name() @@ -140,24 +140,24 @@ isNull() value() .TP isReadOnly() -.SH "void QSqlField::setName ( const TQString & name )\fC [virtual]\fR" +.SH "void TQSqlField::setName ( const TQString & name )\fC [virtual]\fR" Sets the name of the field to \fIname\fR. -.SH "void QSqlField::setNull ()\fC [virtual]\fR" +.SH "void TQSqlField::setNull ()\fC [virtual]\fR" Sets the field to NULL and clears the value using clear(). If the field is read-only, nothing happens. .PP See also isReadOnly() and clear(). -.SH "void QSqlField::setReadOnly ( bool readOnly )\fC [virtual]\fR" +.SH "void TQSqlField::setReadOnly ( bool readOnly )\fC [virtual]\fR" Sets the read only flag of the field's value to \fIreadOnly\fR. .PP See also setValue(). -.SH "void QSqlField::setValue ( const QVariant & value )\fC [virtual]\fR" +.SH "void TQSqlField::setValue ( const QVariant & value )\fC [virtual]\fR" Sets the value of the field to \fIvalue\fR. If the field is read-only (isReadOnly() returns TRUE), nothing happens. If the data type of \fIvalue\fR differs from the field's current data type, an attempt is made to cast it to the proper type. This preserves the data type of the field in the case of assignment, e.g. a TQString to an integer data type. For example: .PP .nf .br - QSqlCursor cur( "Employee" ); // 'Employee' table + TQSqlCursor cur( "Employee" ); // 'Employee' table .br - QSqlField* f = cur.field( "student_count" ); // an integer field + TQSqlField* f = cur.field( "student_count" ); // an integer field .br ... .br @@ -166,15 +166,15 @@ Sets the value of the field to \fIvalue\fR. If the field is read-only (isReadOnl .fi .PP See also isReadOnly(). -.SH "QVariant::Type QSqlField::type () const" +.SH "QVariant::Type TQSqlField::type () const" Returns the field's type as stored in the database. Note that the actual value might have a different type, Numerical values that are too large to store in a long int or double are usually stored as strings to prevent precision loss. -.SH "QVariant QSqlField::value () const\fC [virtual]\fR" +.SH "QVariant TQSqlField::value () const\fC [virtual]\fR" Returns the value of the field as a QVariant. .PP Example: sql/overview/table4/main.cpp. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlfield.html +.BR http://doc.trolltech.com/tqsqlfield.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlfieldinfo.3qt b/doc/man/man3/tqsqlfieldinfo.3qt index fdb6f9066..fb0333b7c 100644 --- a/doc/man/man3/tqsqlfieldinfo.3qt +++ b/doc/man/man3/tqsqlfieldinfo.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlFieldInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlFieldInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlFieldInfo \- Stores meta data associated with a SQL field +TQSqlFieldInfo \- Stores meta data associated with a SQL field .SH SYNOPSIS -\fC#include <ntqsqlfield.h>\fR +\fC#include <tqsqlfield.h>\fR .PP .SS "Public Members" .in +1c @@ -17,22 +17,22 @@ QSqlFieldInfo \- Stores meta data associated with a SQL field .BI "\fBQSqlFieldInfo\fR ( const TQString & name = TQString::null, QVariant::Type typ = QVariant::Invalid, int required = -1, int len = -1, int prec = -1, const QVariant & defValue = QVariant ( ), int typeID = 0, bool generated = TRUE, bool trim = FALSE, bool calculated = FALSE )" .br .ti -1c -.BI "\fBQSqlFieldInfo\fR ( const QSqlFieldInfo & other )" +.BI "\fBQSqlFieldInfo\fR ( const TQSqlFieldInfo & other )" .br .ti -1c -.BI "\fBQSqlFieldInfo\fR ( const QSqlField & other, bool generated = TRUE )" +.BI "\fBQSqlFieldInfo\fR ( const TQSqlField & other, bool generated = TRUE )" .br .ti -1c -.BI "virtual \fB~QSqlFieldInfo\fR ()" +.BI "virtual \fB~TQSqlFieldInfo\fR ()" .br .ti -1c -.BI "QSqlFieldInfo & \fBoperator=\fR ( const QSqlFieldInfo & other )" +.BI "TQSqlFieldInfo & \fBoperator=\fR ( const TQSqlFieldInfo & other )" .br .ti -1c -.BI "bool \fBoperator==\fR ( const QSqlFieldInfo & f ) const" +.BI "bool \fBoperator==\fR ( const TQSqlFieldInfo & f ) const" .br .ti -1c -.BI "QSqlField \fBtoField\fR () const" +.BI "TQSqlField \fBtoField\fR () const" .br .ti -1c .BI "int \fBisRequired\fR () const" @@ -75,82 +75,82 @@ QSqlFieldInfo \- Stores meta data associated with a SQL field .br .in -1c .SH DESCRIPTION -The QSqlFieldInfo class stores meta data associated with a SQL field. +The TQSqlFieldInfo class stores meta data associated with a SQL field. .PP -QSqlFieldInfo objects only store meta data; field values are stored in QSqlField objects. +TQSqlFieldInfo objects only store meta data; field values are stored in TQSqlField objects. .PP All values must be set in the constructor, and may be retrieved using isRequired(), type(), length(), precision(), defaultValue(), name(), isGenerated() and typeID(). .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlFieldInfo::QSqlFieldInfo ( const TQString & name = TQString::null, QVariant::Type typ = QVariant::Invalid, int required = -1, int len = -1, int prec = -1, const QVariant & defValue = QVariant ( ), int typeID = 0, bool generated = TRUE, bool trim = FALSE, bool calculated = FALSE )" -Constructs a QSqlFieldInfo with the following parameters: <center>.nf +.SH "TQSqlFieldInfo::TQSqlFieldInfo ( const TQString & name = TQString::null, QVariant::Type typ = QVariant::Invalid, int required = -1, int len = -1, int prec = -1, const QVariant & defValue = QVariant ( ), int typeID = 0, bool generated = TRUE, bool trim = FALSE, bool calculated = FALSE )" +Constructs a TQSqlFieldInfo with the following parameters: <center>.nf .TS -l - l. \fIname\fR the name of the field. \fItyp\fR the field's type in a QVariant. \fIrequired\fR greater than 0 if the field is required, 0 if its value can be NULL and less than 0 if it cannot be determined whether the field is required or not. \fIlen\fR the length of the field. Note that for non-character types some databases return either the length in bytes or the number of digits. -1 signifies that the length cannot be determined. \fIprec\fR the precision of the field, or -1 if the field has no precision or it cannot be determined. \fIdefValue\fR the default value that is inserted into the table if none is specified by the user. QVariant() if there is no default value or it cannot be determined. \fItypeID\fR the internal typeID of the database system (only useful for low-level programming). 0 if unknown. \fIgenerated\fR TRUE indicates that this field should be included in auto-generated SQL statments, e.g. in QSqlCursor. \fItrim\fR TRUE indicates that widgets should remove trailing whitespace from character fields. This does not affect the field value but only its representation inside widgets. \fIcalculated\fR +l - l. \fIname\fR the name of the field. \fItyp\fR the field's type in a QVariant. \fIrequired\fR greater than 0 if the field is required, 0 if its value can be NULL and less than 0 if it cannot be determined whether the field is required or not. \fIlen\fR the length of the field. Note that for non-character types some databases return either the length in bytes or the number of digits. -1 signifies that the length cannot be determined. \fIprec\fR the precision of the field, or -1 if the field has no precision or it cannot be determined. \fIdefValue\fR the default value that is inserted into the table if none is specified by the user. QVariant() if there is no default value or it cannot be determined. \fItypeID\fR the internal typeID of the database system (only useful for low-level programming). 0 if unknown. \fIgenerated\fR TRUE indicates that this field should be included in auto-generated SQL statments, e.g. in TQSqlCursor. \fItrim\fR TRUE indicates that widgets should remove trailing whitespace from character fields. This does not affect the field value but only its representation inside widgets. \fIcalculated\fR .TE .fi </center> -.SH "QSqlFieldInfo::QSqlFieldInfo ( const QSqlFieldInfo & other )" +.SH "TQSqlFieldInfo::TQSqlFieldInfo ( const TQSqlFieldInfo & other )" Constructs a copy of \fIother\fR. -.SH "QSqlFieldInfo::QSqlFieldInfo ( const QSqlField & other, bool generated = TRUE )" -Creates a QSqlFieldInfo object with the type and the name of the QSqlField \fIother\fR. If \fIgenerated\fR is TRUE this field will be included in auto-generated SQL statments, e.g. in QSqlCursor. -.SH "QSqlFieldInfo::~QSqlFieldInfo ()\fC [virtual]\fR" +.SH "TQSqlFieldInfo::TQSqlFieldInfo ( const TQSqlField & other, bool generated = TRUE )" +Creates a TQSqlFieldInfo object with the type and the name of the TQSqlField \fIother\fR. If \fIgenerated\fR is TRUE this field will be included in auto-generated SQL statments, e.g. in TQSqlCursor. +.SH "TQSqlFieldInfo::~TQSqlFieldInfo ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "QVariant QSqlFieldInfo::defaultValue () const" +.SH "QVariant TQSqlFieldInfo::defaultValue () const" Returns the field's default value or an empty QVariant if the field has no default value or the value couldn't be determined. The default value is the value inserted in the database when it is not explicitly specified by the user. -.SH "bool QSqlFieldInfo::isCalculated () const" +.SH "bool TQSqlFieldInfo::isCalculated () const" Returns TRUE if the field is calculated; otherwise returns FALSE. .PP See also setCalculated(). -.SH "bool QSqlFieldInfo::isGenerated () const" -Returns TRUE if the field should be included in auto-generated SQL statments, e.g. in QSqlCursor; otherwise returns FALSE. +.SH "bool TQSqlFieldInfo::isGenerated () const" +Returns TRUE if the field should be included in auto-generated SQL statments, e.g. in TQSqlCursor; otherwise returns FALSE. .PP See also setGenerated(). -.SH "int QSqlFieldInfo::isRequired () const" +.SH "int TQSqlFieldInfo::isRequired () const" Returns a value greater than 0 if the field is required (NULL values are not allowed), 0 if it isn't required (NULL values are allowed) or less than 0 if it cannot be determined whether the field is required or not. -.SH "bool QSqlFieldInfo::isTrim () const" +.SH "bool TQSqlFieldInfo::isTrim () const" Returns TRUE if trailing whitespace should be removed from character fields; otherwise returns FALSE. .PP See also setTrim(). -.SH "int QSqlFieldInfo::length () const" +.SH "int TQSqlFieldInfo::length () const" Returns the field's length. For fields storing text the return value is the maximum number of characters the field can hold. For non-character fields some database systems return the number of bytes needed or the number of digits allowed. If the length cannot be determined -1 is returned. -.SH "TQString QSqlFieldInfo::name () const" +.SH "TQString TQSqlFieldInfo::name () const" Returns the name of the field in the SQL table. .PP Examples: .)l sql/overview/subclass3/main.cpp and sql/overview/subclass4/main.cpp. -.SH "QSqlFieldInfo & QSqlFieldInfo::operator= ( const QSqlFieldInfo & other )" +.SH "TQSqlFieldInfo & TQSqlFieldInfo::operator= ( const TQSqlFieldInfo & other )" Assigns \fIother\fR to this field info and returns a reference to it. -.SH "bool QSqlFieldInfo::operator== ( const QSqlFieldInfo & f ) const" +.SH "bool TQSqlFieldInfo::operator== ( const TQSqlFieldInfo & f ) const" Returns TRUE if this fieldinfo is equal to \fIf\fR; otherwise returns FALSE. .PP Two field infos are considered equal if all their attributes match. -.SH "int QSqlFieldInfo::precision () const" +.SH "int TQSqlFieldInfo::precision () const" Returns the field's precision or -1 if the field has no precision or it cannot be determined. -.SH "void QSqlFieldInfo::setCalculated ( bool calc )\fC [virtual]\fR" -\fIcalc\fR set to TRUE indicates that this field is a calculated field. The value of calculated fields can by modified by subclassing QSqlCursor and overriding QSqlCursor::calculateField(). +.SH "void TQSqlFieldInfo::setCalculated ( bool calc )\fC [virtual]\fR" +\fIcalc\fR set to TRUE indicates that this field is a calculated field. The value of calculated fields can by modified by subclassing TQSqlCursor and overriding TQSqlCursor::calculateField(). .PP See also isCalculated(). -.SH "void QSqlFieldInfo::setGenerated ( bool gen )\fC [virtual]\fR" -\fIgen\fR set to FALSE indicates that this field should not appear in auto-generated SQL statements (for example in QSqlCursor). +.SH "void TQSqlFieldInfo::setGenerated ( bool gen )\fC [virtual]\fR" +\fIgen\fR set to FALSE indicates that this field should not appear in auto-generated SQL statements (for example in TQSqlCursor). .PP See also isGenerated(). -.SH "void QSqlFieldInfo::setTrim ( bool trim )\fC [virtual]\fR" +.SH "void TQSqlFieldInfo::setTrim ( bool trim )\fC [virtual]\fR" If \fItrim\fR is TRUE widgets should remove trailing whitespace from character fields. This does not affect the field value but only its representation inside widgets. .PP See also isTrim(). -.SH "QSqlField QSqlFieldInfo::toField () const" -Returns an empty QSqlField based on the information in this QSqlFieldInfo. -.SH "QVariant::Type QSqlFieldInfo::type () const" +.SH "TQSqlField TQSqlFieldInfo::toField () const" +Returns an empty TQSqlField based on the information in this TQSqlFieldInfo. +.SH "QVariant::Type TQSqlFieldInfo::type () const" Returns the field's type or QVariant::Invalid if the type is unknown. -.SH "int QSqlFieldInfo::typeID () const" +.SH "int TQSqlFieldInfo::typeID () const" Returns the internal type identifier as returned from the database system. The return value is 0 if the type is unknown. .PP \fBWarning:\fR This information is only useful for low-level database programming and is \fInot\fR database independent. .SH "SEE ALSO" -.BR http://doc.trolltech.com/qsqlfieldinfo.html +.BR http://doc.trolltech.com/tqsqlfieldinfo.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlform.3qt b/doc/man/man3/tqsqlform.3qt index aeaa3befb..3af3402ea 100644 --- a/doc/man/man3/tqsqlform.3qt +++ b/doc/man/man3/tqsqlform.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlForm 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlForm 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlForm \- Creates and manages data entry forms tied to SQL databases +TQSqlForm \- Creates and manages data entry forms tied to SQL databases .SH SYNOPSIS -\fC#include <ntqsqlform.h>\fR +\fC#include <tqsqlform.h>\fR .PP Inherits TQObject. .PP @@ -19,7 +19,7 @@ Inherits TQObject. .BI "\fBQSqlForm\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QSqlForm\fR ()" +.BI "\fB~TQSqlForm\fR ()" .br .ti -1c .BI "virtual void \fBinsert\fR ( TQWidget * widget, const TQString & field )" @@ -34,16 +34,16 @@ Inherits TQObject. .BI "TQWidget * \fBwidget\fR ( uint i ) const" .br .ti -1c -.BI "QSqlField * \fBwidgetToField\fR ( TQWidget * widget ) const" +.BI "TQSqlField * \fBwidgetToField\fR ( TQWidget * widget ) const" .br .ti -1c -.BI "TQWidget * \fBfieldToWidget\fR ( QSqlField * field ) const" +.BI "TQWidget * \fBfieldToWidget\fR ( TQSqlField * field ) const" .br .ti -1c -.BI "void \fBinstallPropertyMap\fR ( QSqlPropertyMap * pmap )" +.BI "void \fBinstallPropertyMap\fR ( TQSqlPropertyMap * pmap )" .br .ti -1c -.BI "virtual void \fBsetRecord\fR ( QSqlRecord * buf )" +.BI "virtual void \fBsetRecord\fR ( TQSqlRecord * buf )" .br .in -1c .SS "Public Slots" @@ -70,22 +70,22 @@ Inherits TQObject. .SS "Protected Members" .in +1c .ti -1c -.BI "virtual void \fBinsert\fR ( TQWidget * widget, QSqlField * field )" +.BI "virtual void \fBinsert\fR ( TQWidget * widget, TQSqlField * field )" .br .ti -1c .BI "virtual void \fBremove\fR ( TQWidget * widget )" .br .in -1c .SH DESCRIPTION -The QSqlForm class creates and manages data entry forms tied to SQL databases. +The TQSqlForm class creates and manages data entry forms tied to SQL databases. .PP -Typical use of a QSqlForm consists of the following steps: +Typical use of a TQSqlForm consists of the following steps: .TP Create the widgets you want to appear in the form. .TP Create a cursor and navigate to the record to be edited. .TP -Create the QSqlForm. +Create the TQSqlForm. .TP Set the form's record buffer to the cursor's update buffer. .TP @@ -97,7 +97,7 @@ Display the form and let the user edit values etc. .TP Use writeFields() to update the database's field values with the values in the editor widgets. .PP -Note that a QSqlForm does not access the database directly, but most often via QSqlFields which are part of a QSqlCursor. A QSqlCursor::insert(), QSqlCursor::update() or QSqlCursor::del() call is needed to actually write values to the database. +Note that a TQSqlForm does not access the database directly, but most often via TQSqlFields which are part of a TQSqlCursor. A TQSqlCursor::insert(), TQSqlCursor::update() or TQSqlCursor::del() call is needed to actually write values to the database. .PP Some sample code to initialize a form successfully: .PP @@ -105,9 +105,9 @@ Some sample code to initialize a form successfully: .br QLineEdit myEditor( this ); .br - QSqlForm myForm( this ); + TQSqlForm myForm( this ); .br - QSqlCursor myCursor( "mytable" ); + TQSqlCursor myCursor( "mytable" ); .br .br // Execute a query to make the cursor valid @@ -150,76 +150,76 @@ Some sample code to initialize a form successfully: .br .fi .PP -If you want to use custom editors for displaying and editing data fields, you must install a custom QSqlPropertyMap. The form uses this object to get or set the value of a widget. +If you want to use custom editors for displaying and editing data fields, you must install a custom TQSqlPropertyMap. The form uses this object to get or set the value of a widget. .PP Note that TQt Designer provides a visual means of creating data-aware forms. .PP -See also installPropertyMap(), QSqlPropertyMap, and Database Classes. +See also installPropertyMap(), TQSqlPropertyMap, and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlForm::QSqlForm ( TQObject * parent = 0, const char * name = 0 )" -Constructs a QSqlForm with parent \fIparent\fR and called \fIname\fR. -.SH "QSqlForm::~QSqlForm ()" +.SH "TQSqlForm::TQSqlForm ( TQObject * parent = 0, const char * name = 0 )" +Constructs a TQSqlForm with parent \fIparent\fR and called \fIname\fR. +.SH "TQSqlForm::~TQSqlForm ()" Destroys the object and frees any allocated resources. -.SH "void QSqlForm::clear ()\fC [virtual slot]\fR" +.SH "void TQSqlForm::clear ()\fC [virtual slot]\fR" Removes every widget, and the fields they're mapped to, from the form. -.SH "void QSqlForm::clearValues ( bool nullify = FALSE )\fC [virtual slot]\fR" +.SH "void TQSqlForm::clearValues ( bool nullify = FALSE )\fC [virtual slot]\fR" Clears the values in all the widgets, and the fields they are mapped to, in the form. If \fInullify\fR is TRUE (the default is FALSE), each field is also set to NULL. -.SH "uint QSqlForm::count () const" +.SH "uint TQSqlForm::count () const" Returns the number of widgets in the form. -.SH "TQWidget * QSqlForm::fieldToWidget ( QSqlField * field ) const" +.SH "TQWidget * TQSqlForm::fieldToWidget ( TQSqlField * field ) const" Returns the widget that field \fIfield\fR is mapped to. -.SH "void QSqlForm::insert ( TQWidget * widget, const TQString & field )\fC [virtual]\fR" +.SH "void TQSqlForm::insert ( TQWidget * widget, const TQString & field )\fC [virtual]\fR" Inserts a \fIwidget\fR, and the name of the \fIfield\fR it is to be mapped to, into the form. To actually associate inserted widgets with an edit buffer, use setRecord(). .PP See also setRecord(). .PP Examples: .)l sql/overview/form1/main.cpp and sql/overview/form2/main.cpp. -.SH "void QSqlForm::insert ( TQWidget * widget, QSqlField * field )\fC [virtual protected]\fR" +.SH "void TQSqlForm::insert ( TQWidget * widget, TQSqlField * field )\fC [virtual protected]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Inserts a \fIwidget\fR, and the \fIfield\fR it is to be mapped to, into the form. -.SH "void QSqlForm::installPropertyMap ( QSqlPropertyMap * pmap )" -Installs a custom QSqlPropertyMap. This is useful if you plan to create your own custom editor widgets. +.SH "void TQSqlForm::installPropertyMap ( TQSqlPropertyMap * pmap )" +Installs a custom TQSqlPropertyMap. This is useful if you plan to create your own custom editor widgets. .PP -QSqlForm takes ownership of \fIpmap\fR, so \fIpmap\fR is deleted when QSqlForm goes out of scope. +TQSqlForm takes ownership of \fIpmap\fR, so \fIpmap\fR is deleted when TQSqlForm goes out of scope. .PP -See also QDataTable::installEditorFactory(). +See also TQDataTable::installEditorFactory(). .PP Example: sql/overview/custom1/main.cpp. -.SH "void QSqlForm::readField ( TQWidget * widget )\fC [virtual slot]\fR" +.SH "void TQSqlForm::readField ( TQWidget * widget )\fC [virtual slot]\fR" Updates the widget \fIwidget\fR with the value from the SQL field it is mapped to. Nothing happens if no SQL field is mapped to the \fIwidget\fR. -.SH "void QSqlForm::readFields ()\fC [virtual slot]\fR" +.SH "void TQSqlForm::readFields ()\fC [virtual slot]\fR" Updates the widgets in the form with current values from the SQL fields they are mapped to. .PP Examples: .)l sql/overview/form1/main.cpp and sql/overview/form2/main.cpp. -.SH "void QSqlForm::remove ( TQWidget * widget )\fC [virtual protected]\fR" +.SH "void TQSqlForm::remove ( TQWidget * widget )\fC [virtual protected]\fR" Removes a \fIwidget\fR, and hence the field it's mapped to, from the form. -.SH "void QSqlForm::remove ( const TQString & field )\fC [virtual]\fR" +.SH "void TQSqlForm::remove ( const TQString & field )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Removes \fIfield\fR from the form. -.SH "void QSqlForm::setRecord ( QSqlRecord * buf )\fC [virtual]\fR" +.SH "void TQSqlForm::setRecord ( TQSqlRecord * buf )\fC [virtual]\fR" Sets \fIbuf\fR as the record buffer for the form. To force the display of the data from \fIbuf\fR, use readFields(). .PP See also readFields() and writeFields(). .PP Examples: .)l sql/overview/custom1/main.cpp, sql/overview/form1/main.cpp, and sql/overview/form2/main.cpp. -.SH "TQWidget * QSqlForm::widget ( uint i ) const" +.SH "TQWidget * TQSqlForm::widget ( uint i ) const" Returns the \fIi\fR-th widget in the form. Useful for traversing the widgets in the form. -.SH "QSqlField * QSqlForm::widgetToField ( TQWidget * widget ) const" +.SH "TQSqlField * TQSqlForm::widgetToField ( TQWidget * widget ) const" Returns the SQL field that widget \fIwidget\fR is mapped to. -.SH "void QSqlForm::writeField ( TQWidget * widget )\fC [virtual slot]\fR" +.SH "void TQSqlForm::writeField ( TQWidget * widget )\fC [virtual slot]\fR" Updates the SQL field with the value from the \fIwidget\fR it is mapped to. Nothing happens if no SQL field is mapped to the \fIwidget\fR. -.SH "void QSqlForm::writeFields ()\fC [virtual slot]\fR" -Updates the SQL fields with values from the widgets they are mapped to. To actually update the database with the contents of the record buffer, use QSqlCursor::insert(), QSqlCursor::update() or QSqlCursor::del() as appropriate. +.SH "void TQSqlForm::writeFields ()\fC [virtual slot]\fR" +Updates the SQL fields with values from the widgets they are mapped to. To actually update the database with the contents of the record buffer, use TQSqlCursor::insert(), TQSqlCursor::update() or TQSqlCursor::del() as appropriate. .PP Example: sql/overview/form2/main.cpp. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlform.html +.BR http://doc.trolltech.com/tqsqlform.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlindex.3qt b/doc/man/man3/tqsqlindex.3qt index 5c88ffa3f..b226b887a 100644 --- a/doc/man/man3/tqsqlindex.3qt +++ b/doc/man/man3/tqsqlindex.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlIndex 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlIndex 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,11 +7,11 @@ .ad l .nh .SH NAME -QSqlIndex \- Functions to manipulate and describe QSqlCursor and QSqlDatabase indexes +TQSqlIndex \- Functions to manipulate and describe TQSqlCursor and TQSqlDatabase indexes .SH SYNOPSIS -\fC#include <ntqsqlindex.h>\fR +\fC#include <tqsqlindex.h>\fR .PP -Inherits QSqlRecord. +Inherits TQSqlRecord. .PP .SS "Public Members" .in +1c @@ -19,13 +19,13 @@ Inherits QSqlRecord. .BI "\fBQSqlIndex\fR ( const TQString & cursorname = TQString::null, const TQString & name = TQString::null )" .br .ti -1c -.BI "\fBQSqlIndex\fR ( const QSqlIndex & other )" +.BI "\fBQSqlIndex\fR ( const TQSqlIndex & other )" .br .ti -1c -.BI "\fB~QSqlIndex\fR ()" +.BI "\fB~TQSqlIndex\fR ()" .br .ti -1c -.BI "QSqlIndex & \fBoperator=\fR ( const QSqlIndex & other )" +.BI "TQSqlIndex & \fBoperator=\fR ( const TQSqlIndex & other )" .br .ti -1c .BI "virtual void \fBsetCursorName\fR ( const TQString & cursorName )" @@ -40,10 +40,10 @@ Inherits QSqlRecord. .BI "TQString \fBname\fR () const" .br .ti -1c -.BI "virtual void \fBappend\fR ( const QSqlField & field )" +.BI "virtual void \fBappend\fR ( const TQSqlField & field )" .br .ti -1c -.BI "virtual void \fBappend\fR ( const QSqlField & field, bool desc )" +.BI "virtual void \fBappend\fR ( const TQSqlField & field, bool desc )" .br .ti -1c .BI "bool \fBisDescending\fR ( int i ) const" @@ -55,53 +55,53 @@ Inherits QSqlRecord. .SS "Static Public Members" .in +1c .ti -1c -.BI "QSqlIndex \fBfromStringList\fR ( const QStringList & l, const QSqlCursor * cursor )" +.BI "TQSqlIndex \fBfromStringList\fR ( const QStringList & l, const TQSqlCursor * cursor )" .br .in -1c .SH DESCRIPTION -The QSqlIndex class provides functions to manipulate and describe QSqlCursor and QSqlDatabase indexes. +The TQSqlIndex class provides functions to manipulate and describe TQSqlCursor and TQSqlDatabase indexes. .PP -This class is used to describe and manipulate QSqlCursor and QSqlDatabase indexes. An index refers to a single table or view in a database. Information about the fields that comprise the index can be used to generate SQL statements, or to affect the behavior of a QSqlCursor object. +This class is used to describe and manipulate TQSqlCursor and TQSqlDatabase indexes. An index refers to a single table or view in a database. Information about the fields that comprise the index can be used to generate SQL statements, or to affect the behavior of a TQSqlCursor object. .PP -Normally, QSqlIndex objects are created by QSqlDatabase or QSqlCursor. +Normally, TQSqlIndex objects are created by TQSqlDatabase or TQSqlCursor. .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlIndex::QSqlIndex ( const TQString & cursorname = TQString::null, const TQString & name = TQString::null )" +.SH "TQSqlIndex::TQSqlIndex ( const TQString & cursorname = TQString::null, const TQString & name = TQString::null )" Constructs an empty index using the cursor name \fIcursorname\fR and index name \fIname\fR. -.SH "QSqlIndex::QSqlIndex ( const QSqlIndex & other )" +.SH "TQSqlIndex::TQSqlIndex ( const TQSqlIndex & other )" Constructs a copy of \fIother\fR. -.SH "QSqlIndex::~QSqlIndex ()" +.SH "TQSqlIndex::~TQSqlIndex ()" Destroys the object and frees any allocated resources. -.SH "void QSqlIndex::append ( const QSqlField & field )\fC [virtual]\fR" +.SH "void TQSqlIndex::append ( const TQSqlField & field )\fC [virtual]\fR" Appends the field \fIfield\fR to the list of indexed fields. The field is appended with an ascending sort order. .PP -Reimplemented from QSqlRecord. -.SH "void QSqlIndex::append ( const QSqlField & field, bool desc )\fC [virtual]\fR" +Reimplemented from TQSqlRecord. +.SH "void TQSqlIndex::append ( const TQSqlField & field, bool desc )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Appends the field \fIfield\fR to the list of indexed fields. The field is appended with an ascending sort order, unless \fIdesc\fR is TRUE. -.SH "TQString QSqlIndex::cursorName () const" +.SH "TQString TQSqlIndex::cursorName () const" Returns the name of the cursor which the index is associated with. -.SH "QSqlIndex QSqlIndex::fromStringList ( const QStringList & l, const QSqlCursor * cursor )\fC [static]\fR" +.SH "TQSqlIndex TQSqlIndex::fromStringList ( const QStringList & l, const TQSqlCursor * cursor )\fC [static]\fR" Returns an index based on the field descriptions in \fIl\fR and the cursor \fIcursor\fR. The field descriptions should be in the same format that toStringList() produces, for example, a surname field in the people table might be in one of these forms: "surname"," surname DESC" or "people.surname ASC". .PP See also toStringList(). -.SH "bool QSqlIndex::isDescending ( int i ) const" +.SH "bool TQSqlIndex::isDescending ( int i ) const" Returns TRUE if field \fIi\fR in the index is sorted in descending order; otherwise returns FALSE. -.SH "TQString QSqlIndex::name () const" +.SH "TQString TQSqlIndex::name () const" Returns the name of the index. -.SH "QSqlIndex & QSqlIndex::operator= ( const QSqlIndex & other )" +.SH "TQSqlIndex & TQSqlIndex::operator= ( const TQSqlIndex & other )" Sets the index equal to \fIother\fR. -.SH "void QSqlIndex::setCursorName ( const TQString & cursorName )\fC [virtual]\fR" +.SH "void TQSqlIndex::setCursorName ( const TQString & cursorName )\fC [virtual]\fR" Sets the name of the cursor that the index is associated with to \fIcursorName\fR. -.SH "void QSqlIndex::setDescending ( int i, bool desc )\fC [virtual]\fR" +.SH "void TQSqlIndex::setDescending ( int i, bool desc )\fC [virtual]\fR" If \fIdesc\fR is TRUE, field \fIi\fR is sorted in descending order. Otherwise, field \fIi\fR is sorted in ascending order (the default). If the field does not exist, nothing happens. -.SH "void QSqlIndex::setName ( const TQString & name )\fC [virtual]\fR" +.SH "void TQSqlIndex::setName ( const TQString & name )\fC [virtual]\fR" Sets the name of the index to \fIname\fR. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlindex.html +.BR http://doc.trolltech.com/tqsqlindex.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlpropertymap.3qt b/doc/man/man3/tqsqlpropertymap.3qt index 3857f1303..ec88742a6 100644 --- a/doc/man/man3/tqsqlpropertymap.3qt +++ b/doc/man/man3/tqsqlpropertymap.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlPropertyMap 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlPropertyMap 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlPropertyMap \- Used to map widgets to SQL fields +TQSqlPropertyMap \- Used to map widgets to SQL fields .SH SYNOPSIS -\fC#include <ntqsqlpropertymap.h>\fR +\fC#include <tqsqlpropertymap.h>\fR .PP .SS "Public Members" .in +1c @@ -17,7 +17,7 @@ QSqlPropertyMap \- Used to map widgets to SQL fields .BI "\fBQSqlPropertyMap\fR ()" .br .ti -1c -.BI "virtual \fB~QSqlPropertyMap\fR ()" +.BI "virtual \fB~TQSqlPropertyMap\fR ()" .br .ti -1c .BI "QVariant \fBproperty\fR ( TQWidget * widget )" @@ -35,35 +35,35 @@ QSqlPropertyMap \- Used to map widgets to SQL fields .SS "Static Public Members" .in +1c .ti -1c -.BI "QSqlPropertyMap * \fBdefaultMap\fR ()" +.BI "TQSqlPropertyMap * \fBdefaultMap\fR ()" .br .ti -1c -.BI "void \fBinstallDefaultMap\fR ( QSqlPropertyMap * map )" +.BI "void \fBinstallDefaultMap\fR ( TQSqlPropertyMap * map )" .br .in -1c .SH DESCRIPTION -The QSqlPropertyMap class is used to map widgets to SQL fields. +The TQSqlPropertyMap class is used to map widgets to SQL fields. .PP The SQL module uses TQt object properties to insert and extract values from editor widgets. .PP This class is used to map editors to SQL fields. This works by associating SQL editor class names to the properties used to insert and extract values to/from the editor. .PP -For example, a QLineEdit can be used to edit text strings and other data types in QDataTables or QSqlForms. Several properties are defined in QLineEdit, but only the \fItext\fR property is used to insert and extract text from a QLineEdit. Both QDataTable and QSqlForm use the global QSqlPropertyMap for inserting and extracting values to and from an editor widget. The global property map defines several common widgets and properties that are suitable for many applications. You can add and remove widget properties to suit your specific needs. +For example, a QLineEdit can be used to edit text strings and other data types in TQDataTables or TQSqlForms. Several properties are defined in QLineEdit, but only the \fItext\fR property is used to insert and extract text from a QLineEdit. Both TQDataTable and TQSqlForm use the global TQSqlPropertyMap for inserting and extracting values to and from an editor widget. The global property map defines several common widgets and properties that are suitable for many applications. You can add and remove widget properties to suit your specific needs. .PP -If you want to use custom editors with your QDataTable or QSqlForm, you must install your own QSqlPropertyMap for that table or form. Example: +If you want to use custom editors with your TQDataTable or TQSqlForm, you must install your own TQSqlPropertyMap for that table or form. Example: .PP .nf .br - QSqlPropertyMap *myMap = new QSqlPropertyMap(); + TQSqlPropertyMap *myMap = new TQSqlPropertyMap(); .br - QSqlForm *myForm = new QSqlForm( this ); + TQSqlForm *myForm = new TQSqlForm( this ); .br MyEditor myEditor( this ); .br .br - // Set the QSqlForm's record buffer to the update buffer of + // Set the TQSqlForm's record buffer to the update buffer of .br - // a pre-existing QSqlCursor called 'cur'. + // a pre-existing TQSqlCursor called 'cur'. .br myForm->setRecord( cur->primeUpdate() ); .br @@ -101,25 +101,25 @@ If you want to use custom editors with your QDataTable or QSqlForm, you must ins .br .fi .PP -You can also replace the global QSqlPropertyMap that is used by default. (Bear in mind that QSqlPropertyMap takes ownership of the new default map.) +You can also replace the global TQSqlPropertyMap that is used by default. (Bear in mind that TQSqlPropertyMap takes ownership of the new default map.) .PP .nf .br - QSqlPropertyMap *myMap = new QSqlPropertyMap; + TQSqlPropertyMap *myMap = new TQSqlPropertyMap; .br .br myMap->insert( "MyEditor", "content" ); .br - QSqlPropertyMap::installDefaultMap( myMap ); + TQSqlPropertyMap::installDefaultMap( myMap ); .br ... .br .fi .PP -See also QDataTable, QSqlForm, QSqlEditorFactory, and Database Classes. +See also TQDataTable, TQSqlForm, TQSqlEditorFactory, and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlPropertyMap::QSqlPropertyMap ()" -Constructs a QSqlPropertyMap. +.SH "TQSqlPropertyMap::TQSqlPropertyMap ()" +Constructs a TQSqlPropertyMap. .PP The default property mappings used by TQt widgets are: <center>.nf .TS @@ -127,27 +127,27 @@ l - l. Widgets Property QCheckBox, QRadioButton checked QComboBox, QListBox curr .TE .fi </center> -.SH "QSqlPropertyMap::~QSqlPropertyMap ()\fC [virtual]\fR" -Destroys the QSqlPropertyMap. +.SH "TQSqlPropertyMap::~TQSqlPropertyMap ()\fC [virtual]\fR" +Destroys the TQSqlPropertyMap. .PP -Note that if the QSqlPropertyMap is installed with installPropertyMap() the object it was installed into, e.g. the QSqlForm, takes ownership and will delete the QSqlPropertyMap when necessary. -.SH "QSqlPropertyMap * QSqlPropertyMap::defaultMap ()\fC [static]\fR" -Returns the application global QSqlPropertyMap. -.SH "void QSqlPropertyMap::insert ( const TQString & classname, const TQString & property )" +Note that if the TQSqlPropertyMap is installed with installPropertyMap() the object it was installed into, e.g. the TQSqlForm, takes ownership and will delete the TQSqlPropertyMap when necessary. +.SH "TQSqlPropertyMap * TQSqlPropertyMap::defaultMap ()\fC [static]\fR" +Returns the application global TQSqlPropertyMap. +.SH "void TQSqlPropertyMap::insert ( const TQString & classname, const TQString & property )" Insert a new classname/property pair, which is used for custom SQL field editors. There \fImust\fR be a \fCTQ_PROPERTY\fR clause in the \fIclassname\fR class declaration for the \fIproperty\fR. .PP Example: sql/overview/custom1/main.cpp. -.SH "void QSqlPropertyMap::installDefaultMap ( QSqlPropertyMap * map )\fC [static]\fR" -Replaces the global default property map with \fImap\fR. All QDataTable and QSqlForm instantiations will use this new map for inserting and extracting values to and from editors. \fIQSqlPropertyMap takes ownership of \a map, and destroys it when it is no longer needed.\fR -.SH "QVariant QSqlPropertyMap::property ( TQWidget * widget )" +.SH "void TQSqlPropertyMap::installDefaultMap ( TQSqlPropertyMap * map )\fC [static]\fR" +Replaces the global default property map with \fImap\fR. All TQDataTable and TQSqlForm instantiations will use this new map for inserting and extracting values to and from editors. \fIQSqlPropertyMap takes ownership of \a map, and destroys it when it is no longer needed.\fR +.SH "QVariant TQSqlPropertyMap::property ( TQWidget * widget )" Returns the mapped property of \fIwidget\fR as a QVariant. -.SH "void QSqlPropertyMap::remove ( const TQString & classname )" +.SH "void TQSqlPropertyMap::remove ( const TQString & classname )" Removes \fIclassname\fR from the map. -.SH "void QSqlPropertyMap::setProperty ( TQWidget * widget, const QVariant & value )\fC [virtual]\fR" +.SH "void TQSqlPropertyMap::setProperty ( TQWidget * widget, const QVariant & value )\fC [virtual]\fR" Sets the property of \fIwidget\fR to \fIvalue\fR. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlpropertymap.html +.BR http://doc.trolltech.com/tqsqlpropertymap.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlquery.3qt b/doc/man/man3/tqsqlquery.3qt index 682b1639a..85fa5f032 100644 --- a/doc/man/man3/tqsqlquery.3qt +++ b/doc/man/man3/tqsqlquery.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlQuery 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlQuery 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,31 +7,31 @@ .ad l .nh .SH NAME -QSqlQuery \- Means of executing and manipulating SQL statements +TQSqlQuery \- Means of executing and manipulating SQL statements .SH SYNOPSIS -\fC#include <ntqsqlquery.h>\fR +\fC#include <tqsqlquery.h>\fR .PP -Inherited by QSqlCursor. +Inherited by TQSqlCursor. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQSqlQuery\fR ( QSqlResult * r )" +.BI "\fBQSqlQuery\fR ( TQSqlResult * r )" .br .ti -1c -.BI "\fBQSqlQuery\fR ( const TQString & query = TQString::null, QSqlDatabase * db = 0 )" +.BI "\fBQSqlQuery\fR ( const TQString & query = TQString::null, TQSqlDatabase * db = 0 )" .br .ti -1c -.BI "explicit \fBQSqlQuery\fR ( QSqlDatabase * db )" +.BI "explicit \fBQSqlQuery\fR ( TQSqlDatabase * db )" .br .ti -1c -.BI "\fBQSqlQuery\fR ( const QSqlQuery & other )" +.BI "\fBQSqlQuery\fR ( const TQSqlQuery & other )" .br .ti -1c -.BI "QSqlQuery & \fBoperator=\fR ( const QSqlQuery & other )" +.BI "TQSqlQuery & \fBoperator=\fR ( const TQSqlQuery & other )" .br .ti -1c -.BI "virtual \fB~QSqlQuery\fR ()" +.BI "virtual \fB~TQSqlQuery\fR ()" .br .ti -1c .BI "bool \fBisValid\fR () const" @@ -52,7 +52,7 @@ Inherited by QSqlCursor. .BI "int \fBnumRowsAffected\fR () const" .br .ti -1c -.BI "QSqlError \fBlastError\fR () const" +.BI "TQSqlError \fBlastError\fR () const" .br .ti -1c .BI "bool \fBisSelect\fR () const" @@ -61,10 +61,10 @@ Inherited by QSqlCursor. .BI "int \fBsize\fR () const" .br .ti -1c -.BI "const QSqlDriver * \fBdriver\fR () const" +.BI "const TQSqlDriver * \fBdriver\fR () const" .br .ti -1c -.BI "const QSqlResult * \fBresult\fR () const" +.BI "const TQSqlResult * \fBresult\fR () const" .br .ti -1c .BI "bool \fBisForwardOnly\fR () const" @@ -109,13 +109,13 @@ Inherited by QSqlCursor. .BI "void \fBaddBindValue\fR ( const QVariant & val )" .br .ti -1c -.BI "void \fBbindValue\fR ( const TQString & placeholder, const QVariant & val, QSql::ParameterType type )" +.BI "void \fBbindValue\fR ( const TQString & placeholder, const QVariant & val, TQSql::ParameterType type )" .br .ti -1c -.BI "void \fBbindValue\fR ( int pos, const QVariant & val, QSql::ParameterType type )" +.BI "void \fBbindValue\fR ( int pos, const QVariant & val, TQSql::ParameterType type )" .br .ti -1c -.BI "void \fBaddBindValue\fR ( const QVariant & val, QSql::ParameterType type )" +.BI "void \fBaddBindValue\fR ( const QVariant & val, TQSql::ParameterType type )" .br .ti -1c .BI "QVariant \fBboundValue\fR ( const TQString & placeholder ) const" @@ -140,9 +140,9 @@ Inherited by QSqlCursor. .br .in -1c .SH DESCRIPTION -The QSqlQuery class provides a means of executing and manipulating SQL statements. +The TQSqlQuery class provides a means of executing and manipulating SQL statements. .PP -QSqlQuery encapsulates the functionality involved in creating, navigating and retrieving data from SQL queries which are executed on a QSqlDatabase. It can be used to execute DML (data manipulation language) statements, e.g. \fCSELECT\fR, \fCINSERT\fR, \fCUPDATE\fR and \fCDELETE\fR, and also DDL (data definition language) statements, e.g. \fCCREATE TABLE\fR. It can also be used to execute database-specific commands which are not standard SQL (e.g. \fCSET DATESTYLE=ISO\fR for PostgreSQL). +TQSqlQuery encapsulates the functionality involved in creating, navigating and retrieving data from SQL queries which are executed on a TQSqlDatabase. It can be used to execute DML (data manipulation language) statements, e.g. \fCSELECT\fR, \fCINSERT\fR, \fCUPDATE\fR and \fCDELETE\fR, and also DDL (data definition language) statements, e.g. \fCCREATE TABLE\fR. It can also be used to execute database-specific commands which are not standard SQL (e.g. \fCSET DATESTYLE=ISO\fR for PostgreSQL). .PP Successfully executed SQL statements set the query's state to active (isActive() returns TRUE); otherwise the query's state is set to inactive. In either case, when executing a new SQL statement, the query is positioned on an invalid record; an active query must be navigated to a valid record (so that isValid() returns TRUE) before values can be retrieved. .PP @@ -164,7 +164,7 @@ For example: .PP .nf .br - QSqlQuery query( "SELECT name FROM customer" ); + TQSqlQuery query( "SELECT name FROM customer" ); .br while ( query.next() ) { .br @@ -176,9 +176,9 @@ For example: .br .fi .PP -To access the data returned by a query, use the value() method. Each field in the data returned by a SELECT statement is accessed by passing the field's position in the statement, starting from 0. Information about the fields can be obtained via QSqlDatabase::record(). For the sake of efficiency there are no functions to access a field by name. (The QSqlCursor class provides a higher-level interface with field access by name and automatic SQL generation.) +To access the data returned by a query, use the value() method. Each field in the data returned by a SELECT statement is accessed by passing the field's position in the statement, starting from 0. Information about the fields can be obtained via TQSqlDatabase::record(). For the sake of efficiency there are no functions to access a field by name. (The TQSqlCursor class provides a higher-level interface with field access by name and automatic SQL generation.) .PP -QSqlQuery supports prepared query execution and the binding of parameter values to placeholders. Some databases don't support these features, so for them TQt emulates the required functionality. For example, the Oracle and ODBC drivers have proper prepared query support, and TQt makes use of it; but for databases that don't have this support, TQt implements the feature itself, e.g. by replacing placeholders with actual values when a query is executed. The exception is positional binding using named placeholders, which requires that the database supports prepared queries. +TQSqlQuery supports prepared query execution and the binding of parameter values to placeholders. Some databases don't support these features, so for them TQt emulates the required functionality. For example, the Oracle and ODBC drivers have proper prepared query support, and TQt makes use of it; but for databases that don't have this support, TQt implements the feature itself, e.g. by replacing placeholders with actual values when a query is executed. The exception is positional binding using named placeholders, which requires that the database supports prepared queries. .PP Oracle databases identify placeholders by using a colon-name syntax, e.g \fC:name\fR. ODBC simply uses \fC?\fR characters. TQt supports both syntaxes (although you can't mix them in the same query). .PP @@ -188,7 +188,7 @@ Below we present the same example using each of the four different binding appro .PP .nf .br - QSqlQuery query; + TQSqlQuery query; .br query.prepare( "INSERT INTO atable (id, forename, surname) " .br @@ -208,7 +208,7 @@ Below we present the same example using each of the four different binding appro .PP .nf .br - QSqlQuery query; + TQSqlQuery query; .br query.prepare( "INSERT INTO atable (id, forename, surname) " .br @@ -223,13 +223,13 @@ Below we present the same example using each of the four different binding appro query.exec(); .br .fi -\fBNote:\fR Using positional binding with named placeholders will only work if the database supports prepared queries. This can be checked with QSqlDriver::hasFeature() using QSqlDriver::PreparedQueries as argument for driver feature. +\fBNote:\fR Using positional binding with named placeholders will only work if the database supports prepared queries. This can be checked with TQSqlDriver::hasFeature() using TQSqlDriver::PreparedQueries as argument for driver feature. .PP \fBBinding values using positional placeholders #1\fR .PP .nf .br - QSqlQuery query; + TQSqlQuery query; .br query.prepare( "INSERT INTO atable (id, forename, surname) " .br @@ -267,13 +267,13 @@ Below we present the same example using each of the four different binding appro .PP .nf .br - QSqlQuery query; + TQSqlQuery query; .br query.prepare( "call AsciiToInt(?, ?)" ); .br query.bindValue( 0, "A" ); .br - query.bindValue( 1, 0, QSql::Out ); + query.bindValue( 1, 0, TQSql::Out ); .br query.exec(); .br @@ -281,72 +281,72 @@ Below we present the same example using each of the four different binding appro .br .fi .PP -See also QSqlDatabase, QSqlCursor, QVariant, and Database Classes. +See also TQSqlDatabase, TQSqlCursor, QVariant, and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlQuery::QSqlQuery ( QSqlResult * r )" -Creates a QSqlQuery object which uses the QSqlResult \fIr\fR to communicate with a database. -.SH "QSqlQuery::QSqlQuery ( const TQString & query = TQString::null, QSqlDatabase * db = 0 )" -Creates a QSqlQuery object using the SQL \fIquery\fR and the database \fIdb\fR. If \fIdb\fR is 0, (the default), the application's default database is used. If \fIquery\fR is not a null string, it will be executed. +.SH "TQSqlQuery::TQSqlQuery ( TQSqlResult * r )" +Creates a TQSqlQuery object which uses the TQSqlResult \fIr\fR to communicate with a database. +.SH "TQSqlQuery::TQSqlQuery ( const TQString & query = TQString::null, TQSqlDatabase * db = 0 )" +Creates a TQSqlQuery object using the SQL \fIquery\fR and the database \fIdb\fR. If \fIdb\fR is 0, (the default), the application's default database is used. If \fIquery\fR is not a null string, it will be executed. .PP -See also QSqlDatabase. -.SH "explicit QSqlQuery::QSqlQuery ( QSqlDatabase * db )" -Creates a QSqlQuery object using the database \fIdb\fR. If \fIdb\fR is 0, the application's default database is used. +See also TQSqlDatabase. +.SH "explicit TQSqlQuery::TQSqlQuery ( TQSqlDatabase * db )" +Creates a TQSqlQuery object using the database \fIdb\fR. If \fIdb\fR is 0, the application's default database is used. .PP -See also QSqlDatabase. -.SH "QSqlQuery::QSqlQuery ( const QSqlQuery & other )" +See also TQSqlDatabase. +.SH "TQSqlQuery::TQSqlQuery ( const TQSqlQuery & other )" Constructs a copy of \fIother\fR. -.SH "QSqlQuery::~QSqlQuery ()\fC [virtual]\fR" +.SH "TQSqlQuery::~TQSqlQuery ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "void QSqlQuery::addBindValue ( const QVariant & val, QSql::ParameterType type )" -Adds the value \fIval\fR to the list of values when using positional value binding. The order of the addBindValue() calls determines which placeholder a value will be bound to in the prepared query. If \fItype\fR is QSql::Out or QSql::InOut, the placeholder will be overwritten with data from the database after the exec() call. +.SH "void TQSqlQuery::addBindValue ( const QVariant & val, TQSql::ParameterType type )" +Adds the value \fIval\fR to the list of values when using positional value binding. The order of the addBindValue() calls determines which placeholder a value will be bound to in the prepared query. If \fItype\fR is TQSql::Out or TQSql::InOut, the placeholder will be overwritten with data from the database after the exec() call. .PP See also bindValue(), prepare(), and exec(). -.SH "void QSqlQuery::addBindValue ( const QVariant & val )" +.SH "void TQSqlQuery::addBindValue ( const QVariant & val )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Binds the placeholder with type QSql::In. -.SH "void QSqlQuery::afterSeek ()\fC [virtual protected]\fR" +Binds the placeholder with type TQSql::In. +.SH "void TQSqlQuery::afterSeek ()\fC [virtual protected]\fR" Protected virtual function called after the internal record pointer is moved to a new record. The default implementation does nothing. -.SH "int QSqlQuery::at () const" -Returns the current internal position of the query. The first record is at position zero. If the position is invalid, a QSql::Location will be returned indicating the invalid position. +.SH "int TQSqlQuery::at () const" +Returns the current internal position of the query. The first record is at position zero. If the position is invalid, a TQSql::Location will be returned indicating the invalid position. .PP See also prev(), next(), first(), last(), seek(), isActive(), and isValid(). .PP Example: sql/overview/navigating/main.cpp. -.SH "void QSqlQuery::beforeSeek ()\fC [virtual protected]\fR" +.SH "void TQSqlQuery::beforeSeek ()\fC [virtual protected]\fR" Protected virtual function called before the internal record pointer is moved to a new record. The default implementation does nothing. -.SH "void QSqlQuery::bindValue ( const TQString & placeholder, const QVariant & val, QSql::ParameterType type )" -Set the placeholder \fIplaceholder\fR to be bound to value \fIval\fR in the prepared statement. Note that the placeholder mark (e.g \fC:\fR) must be included when specifying the placeholder name. If \fItype\fR is QSql::Out or QSql::InOut, the placeholder will be overwritten with data from the database after the exec() call. +.SH "void TQSqlQuery::bindValue ( const TQString & placeholder, const QVariant & val, TQSql::ParameterType type )" +Set the placeholder \fIplaceholder\fR to be bound to value \fIval\fR in the prepared statement. Note that the placeholder mark (e.g \fC:\fR) must be included when specifying the placeholder name. If \fItype\fR is TQSql::Out or TQSql::InOut, the placeholder will be overwritten with data from the database after the exec() call. .PP See also addBindValue(), prepare(), and exec(). -.SH "void QSqlQuery::bindValue ( const TQString & placeholder, const QVariant & val )" +.SH "void TQSqlQuery::bindValue ( const TQString & placeholder, const QVariant & val )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Binds the placeholder with type QSql::In. -.SH "void QSqlQuery::bindValue ( int pos, const QVariant & val )" +Binds the placeholder with type TQSql::In. +.SH "void TQSqlQuery::bindValue ( int pos, const QVariant & val )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Binds the placeholder at position \fIpos\fR with type QSql::In. -.SH "void QSqlQuery::bindValue ( int pos, const QVariant & val, QSql::ParameterType type )" +Binds the placeholder at position \fIpos\fR with type TQSql::In. +.SH "void TQSqlQuery::bindValue ( int pos, const QVariant & val, TQSql::ParameterType type )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Set the placeholder in position \fIpos\fR to be bound to value \fIval\fR in the prepared statement. Field numbering starts at 0. If \fItype\fR is QSql::Out or QSql::InOut, the placeholder will be overwritten with data from the database after the exec() call. +Set the placeholder in position \fIpos\fR to be bound to value \fIval\fR in the prepared statement. Field numbering starts at 0. If \fItype\fR is TQSql::Out or TQSql::InOut, the placeholder will be overwritten with data from the database after the exec() call. .PP See also addBindValue(), prepare(), and exec(). -.SH "QVariant QSqlQuery::boundValue ( const TQString & placeholder ) const" +.SH "QVariant TQSqlQuery::boundValue ( const TQString & placeholder ) const" Returns the value for the \fIplaceholder\fR. -.SH "QVariant QSqlQuery::boundValue ( int pos ) const" +.SH "QVariant TQSqlQuery::boundValue ( int pos ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the value for the placeholder at position \fIpos\fR. -.SH "QMap<TQString, QVariant> QSqlQuery::boundValues () const" +.SH "QMap<TQString, QVariant> TQSqlQuery::boundValues () const" Returns a map of the bound values. .PP The bound values can be examined in the following way: .PP .nf .br - QSqlQuery query; + TQSqlQuery query; .br ... .br @@ -379,9 +379,9 @@ The bound values can be examined in the following way: .br .br .fi -.SH "const QSqlDriver * QSqlQuery::driver () const" +.SH "const TQSqlDriver * TQSqlQuery::driver () const" Returns the database driver associated with the query. -.SH "bool QSqlQuery::exec ( const TQString & query )\fC [virtual]\fR" +.SH "bool TQSqlQuery::exec ( const TQString & query )\fC [virtual]\fR" Executes the SQL in \fIquery\fR. Returns TRUE and sets the query state to active if the query was successful; otherwise returns FALSE and sets the query state to inactive. The \fIquery\fR string must use syntax appropriate for the SQL database being queried, for example, standard SQL. .PP After the query is executed, the query is positioned on an \fIinvalid\fR record, and must be navigated to a valid record before data values can be retrieved, e.g. using next(). @@ -392,56 +392,56 @@ See also isActive(), isValid(), next(), prev(), first(), last(), and seek(). .PP Examples: .)l sql/overview/basicbrowsing/main.cpp, sql/overview/basicbrowsing2/main.cpp, sql/overview/basicdatamanip/main.cpp, and sql/overview/connection.cpp. -.SH "bool QSqlQuery::exec ()" +.SH "bool TQSqlQuery::exec ()" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Executes a previously prepared SQL query. Returns TRUE if the query executed successfully; otherwise returns FALSE. .PP See also prepare(), bindValue(), and addBindValue(). -.SH "TQString QSqlQuery::executedQuery () const" +.SH "TQString TQSqlQuery::executedQuery () const" Returns the last query that was executed. .PP In most cases this function returns the same as lastQuery(). If a prepared query with placeholders is executed on a DBMS that does not support it, the preparation of this query is emulated. The placeholders in the original query are replaced with their bound values to form a new query. This function returns the modified query. Useful for debugging purposes. .PP See also lastQuery(). -.SH "bool QSqlQuery::first ()\fC [virtual]\fR" +.SH "bool TQSqlQuery::first ()\fC [virtual]\fR" Retrieves the first record in the result, if available, and positions the query on the retrieved record. Note that the result must be in an active state and isSelect() must return TRUE before calling this function or it will do nothing and return FALSE. Returns TRUE if successful. If unsuccessful the query position is set to an invalid position and FALSE is returned. .PP See also next(), prev(), last(), seek(), at(), isActive(), and isValid(). .PP Example: sql/overview/navigating/main.cpp. -.SH "bool QSqlQuery::isActive () const" +.SH "bool TQSqlQuery::isActive () const" Returns TRUE if the query is currently active; otherwise returns FALSE. .PP Examples: .)l sql/overview/basicbrowsing/main.cpp, sql/overview/basicbrowsing2/main.cpp, sql/overview/basicdatamanip/main.cpp, sql/overview/navigating/main.cpp, and sql/overview/retrieve1/main.cpp. -.SH "bool QSqlQuery::isForwardOnly () const" +.SH "bool TQSqlQuery::isForwardOnly () const" Returns TRUE if you can only scroll \fIforward\fR through a result set; otherwise returns FALSE. .PP See also setForwardOnly(). -.SH "bool QSqlQuery::isNull ( int field ) const" +.SH "bool TQSqlQuery::isNull ( int field ) const" Returns TRUE if the query is active and positioned on a valid record and the \fIfield\fR is NULL; otherwise returns FALSE. Note that for some drivers isNull() will not return accurate information until after an attempt is made to retrieve data. .PP See also isActive(), isValid(), and value(). -.SH "bool QSqlQuery::isSelect () const" +.SH "bool TQSqlQuery::isSelect () const" Returns TRUE if the current query is a \fCSELECT\fR statement; otherwise returns FALSE. -.SH "bool QSqlQuery::isValid () const" +.SH "bool TQSqlQuery::isValid () const" Returns TRUE if the query is currently positioned on a valid record; otherwise returns FALSE. -.SH "bool QSqlQuery::last ()\fC [virtual]\fR" +.SH "bool TQSqlQuery::last ()\fC [virtual]\fR" Retrieves the last record in the result, if available, and positions the query on the retrieved record. Note that the result must be in an active state and isSelect() must return TRUE before calling this function or it will do nothing and return FALSE. Returns TRUE if successful. If unsuccessful the query position is set to an invalid position and FALSE is returned. .PP See also next(), prev(), first(), seek(), at(), isActive(), and isValid(). .PP Example: sql/overview/navigating/main.cpp. -.SH "QSqlError QSqlQuery::lastError () const" +.SH "TQSqlError TQSqlQuery::lastError () const" Returns error information about the last error (if any) that occurred. .PP -See also QSqlError. -.SH "TQString QSqlQuery::lastQuery () const" +See also TQSqlError. +.SH "TQString TQSqlQuery::lastQuery () const" Returns the text of the current query being used, or TQString::null if there is no current query text. .PP See also executedQuery(). -.SH "bool QSqlQuery::next ()\fC [virtual]\fR" +.SH "bool TQSqlQuery::next ()\fC [virtual]\fR" Retrieves the next record in the result, if available, and positions the query on the retrieved record. Note that the result must be in an active state and isSelect() must return TRUE before calling this function or it will do nothing and return FALSE. .PP The following rules apply: @@ -460,20 +460,20 @@ See also prev(), first(), last(), seek(), at(), isActive(), and isValid(). .PP Examples: .)l sql/overview/basicbrowsing/main.cpp, sql/overview/basicbrowsing2/main.cpp, sql/overview/delete/main.cpp, sql/overview/order1/main.cpp, sql/overview/retrieve1/main.cpp, sql/overview/subclass4/main.cpp, and sql/overview/subclass5/main.cpp. -.SH "int QSqlQuery::numRowsAffected () const" +.SH "int TQSqlQuery::numRowsAffected () const" Returns the number of rows affected by the result's SQL statement, or -1 if it cannot be determined. Note that for \fCSELECT\fR statements, the value is undefined; see size() instead. If the query is not active (isActive() returns FALSE), -1 is returned. .PP -See also size() and QSqlDriver::hasFeature(). +See also size() and TQSqlDriver::hasFeature(). .PP Examples: .)l sql/overview/basicbrowsing2/main.cpp and sql/overview/basicdatamanip/main.cpp. -.SH "QSqlQuery & QSqlQuery::operator= ( const QSqlQuery & other )" +.SH "TQSqlQuery & TQSqlQuery::operator= ( const TQSqlQuery & other )" Assigns \fIother\fR to the query. -.SH "bool QSqlQuery::prepare ( const TQString & query )" +.SH "bool TQSqlQuery::prepare ( const TQString & query )" Prepares the SQL query \fIquery\fR for execution. The query may contain placeholders for binding values. Both Oracle style colon-name (e.g. \fC:surname\fR), and ODBC style (e.g. \fC?\fR) placeholders are supported; but they cannot be mixed in the same query. See the Description for examples. .PP See also exec(), bindValue(), and addBindValue(). -.SH "bool QSqlQuery::prev ()\fC [virtual]\fR" +.SH "bool TQSqlQuery::prev ()\fC [virtual]\fR" Retrieves the previous record in the result, if available, and positions the query on the retrieved record. Note that the result must be in an active state and isSelect() must return TRUE before calling this function or it will do nothing and return FALSE. .PP The following rules apply: @@ -489,9 +489,9 @@ If the result is somewhere in the middle, an attempt is made to retrieve the pre If the record could not be retrieved, the result is positioned before the first record and FALSE is returned. If the record is successfully retrieved, TRUE is returned. .PP See also next(), first(), last(), seek(), at(), isActive(), and isValid(). -.SH "const QSqlResult * QSqlQuery::result () const" +.SH "const TQSqlResult * TQSqlQuery::result () const" Returns the result associated with the query. -.SH "bool QSqlQuery::seek ( int i, bool relative = FALSE )\fC [virtual]\fR" +.SH "bool TQSqlQuery::seek ( int i, bool relative = FALSE )\fC [virtual]\fR" Retrieves the record at position (offset) \fIi\fR, if available, and positions the query on the retrieved record. The first record is at position 0. Note that the query must be in an active state and isSelect() must return TRUE before calling this function. .PP If \fIrelative\fR is FALSE (the default), the following rules apply: @@ -513,23 +513,23 @@ Otherwise, an attempt is made to move to the record \fIi\fR records ahead of the See also next(), prev(), first(), last(), at(), isActive(), and isValid(). .PP Example: sql/overview/navigating/main.cpp. -.SH "void QSqlQuery::setForwardOnly ( bool forward )" +.SH "void TQSqlQuery::setForwardOnly ( bool forward )" Sets forward only mode to \fIforward\fR. If forward is TRUE only next(), and seek() with positive values, are allowed for navigating the results. Forward only mode needs far less memory since results do not need to be cached. .PP Forward only mode is off by default. .PP -Forward only mode cannot be used with data aware widgets like QDataTable, since they must to be able to scroll backward as well as forward. +Forward only mode cannot be used with data aware widgets like TQDataTable, since they must to be able to scroll backward as well as forward. .PP See also isForwardOnly(), next(), and seek(). -.SH "int QSqlQuery::size () const" +.SH "int TQSqlQuery::size () const" Returns the size of the result, (number of rows returned), or -1 if the size cannot be determined or if the database does not support reporting information about query sizes. Note that for non-\fCSELECT\fR statements (isSelect() returns FALSE), size() will return -1. If the query is not active (isActive() returns FALSE), -1 is returned. .PP To determine the number of rows affected by a non-SELECT statement, use numRowsAffected(). .PP -See also isActive(), numRowsAffected(), and QSqlDriver::hasFeature(). +See also isActive(), numRowsAffected(), and TQSqlDriver::hasFeature(). .PP Example: sql/overview/navigating/main.cpp. -.SH "QVariant QSqlQuery::value ( int i ) const\fC [virtual]\fR" +.SH "QVariant TQSqlQuery::value ( int i ) const\fC [virtual]\fR" Returns the value of the \fIi\fR-th field in the query (zero based). .PP The fields are numbered from left to right using the text of the \fCSELECT\fR statement, e.g. in \fCSELECT forename, surname FROM people\fR, field 0 is \fCforename\fR and field 1 is \fCsurname\fR. Using \fCSELECT *\fR is not recommended because the order of the fields in the query is undefined. @@ -542,7 +542,7 @@ Examples: .)l sql/overview/basicbrowsing/main.cpp, sql/overview/basicbrowsing2/main.cpp, sql/overview/retrieve1/main.cpp, sql/overview/subclass3/main.cpp, sql/overview/subclass4/main.cpp, sql/overview/subclass5/main.cpp, and sql/overview/table4/main.cpp. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlquery.html +.BR http://doc.trolltech.com/tqsqlquery.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlrecord.3qt b/doc/man/man3/tqsqlrecord.3qt index 241b7de35..fa095195f 100644 --- a/doc/man/man3/tqsqlrecord.3qt +++ b/doc/man/man3/tqsqlrecord.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlRecord 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlRecord 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,11 +7,11 @@ .ad l .nh .SH NAME -QSqlRecord \- Encapsulates a database record, i.e. a set of database fields +TQSqlRecord \- Encapsulates a database record, i.e. a set of database fields .SH SYNOPSIS -\fC#include <ntqsqlrecord.h>\fR +\fC#include <tqsqlrecord.h>\fR .PP -Inherited by QSqlCursor and QSqlIndex. +Inherited by TQSqlCursor and TQSqlIndex. .PP .SS "Public Members" .in +1c @@ -19,13 +19,13 @@ Inherited by QSqlCursor and QSqlIndex. .BI "\fBQSqlRecord\fR ()" .br .ti -1c -.BI "\fBQSqlRecord\fR ( const QSqlRecord & other )" +.BI "\fBQSqlRecord\fR ( const TQSqlRecord & other )" .br .ti -1c -.BI "QSqlRecord & \fBoperator=\fR ( const QSqlRecord & other )" +.BI "TQSqlRecord & \fBoperator=\fR ( const TQSqlRecord & other )" .br .ti -1c -.BI "virtual \fB~QSqlRecord\fR ()" +.BI "virtual \fB~TQSqlRecord\fR ()" .br .ti -1c .BI "virtual QVariant \fBvalue\fR ( int i ) const" @@ -70,22 +70,22 @@ Inherited by QSqlCursor and QSqlIndex. .BI "TQString \fBfieldName\fR ( int i ) const" .br .ti -1c -.BI "QSqlField * \fBfield\fR ( int i )" +.BI "TQSqlField * \fBfield\fR ( int i )" .br .ti -1c -.BI "QSqlField * \fBfield\fR ( const TQString & name )" +.BI "TQSqlField * \fBfield\fR ( const TQString & name )" .br .ti -1c -.BI "const QSqlField * \fBfield\fR ( int i ) const" +.BI "const TQSqlField * \fBfield\fR ( int i ) const" .br .ti -1c -.BI "const QSqlField * \fBfield\fR ( const TQString & name ) const" +.BI "const TQSqlField * \fBfield\fR ( const TQString & name ) const" .br .ti -1c -.BI "virtual void \fBappend\fR ( const QSqlField & field )" +.BI "virtual void \fBappend\fR ( const TQSqlField & field )" .br .ti -1c -.BI "virtual void \fBinsert\fR ( int pos, const QSqlField & field )" +.BI "virtual void \fBinsert\fR ( int pos, const TQSqlField & field )" .br .ti -1c .BI "virtual void \fBremove\fR ( int pos )" @@ -113,137 +113,137 @@ Inherited by QSqlCursor and QSqlIndex. .br .in -1c .SH DESCRIPTION -The QSqlRecord class encapsulates a database record, i.e. a set of database fields. +The TQSqlRecord class encapsulates a database record, i.e. a set of database fields. .PP -The QSqlRecord class encapsulates the functionality and characteristics of a database record (usually a table or view within the database). QSqlRecords support adding and removing fields as well as setting and retrieving field values. +The TQSqlRecord class encapsulates the functionality and characteristics of a database record (usually a table or view within the database). TQSqlRecords support adding and removing fields as well as setting and retrieving field values. .PP -QSqlRecord is implicitly shared. This means you can make copies of the record in time O(1). If multiple QSqlRecord instances share the same data and one is modifying the record's data then this modifying instance makes a copy and modifies its private copy - thus it does not affect other instances. +TQSqlRecord is implicitly shared. This means you can make copies of the record in time O(1). If multiple TQSqlRecord instances share the same data and one is modifying the record's data then this modifying instance makes a copy and modifies its private copy - thus it does not affect other instances. .PP -See also QSqlRecordInfo and Database Classes. +See also TQSqlRecordInfo and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlRecord::QSqlRecord ()" +.SH "TQSqlRecord::TQSqlRecord ()" Constructs an empty record. -.SH "QSqlRecord::QSqlRecord ( const QSqlRecord & other )" +.SH "TQSqlRecord::TQSqlRecord ( const TQSqlRecord & other )" Constructs a copy of \fIother\fR. -.SH "QSqlRecord::~QSqlRecord ()\fC [virtual]\fR" +.SH "TQSqlRecord::~TQSqlRecord ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "void QSqlRecord::append ( const QSqlField & field )\fC [virtual]\fR" +.SH "void TQSqlRecord::append ( const TQSqlField & field )\fC [virtual]\fR" Append a copy of field \fIfield\fR to the end of the record. .PP -Reimplemented in QSqlIndex. -.SH "void QSqlRecord::clear ()\fC [virtual]\fR" +Reimplemented in TQSqlIndex. +.SH "void TQSqlRecord::clear ()\fC [virtual]\fR" Removes all the record's fields. .PP See also clearValues(). .PP -Reimplemented in QSqlCursor. -.SH "void QSqlRecord::clearValues ( bool nullify = FALSE )\fC [virtual]\fR" +Reimplemented in TQSqlCursor. +.SH "void TQSqlRecord::clearValues ( bool nullify = FALSE )\fC [virtual]\fR" Clears the value of all fields in the record. If \fInullify\fR is TRUE, (the default is FALSE), each field is set to NULL. -.SH "bool QSqlRecord::contains ( const TQString & name ) const" +.SH "bool TQSqlRecord::contains ( const TQString & name ) const" Returns TRUE if there is a field in the record called \fIname\fR; otherwise returns FALSE. -.SH "uint QSqlRecord::count () const" +.SH "uint TQSqlRecord::count () const" Returns the number of fields in the record. -.SH "QSqlField * QSqlRecord::field ( int i )" +.SH "TQSqlField * TQSqlRecord::field ( int i )" Returns the field at position \fIi\fR within the record, or 0 if it cannot be found. -.SH "QSqlField * QSqlRecord::field ( const TQString & name )" +.SH "TQSqlField * TQSqlRecord::field ( const TQString & name )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the field called \fIname\fR within the record, or 0 if it cannot be found. Field names are not case-sensitive. -.SH "const QSqlField * QSqlRecord::field ( int i ) const" +.SH "const TQSqlField * TQSqlRecord::field ( int i ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -.SH "const QSqlField * QSqlRecord::field ( const TQString & name ) const" +.SH "const TQSqlField * TQSqlRecord::field ( const TQString & name ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the field called \fIname\fR within the record, or 0 if it cannot be found. Field names are not case-sensitive. -.SH "TQString QSqlRecord::fieldName ( int i ) const" +.SH "TQString TQSqlRecord::fieldName ( int i ) const" Returns the name of the field at position \fIi\fR. If the field does not exist, TQString::null is returned. -.SH "void QSqlRecord::insert ( int pos, const QSqlField & field )\fC [virtual]\fR" +.SH "void TQSqlRecord::insert ( int pos, const TQSqlField & field )\fC [virtual]\fR" Insert a copy of \fIfield\fR at position \fIpos\fR. If a field already exists at \fIpos\fR, it is removed. -.SH "bool QSqlRecord::isEmpty () const" +.SH "bool TQSqlRecord::isEmpty () const" Returns TRUE if there are no fields in the record; otherwise returns FALSE. -.SH "bool QSqlRecord::isGenerated ( const TQString & name ) const" +.SH "bool TQSqlRecord::isGenerated ( const TQString & name ) const" Returns TRUE if the record has a field called \fIname\fR and this field is to be generated (the default); otherwise returns FALSE. .PP See also setGenerated(). -.SH "bool QSqlRecord::isGenerated ( int i ) const" +.SH "bool TQSqlRecord::isGenerated ( int i ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns TRUE if the record has a field at position \fIi\fR and this field is to be generated (the default); otherwise returns FALSE. .PP See also setGenerated(). -.SH "bool QSqlRecord::isNull ( const TQString & name ) const" +.SH "bool TQSqlRecord::isNull ( const TQString & name ) const" Returns TRUE if the field called \fIname\fR is NULL or if there is no field called \fIname\fR; otherwise returns FALSE. .PP See also position(). -.SH "bool QSqlRecord::isNull ( int i ) const" +.SH "bool TQSqlRecord::isNull ( int i ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns TRUE if the field \fIi\fR is NULL or if there is no field at position \fIi\fR; otherwise returns FALSE. .PP See also fieldName(). -.SH "QSqlRecord & QSqlRecord::operator= ( const QSqlRecord & other )" +.SH "TQSqlRecord & TQSqlRecord::operator= ( const TQSqlRecord & other )" Sets the record equal to \fIother\fR. -.SH "int QSqlRecord::position ( const TQString & name ) const" +.SH "int TQSqlRecord::position ( const TQString & name ) const" Returns the position of the field called \fIname\fR within the record, or -1 if it cannot be found. Field names are not case-sensitive. If more than one field matches, the first one is returned. -.SH "void QSqlRecord::remove ( int pos )\fC [virtual]\fR" +.SH "void TQSqlRecord::remove ( int pos )\fC [virtual]\fR" Removes the field at \fIpos\fR. If \fIpos\fR does not exist, nothing happens. .PP -Reimplemented in QSqlCursor. -.SH "void QSqlRecord::setGenerated ( const TQString & name, bool generated )\fC [virtual]\fR" -Sets the generated flag for the field called \fIname\fR to \fIgenerated\fR. If the field does not exist, nothing happens. Only fields that have \fIgenerated\fR set to TRUE are included in the SQL that is generated, e.g. by QSqlCursor. +Reimplemented in TQSqlCursor. +.SH "void TQSqlRecord::setGenerated ( const TQString & name, bool generated )\fC [virtual]\fR" +Sets the generated flag for the field called \fIname\fR to \fIgenerated\fR. If the field does not exist, nothing happens. Only fields that have \fIgenerated\fR set to TRUE are included in the SQL that is generated, e.g. by TQSqlCursor. .PP See also isGenerated(). .PP -Reimplemented in QSqlCursor. -.SH "void QSqlRecord::setGenerated ( int i, bool generated )\fC [virtual]\fR" +Reimplemented in TQSqlCursor. +.SH "void TQSqlRecord::setGenerated ( int i, bool generated )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the generated flag for the field \fIi\fR to \fIgenerated\fR. .PP See also isGenerated(). .PP -Reimplemented in QSqlCursor. -.SH "void QSqlRecord::setNull ( int i )\fC [virtual]\fR" +Reimplemented in TQSqlCursor. +.SH "void TQSqlRecord::setNull ( int i )\fC [virtual]\fR" Sets the value of field \fIi\fR to NULL. If the field does not exist, nothing happens. -.SH "void QSqlRecord::setNull ( const TQString & name )\fC [virtual]\fR" +.SH "void TQSqlRecord::setNull ( const TQString & name )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the value of the field called \fIname\fR to NULL. If the field does not exist, nothing happens. -.SH "void QSqlRecord::setValue ( int i, const QVariant & val )\fC [virtual]\fR" +.SH "void TQSqlRecord::setValue ( int i, const QVariant & val )\fC [virtual]\fR" Sets the value of the field at position \fIi\fR to \fIval\fR. If the field does not exist, nothing happens. .PP Examples: .)l sql/overview/insert/main.cpp, sql/overview/insert2/main.cpp, sql/overview/subclass5/main.cpp, sql/overview/update/main.cpp, and sql/sqltable/main.cpp. -.SH "void QSqlRecord::setValue ( const TQString & name, const QVariant & val )\fC [virtual]\fR" +.SH "void TQSqlRecord::setValue ( const TQString & name, const QVariant & val )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the value of the field called \fIname\fR to \fIval\fR. If the field does not exist, nothing happens. -.SH "TQString QSqlRecord::toString ( const TQString & prefix = TQString::null, const TQString & sep = "," ) const\fC [virtual]\fR" +.SH "TQString TQSqlRecord::toString ( const TQString & prefix = TQString::null, const TQString & sep = "," ) const\fC [virtual]\fR" Returns a list of all the record's field names as a string separated by \fIsep\fR. .PP Note that fields which are not generated are \fInot\fR included (see isGenerated()). The returned string is suitable, for example, for generating SQL SELECT statements. If a \fIprefix\fR is specified, e.g. a table name, all fields are prefixed in the form: .PP" \fIprefix\fR.<fieldname>" -.SH "QStringList QSqlRecord::toStringList ( const TQString & prefix = TQString::null ) const\fC [virtual]\fR" +.SH "QStringList TQSqlRecord::toStringList ( const TQString & prefix = TQString::null ) const\fC [virtual]\fR" Returns a list of all the record's field names, each having the prefix \fIprefix\fR. .PP Note that fields which have generated set to FALSE are \fInot\fR included. (See isGenerated()). If \fIprefix\fR is supplied, e.g. a table name, all fields are prefixed in the form: .PP" \fIprefix\fR.<fieldname>" -.SH "QVariant QSqlRecord::value ( int i ) const\fC [virtual]\fR" +.SH "QVariant TQSqlRecord::value ( int i ) const\fC [virtual]\fR" Returns the value of the field located at position \fIi\fR in the record. If field \fIi\fR does not exist the resultant behaviour is undefined. .PP -This function should be used with QSqlQuerys. When working with a QSqlCursor the value(const TQString&) overload which uses field names is more appropriate. +This function should be used with TQSqlQuerys. When working with a TQSqlCursor the value(const TQString&) overload which uses field names is more appropriate. .PP Example: sql/overview/update/main.cpp. -.SH "QVariant QSqlRecord::value ( const TQString & name ) const\fC [virtual]\fR" +.SH "QVariant TQSqlRecord::value ( const TQString & name ) const\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the value of the field called \fIname\fR in the record. If field \fIname\fR does not exist the resultant behaviour is undefined. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlrecord.html +.BR http://doc.trolltech.com/tqsqlrecord.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlrecordinfo.3qt b/doc/man/man3/tqsqlrecordinfo.3qt index e06c26851..7b5a74324 100644 --- a/doc/man/man3/tqsqlrecordinfo.3qt +++ b/doc/man/man3/tqsqlrecordinfo.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlRecordInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlRecordInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSqlRecordInfo \- Encapsulates a set of database field meta data +TQSqlRecordInfo \- Encapsulates a set of database field meta data .SH SYNOPSIS -\fC#include <ntqsqlrecord.h>\fR +\fC#include <tqsqlrecord.h>\fR .PP .SS "Public Members" .in +1c @@ -17,44 +17,44 @@ QSqlRecordInfo \- Encapsulates a set of database field meta data .BI "\fBQSqlRecordInfo\fR ()" .br .ti -1c -.BI "\fBQSqlRecordInfo\fR ( const QSqlFieldInfoList & other )" +.BI "\fBQSqlRecordInfo\fR ( const TQSqlFieldInfoList & other )" .br .ti -1c -.BI "\fBQSqlRecordInfo\fR ( const QSqlRecord & other )" +.BI "\fBQSqlRecordInfo\fR ( const TQSqlRecord & other )" .br .ti -1c .BI "size_type \fBcontains\fR ( const TQString & fieldName ) const" .br .ti -1c -.BI "QSqlFieldInfo \fBfind\fR ( const TQString & fieldName ) const" +.BI "TQSqlFieldInfo \fBfind\fR ( const TQString & fieldName ) const" .br .ti -1c -.BI "QSqlRecord \fBtoRecord\fR () const" +.BI "TQSqlRecord \fBtoRecord\fR () const" .br .in -1c .SH DESCRIPTION -The QSqlRecordInfo class encapsulates a set of database field meta data. +The TQSqlRecordInfo class encapsulates a set of database field meta data. .PP -This class is a QValueList that holds a set of database field meta data. Use contains() to see if a given field name exists in the record, and use find() to get a QSqlFieldInfo record for a named field. +This class is a QValueList that holds a set of database field meta data. Use contains() to see if a given field name exists in the record, and use find() to get a TQSqlFieldInfo record for a named field. .PP -See also QValueList, QSqlFieldInfo, and Database Classes. +See also QValueList, TQSqlFieldInfo, and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlRecordInfo::QSqlRecordInfo ()" +.SH "TQSqlRecordInfo::TQSqlRecordInfo ()" Constructs an empty record info object -.SH "QSqlRecordInfo::QSqlRecordInfo ( const QSqlFieldInfoList & other )" +.SH "TQSqlRecordInfo::TQSqlRecordInfo ( const TQSqlFieldInfoList & other )" Constructs a copy of \fIother\fR. -.SH "QSqlRecordInfo::QSqlRecordInfo ( const QSqlRecord & other )" -Constructs a QSqlRecordInfo object based on the fields in the QSqlRecord \fIother\fR. -.SH "size_type QSqlRecordInfo::contains ( const TQString & fieldName ) const" +.SH "TQSqlRecordInfo::TQSqlRecordInfo ( const TQSqlRecord & other )" +Constructs a TQSqlRecordInfo object based on the fields in the TQSqlRecord \fIother\fR. +.SH "size_type TQSqlRecordInfo::contains ( const TQString & fieldName ) const" Returns the number of times a field called \fIfieldName\fR occurs in the record. Returns 0 if no field by that name could be found. -.SH "QSqlFieldInfo QSqlRecordInfo::find ( const TQString & fieldName ) const" -Returns a QSqlFieldInfo object for the first field in the record which has the field name \fIfieldName\fR. If no matching field is found then an empty QSqlFieldInfo object is returned. -.SH "QSqlRecord QSqlRecordInfo::toRecord () const" -Returns an empty QSqlRecord based on the field information -in this QSqlRecordInfo. +.SH "TQSqlFieldInfo TQSqlRecordInfo::find ( const TQString & fieldName ) const" +Returns a TQSqlFieldInfo object for the first field in the record which has the field name \fIfieldName\fR. If no matching field is found then an empty TQSqlFieldInfo object is returned. +.SH "TQSqlRecord TQSqlRecordInfo::toRecord () const" +Returns an empty TQSqlRecord based on the field information +in this TQSqlRecordInfo. .SH "SEE ALSO" -.BR http://doc.trolltech.com/qsqlrecordinfo.html +.BR http://doc.trolltech.com/tqsqlrecordinfo.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlresult.3qt b/doc/man/man3/tqsqlresult.3qt index c8c3ab66a..7f3bf88ae 100644 --- a/doc/man/man3/tqsqlresult.3qt +++ b/doc/man/man3/tqsqlresult.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlResult 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlResult 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,20 +7,20 @@ .ad l .nh .SH NAME -QSqlResult \- Abstract interface for accessing data from SQL databases +TQSqlResult \- Abstract interface for accessing data from SQL databases .SH SYNOPSIS -\fC#include <ntqsqlresult.h>\fR +\fC#include <tqsqlresult.h>\fR .PP .SS "Public Members" .in +1c .ti -1c -.BI "virtual \fB~QSqlResult\fR ()" +.BI "virtual \fB~TQSqlResult\fR ()" .br .in -1c .SS "Protected Members" .in +1c .ti -1c -.BI "\fBQSqlResult\fR ( const QSqlDriver * db )" +.BI "\fBQSqlResult\fR ( const TQSqlDriver * db )" .br .ti -1c .BI "int \fBat\fR () const" @@ -29,7 +29,7 @@ QSqlResult \- Abstract interface for accessing data from SQL databases .BI "TQString \fBlastQuery\fR () const" .br .ti -1c -.BI "QSqlError \fBlastError\fR () const" +.BI "TQSqlError \fBlastError\fR () const" .br .ti -1c .BI "bool \fBisValid\fR () const" @@ -44,7 +44,7 @@ QSqlResult \- Abstract interface for accessing data from SQL databases .BI "bool \fBisForwardOnly\fR () const" .br .ti -1c -.BI "const QSqlDriver * \fBdriver\fR () const" +.BI "const TQSqlDriver * \fBdriver\fR () const" .br .ti -1c .BI "virtual void \fBsetAt\fR ( int at )" @@ -53,7 +53,7 @@ QSqlResult \- Abstract interface for accessing data from SQL databases .BI "virtual void \fBsetActive\fR ( bool a )" .br .ti -1c -.BI "virtual void \fBsetLastError\fR ( const QSqlError & e )" +.BI "virtual void \fBsetLastError\fR ( const TQSqlError & e )" .br .ti -1c .BI "virtual void \fBsetQuery\fR ( const TQString & query )" @@ -96,75 +96,75 @@ QSqlResult \- Abstract interface for accessing data from SQL databases .br .in -1c .SH DESCRIPTION -The QSqlResult class provides an abstract interface for accessing data from SQL databases. +The TQSqlResult class provides an abstract interface for accessing data from SQL databases. .PP -Normally you would use QSqlQuery instead of QSqlResult since QSqlQuery provides a generic wrapper for database-specific implementations of QSqlResult. +Normally you would use TQSqlQuery instead of TQSqlResult since TQSqlQuery provides a generic wrapper for database-specific implementations of TQSqlResult. .PP -See also QSql and Database Classes. +See also TQSql and Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlResult::QSqlResult ( const QSqlDriver * db )\fC [protected]\fR" -Protected constructor which creates a QSqlResult using database \fIdb\fR. The object is initialized to an inactive state. -.SH "QSqlResult::~QSqlResult ()\fC [virtual]\fR" +.SH "TQSqlResult::TQSqlResult ( const TQSqlDriver * db )\fC [protected]\fR" +Protected constructor which creates a TQSqlResult using database \fIdb\fR. The object is initialized to an inactive state. +.SH "TQSqlResult::~TQSqlResult ()\fC [virtual]\fR" Destroys the object and frees any allocated resources. -.SH "int QSqlResult::at () const\fC [protected]\fR" +.SH "int TQSqlResult::at () const\fC [protected]\fR" Returns the current (zero-based) position of the result. -.SH "QVariant QSqlResult::data ( int i )\fC [pure virtual protected]\fR" +.SH "QVariant TQSqlResult::data ( int i )\fC [pure virtual protected]\fR" Returns the data for field \fIi\fR (zero-based) as a QVariant. This function is only called if the result is in an active state and is positioned on a valid record and \fIi\fR is non-negative. Derived classes must reimplement this function and return the value of field \fIi\fR, or QVariant() if it cannot be determined. -.SH "const QSqlDriver * QSqlResult::driver () const\fC [protected]\fR" +.SH "const TQSqlDriver * TQSqlResult::driver () const\fC [protected]\fR" Returns the driver associated with the result. -.SH "bool QSqlResult::fetch ( int i )\fC [pure virtual protected]\fR" +.SH "bool TQSqlResult::fetch ( int i )\fC [pure virtual protected]\fR" Positions the result to an arbitrary (zero-based) index \fIi\fR. This function is only called if the result is in an active state. Derived classes must reimplement this function and position the result to the index \fIi\fR, and call setAt() with an appropriate value. Return TRUE to indicate success, or FALSE to signify failure. -.SH "bool QSqlResult::fetchFirst ()\fC [pure virtual protected]\fR" +.SH "bool TQSqlResult::fetchFirst ()\fC [pure virtual protected]\fR" Positions the result to the first record in the result. This function is only called if the result is in an active state. Derived classes must reimplement this function and position the result to the first record, and call setAt() with an appropriate value. Return TRUE to indicate success, or FALSE to signify failure. -.SH "bool QSqlResult::fetchLast ()\fC [pure virtual protected]\fR" +.SH "bool TQSqlResult::fetchLast ()\fC [pure virtual protected]\fR" Positions the result to the last record in the result. This function is only called if the result is in an active state. Derived classes must reimplement this function and position the result to the last record, and call setAt() with an appropriate value. Return TRUE to indicate success, or FALSE to signify failure. -.SH "bool QSqlResult::fetchNext ()\fC [virtual protected]\fR" +.SH "bool TQSqlResult::fetchNext ()\fC [virtual protected]\fR" Positions the result to the next available record in the result. This function is only called if the result is in an active state. The default implementation calls fetch() with the next index. Derived classes can reimplement this function and position the result to the next record in some other way, and call setAt() with an appropriate value. Return TRUE to indicate success, or FALSE to signify failure. -.SH "bool QSqlResult::fetchPrev ()\fC [virtual protected]\fR" +.SH "bool TQSqlResult::fetchPrev ()\fC [virtual protected]\fR" Positions the result to the previous available record in the result. This function is only called if the result is in an active state. The default implementation calls fetch() with the previous index. Derived classes can reimplement this function and position the result to the next record in some other way, and call setAt() with an appropriate value. Return TRUE to indicate success, or FALSE to signify failure. -.SH "bool QSqlResult::isActive () const\fC [protected]\fR" +.SH "bool TQSqlResult::isActive () const\fC [protected]\fR" Returns TRUE if the result has records to be retrieved; otherwise returns FALSE. -.SH "bool QSqlResult::isForwardOnly () const\fC [protected]\fR" +.SH "bool TQSqlResult::isForwardOnly () const\fC [protected]\fR" Returns TRUE if you can only scroll forward through a result set; otherwise returns FALSE. -.SH "bool QSqlResult::isNull ( int i )\fC [pure virtual protected]\fR" +.SH "bool TQSqlResult::isNull ( int i )\fC [pure virtual protected]\fR" Returns TRUE if the field at position \fIi\fR is NULL; otherwise returns FALSE. -.SH "bool QSqlResult::isSelect () const\fC [protected]\fR" +.SH "bool TQSqlResult::isSelect () const\fC [protected]\fR" Returns TRUE if the current result is from a SELECT statement; otherwise returns FALSE. -.SH "bool QSqlResult::isValid () const\fC [protected]\fR" +.SH "bool TQSqlResult::isValid () const\fC [protected]\fR" Returns TRUE if the result is positioned on a valid record (that is, the result is not positioned before the first or after the last record); otherwise returns FALSE. -.SH "QSqlError QSqlResult::lastError () const\fC [protected]\fR" +.SH "TQSqlError TQSqlResult::lastError () const\fC [protected]\fR" Returns the last error associated with the result. -.SH "TQString QSqlResult::lastQuery () const\fC [protected]\fR" +.SH "TQString TQSqlResult::lastQuery () const\fC [protected]\fR" Returns the current SQL query text, or TQString::null if there is none. -.SH "int QSqlResult::numRowsAffected ()\fC [pure virtual protected]\fR" +.SH "int TQSqlResult::numRowsAffected ()\fC [pure virtual protected]\fR" Returns the number of rows affected by the last query executed. -.SH "bool QSqlResult::reset ( const TQString & query )\fC [pure virtual protected]\fR" +.SH "bool TQSqlResult::reset ( const TQString & query )\fC [pure virtual protected]\fR" Sets the result to use the SQL statement \fIquery\fR for subsequent data retrieval. Derived classes must reimplement this function and apply the \fIquery\fR to the database. This function is called only after the result is set to an inactive state and is positioned before the first record of the new result. Derived classes should return TRUE if the query was successful and ready to be used, or FALSE otherwise. -.SH "void QSqlResult::setActive ( bool a )\fC [virtual protected]\fR" +.SH "void TQSqlResult::setActive ( bool a )\fC [virtual protected]\fR" Protected function provided for derived classes to set the internal active state to the value of \fIa\fR. .PP See also isActive(). -.SH "void QSqlResult::setAt ( int at )\fC [virtual protected]\fR" +.SH "void TQSqlResult::setAt ( int at )\fC [virtual protected]\fR" Protected function provided for derived classes to set the internal (zero-based) result index to \fIat\fR. .PP See also at(). -.SH "void QSqlResult::setForwardOnly ( bool forward )\fC [virtual protected]\fR" +.SH "void TQSqlResult::setForwardOnly ( bool forward )\fC [virtual protected]\fR" Sets forward only mode to \fIforward\fR. If forward is TRUE only fetchNext() is allowed for navigating the results. Forward only mode needs far less memory since results do not have to be cached. forward only mode is off by default. .PP See also fetchNext(). -.SH "void QSqlResult::setLastError ( const QSqlError & e )\fC [virtual protected]\fR" +.SH "void TQSqlResult::setLastError ( const TQSqlError & e )\fC [virtual protected]\fR" Protected function provided for derived classes to set the last error to the value of \fIe\fR. .PP See also lastError(). -.SH "void QSqlResult::setQuery ( const TQString & query )\fC [virtual protected]\fR" +.SH "void TQSqlResult::setQuery ( const TQString & query )\fC [virtual protected]\fR" Sets the current query for the result to \fIquery\fR. The result must be reset() in order to execute the query on the database. -.SH "void QSqlResult::setSelect ( bool s )\fC [virtual protected]\fR" +.SH "void TQSqlResult::setSelect ( bool s )\fC [virtual protected]\fR" Protected function provided for derived classes to indicate whether or not the current statement is a SQL SELECT statement. The \fIs\fR parameter should be TRUE if the statement is a SELECT statement, or FALSE otherwise. -.SH "int QSqlResult::size ()\fC [pure virtual protected]\fR" +.SH "int TQSqlResult::size ()\fC [pure virtual protected]\fR" Returns the size of the result or -1 if it cannot be determined. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlresult.html +.BR http://doc.trolltech.com/tqsqlresult.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsqlselectcursor.3qt b/doc/man/man3/tqsqlselectcursor.3qt index a169131f9..231287936 100644 --- a/doc/man/man3/tqsqlselectcursor.3qt +++ b/doc/man/man3/tqsqlselectcursor.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSqlSelectCursor 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSqlSelectCursor 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,30 +7,30 @@ .ad l .nh .SH NAME -QSqlSelectCursor \- Browsing of general SQL SELECT statements +TQSqlSelectCursor \- Browsing of general SQL SELECT statements .SH SYNOPSIS -\fC#include <ntqsqlselectcursor.h>\fR +\fC#include <tqsqlselectcursor.h>\fR .PP -Inherits QSqlCursor. +Inherits TQSqlCursor. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQSqlSelectCursor\fR ( const TQString & query = TQString::null, QSqlDatabase * db = 0 )" +.BI "\fBQSqlSelectCursor\fR ( const TQString & query = TQString::null, TQSqlDatabase * db = 0 )" .br .ti -1c -.BI "\fBQSqlSelectCursor\fR ( const QSqlSelectCursor & other )" +.BI "\fBQSqlSelectCursor\fR ( const TQSqlSelectCursor & other )" .br .ti -1c -.BI "\fB~QSqlSelectCursor\fR ()" +.BI "\fB~TQSqlSelectCursor\fR ()" .br .in -1c .SH DESCRIPTION -The QSqlSelectCursor class provides browsing of general SQL SELECT statements. +The TQSqlSelectCursor class provides browsing of general SQL SELECT statements. .PP -QSqlSelectCursor is a convenience class that makes it possible to display result sets from general SQL \fCSELECT\fR statements in data-aware TQt widgets. QSqlSelectCursor is read-only and does not support \fCINSERT\fR, \fCUPDATE\fR or \fCDELETE\fR operations. +TQSqlSelectCursor is a convenience class that makes it possible to display result sets from general SQL \fCSELECT\fR statements in data-aware TQt widgets. TQSqlSelectCursor is read-only and does not support \fCINSERT\fR, \fCUPDATE\fR or \fCDELETE\fR operations. .PP -Pass the query in at construction time, or use the QSqlSelectCursor::exec() function. +Pass the query in at construction time, or use the TQSqlSelectCursor::exec() function. .PP Example: .PP @@ -38,9 +38,9 @@ Example: .br ... .br - QSqlSelectCursor* cur = new QSqlSelectCursor( "SELECT id, firstname, lastname FROM author" ); + TQSqlSelectCursor* cur = new TQSqlSelectCursor( "SELECT id, firstname, lastname FROM author" ); .br - QDataTable* table = new QDataTable( this ); + TQDataTable* table = new TQDataTable( this ); .br table->setSqlCursor( cur, TRUE, TRUE ); .br @@ -58,15 +58,15 @@ Example: .PP See also Database Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSqlSelectCursor::QSqlSelectCursor ( const TQString & query = TQString::null, QSqlDatabase * db = 0 )" +.SH "TQSqlSelectCursor::TQSqlSelectCursor ( const TQString & query = TQString::null, TQSqlDatabase * db = 0 )" Constructs a read only cursor on database \fIdb\fR using the query \fIquery\fR. -.SH "QSqlSelectCursor::QSqlSelectCursor ( const QSqlSelectCursor & other )" +.SH "TQSqlSelectCursor::TQSqlSelectCursor ( const TQSqlSelectCursor & other )" Constructs a copy of \fIother\fR -.SH "QSqlSelectCursor::~QSqlSelectCursor ()" +.SH "TQSqlSelectCursor::~TQSqlSelectCursor ()" Destroys the object and frees any allocated resources .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsqlselectcursor.html +.BR http://doc.trolltech.com/tqsqlselectcursor.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqtable.3qt b/doc/man/man3/tqtable.3qt index 164b1acb6..ec0bbfb79 100644 --- a/doc/man/man3/tqtable.3qt +++ b/doc/man/man3/tqtable.3qt @@ -13,7 +13,7 @@ QTable \- Flexible editable table widget .PP Inherits QScrollView. .PP -Inherited by QDataTable. +Inherited by TQDataTable. .PP .SS "Public Members" .in +1c @@ -622,7 +622,7 @@ See also adjustRow(). .PP Example: regexptester/regexptester.cpp. .PP -Reimplemented in QDataTable. +Reimplemented in TQDataTable. .SH "void QTable::adjustRow ( int row )\fC [virtual slot]\fR" Resizes row \fIrow\fR so that the row height is tall enough to display the tallest item the row contains. .PP @@ -923,11 +923,11 @@ Example: regexptester/regexptester.cpp. .SH "int QTable::numCols () const\fC [virtual]\fR" Returns the number of columns in the table. See the "numCols" property for details. .PP -Reimplemented in QDataTable. +Reimplemented in TQDataTable. .SH "int QTable::numRows () const\fC [virtual]\fR" Returns the number of rows in the table. See the "numRows" property for details. .PP -Reimplemented in QDataTable. +Reimplemented in TQDataTable. .SH "int QTable::numSelections () const" Returns the number of selections. See the "numSelections" property for details. .SH "void QTable::paintCell ( QPainter * p, int row, int col, const QRect & cr, bool selected, const QColorGroup & cg )\fC [virtual]\fR" @@ -1097,7 +1097,7 @@ See also columnWidth() and setRowHeight(). .PP Example: chart/setdataform.cpp. .PP -Reimplemented in QDataTable. +Reimplemented in TQDataTable. .SH "void QTable::setCurrentCell ( int row, int col )\fC [virtual slot]\fR" Moves the focus to the cell at \fIrow\fR, \fIcol\fR. .PP @@ -1210,7 +1210,7 @@ See also swapRows(). .PP Example: table/statistics/statistics.cpp. .PP -Reimplemented in QDataTable. +Reimplemented in TQDataTable. .SH "bool QTable::sorting () const" Returns TRUE if a click on the header of a column sorts that column; otherwise returns FALSE. See the "sorting" property for details. .SH "void QTable::startDrag ()\fC [virtual protected]\fR" @@ -1262,7 +1262,7 @@ See also setText() and setPixmap(). .PP Example: chart/setdataform.cpp. .PP -Reimplemented in QDataTable. +Reimplemented in TQDataTable. .SH "void QTable::updateCell ( int row, int col )" Repaints the cell at \fIrow\fR, \fIcol\fR. .SH "void QTable::updateHeaderStates ()" diff --git a/doc/man/man3/tqwidget.3qt b/doc/man/man3/tqwidget.3qt index ab8969d1c..456e74284 100644 --- a/doc/man/man3/tqwidget.3qt +++ b/doc/man/man3/tqwidget.3qt @@ -13,7 +13,7 @@ TQWidget \- The base class of all user interface objects .PP Inherits TQObject and QPaintDevice. .PP -Inherited by QAxWidget, QButton, QFrame, QDialog, QComboBox, QDataBrowser, QDataView, QDateTimeEditBase, QDateTimeEdit, QDesktopWidget, QDial, QDockArea, QGLWidget, QHeader, QMainWindow, QMotifWidget, QNPWidget, QScrollBar, QSizeGrip, QSlider, QSpinBox, QSplashScreen, QStatusBar, QTabBar, QTabWidget, QWorkspace, and QXtWidget. +Inherited by QAxWidget, QButton, QFrame, QDialog, QComboBox, TQDataBrowser, TQDataView, QDateTimeEditBase, QDateTimeEdit, QDesktopWidget, QDial, QDockArea, QGLWidget, QHeader, QMainWindow, QMotifWidget, QNPWidget, QScrollBar, QSizeGrip, QSlider, QSpinBox, QSplashScreen, QStatusBar, QTabBar, QTabWidget, QWorkspace, and QXtWidget. .PP .SS "Public Members" .in +1c |