Qt 4.8
Public Functions | Properties | List of all members
QRelatedTableModel Class Reference
Inheritance diagram for QRelatedTableModel:
QSqlTableModel QSqlQueryModel QAbstractTableModel QAbstractItemModel QObject

Public Functions

 QRelatedTableModel (QRelation *rel, QObject *parent=0, QSqlDatabase db=QSqlDatabase())
 
bool select ()
 Populates the model with data from the table that was set via setTable(), using the specified filter and sort condition, and returns true if successful; otherwise returns false. More...
 
- Public Functions inherited from QSqlTableModel
void clear ()
 Reimplemented Function More...
 
QVariant data (const QModelIndex &idx, int role=Qt::DisplayRole) const
 Reimplemented Function More...
 
QSqlDatabase database () const
 Returns a pointer to the used QSqlDatabase or 0 if no database was set. More...
 
EditStrategy editStrategy () const
 Returns the current edit strategy. More...
 
int fieldIndex (const QString &fieldName) const
 Returns the index of the field fieldName, or -1 if no corresponding field exists in the model. More...
 
QString filter () const
 Returns the currently set filter. More...
 
Qt::ItemFlags flags (const QModelIndex &index) const
 Reimplemented Function More...
 
QVariant headerData (int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const
 Reimplemented Function More...
 
bool insertRecord (int row, const QSqlRecord &record)
 Inserts the record after row. More...
 
bool insertRows (int row, int count, const QModelIndex &parent=QModelIndex())
 Inserts count empty rows at position row. More...
 
bool isDirty (const QModelIndex &index) const
 Returns true if the value at the index index is dirty, otherwise false. More...
 
QSqlIndex primaryKey () const
 Returns the primary key for the current table, or an empty QSqlIndex if the table is not set or has no primary key. More...
 
 QSqlTableModel (QObject *parent=0, QSqlDatabase db=QSqlDatabase())
 Creates an empty QSqlTableModel and sets the parent to parent and the database connection to db. More...
 
bool removeColumns (int column, int count, const QModelIndex &parent=QModelIndex())
 Removes count columns from the parent model, starting at index column. More...
 
bool removeRows (int row, int count, const QModelIndex &parent=QModelIndex())
 Removes count rows starting at row. More...
 
virtual void revertRow (int row)
 Reverts all changes for the specified row. More...
 
int rowCount (const QModelIndex &parent=QModelIndex()) const
 Reimplemented Function More...
 
bool setData (const QModelIndex &index, const QVariant &value, int role=Qt::EditRole)
 Sets the data for the item index for the role role to value. More...
 
virtual void setEditStrategy (EditStrategy strategy)
 Sets the strategy for editing values in the database to strategy. More...
 
virtual void setFilter (const QString &filter)
 Sets the current filter to filter. More...
 
bool setRecord (int row, const QSqlRecord &record)
 Sets the values at the specified row to the values of record. More...
 
virtual void setSort (int column, Qt::SortOrder order)
 Sets the sort order for column to order. More...
 
virtual void setTable (const QString &tableName)
 Sets the database table on which the model operates to tableName. More...
 
void sort (int column, Qt::SortOrder order)
 Sorts the data by column with the sort order order. More...
 
QString tableName () const
 Returns the name of the currently selected table. More...
 
virtual ~QSqlTableModel ()
 Destroys the object and frees any allocated resources. More...
 
- Public Functions inherited from QSqlQueryModel
bool canFetchMore (const QModelIndex &parent=QModelIndex()) const
 Returns true if it is possible to read more rows from the database. More...
 
int columnCount (const QModelIndex &parent=QModelIndex()) const
 Reimplemented Function More...
 
void fetchMore (const QModelIndex &parent=QModelIndex())
 Fetches more rows from a database. More...
 
bool insertColumns (int column, int count, const QModelIndex &parent=QModelIndex())
 Inserts count columns into the model at position column. More...
 
QSqlError lastError () const
 Returns information about the last error that occurred on the database. More...
 
 QSqlQueryModel (QObject *parent=0)
 Creates an empty QSqlQueryModel with the given parent. More...
 
QSqlQuery query () const
 Returns the QSqlQuery associated with this model. More...
 
QSqlRecord record (int row) const
 Returns the record containing information about the fields of the current query. More...
 
QSqlRecord record () const
 Returns an empty record containing information about the fields of the current query. More...
 
bool setHeaderData (int section, Qt::Orientation orientation, const QVariant &value, int role=Qt::EditRole)
 Sets the caption for a horizontal header for the specified role to value. More...
 
void setQuery (const QSqlQuery &query)
 Resets the model and sets the data provider to be the given query. More...
 
void setQuery (const QString &query, const QSqlDatabase &db=QSqlDatabase())
 Executes the query query for the given database connection db. More...
 
virtual ~QSqlQueryModel ()
 Destroys the object and frees any allocated resources. More...
 
- Public Functions inherited from QAbstractTableModel
bool dropMimeData (const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)
 Reimplemented Function More...
 
QModelIndex index (int row, int column, const QModelIndex &parent=QModelIndex()) const
 Returns the index of the data in row and column with parent. More...
 
 QAbstractTableModel (QObject *parent=0)
 Constructs an abstract table model for the given parent. More...
 
 ~QAbstractTableModel ()
 Destroys the abstract table model. More...
 
- Public Functions inherited from QAbstractItemModel
virtual QModelIndex buddy (const QModelIndex &index) const
 Returns a model index for the buddy of the item represented by index. More...
 
bool hasIndex (int row, int column, const QModelIndex &parent=QModelIndex()) const
 Returns true if the model returns a valid QModelIndex for row and column with parent, otherwise returns false. More...
 
bool insertColumn (int column, const QModelIndex &parent=QModelIndex())
 Inserts a single column before the given column in the child items of the parent specified. More...
 
bool insertRow (int row, const QModelIndex &parent=QModelIndex())
 Inserts a single row before the given row in the child items of the parent specified. More...
 
virtual QMap< int, QVariantitemData (const QModelIndex &index) const
 Returns a map with values for all predefined roles in the model for the item at the given index. More...
 
virtual QModelIndexList match (const QModelIndex &start, int role, const QVariant &value, int hits=1, Qt::MatchFlags flags=Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const
 Returns a list of indexes for the items in the column of the start index where data stored under the given role matches the specified value. More...
 
virtual QMimeDatamimeData (const QModelIndexList &indexes) const
 Returns an object that contains serialized items of data corresponding to the list of indexes specified. More...
 
virtual QStringList mimeTypes () const
 Returns a list of MIME types that can be used to describe a list of model indexes. More...
 
 QAbstractItemModel (QObject *parent=0)
 Constructs an abstract item model with the given parent. More...
 
bool removeColumn (int column, const QModelIndex &parent=QModelIndex())
 Removes the given column from the child items of the parent specified. More...
 
bool removeRow (int row, const QModelIndex &parent=QModelIndex())
 Removes the given row from the child items of the parent specified. More...
 
const QHash< int, QByteArray > & roleNames () const
 Returns the model's role names. More...
 
virtual bool setItemData (const QModelIndex &index, const QMap< int, QVariant > &roles)
 Sets the role data for the item at index to the associated value in roles, for every Qt::ItemDataRole. More...
 
void setSupportedDragActions (Qt::DropActions)
 Sets the supported drag actions for the items in the model. More...
 
QModelIndex sibling (int row, int column, const QModelIndex &idx) const
 Returns the sibling at row and column for the item at index, or an invalid QModelIndex if there is no sibling at that location. More...
 
virtual QSize span (const QModelIndex &index) const
 Returns the row and column span of the item represented by index. More...
 
Qt::DropActions supportedDragActions () const
 Returns the actions supported by the data in this model. More...
 
virtual Qt::DropActions supportedDropActions () const
 Returns the drop actions supported by this model. More...
 
virtual ~QAbstractItemModel ()
 Destroys the abstract item model. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool event (QEvent *)
 This virtual function receives events to an object and should return true if the event e was recognized and processed. More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
virtual const QMetaObjectmetaObject () const
 Returns a pointer to the meta-object of this object. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 

Properties

bool firstSelect
 
QRelationrelation
 

Additional Inherited Members

- Public Types inherited from QSqlTableModel
enum  EditStrategy { OnFieldChange, OnRowChange, OnManualSubmit }
 This enum type describes which strategy to choose when editing values in the database. More...
 
- Public Slots inherited from QSqlTableModel
void revert ()
 This reimplemented slot is called by the item delegates when the user canceled editing the current row. More...
 
void revertAll ()
 Reverts all pending changes. More...
 
bool submit ()
 This reimplemented slot is called by the item delegates when the user stopped editing the current row. More...
 
bool submitAll ()
 Submits all pending changes and returns true on success. More...
 
- Public Slots inherited from QAbstractItemModel
virtual void revert ()
 Lets the model know that it should discard cached information. More...
 
virtual bool submit ()
 Lets the model know that it should submit cached information to permanent storage. More...
 
- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Signals inherited from QSqlTableModel
void beforeDelete (int row)
 This signal is emitted by deleteRowFromTable() before the row is deleted from the currently active database table. More...
 
void beforeInsert (QSqlRecord &record)
 This signal is emitted by insertRowIntoTable() before a new row is inserted into the currently active database table. More...
 
void beforeUpdate (int row, QSqlRecord &record)
 This signal is emitted by updateRowInTable() before the row is updated in the currently active database table with the values from record. More...
 
void primeInsert (int row, QSqlRecord &record)
 This signal is emitted by insertRows(), when an insertion is initiated in the given row of the currently active database table. More...
 
- Signals inherited from QAbstractItemModel
void columnsAboutToBeInserted (const QModelIndex &parent, int first, int last)
 This signal is emitted just before columns are inserted into the model. More...
 
void columnsAboutToBeMoved (const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationColumn)
 This signal is emitted just before columns are moved within the model. More...
 
void columnsAboutToBeRemoved (const QModelIndex &parent, int first, int last)
 This signal is emitted just before columns are removed from the model. More...
 
void columnsInserted (const QModelIndex &parent, int first, int last)
 This signal is emitted after columns have been inserted into the model. More...
 
void columnsMoved (const QModelIndex &parent, int start, int end, const QModelIndex &destination, int column)
 This signal is emitted after columns have been moved within the model. More...
 
void columnsRemoved (const QModelIndex &parent, int first, int last)
 This signal is emitted after columns have been removed from the model. More...
 
void dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight)
 This signal is emitted whenever the data in an existing item changes. More...
 
void headerDataChanged (Qt::Orientation orientation, int first, int last)
 This signal is emitted whenever a header is changed. More...
 
void layoutAboutToBeChanged ()
 This signal is emitted just before the layout of a model is changed. More...
 
void layoutChanged ()
 This signal is emitted whenever the layout of items exposed by the model has changed; for example, when the model has been sorted. More...
 
void modelAboutToBeReset ()
 This signal is emitted when reset() is called, before the model's internal state (e. More...
 
void modelReset ()
 This signal is emitted when reset() is called, after the model's internal state (e. More...
 
void rowsAboutToBeInserted (const QModelIndex &parent, int first, int last)
 This signal is emitted just before rows are inserted into the model. More...
 
void rowsAboutToBeMoved (const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationRow)
 This signal is emitted just before rows are moved within the model. More...
 
void rowsAboutToBeRemoved (const QModelIndex &parent, int first, int last)
 This signal is emitted just before rows are removed from the model. More...
 
void rowsInserted (const QModelIndex &parent, int first, int last)
 This signal is emitted after rows have been inserted into the model. More...
 
void rowsMoved (const QModelIndex &parent, int start, int end, const QModelIndex &destination, int row)
 This signal is emitted after rows have been moved within the model. More...
 
void rowsRemoved (const QModelIndex &parent, int first, int last)
 This signal is emitted after rows have been removed from the model. More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Slots inherited from QAbstractItemModel
void resetInternalData ()
 This slot is called just after the internal data of a model is cleared while it is being reset. More...
 
- Protected Functions inherited from QSqlTableModel
virtual bool deleteRowFromTable (int row)
 Deletes the given row from the currently active database table. More...
 
QModelIndex indexInQuery (const QModelIndex &item) const
 Returns the index of the value in the database result set for the given item in the model. More...
 
virtual bool insertRowIntoTable (const QSqlRecord &values)
 Inserts the values values into the currently active database table. More...
 
virtual QString orderByClause () const
 Returns an SQL ORDER BY clause based on the currently set sort order. More...
 
 QSqlTableModel (QSqlTableModelPrivate &dd, QObject *parent=0, QSqlDatabase db=QSqlDatabase())
 
virtual QString selectStatement () const
 Returns the SQL SELECT statement used internally to populate the model. More...
 
void setPrimaryKey (const QSqlIndex &key)
 Protected method that allows subclasses to set the primary key to key. More...
 
void setQuery (const QSqlQuery &query)
 This function simply calls QSqlQueryModel::setQuery(query). More...
 
virtual bool updateRowInTable (int row, const QSqlRecord &values)
 Updates the given row in the currently active database table with the specified values. More...
 
- Protected Functions inherited from QSqlQueryModel
QModelIndex indexInQuery (const QModelIndex &item) const
 Returns the index of the value in the database result set for the given item in the model. More...
 
 QSqlQueryModel (QSqlQueryModelPrivate &dd, QObject *parent=0)
 
virtual void queryChange ()
 This virtual function is called whenever the query changes. More...
 
void setLastError (const QSqlError &error)
 Protected function which allows derived classes to set the value of the last error that occurred on the database to error. More...
 
- Protected Functions inherited from QAbstractTableModel
 QAbstractTableModel (QAbstractItemModelPrivate &dd, QObject *parent)
 Constructs an abstract table model with dd and the given parent. More...
 
- Protected Functions inherited from QAbstractItemModel
void beginInsertColumns (const QModelIndex &parent, int first, int last)
 Begins a column insertion operation. More...
 
void beginInsertRows (const QModelIndex &parent, int first, int last)
 Begins a row insertion operation. More...
 
bool beginMoveColumns (const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationColumn)
 Begins a column move operation. More...
 
bool beginMoveRows (const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationRow)
 Begins a row move operation. More...
 
void beginRemoveColumns (const QModelIndex &parent, int first, int last)
 Begins a column removal operation. More...
 
void beginRemoveRows (const QModelIndex &parent, int first, int last)
 Begins a row removal operation. More...
 
void beginResetModel ()
 Begins a model reset operation. More...
 
void changePersistentIndex (const QModelIndex &from, const QModelIndex &to)
 Changes the QPersistentModelIndex that is equal to the given from model index to the given to model index. More...
 
void changePersistentIndexList (const QModelIndexList &from, const QModelIndexList &to)
 Changes the QPersistentModelIndexes that is equal to the indexes in the given from model index list to the given to model index list. More...
 
QModelIndex createIndex (int row, int column, void *data=0) const
 Creates a model index for the given row and column with the internal pointer ptr. More...
 
QModelIndex createIndex (int row, int column, int id) const
 Use QModelIndex QAbstractItemModel::createIndex(int row, int column, quint32 id) instead. More...
 
QModelIndex createIndex (int row, int column, quint32 id) const
 Creates a model index for the given row and column with the internal identifier, id. More...
 
bool decodeData (int row, int column, const QModelIndex &parent, QDataStream &stream)
 
void encodeData (const QModelIndexList &indexes, QDataStream &stream) const
 
void endInsertColumns ()
 Ends a column insertion operation. More...
 
void endInsertRows ()
 Ends a row insertion operation. More...
 
void endMoveColumns ()
 Ends a column move operation. More...
 
void endMoveRows ()
 Ends a row move operation. More...
 
void endRemoveColumns ()
 Ends a column removal operation. More...
 
void endRemoveRows ()
 Ends a row removal operation. More...
 
void endResetModel ()
 Completes a model reset operation. More...
 
QModelIndexList persistentIndexList () const
 Returns the list of indexes stored as persistent indexes in the model. More...
 
 QAbstractItemModel (QAbstractItemModelPrivate &dd, QObject *parent=0)
 
void reset ()
 Resets the model to its original state in any attached views. More...
 
void setRoleNames (const QHash< int, QByteArray > &roleNames)
 Sets the model's role names to roleNames. More...
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void connectNotify (const char *signal)
 This virtual function is called when something has been connected to signal in this object. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *)
 This event handler can be reimplemented in a subclass to receive timer events for the object. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

