|  | Home · All Classes · Modules

# QItemSelectionRange Class Reference
[QtGui module]

The QItemSelectionRange class manages information about a range of selected items in a model. More...

### Methods

- __init__ (self)
- __init__ (self, QItemSelectionRange other)
- __init__ (self, QModelIndex atopLeft, QModelIndex abottomRight)
- __init__ (self, QModelIndex index)
- int bottom (self)
- QModelIndex bottomRight (self)
- bool contains (self, QModelIndex index)
- bool contains (self, int row, int column, QModelIndex parentIndex)
- int height (self)
- QModelIndex-list indexes (self)
- QItemSelectionRange intersect (self, QItemSelectionRange other)
- QItemSelectionRange intersected (self, QItemSelectionRange other)
- bool intersects (self, QItemSelectionRange other)
- bool isValid (self)
- int left (self)
- QAbstractItemModel model (self)
- QModelIndex parent (self)
- int right (self)
- int top (self)
- QModelIndex topLeft (self)
- int width (self)

### Special Methods

- bool __eq__ (self, QItemSelectionRange other)
- long __hash__ (self)
- bool __ne__ (self, QItemSelectionRange other)

## Detailed Description

The QItemSelectionRange class manages information about a range of selected items in a model.

A QItemSelectionRange contains information about a range of selected items in a model. A range of items is a contiguous array of model items, extending to cover a number of adjacent rows and columns with a common parent item; this can be visualized as a two-dimensional block of cells in a table. A selection range has a top(), left() a bottom(), right() and a parent().

The QItemSelectionRange class is one of the Model/View Classes and is part of Qt's model/view framework.

The model items contained in the selection range can be obtained using the indexes() function. Use QItemSelectionModel.selectedIndexes() to get a list of all selected items for a view.

You can determine whether a given model item lies within a particular range by using the contains() function. Ranges can also be compared using the overloaded operators for equality and inequality, and the intersects() function allows you to determine whether two ranges overlap.

See also Model/View Programming, QAbstractItemModel, QItemSelection, and QItemSelectionModel.

## Method Documentation

### QItemSelectionRange.__init__ (self)

Constructs an empty selection range.

### QItemSelectionRange.__init__ (self, QItemSelectionRange other)

Copy constructor. Constructs a new selection range with the same contents as the other range given.

### QItemSelectionRange.__init__ (self, QModelIndex atopLeft, QModelIndex abottomRight)

Constructs a new selection range containing only the index specified by the topLeft and the index bottomRight.

### QItemSelectionRange.__init__ (self, QModelIndex index)

Constructs a new selection range containing only the model item specified by the model index index.

### int QItemSelectionRange.bottom (self)

Returns the row index corresponding to the lowermost selected row in the selection range.

### QModelIndex QItemSelectionRange.bottomRight (self)

Returns the index for the item located at the bottom-right corner of the selection range.

See also bottom(), right(), and topLeft().

### bool QItemSelectionRange.contains (self, QModelIndex index)

Returns true if the model item specified by the index lies within the range of selected items; otherwise returns false.

### bool QItemSelectionRange.contains (self, int row, int column, QModelIndex parentIndex)

This is an overloaded member function, provided for convenience.

Returns true if the model item specified by (row, column) and with parentIndex as the parent item lies within the range of selected items; otherwise returns false.

### int QItemSelectionRange.height (self)

Returns the number of selected rows in the selection range.

### QModelIndex-list QItemSelectionRange.indexes (self)

Returns the list of model index items stored in the selection.

### QItemSelectionRange QItemSelectionRange.intersect (self, QItemSelectionRange other)

### QItemSelectionRange QItemSelectionRange.intersected (self, QItemSelectionRange other)

Returns a new selection range containing only the items that are found in both the selection range and the other selection range.

This function was introduced in Qt 4.2.

### bool QItemSelectionRange.intersects (self, QItemSelectionRange other)

Returns true if this selection range intersects (overlaps with) the other range given; otherwise returns false.

### bool QItemSelectionRange.isValid (self)

Returns true if the selection range is valid; otherwise returns false.

### int QItemSelectionRange.left (self)

Returns the column index corresponding to the leftmost selected column in the selection range.

### QAbstractItemModel QItemSelectionRange.model (self)

Returns the model that the items in the selection range belong to.

### QModelIndex QItemSelectionRange.parent (self)

Returns the parent model item index of the items in the selection range.

### int QItemSelectionRange.right (self)

Returns the column index corresponding to the rightmost selected column in the selection range.

### int QItemSelectionRange.top (self)

Returns the row index corresponding to the uppermost selected row in the selection range.

### QModelIndex QItemSelectionRange.topLeft (self)

Returns the index for the item located at the top-left corner of the selection range.

See also top(), left(), and bottomRight().

### int QItemSelectionRange.width (self)

Returns the number of selected columns in the selection range.

### bool QItemSelectionRange.__eq__ (self, QItemSelectionRange other)

### long QItemSelectionRange.__hash__ (self)

### bool QItemSelectionRange.__ne__ (self, QItemSelectionRange other)