The QPersistentModelIndex class is used to locate data in a data model. More...

#include <qabstractitemmodel.h>

Public Member Functions
	QPersistentModelIndex ()

	QPersistentModelIndex (const QModelIndex &index)

	QPersistentModelIndex (const QPersistentModelIndex &other)

	~QPersistentModelIndex ()

bool	operator< (const QPersistentModelIndex &other) const

bool	operator== (const QPersistentModelIndex &other) const

bool	operator!= (const QPersistentModelIndex &other) const

QPersistentModelIndex &	operator= (const QPersistentModelIndex &other)

	QPersistentModelIndex (QPersistentModelIndex &&other) noexcept

void	swap (QPersistentModelIndex &other) noexcept

bool	operator== (const QModelIndex &other) const

bool	operator!= (const QModelIndex &other) const

QPersistentModelIndex &	operator= (const QModelIndex &other)

	operator QModelIndex () const

int	row () const

int	column () const

void *	internalPointer () const

const void *	constInternalPointer () const

quintptr	internalId () const

QModelIndex	parent () const

QModelIndex	sibling (int row, int column) const

QVariant	data (int role=Qt::DisplayRole) const

void	multiData (QModelRoleDataSpan roleDataSpan) const

Qt::ItemFlags	flags () const

const QAbstractItemModel *	model () const

bool	isValid () const

Friends
size_t	qHash (const QPersistentModelIndex &, size_t seed) noexcept

bool	qHashEquals (const QPersistentModelIndex &a, const QPersistentModelIndex &b) noexcept

Q_CORE_EXPORT QDebug	operator<< (QDebug, const QPersistentModelIndex &)

Related Functions
(Note that these are not member functions.)
size_t	qHash (const QPersistentModelIndex &index, size_t seed=0)

Detailed Description

The QPersistentModelIndex class is used to locate data in a data model.

\inmodule QtCore

A QPersistentModelIndex is a model index that can be stored by an application, and later used to access information in a model. Unlike the QModelIndex class, it is safe to store a QPersistentModelIndex since the model will ensure that references to items will continue to be valid as long as they can be accessed by the model.

It is good practice to check that persistent model indexes are valid before using them.

Note: You cannot store a QStandardItemModel's QPersistentModelIndex in one of the model's items.

See also: {Model/View Programming}, QModelIndex, QAbstractItemModel

Definition at line 210 of file qabstractitemmodel.h.

Constructor & Destructor Documentation

◆ QPersistentModelIndex() [1/4]

QPersistentModelIndex::QPersistentModelIndex ( )

Definition at line 365 of file qabstractitemmodel.cpp.

◆ QPersistentModelIndex() [2/4]

QPersistentModelIndex::QPersistentModelIndex ( const QModelIndex & index )

Creates a new QPersistentModelIndex that is a copy of the model index.

Definition at line 387 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ QPersistentModelIndex() [3/4]

QPersistentModelIndex::QPersistentModelIndex ( const QPersistentModelIndex & other )

Creates a new QPersistentModelIndex that is a copy of the other persistent model index.

Definition at line 377 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ ~QPersistentModelIndex()

QPersistentModelIndex::~QPersistentModelIndex ( )

Definition at line 402 of file qabstractitemmodel.cpp.

◆ QPersistentModelIndex() [4/4]

QPersistentModelIndex::QPersistentModelIndex ( QPersistentModelIndex && other )

inlinenoexcept

Move-constructs a QPersistentModelIndex instance, making it point at the same object that other was pointing to.

Since: 5.2

Definition at line 222 of file qabstractitemmodel.h.

Member Function Documentation

◆ column()

int QPersistentModelIndex::column ( ) const

Returns the column this persistent model index refers to.

Definition at line 553 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ constInternalPointer()

const void * QPersistentModelIndex::constInternalPointer ( ) const

Since: 6.0

Definition at line 585 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ data()

QVariant QPersistentModelIndex::data ( int role = Qt::DisplayRole ) const

Returns the data for the given role for the item referred to by the index.

See also: Qt::ItemDataRole, QAbstractItemModel::setData()

Definition at line 641 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ flags()

Qt::ItemFlags QPersistentModelIndex::flags ( ) const

Since: 4.2

Returns the flags for the item referred to by the index.

Definition at line 667 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ internalId()

quintptr QPersistentModelIndex::internalId ( ) const

Definition at line 601 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ internalPointer()

void * QPersistentModelIndex::internalPointer ( ) const

Definition at line 569 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ isValid()

bool QPersistentModelIndex::isValid ( ) const

Returns {true} if this persistent model index is valid; otherwise returns {false}.

A valid index belongs to a model, and has non-negative row and column numbers.

See also: model(), row(), column()

Definition at line 696 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ model()

const QAbstractItemModel * QPersistentModelIndex::model ( ) const

Returns the model that the index belongs to.

Definition at line 677 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ multiData()

void QPersistentModelIndex::multiData ( QModelRoleDataSpan roleDataSpan ) const

Populates the given roleDataSpan for the item referred to by the index.

Since: 6.0

See also: Qt::ItemDataRole, QAbstractItemModel::setData()

Definition at line 656 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ operator QModelIndex()

