QSortFilterProxyModel Class

Documentación de las funciones miembro

[explicit] QSortFilterProxyModel::QSortFilterProxyModel(QObject *parent = nullptr)

Construye un modelo de filtro de clasificación con la dirección parent.

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

Destruye este modelo de filtro de clasificación.

[signal, since 6.0] void QSortFilterProxyModel::autoAcceptChildRowsChanged(bool autoAcceptChildRows)

Esta señal se emite cuando cambia el valor de la propiedad autoAcceptChildRows.

Esta función se introdujo en Qt 6.0.

Véase también autoAcceptChildRows.

[protected, since 6.9] void QSortFilterProxyModel::beginFilterChange()

Prepara un cambio del filtro.

Se debe llamar a esta función si está implementando un filtrado personalizado (por ejemplo, filterAcceptsRow()), y su parámetro de filtrado está a punto de ser cambiado.

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
    beginFilterChange();
    maxDate = date;
    endFilterChange(QSortFilterProxyModel::Direction::Rows);
}

Una vez cambiado el filtro, llama a endFilterChange() con Direction::Rows para filtros de filas, Direction::Columns para filtros de columnas, o Direction::Columns|Direction::Rows si se filtran tanto filas como columnas.

Esta función se introdujo en Qt 6.9.

Véase también endFilterChange().

[override virtual] QModelIndex QSortFilterProxyModel::buddy(const QModelIndex &index) const

Reimplementa: QAbstractProxyModel::buddy(const QModelIndex &index) const.

[override virtual] bool QSortFilterProxyModel::canFetchMore(const QModelIndex &parent) const

Reimplementa: QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const.

[override virtual] int QSortFilterProxyModel::columnCount(const QModelIndex &parent = QModelIndex()) const

Reimplementa: QAbstractItemModel::columnCount(const QModelIndex &parent) const.

[override virtual] QVariant QSortFilterProxyModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

Reimplementa: QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const.

Véase también setData().

[override virtual] bool QSortFilterProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

Reimplementa: QAbstractProxyModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

[protected, since 6.10] void QSortFilterProxyModel::endFilterChange(QSortFilterProxyModel::Directions directions = Direction::Both)

Invalida el filtrado actual después de que el parámetro del filtro haya cambiado.

Se debe llamar a esta función si se implementa un filtrado personalizado (por ejemplo, filterAcceptsRow()), y los parámetros de filtrado han cambiado. El parámetro directions especifica si el filtro personalizado afecta a filas, columnas o ambas.

Llame a beginFilterChange() cuando el parámetro del filtro esté a punto de cambiar, y siga con una llamada a esta función una vez que los parámetros del filtro hayan cambiado. Llame con directions establecido en Direction::Rows para filtros de filas (es decir, filterAcceptsRow() está implementado), Direction::Columns para filtros de columnas (es decir, filterAcceptsColumn() está implementado), o Direction::Both si ambas funciones de filtro están implementadas.

Esta función se introdujo en Qt 6.10.

[override virtual] void QSortFilterProxyModel::fetchMore(const QModelIndex &parent)

Reimplementa: QAbstractProxyModel::fetchMore(const QModelIndex &parent).

[virtual protected] bool QSortFilterProxyModel::filterAcceptsColumn(int source_column, const QModelIndex &source_parent) const

Devuelve true si el elemento de la columna indicada por los campos source_column y source_parent debe incluirse en el modelo; en caso contrario, devuelve false.

Véase también filterAcceptsRow(), setFilterFixedString(), setFilterRegularExpression() y setFilterWildcard().

[virtual protected] bool QSortFilterProxyModel::filterAcceptsRow(int source_row, const QModelIndex &source_parent) const

Devuelve true si el elemento de la fila indicada por source_row y source_parent debe incluirse en el modelo; en caso contrario, devuelve false.

La implementación por defecto devuelve true si el valor que contiene el elemento en cuestión coincide con la cadena de filtro, la cadena comodín o la expresión regular.

Véase también filterAcceptsColumn(), setFilterFixedString(), setFilterRegularExpression() y setFilterWildcard().

[signal] void QSortFilterProxyModel::filterCaseSensitivityChanged(Qt::CaseSensitivity filterCaseSensitivity)

Esta señal se emite cuando la sensibilidad a mayúsculas/minúsculas del filtro cambia a filterCaseSensitivity.

[signal] void QSortFilterProxyModel::filterRoleChanged(int filterRole)

Esta señal se emite cuando el rol del filtro cambia a filterRole.

[override virtual] Qt::ItemFlags QSortFilterProxyModel::flags(const QModelIndex &index) const

Reimplementa: QAbstractProxyModel::flags(const QModelIndex &index) const.

[override virtual] bool QSortFilterProxyModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

Reimplementa: QAbstractProxyModel::hasChildren(const QModelIndex &parent) const.

[override virtual] QVariant QSortFilterProxyModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

Reimplementa: QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const.

Véase también setHeaderData().

[override virtual] QModelIndex QSortFilterProxyModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

