\inmodule QtCore More...

#include <qitemselectionmodel.h>

Inheritance diagram for QItemSelection:

Collaboration diagram for QItemSelection:

Public Member Functions
Q_CORE_EXPORT	QItemSelection (const QModelIndex &topLeft, const QModelIndex &bottomRight)
	Constructs an empty selection.

Q_CORE_EXPORT void	select (const QModelIndex &topLeft, const QModelIndex &bottomRight)
	Adds the items in the range that extends from the top-left model item, specified by the topLeft index, to the bottom-right item, specified by bottomRight to the list.

Q_CORE_EXPORT bool	contains (const QModelIndex &index) const
	Returns `true` if the selection contains the given index; otherwise returns `false`.

Q_CORE_EXPORT QModelIndexList	indexes () const
	Returns a list of model indexes that correspond to the selected items.

Q_CORE_EXPORT void	merge (const QItemSelection &other, QItemSelectionModel::SelectionFlags command)
	Merges the other selection with this QItemSelection using the command given.

Public Member Functions inherited from QList< QItemSelectionRange >
	QList (DataPointer dd) noexcept

	QList ()=default

	QList (qsizetype size)

	QList (qsizetype size, parameter_type t)

	QList (std::initializer_list< QItemSelectionRange > args)

	QList (InputIterator i1, InputIterator i2)

	QList (const String &str)

QList< QItemSelectionRange > &	operator= (std::initializer_list< QItemSelectionRange > args)

void	swap (QList &other) noexcept

QTypeTraits::compare_eq_result_container< QList, U >	operator== (const QList &other) const

QTypeTraits::compare_eq_result_container< QList, U >	operator!= (const QList &other) const

QTypeTraits::compare_lt_result_container< QList, U >	operator< (const QList &other) const noexcept(noexcept(std::lexicographical_compare< typename QList< U >::const_iterator, typename QList::const_iterator >(std::declval< QList< U > >().begin(), std::declval< QList< U > >().end(), other.begin(), other.end())))

QTypeTraits::compare_lt_result_container< QList, U >	operator> (const QList &other) const noexcept(noexcept(other< std::declval< QList< U > >()))

QTypeTraits::compare_lt_result_container< QList, U >	operator<= (const QList &other) const noexcept(noexcept(other< std::declval< QList< U > >()))

QTypeTraits::compare_lt_result_container< QList, U >	operator>= (const QList &other) const noexcept(noexcept(std::declval< QList< U > >()< other))

qsizetype	size () const noexcept

qsizetype	count () const noexcept

qsizetype	count (const AT &t) const noexcept

qsizetype	length () const noexcept

bool	isEmpty () const noexcept

void	resize (qsizetype size)

void	resize (qsizetype size, parameter_type c)

qsizetype	capacity () const

void	reserve (qsizetype size)

void	squeeze ()

void	detach ()

bool	isDetached () const noexcept

bool	isSharedWith (const QList< QItemSelectionRange > &other) const

pointer	data ()

const_pointer	data () const noexcept

const_pointer	constData () const noexcept

void	clear ()

const_reference	at (qsizetype i) const noexcept

reference	operator[] (qsizetype i)

const_reference	operator[] (qsizetype i) const noexcept

void	append (parameter_type t)

void	append (const_iterator i1, const_iterator i2)

void	append (rvalue_ref t)

void	append (const QList< QItemSelectionRange > &l)

void	append (QList< QItemSelectionRange > &&l)

void	prepend (rvalue_ref t)

void	prepend (parameter_type t)

reference	emplaceBack (Args &&... args)

reference	emplaceFront (Args &&... args)

iterator	insert (qsizetype i, parameter_type t)

iterator	insert (qsizetype i, qsizetype n, parameter_type t)

iterator	insert (const_iterator before, parameter_type t)

iterator	insert (const_iterator before, qsizetype n, parameter_type t)

iterator	insert (const_iterator before, rvalue_ref t)

iterator	insert (qsizetype i, rvalue_ref t)

QList &	assign (qsizetype n, parameter_type t)

QList &	assign (InputIterator first, InputIterator last)