QPersistentModelIndex::operator QModelIndex ( ) const

Cast operator that returns a QModelIndex.

Definition at line 498 of file qabstractitemmodel.cpp.

◆ operator!=() [1/2]

bool QPersistentModelIndex::operator!= ( const QModelIndex & other ) const

Returns {true} if this persistent model index does not refer to the same location as the other model index; otherwise returns {false}.

Definition at line 527 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ operator!=() [2/2]

bool QPersistentModelIndex::operator!= ( const QPersistentModelIndex & other ) const

inline

Since: 4.2

Returns {true} if this persistent model index is not equal to the other persistent model index; otherwise returns {false}.

Definition at line 219 of file qabstractitemmodel.h.

Here is the call graph for this function:

◆ operator<()

bool QPersistentModelIndex::operator< ( const QPersistentModelIndex & other ) const

Since: 4.1

Returns {true} if this persistent model index is smaller than the other persistent model index; otherwise returns {false}.

The internal data pointer, row, column, and model values in the persistent model index are used when comparing with another persistent model index.

Definition at line 435 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ operator=() [1/2]

QPersistentModelIndex & QPersistentModelIndex::operator= ( const QModelIndex & other )

Sets the persistent model index to refer to the same item in a model as the other model index.

Definition at line 479 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ operator=() [2/2]

QPersistentModelIndex & QPersistentModelIndex::operator= ( const QPersistentModelIndex & other )

Sets the persistent model index to refer to the same item in a model as the other persistent model index.

Definition at line 456 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ operator==() [1/2]

bool QPersistentModelIndex::operator== ( const QModelIndex & other ) const

Returns {true} if this persistent model index refers to the same location as the other model index; otherwise returns {false}.

The internal data pointer, row, column, and model values in the persistent model index are used when comparing with another model index.

Definition at line 513 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ operator==() [2/2]

bool QPersistentModelIndex::operator== ( const QPersistentModelIndex & other ) const

Returns {true} if this persistent model index is equal to the other persistent model index; otherwise returns {false}.

The internal data pointer, row, column, and model values in the persistent model index are used when comparing with another persistent model index.

Definition at line 418 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ parent()

QModelIndex QPersistentModelIndex::parent ( ) const

Returns the parent QModelIndex for this persistent index, or an invalid QModelIndex if it has no parent.

See also: sibling(), model()

Definition at line 614 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ row()

int QPersistentModelIndex::row ( ) const

Returns the row this persistent model index refers to.

Definition at line 540 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sibling()

QModelIndex QPersistentModelIndex::sibling	(	int	row,
		int	column
	)		const

Returns the sibling at row and column or an invalid QModelIndex if there is no sibling at this position.

See also: parent()

Definition at line 628 of file qabstractitemmodel.cpp.

Here is the call graph for this function:

◆ swap()

void QPersistentModelIndex::swap ( QPersistentModelIndex & other )

inlinenoexcept

Since: 5.0

Swaps this persistent modelindex with other. This function is very fast and never fails.

Definition at line 225 of file qabstractitemmodel.h.

Here is the call graph for this function:

Friends And Related Function Documentation

◆ operator<<

Q_CORE_EXPORT QDebug operator<<	(	QDebug	,
		const QPersistentModelIndex &
	)

friend

Definition at line 710 of file qabstractitemmodel.cpp.

◆ qHash [1/2]

size_t qHash	(	const QPersistentModelIndex &	index,
		size_t	seed = `0`
	)

friend

Since: 5.0

Returns a hash of the QPersistentModelIndex index, using seed to seed the calculation.

Definition at line 253 of file qabstractitemmodel.h.

◆ qHash() [2/2]

size_t qHash	(	const QPersistentModelIndex &	index,
		size_t	seed = `0`
	)

Since: 5.0

Returns a hash of the QPersistentModelIndex index, using seed to seed the calculation.

Definition at line 253 of file qabstractitemmodel.h.

◆ qHashEquals

bool qHashEquals	(	const QPersistentModelIndex &	a,
		const QPersistentModelIndex &	b
	)

friend

Definition at line 245 of file qabstractitemmodel.h.

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

src/corelib/itemmodels/qabstractitemmodel.h
src/corelib/itemmodels/qabstractitemmodel.cpp

Public Member Functions

Friends

Related Functions

Detailed Description

Constructor & Destructor Documentation

◆ QPersistentModelIndex() [1/4]

◆ QPersistentModelIndex() [2/4]

◆ QPersistentModelIndex() [3/4]

◆ ~QPersistentModelIndex()

◆ QPersistentModelIndex() [4/4]

Member Function Documentation

◆ column()

◆ constInternalPointer()

◆ data()

◆ flags()

◆ internalId()

◆ internalPointer()

◆ isValid()

◆ model()

◆ multiData()

◆ operator QModelIndex()

◆ operator!=() [1/2]

◆ operator!=() [2/2]

◆ operator<()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==() [1/2]

◆ operator==() [2/2]

◆ parent()

◆ row()

◆ sibling()

◆ swap()

Friends And Related Function Documentation

◆ operator<<

◆ qHash [1/2]

◆ qHash() [2/2]

◆ qHashEquals