Reimplementa: QAbstractItemModel::index(int fila, int columna, const QModelIndex &parent) const.

[override virtual] bool QSortFilterProxyModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

Reimplementa: QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

[override virtual] bool QSortFilterProxyModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

Reimplementa: QAbstractItemModel::insertRows(int fila, int recuento, const QModelIndex &parent).

[slot] void QSortFilterProxyModel::invalidate()

Invalida la ordenación y el filtrado actuales.

Véase también beginFilterChange() y endFilterChange().

[protected, since 6.0, until 6.13] void QSortFilterProxyModel::invalidateColumnsFilter()

Esta función dejará de utilizarse en la versión 6.13.

utilice beginFilterChange() y endFilterChange(Direction::Rows) en su lugar.

Invalida el filtrado actual de las columnas.

Esta función debe invocarse si está implementando un filtrado personalizado (mediante filterAcceptsColumn()), y sus parámetros de filtrado han cambiado. Se diferencia de invalidateFilter() en que no invocará a filterAcceptsRow(), sino sólo a filterAcceptsColumn(). Puede utilizar esta opción en lugar de invalidateFilter() si desea ocultar o mostrar una columna cuyas filas no cambien.

Antes de que cambien los parámetros del filtro, llame a beginFilterChange().

Esta función se introdujo en Qt 6.0.

Véase también invalidate(), invalidateRowsFilter(), y beginFilterChange().

[protected, until 6.13] void QSortFilterProxyModel::invalidateFilter()

Esta función dejará de utilizarse en la versión 6.13.

utilice beginFilterChange() y endFilterChange() en su lugar.

Invalida el filtrado actual.

Esta función debe invocarse si está implementando un filtrado personalizado (por ejemplo, filterAcceptsRow()), y sus parámetros de filtrado han cambiado.

Antes de cambiar los parámetros del filtro, llame a beginFilterChange().

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
    beginFilterChange();
    maxDate = date;
    endFilterChange(QSortFilterProxyModel::Direction::Rows);
}

Véase también invalidate(), invalidateColumnsFilter(), invalidateRowsFilter() y beginFilterChange().

[protected, since 6.0, until 6.13] void QSortFilterProxyModel::invalidateRowsFilter()

Esta función dejará de utilizarse en la versión 6.13.

utilice beginFilterChange() y endFilterChange(Direction::Columns) en su lugar.

Invalida el filtrado actual para las filas.

Esta función debe invocarse si está implementando un filtrado personalizado (mediante filterAcceptsRow()), y sus parámetros de filtrado han cambiado. Se diferencia de invalidateFilter() en que no invocará a filterAcceptsColumn(), sino sólo a filterAcceptsRow(). Puede utilizar esta opción en lugar de invalidateFilter() si desea ocultar o mostrar una fila cuyas columnas no cambien.

Antes de que cambien los parámetros del filtro, llame a beginFilterChange().

Esta función se introdujo en Qt 6.0.

Véase también invalidate(), invalidateFilter(), y invalidateColumnsFilter().

[virtual protected] bool QSortFilterProxyModel::lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const

Devuelve true si el valor del elemento al que hace referencia el índice dado source_left es menor que el valor del elemento al que hace referencia el índice dado source_right, en caso contrario devuelve false.

Esta función se utiliza como operador < al ordenar, y maneja los siguientes tipos QVariant:

• QMetaType::Int
• QMetaType::UInt
• QMetaType::LongLong
• QMetaType::ULongLong
• QMetaType::Float
• QMetaType::Double
• QMetaType::QChar
• QMetaType::QDate
• QMetaType::QTime
• QMetaType::QDateTime
• QMetaType::QString

Cualquier otro tipo se convertirá a QString utilizando QVariant::toString().

La comparación de QStrings distingue entre mayúsculas y minúsculas por defecto; esto puede cambiarse utilizando la propiedad sortCaseSensitivity.

Por defecto, el Qt::DisplayRole asociado con el QModelIndexes utilizado para las comparaciones. Esto puede cambiarse estableciendo la propiedad sortRole.

Véase también sortRole, sortCaseSensitivity, y dynamicSortFilter.

[override virtual] QModelIndex QSortFilterProxyModel::mapFromSource(const QModelIndex &sourceIndex) const

Reimplementa: QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const.

Devuelve el índice del modelo en QSortFilterProxyModel dado el sourceIndex del modelo fuente.

Ver también mapToSource().

[override virtual] QItemSelection QSortFilterProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const

Reimplementa: QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const.

[override virtual] QItemSelection QSortFilterProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const

Reimplementa: QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const.

[override virtual] QModelIndex QSortFilterProxyModel::mapToSource(const QModelIndex &proxyIndex) const

Reimplementa: QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const.

Devuelve el índice del modelo fuente correspondiente al proxyIndex dado del modelo del filtro de ordenación.

Véase también mapFromSource().