QList &	assign (std::initializer_list< QItemSelectionRange > l)

iterator	emplace (const_iterator before, Args &&... args)

iterator	emplace (qsizetype i, Args &&... args)

void	replace (qsizetype i, parameter_type t)

void	replace (qsizetype i, rvalue_ref t)

void	remove (qsizetype i, qsizetype n=1)

void	removeFirst () noexcept

void	removeLast () noexcept

value_type	takeFirst ()

value_type	takeLast ()

QList< QItemSelectionRange > &	fill (parameter_type t, qsizetype size=-1)

void	removeAt (qsizetype i)

qsizetype	removeAll (const AT &t)

bool	removeOne (const AT &t)

qsizetype	removeIf (Predicate pred)

QItemSelectionRange	takeAt (qsizetype i)

void	move (qsizetype from, qsizetype to)

iterator	begin ()

const_iterator	begin () const noexcept

iterator	end ()

const_iterator	end () const noexcept

const_iterator	cbegin () const noexcept

const_iterator	cend () const noexcept

const_iterator	constBegin () const noexcept

const_iterator	constEnd () const noexcept

reverse_iterator	rbegin ()

const_reverse_iterator	rbegin () const noexcept

reverse_iterator	rend ()

const_reverse_iterator	rend () const noexcept

const_reverse_iterator	crbegin () const noexcept

const_reverse_iterator	crend () const noexcept

iterator	erase (const_iterator begin, const_iterator end)

iterator	erase (const_iterator pos)

QItemSelectionRange &	first ()

const QItemSelectionRange &	first () const noexcept

QList< QItemSelectionRange >	first (qsizetype n) const

const QItemSelectionRange &	constFirst () const noexcept

QItemSelectionRange &	last ()

const QItemSelectionRange &	last () const noexcept

QList< QItemSelectionRange >	last (qsizetype n) const

const QItemSelectionRange &	constLast () const noexcept

bool	startsWith (parameter_type t) const

bool	endsWith (parameter_type t) const

QList< QItemSelectionRange >	mid (qsizetype pos, qsizetype len=-1) const

QList< QItemSelectionRange >	sliced (qsizetype pos) const

QList< QItemSelectionRange >	sliced (qsizetype pos, qsizetype n) const

QItemSelectionRange	value (qsizetype i) const

QItemSelectionRange	value (qsizetype i, parameter_type defaultValue) const

void	swapItemsAt (qsizetype i, qsizetype j)

void	push_back (parameter_type t)

void	push_back (rvalue_ref t)

void	push_front (rvalue_ref t)

void	push_front (parameter_type t)

void	pop_back () noexcept

void	pop_front () noexcept

reference	emplace_back (Args &&... args)

bool	empty () const noexcept

reference	front ()

const_reference	front () const noexcept

reference	back ()

const_reference	back () const noexcept

void	shrink_to_fit ()

QList< QItemSelectionRange > &	operator+= (const QList< QItemSelectionRange > &l)

QList< QItemSelectionRange > &	operator+= (QList< QItemSelectionRange > &&l)

QList< QItemSelectionRange > &	operator+= (parameter_type t)

QList< QItemSelectionRange > &	operator+= (rvalue_ref t)

QList< QItemSelectionRange >	operator+ (const QList< QItemSelectionRange > &l) const &

QList< QItemSelectionRange >	operator+ (const QList< QItemSelectionRange > &l) &&

QList< QItemSelectionRange >	operator+ (QList< QItemSelectionRange > &&l) const &

QList< QItemSelectionRange >	operator+ (QList< QItemSelectionRange > &&l) &&

QList< QItemSelectionRange > &	operator<< (parameter_type t)

QList< QItemSelectionRange > &	operator<< (const QList< QItemSelectionRange > &l)

QList< QItemSelectionRange > &	operator<< (QList< QItemSelectionRange > &&l)

QList< QItemSelectionRange > &	operator<< (rvalue_ref t)

QList< QItemSelectionRange >	toList () const noexcept

QList< QItemSelectionRange >	toVector () const noexcept

Public Member Functions inherited from QListSpecialMethodsBase< T >
template<typename AT = T>
qsizetype	indexOf (const AT &t, qsizetype from=0) const noexcept

template<typename AT = T>
qsizetype	lastIndexOf (const AT &t, qsizetype from=-1) const noexcept

template<typename AT = T>
bool	contains (const AT &t) const noexcept

Static Public Member Functions
static Q_CORE_EXPORT void	split (const QItemSelectionRange &range, const QItemSelectionRange &other, QItemSelection *result)
	Splits the selection range using the selection other range.

Static Public Member Functions inherited from QList< QItemSelectionRange >
static QList< QItemSelectionRange >	fromList (const QList< QItemSelectionRange > &list) noexcept

static QList< QItemSelectionRange >	fromVector (const QList< QItemSelectionRange > &vector) noexcept

static QList< QItemSelectionRange >	fromReadOnlyData (const QItemSelectionRange(&t)[N]) noexcept

Additional Inherited Members
Public Types inherited from QList< QItemSelectionRange >
using	Type = QItemSelectionRange

using	value_type = QItemSelectionRange

using	pointer = QItemSelectionRange *

using	const_pointer = const QItemSelectionRange *

using	reference = QItemSelectionRange &

using	const_reference = const QItemSelectionRange &

using	size_type = qsizetype

using	difference_type = qptrdiff

using	parameter_type = typename DataPointer::parameter_type

using	rvalue_ref = typename std::conditional< DataPointer::pass_parameter_by_value, DisableRValueRefs, QItemSelectionRange && >::type

using	Iterator = iterator

using	ConstIterator = const_iterator

using	reverse_iterator = std::reverse_iterator< iterator >

using	const_reverse_iterator = std::reverse_iterator< const_iterator >

Protected Types inherited from QListSpecialMethodsBase< T >
using	Self = QList< T >

Protected Member Functions inherited from QListSpecialMethods< T >
	~QListSpecialMethods ()=default

Protected Member Functions inherited from QListSpecialMethodsBase< T >
	~QListSpecialMethodsBase ()=default

Self *	self ()

const Self *	self () const

Detailed Description

\inmodule QtCore

The QItemSelection class manages information about selected items in a model.

A QItemSelection describes the items in a model that have been selected by the user. A QItemSelection is basically a list of selection ranges, see QItemSelectionRange. It provides functions for creating and manipulating selections, and selecting a range of items from a model.

The QItemSelection class is one of the \l{Model/View Classes} and is part of Qt's \l{Model/View Programming}{model/view framework}.

An item selection can be constructed and initialized to contain a range of items from an existing model. The following example constructs a selection that contains a range of items from the given model, beginning at the topLeft, and ending at the bottomRight.

QItemSelection *selection = new QItemSelection(topLeft, bottomRight);

QItemSelection

\inmodule QtCore

Definition qitemselectionmodel.h:182

selection

QItemSelection * selection

[0]

Definition src_gui_itemviews_qitemselectionmodel.cpp:5

An empty item selection can be constructed, and later populated as required. So, if the model is going to be unavailable when we construct the item selection, we can rewrite the above code in the following way:

QItemSelection *selection = new QItemSelection();
...
selection->select(topLeft, bottomRight);

QItemSelection saves memory, and avoids unnecessary work, by working with selection ranges rather than recording the model item index for each item in the selection. Generally, an instance of this class will contain a list of non-overlapping selection ranges.

Use merge() to merge one item selection into another without making overlapping ranges. Use split() to split one selection range into smaller ranges based on a another selection range.

See also: {Model/View Programming}, QItemSelectionModel

Definition at line 181 of file qitemselectionmodel.h.

Constructor & Destructor Documentation

◆ QItemSelection()

QItemSelection::QItemSelection	(	const QModelIndex &	topLeft,
		const QModelIndex &	bottomRight
	)

Constructs an empty selection.

Constructs an item selection that extends from the top-left model item, specified by the topLeft index, to the bottom-right item, specified by bottomRight.

Definition at line 375 of file qitemselectionmodel.cpp.

References select().

Here is the call graph for this function:

Member Function Documentation

◆ contains()