Definition at line 169 of file qsqlrelationaltablemodel.cpp.

Constructors and Destructors

◆ QRelatedTableModel()

QRelatedTableModel::QRelatedTableModel ( QRelation rel,
QObject parent = 0,
QSqlDatabase  db = QSqlDatabase() 
)

Definition at line 256 of file qsqlrelationaltablemodel.cpp.

256  :
257  QSqlTableModel(parent, db), firstSelect(true), relation(rel)
258 {
259 }
QSqlTableModel(QObject *parent=0, QSqlDatabase db=QSqlDatabase())
Creates an empty QSqlTableModel and sets the parent to parent and the database connection to db...

Functions

◆ select()

bool QRelatedTableModel::select ( )
virtual

Populates the model with data from the table that was set via setTable(), using the specified filter and sort condition, and returns true if successful; otherwise returns false.

Note
Calling select() will revert any unsubmitted changes and remove any inserted columns.
See also
setTable(), setFilter(), selectStatement()

Reimplemented from QSqlTableModel.

Definition at line 261 of file qsqlrelationaltablemodel.cpp.

Referenced by QRelation::populateModel().

262 {
263  if (firstSelect) {
264  firstSelect = false;
265  return QSqlTableModel::select();
266  }
268  bool res = QSqlTableModel::select();
269  if (res)
271  return res;
272 }
virtual bool select()
Populates the model with data from the table that was set via setTable(), using the specified filter ...

Properties

◆ firstSelect

bool QRelatedTableModel::firstSelect
private

Definition at line 175 of file qsqlrelationaltablemodel.cpp.

Referenced by select().

◆ relation

QRelation* QRelatedTableModel::relation
private

Definition at line 176 of file qsqlrelationaltablemodel.cpp.

Referenced by select().


The documentation for this class was generated from the following file: