The QAbstractItemModelTester class helps testing QAbstractItemModel subclasses. More...

#include <qabstractitemmodeltester.h>

Inheritance diagram for QAbstractItemModelTester:

Collaboration diagram for QAbstractItemModelTester:

Public Types
enum class	FailureReportingMode { QtTest , Warning , Fatal }

Public Member Functions
	QAbstractItemModelTester (QAbstractItemModel model, QObject parent=nullptr)

	QAbstractItemModelTester (QAbstractItemModel model, FailureReportingMode mode, QObject parent=nullptr)

QAbstractItemModel *	model () const

FailureReportingMode	failureReportingMode () const

Public Member Functions inherited from QObject
Q_INVOKABLE	QObject (QObject *parent=nullptr)

virtual	~QObject ()

virtual bool	event (QEvent *event)

virtual bool	eventFilter (QObject watched, QEvent event)

QString	objectName () const

void	setObjectName (const QString &name)

QBindable< QString >	bindableObjectName ()

bool	isWidgetType () const

bool	isWindowType () const

bool	signalsBlocked () const noexcept

bool	blockSignals (bool b) noexcept

QThread *	thread () const

void	moveToThread (QThread *thread)

int	startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)

void	killTimer (int id)

template<typename T >
T	findChild (const QString &aName=QString(), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

template<typename T >
QList< T >	findChildren (const QString &aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

template<typename T >
QList< T >	findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

const QObjectList &	children () const

void	setParent (QObject *parent)

void	installEventFilter (QObject *filterObj)

void	removeEventFilter (QObject *obj)

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const

bool	disconnect (const char signal=nullptr, const QObject receiver=nullptr, const char *member=nullptr) const

bool	disconnect (const QObject receiver, const char member=nullptr) const

void	dumpObjectTree () const

void	dumpObjectInfo () const

bool	setProperty (const char *name, const QVariant &value)

QVariant	property (const char *name) const

QList< QByteArray >	dynamicPropertyNames () const

QBindingStorage *	bindingStorage ()

const QBindingStorage *	bindingStorage () const

QObject *	parent () const

bool	inherits (const char *classname) const

Friends
bool	QTestPrivate::testDataGuiRoles (QAbstractItemModelTester *tester)

Additional Inherited Members
Public Slots inherited from QObject
void	deleteLater ()

Signals inherited from QObject
void	destroyed (QObject *=nullptr)

void	objectNameChanged (const QString &objectName, QPrivateSignal)

Static Public Member Functions inherited from QObject
static QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char member, Qt::ConnectionType=Qt::AutoConnection)

static QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)

template<typename Func1 , typename Func2 >
static QMetaObject::Connection	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object receiver, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

static QMetaObject::Connection ::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 slot)

static QMetaObject::Connection ::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject context, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

template<typename Func1 , typename Func2 >
static std::enable_if< QtPrivate::FunctionPointer< Func2 >::ArgumentCount==-1 &&!std::is_convertible_v< Func2, const char * >, QMetaObject::Connection >::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 slot)

template<typename Func1 , typename Func2 >
static std::enable_if< QtPrivate::FunctionPointer< Func2 >::ArgumentCount==-1 &&!std::is_convertible_v< Func2, const char * >, QMetaObject::Connection >::type	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject context, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

static bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char member)

static bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &member)

static bool	disconnect (const QMetaObject::Connection &)

template<typename Func1 , typename Func2 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object receiver, Func2 slot)

template<typename Func1 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject receiver, void **zero)

Protected Member Functions inherited from QObject
QObject *	sender () const

int	senderSignalIndex () const

int	receivers (const char *signal) const

bool	isSignalConnected (const QMetaMethod &signal) const

virtual void	timerEvent (QTimerEvent *event)

virtual void	childEvent (QChildEvent *event)

virtual void	customEvent (QEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	disconnectNotify (const QMetaMethod &signal)

	QObject (QObjectPrivate &dd, QObject *parent=nullptr)

Protected Attributes inherited from QObject
QScopedPointer< QObjectData >	d_ptr

Properties inherited from QObject
QString	objectName
	the name of this object More...

Related Functions inherited from QObject
template< class T > T	qobject_cast (const QObject *object)

template< typename T > T	qFindChildqFindChildren (const QObject *obj, const QString &name)()

template< typename T > QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QString &name)()

	QObjectList

Detailed Description

The QAbstractItemModelTester class helps testing QAbstractItemModel subclasses.

Since: 5.11 \inmodule QtTest

The QAbstractItemModelTester class is a utility class to test item models.

When implementing an item model (that is, a concrete QAbstractItemModel subclass) one must abide to a very strict set of rules that ensure consistency for users of the model (views, proxy models, and so on).

For instance, for a given index, a model's reimplementation of \l{QAbstractItemModel::hasChildren()}{hasChildren()} must be consistent with the values returned by \l{QAbstractItemModel::rowCount()}{rowCount()} and \l{QAbstractItemModel::columnCount()}{columnCount()}.

QAbstractItemModelTester helps catching the most common errors in custom item model classes. By performing a series of tests, it will try to check that the model status is consistent at all times. The tests will be repeated automatically every time the model is modified.

QAbstractItemModelTester employs non-destructive tests, which typically consist in reading data and metadata out of a given item model. QAbstractItemModelTester will also attempt illegal modifications of the model. In models which are properly implemented, such attempts should be rejected, and no data should be changed as a consequence.

Definition at line 69 of file qabstractitemmodeltester.h.

Member Enumeration Documentation

◆ FailureReportingMode

enum QAbstractItemModelTester::FailureReportingMode

strong

This enumeration specifies how QAbstractItemModelTester should report a failure when it tests a QAbstractItemModel subclass.

\value QtTest The failures will be reported as QtTest test failures.

\value Warning The failures will be reported as warning messages in the {qt.modeltest} logging category.

\value Fatal A failure will cause immediate and abnormal program termination. The reason for the failure will be reported using {qFatal()}.

Enumerator
QtTest
Warning
Fatal

Definition at line 75 of file qabstractitemmodeltester.h.

Constructor & Destructor Documentation

◆ QAbstractItemModelTester() [1/2]

QAbstractItemModelTester::QAbstractItemModelTester	(	QAbstractItemModel *	model,
		QObject *	parent = `nullptr`
	)

Creates a model tester instance, with the given parent, that will test the model model.

Definition at line 202 of file qabstractitemmodeltester.cpp.

◆ QAbstractItemModelTester() [2/2]

QAbstractItemModelTester::QAbstractItemModelTester	(	QAbstractItemModel *	model,
		FailureReportingMode	mode,
		QObject *	parent = `nullptr`
	)

Creates a model tester instance, with the given parent, that will test the model model, using the specified mode to report test failures.

See also: QAbstractItemModelTester::FailureReportingMode

Definition at line 213 of file qabstractitemmodeltester.cpp.

Here is the call graph for this function:

Member Function Documentation

◆ failureReportingMode()

QAbstractItemModelTester::FailureReportingMode QAbstractItemModelTester::failureReportingMode ( ) const

Returns the mode that this instancing is using to report test failures.

See also: QAbstractItemModelTester::FailureReportingMode

Definition at line 286 of file qabstractitemmodeltester.cpp.

◆ model()

QAbstractItemModel * QAbstractItemModelTester::model ( ) const

Returns the model that this instance is testing.

Definition at line 275 of file qabstractitemmodeltester.cpp.

Here is the caller graph for this function:

Friends And Related Function Documentation

◆ QTestPrivate::testDataGuiRoles

bool QTestPrivate::testDataGuiRoles ( QAbstractItemModelTester * tester )

friend

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

src/testlib/qabstractitemmodeltester.h
src/testlib/qabstractitemmodeltester.cpp

Public Types

Public Member Functions

Friends

Additional Inherited Members