[override virtual] QModelIndexList QSortFilterProxyModel::match(const QModelIndex &start, int role, const QVariant &value, int hits = 1, Qt::MatchFlags flags = Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const

Reimplementa: QAbstractItemModel::match(const QModelIndex &start, int role, const QVariant &value, int hits, Qt::MatchFlags flags) const.

[override virtual] QMimeData *QSortFilterProxyModel::mimeData(const QModelIndexList &indexes) const

Reimplementa: QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const.

[override virtual] QStringList QSortFilterProxyModel::mimeTypes() const

Reimplementa: QAbstractProxyModel::mimeTypes() const.

[override virtual] QModelIndex QSortFilterProxyModel::parent(const QModelIndex &child) const

Reimplementa: QAbstractItemModel::parent(const QModelIndex &index) const.

[signal] void QSortFilterProxyModel::recursiveFilteringEnabledChanged(bool recursiveFilteringEnabled)

Esta señal se emite cuando la configuración del filtro recursivo se cambia a recursiveFilteringEnabled.

[override virtual] bool QSortFilterProxyModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

Reimplementa: QAbstractItemModel::removeColumns(int columna, int cuenta, const QModelIndex &parent).

[override virtual] bool QSortFilterProxyModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

Reimplementa: QAbstractItemModel::removeRows(int fila, int recuento, const QModelIndex &parent).

[override virtual] int QSortFilterProxyModel::rowCount(const QModelIndex &parent = QModelIndex()) const

Reimplementa: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

[override virtual] bool QSortFilterProxyModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

Reimplementa: QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role).

Véase también data().

[slot] void QSortFilterProxyModel::setFilterFixedString(const QString &pattern)

Establece la cadena fija utilizada para filtrar el contenido del modelo fuente en la dirección pattern.

Este método restablecerá las opciones de la expresión regular pero respetará la distinción entre mayúsculas y minúsculas.

Véase también setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterWildcard(), y filterRegularExpression().

[slot] void QSortFilterProxyModel::setFilterRegularExpression(const QString &pattern)

Establece la expresión regular utilizada para filtrar el contenido del modelo fuente en pattern.

Este método debería preferirse para código nuevo, ya que utilizará QRegularExpression internamente.

Este método restablecerá las opciones de la expresión regular pero respetará la distinción entre mayúsculas y minúsculas.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        sortFilterProxyModel, qOverload(&QSortFilterProxyModel::setFilterRegularExpression));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        sortFilterProxyModel, [receiver = sortFilterProxyModel](const QString &pattern) { receiver->setFilterRegularExpression(pattern); });

Véase también setFilterCaseSensitivity(), setFilterWildcard(), setFilterFixedString() y filterRegularExpression().

[slot] void QSortFilterProxyModel::setFilterWildcard(const QString &pattern)

Establece la expresión comodín utilizada para filtrar el contenido del modelo de origen en la dirección pattern.

Este método restablecerá las opciones de la expresión regular pero respetará la distinción entre mayúsculas y minúsculas.

Véase también setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterFixedString(), y filterRegularExpression().

[override virtual] bool QSortFilterProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

Reimplementa: QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

Véase también headerData().

[override virtual] void QSortFilterProxyModel::setSourceModel(QAbstractItemModel *sourceModel)

Reimplementa: QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel).

[override virtual] QModelIndex QSortFilterProxyModel::sibling(int row, int column, const QModelIndex &idx) const

Reimplementa: QAbstractProxyModel::sibling(int fila, int columna, const QModelIndex &idx) const.

[override virtual] void QSortFilterProxyModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

Reimplementa: QAbstractProxyModel::sort(int columna, Qt::SortOrder orden).

Ordena el modelo por column en el order dado . Si el orden column es menor que cero, el modelo se ordenará por la fila del modelo de origen en el order dado.

Véase también sortColumn().

[signal] void QSortFilterProxyModel::sortCaseSensitivityChanged(Qt::CaseSensitivity sortCaseSensitivity)

Esta señal se emite cuando la distinción entre mayúsculas y minúsculas para la ordenación cambia a sortCaseSensitivity.

int QSortFilterProxyModel::sortColumn() const

Devuelve la columna utilizada actualmente para ordenar

Devuelve la columna de ordenación utilizada más recientemente. El valor por defecto es -1, lo que significa que este modelo proxy no ordena.

Véase también sort().

[signal] void QSortFilterProxyModel::sortLocaleAwareChanged(bool sortLocaleAware)

Esta señal se emite cuando la configuración consciente de la configuración regional cambia a sortLocaleAware.

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

Devuelve el orden utilizado actualmente para ordenar

Devuelve el orden de clasificación utilizado más recientemente. El valor por defecto es Qt::AscendingOrder.

Véase también sort().

[signal] void QSortFilterProxyModel::sortRoleChanged(int sortRole)

Esta señal se emite cuando el rol de ordenación cambia a sortRole.

[override virtual] QSize QSortFilterProxyModel::span(const QModelIndex &index) const

Reimplementa: QAbstractProxyModel::span(const QModelIndex &index) const.

[override virtual] Qt::DropActions QSortFilterProxyModel::supportedDropActions() const

Reimplementa: QAbstractProxyModel::supportedDropActions() const.