QItemSelectionModel Class

Documentación de la función miembro

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = nullptr)

Construye un modelo de selección que opera sobre el elemento especificado model.

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)

Construye un modelo de selección que opera sobre el elemento especificado model con parent.

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

Destruye el modelo de selección.

[virtual slot] void QItemSelectionModel::clear()

Borra el modelo de selección. Emite selectionChanged() y currentChanged().

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

Borra el índice actual. Emite currentChanged().

[slot] void QItemSelectionModel::clearSelection()

Borra la selección en el modelo de selección. Emite selectionChanged().

[invokable] bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent = QModelIndex()) const

Devuelve true si hay algún elemento seleccionado en column con el parent dado.

[signal] void QItemSelectionModel::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Esta señal se emite cada vez que cambia el elemento actual. El índice del elemento del modelo previous se sustituye por el índice current como elemento actual de la selección.

Tenga en cuenta que esta señal no se emitirá cuando se restablezca el modelo del elemento.

Véase también currentIndex(), setCurrentIndex(), y selectionChanged().

[signal] void QItemSelectionModel::currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)

Esta señal se emite si el elemento current cambia y su columna es diferente a la columna del elemento actual previous.

Ten en cuenta que esta señal no se emitirá cuando se restablezca el modelo del elemento.

Véase también currentChanged(), currentRowChanged(), currentIndex(), y setCurrentIndex().

QModelIndex QItemSelectionModel::currentIndex() const

Devuelve el índice del elemento del modelo para el elemento actual, o un índice no válido si no hay ningún elemento actual.

Véase también setCurrentIndex().

[signal] void QItemSelectionModel::currentRowChanged(const QModelIndex &current, const QModelIndex &previous)

Esta señal se emite si el elemento current cambia y su fila es diferente de la fila del elemento actual previous.

Ten en cuenta que esta señal no se emitirá cuando se restablezca el modelo del elemento.

Véase también currentChanged(), currentColumnChanged(), currentIndex(), y setCurrentIndex().

[protected] void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

Compara las dos selecciones newSelection y oldSelection y emite selectionChanged() con los elementos deseleccionados y seleccionados.

bool QItemSelectionModel::hasSelection() const

Devuelve true si el modelo de selección contiene algún elemento seleccionado, en caso contrario devuelve false.

[invokable] bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent = QModelIndex()) const

Devuelve true si todos los elementos están seleccionados en column con el parent dado.

Tenga en cuenta que esta función suele ser más rápida que llamar a isSelected() en todos los elementos de la misma columna y que se ignoran los elementos no seleccionables.

[invokable] bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent = QModelIndex()) const

Devuelve true si todos los elementos están seleccionados en row con el parent dado.

Tenga en cuenta que esta función suele ser más rápida que llamar a isSelected() en todos los elementos de la misma fila y que se ignoran los elementos no seleccionables.

[invokable] bool QItemSelectionModel::isSelected(const QModelIndex &index) const

Devuelve true si el elemento del modelo dado index está seleccionado.

QAbstractItemModel *QItemSelectionModel::model()

Devuelve el modelo de artículo operado por el modelo de selección.

Véase también setModel().

const QAbstractItemModel *QItemSelectionModel::model() const

Devuelve el modelo de artículo operado por el modelo de selección.

[signal] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

Esta señal se emite cuando model se establece correctamente con setModel().

Véase también model() y setModel().

[virtual slot] void QItemSelectionModel::reset()

Borra el modelo de selección. No emite ninguna señal.

[invokable] bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent = QModelIndex()) const

Devuelve true si hay algún elemento seleccionado en row con el parent dado.

[virtual slot] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

Selecciona el elemento selection utilizando el command especificado y emite selectionChanged().

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QItemSelection &selection, QItemSelectionModel::SelectionFlags command) { receiver->select(selection, command); });

Véase también QItemSelectionModel::SelectionFlag.

[virtual slot] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Selecciona el elemento del modelo index utilizando el command especificado y emite selectionChanged().

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QModelIndex &index, QItemSelectionModel::SelectionFlags command) { receiver->select(index, command); });

Véase también QItemSelectionModel::SelectionFlags.

[invokable] QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

Devuelve los índices en el row dado para las columnas en las que todas las filas están seleccionadas.

Véase también selectedIndexes() y selectedRows().

QModelIndexList QItemSelectionModel::selectedIndexes() const

Devuelve una lista de todos los índices de elementos del modelo seleccionados. La lista no contiene duplicados y no está ordenada.

[invokable] QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

Devuelve los índices en el column dado para las filas en las que todas las columnas están seleccionadas.

Véase también selectedIndexes() y selectedColumns().

const QItemSelection QItemSelectionModel::selection() const

Devuelve los rangos de selección almacenados en el modelo de selección.

[signal] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Esta señal se emite cada vez que cambia la selección. El cambio en la selección se representa como una selección de elementos de deselected elementos y una selección de elementos de selected elementos.

Tenga en cuenta que el índice actual cambia independientemente de la selección. Ten en cuenta también que esta señal no se emitirá cuando se reinicie el modelo de ítems.

Los elementos que permanecen seleccionados pero cambian su índice no se incluyen en selected y deselected. Por lo tanto, esta señal puede emitirse con selected y deselected vacíos, si sólo cambian los índices de los elementos seleccionados.

Véase también select() y currentChanged().

[virtual slot] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

Establece el elemento del modelo index como elemento actual y emite currentChanged(). El elemento actual se utiliza para la navegación por teclado y la indicación de foco; es independiente de cualquier elemento seleccionado, aunque un elemento seleccionado también puede ser el elemento actual.

Dependiendo del command especificado, el index también puede formar parte de la selección actual.

Véase también currentIndex() y select().

void QItemSelectionModel::setModel(QAbstractItemModel *model)

Establece el modelo en model. Se emitirá la señal modelChanged().

Véase también model() y modelChanged().