bool QItemSelection::contains ( const QModelIndex & index ) const

Returns true if the selection contains the given index; otherwise returns false.

Definition at line 415 of file qitemselectionmodel.cpp.

References QList< QItemSelectionRange >::begin(), QList< QItemSelectionRange >::end(), isSelectableAndEnabled(), and it.

Here is the call graph for this function:

◆ indexes()

QModelIndexList QItemSelection::indexes ( ) const

Returns a list of model indexes that correspond to the selected items.

Definition at line 430 of file qitemselectionmodel.cpp.

Referenced by QCompleterPrivate::_q_completionSelected(), QTreeWidgetPrivate::_q_selectionChanged(), QAbstractItemViewPrivate::clearOrRemove(), QAbstractProxyModel::mapSelectionFromSource(), QAbstractProxyModel::mapSelectionToSource(), QItemSelectionModel::selectedIndexes(), QListView::selectionChanged(), QTableView::selectionChanged(), QTreeView::selectionChanged(), QQuickTableViewPrivate::selectionChangedInSelectionModel(), and MainWindow::updateSelection().

Here is the caller graph for this function:

◆ merge()

void QItemSelection::merge	(	const QItemSelection &	other,
		QItemSelectionModel::SelectionFlags	command
	)

Merges the other selection with this QItemSelection using the command given.

This method guarantees that no ranges are overlapping.

Note that only QItemSelectionModel::Select, QItemSelectionModel::Deselect, and QItemSelectionModel::Toggle are supported.

See also: split()

Definition at line 453 of file qitemselectionmodel.cpp.

References QList< T >::append(), QList< T >::at(), at, QItemSelectionModel::Deselect, i, QItemSelectionRange::intersects(), QList< QItemSelectionRange >::operator+=(), other(), QList< T >::push_back(), QList< QItemSelectionRange >::removeAt(), QList< T >::removeAt(), QList< T >::reserve(), QItemSelectionModel::Select, QList< T >::size(), QList< QItemSelectionRange >::size(), split(), and QItemSelectionModel::Toggle.

Referenced by QItemSelectionModel::columnIntersectsSelection(), QItemSelectionModelPrivate::expandSelection(), QItemSelectionModel::hasSelection(), QItemSelectionModel::rowIntersectsSelection(), QItemSelectionModel::select(), QItemSelectionModel::selectedIndexes(), QItemSelectionModel::selection(), and QListView::setSelection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ select()

void QItemSelection::select	(	const QModelIndex &	topLeft,
		const QModelIndex &	bottomRight
	)

Adds the items in the range that extends from the top-left model item, specified by the topLeft index, to the bottom-right item, specified by bottomRight to the list.

Note: topLeft and bottomRight must have the same parent.

Definition at line 387 of file qitemselectionmodel.cpp.

References QList< QItemSelectionRange >::append(), QModelIndex::column(), QModelIndex::isValid(), QModelIndex::model(), QModelIndex::parent(), qMax(), qMin(), qWarning, QModelIndex::row(), and QModelIndex::sibling().

Referenced by QItemSelection(), main(), QListViewPrivate::selection(), and QListView::setSelection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ split()

void QItemSelection::split	(	const QItemSelectionRange &	range,
		const QItemSelectionRange &	other,
		QItemSelection *	result
	)

static

Splits the selection range using the selection other range.

Removes all items in other from range and puts the result in result. This can be compared with the semantics of the subtract operation of a set.

See also: merge()

Definition at line 507 of file qitemselectionmodel.cpp.

References QAbstractTableModel::index(), model, other(), parent, and Q_ASSERT.

Referenced by QItemSelectionModelPrivate::_q_rowsAboutToBeRemoved(), QItemSelectionModel::emitSelectionChanged(), and merge().

Here is the call graph for this function:

Here is the caller graph for this function:

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

qtbase/src/corelib/itemmodels/qitemselectionmodel.h
qtbase/src/corelib/itemmodels/qitemselectionmodel.cpp

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QItemSelection()

Member Function Documentation

◆ contains()

◆ indexes()

◆ merge()

◆ select()

◆ split()