QSortFilterProxyModel Class

멤버 함수 설명서

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

주어진 parent 를 사용하여 정렬 필터 모델을 생성합니다.

[virtual noexcept] QSortFilterProxyModel::~QSortFilterProxyModel()

이 정렬 필터 모델을 삭제합니다.

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

이 신호는 autoAcceptChildRows 속성의 값이 변경될 때 발생합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

autoAcceptChildRows도 참조하십시오 .

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

필터 변경을 준비합니다.

사용자 정의 필터링(예: filterAcceptsRow())을 구현 중이며, 필터 매개변수가 변경될 예정인 경우 이 함수를 호출해야 합니다.

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

필터가 변경되면, 행 필터의 경우 Direction::Rows 를, 열 필터의 경우 Direction::Columns 를, 행과 열이 모두 필터링되는 경우 Direction::Columns|Direction::Rows 를 사용하여 endFilterChange()를 호출하십시오.

이 함수는 Qt 6.9에서 도입되었습니다.

endFilterChange()도 참조하십시오 .

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

QAbstractProxyModel::buddy(const QModelIndex &index) const를 재구현합니다.

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

QAbstractProxyModel::canFetchMore(const QModelIndex &parent) const를 재구현합니다.

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

QAbstractItemModel::columnCount(const QModelIndex &parent) const를 재구현합니다.

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

QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const를 재구현합니다.

setData()도 참조하십시오 .

[protected invokable, since 6.12] QSortFilterProxyModel::DataChangeRelevanceFlags QSortFilterProxyModel::dataChangeRelevanceFlags(const QModelIndex &sourceTopLeft, const QModelIndex &sourceBottomRight, const QList<int> &roles) const

소스 모델의 변경 사항이 필터링이나 정렬에 영향을 미치는지 여부를 나타내려면 하위 클래스에서 이 슬롯을 재구현하십시오. 이는 정렬 및 필터링 결과에 영향을 미치지 않는 소스 모델 변경 시 불필요한 ` filterAcceptsRow()` 및 ` lessThan()` 호출을 방지하기 위한 성능 최적화 목적으로 사용됩니다. sourceTopLeft, sourceBottomRight 및 roles 매개변수는 관련성을 평가 중인 변경 사항에 해당하는 소스 모델의 dataChanged() 시그널에서 발송되는 매개변수들입니다.

이 함수는 Qt 6.12에서 도입되었습니다.

DataChangeRelevanceFlags, filterAcceptsRow() 및 lessThan()도 참조하십시오 .

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

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)

필터 매개변수가 변경된 후 현재 필터링 설정을 무효화합니다.

사용자 정의 필터링(예: ` filterAcceptsRow()`)을 구현한 경우, 필터 매개변수가 변경되면 이 함수를 호출해야 합니다. ` directions ` 매개변수는 사용자 정의 필터가 행, 열 또는 둘 모두에 영향을 미치는지 여부를 지정합니다.

필터 매개변수가 변경되기 직전에 beginFilterChange()를 호출하고, 필터 매개변수가 변경된 후 이 함수를 호출해야 합니다. 행 필터의 경우 directions 을 Direction::Rows 로 설정하여 호출하고(즉, filterAcceptsRow()이 구현된 경우), 열 필터의 경우 Direction::Columns 로 설정하여 호출하며(즉, filterAcceptsColumn()이 구현된 경우), 두 필터 함수가 모두 구현된 경우에는 Direction::Both 로 설정하여 호출하십시오.

이 함수는 Qt 6.10에서 도입되었습니다.

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

QAbstractProxyModel::fetchMore(const QModelIndex &parent)를 재구현합니다.

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

주어진 ` source_column ` 및 ` source_parent `로 지정한 열의 항목이 모델에 포함되어야 하는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

filterAcceptsRow(), setFilterFixedString(), setFilterRegularExpression() 및 setFilterWildcard()도 참조하십시오 .

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

주어진 source_row 및 source_parent 로 지정한 행의 항목이 모델에 포함되어야 하는 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.

기본 구현에서는 해당 항목이 보유한 값이 필터 문자열, 와일드카드 문자열 또는 정규 표현식과 일치하는 경우 ` true `를 반환합니다.

참조: filterAcceptsColumn(), setFilterFixedString(), setFilterRegularExpression(), setFilterWildcard().

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

이 신호는 필터의 대소문자 구분 설정이 ‘ filterCaseSensitivity ’로 변경될 때 발생합니다.

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

이 신호는 필터 역할이 ‘ filterRole ’로 변경될 때 발생합니다.

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

QAbstractProxyModel::flags(const QModelIndex &index) const를 재구현합니다.

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

QAbstractProxyModel::hasChildren(const QModelIndex &parent) const를 재구현합니다.

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

QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const를 재구현합니다.

setHeaderData()도 참조하십시오 .

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

QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const를 재구현합니다.

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

QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent)를 재구현합니다.

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

QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent)를 재구현합니다.

[slot] void QSortFilterProxyModel::invalidate()

현재 정렬 및 필터링 설정을 초기화합니다.

beginFilterChange() 및 endFilterChange()도 참조하십시오 .

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

이 함수는 버전 6.13에서 사용 중단될 예정입니다.

대신 ` beginFilterChange()` 및 ` endFilterChange(Direction::Rows)`를 사용하십시오.

열에 대한 현재 필터링을 무효화합니다.

사용자 정의 필터링( filterAcceptsColumn()을 통해)을 구현 중이고 필터 매개변수가 변경된 경우 이 함수를 호출해야 합니다. 이 함수는 invalidateFilter()과 달리 filterAcceptsRow()을 호출하지 않고, filterAcceptsColumn()만 호출한다는 점에서 다릅니다. 행이 변경되지 않는 열을 숨기거나 표시하려면 invalidateFilter() 대신 이 함수를 사용할 수 있습니다.

필터 매개변수가 변경되기 전에 beginFilterChange()를 호출하십시오.

이 함수는 Qt 6.0에서 도입되었습니다.

invalidate(), invalidateRowsFilter() 및 beginFilterChange()도 참조하십시오 .

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

이 함수는 버전 6.13에서 사용 중단될 예정입니다.

대신 ` beginFilterChange()` 및 ` endFilterChange()`을 사용하십시오.

현재 필터링을 무효화합니다.

사용자 정의 필터링(예: filterAcceptsRow())을 구현 중이고 필터 매개변수가 변경된 경우 이 함수를 호출해야 합니다.

필터 매개변수가 변경되기 전에 beginFilterChange()을 호출하십시오.

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

invalidate(), invalidateColumnsFilter(), invalidateRowsFilter() 및 beginFilterChange()도 참조하십시오 .

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

이 함수는 버전 6.13에서 사용 중단될 예정입니다.

대신 ` beginFilterChange()` 및 ` endFilterChange`(Direction::Columns)를 사용하십시오.

행에 대한 현재 필터링을 무효화합니다.

사용자 정의 필터링( filterAcceptsRow()을 통해)을 구현 중이고 필터 매개변수가 변경된 경우 이 함수를 호출해야 합니다. 이 함수는 invalidateFilter()과 달리 filterAcceptsColumn()을 호출하지 않고 filterAcceptsRow()만 호출한다는 점에서 다릅니다. 열이 변경되지 않는 행을 숨기거나 표시하려면 invalidateFilter() 대신 이 함수를 사용할 수 있습니다.

필터 매개변수가 변경되기 전에 beginFilterChange()를 호출하십시오.

이 함수는 Qt 6.0에서 도입되었습니다.

invalidate(), invalidateFilter(), invalidateColumnsFilter()도 참조하십시오 .

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

주어진 인덱스 source_left 가 가리키는 항목의 값이 주어진 인덱스 source_right 가 가리키는 항목의 값보다 작으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

이 함수는 정렬 시 operator< 로 사용되며, QAbstractItemModel::compareData()을 사용합니다.

기본적으로 QString간의 비교는 대소문자를 구분하지만, sortCaseSensitivity 속성을 사용하여 이를 변경할 수 있습니다.

기본적으로 QModelIndex과 연결된 Qt::DisplayRole 이 비교에 사용됩니다. 이는 sortRole 속성을 설정하여 변경할 수 있습니다.

sortRole, sortCaseSensitivity 및 dynamicSortFilter항목도 참조하십시오 .

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

QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const를 재구현합니다.

소스 모델의 ` sourceIndex `를 기반으로 ` QSortFilterProxyModel ` 내의 모델 인덱스를 반환합니다.

mapToSource()도 참조하십시오 .

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

QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const를 재구현합니다.

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

QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const를 재구현합니다.

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

QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const를 재구현합니다.

정렬 필터 모델에서 주어진 proxyIndex 에 해당하는 소스 모델 인덱스를 반환합니다.

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

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

QAbstractProxyModel::mimeData(const QModelIndexList &indexes) const를 재구현합니다.

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

QAbstractProxyModel::mimeTypes() const를 재구현합니다.

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

QAbstractItemModel::parent(const QModelIndex &index) const를 재구현합니다.

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

이 신호는 재귀 필터 설정이 ‘ recursiveFilteringEnabled ’로 변경될 때 발생합니다.

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

QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent)를 재구현합니다.

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

QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent)를 재구현합니다.

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

QAbstractItemModel::rowCount(const QModelIndex &parent) const를 재구현합니다.

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

QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role)를 재구현합니다.

data()도 참조하십시오 .

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

소스 모델의 내용을 필터링하는 데 사용되는 고정 문자열을 지정된 ` pattern`로 설정합니다.

이 메서드는 정규식 옵션을 재설정하지만 대소문자 구분을 유지합니다.

setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterWildcard(), filterRegularExpression()도 참조하십시오 .

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

소스 모델의 내용을 필터링하는 데 사용되는 정규 표현식을 pattern 로 설정합니다.

이 메서드는 내부적으로 ` QRegularExpression `를 사용하므로, 새로운 코드를 작성할 때는 이 메서드를 우선적으로 사용해야 합니다.

이 메서드는 정규식 옵션을 재설정하지만 대소문자 구분을 유지합니다.

// 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); });

setFilterCaseSensitivity(), setFilterWildcard(), setFilterFixedString(), filterRegularExpression()도 참조하십시오 .

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

소스 모델의 내용을 필터링하는 데 사용되는 와일드카드 표현식을 지정된 pattern 로 설정합니다.

이 메서드는 정규식 옵션을 초기화하지만 대소문자 구분을 유지합니다.

setFilterCaseSensitivity(), setFilterRegularExpression(), setFilterFixedString() 및 filterRegularExpression()도 참조하십시오 .

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

QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role)를 재구현합니다.

headerData()도 참조하십시오 .

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

QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel)을 재구현합니다.

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

QAbstractProxyModel::sibling(int row, int column, const QModelIndex &idx) const를 재구현합니다.

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

QAbstractProxyModel::sort(int column, Qt::SortOrder order)를 재구현합니다.

주어진 order 내에서 column 에 따라 모델을 정렬합니다. 정렬 column 이 0보다 작을 경우, 모델은 주어진 order 내에서 소스 모델 행 순서에 따라 정렬됩니다.

sortColumn()도 참조하십시오 .

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

정렬 시 대소문자 구분이 ‘ sortCaseSensitivity ’로 변경되면 이 신호가 발생합니다.

int QSortFilterProxyModel::sortColumn() const

현재 정렬에 사용 중인 열을 반환합니다

이 메서드는 가장 최근에 사용된 정렬 열을 반환합니다. 기본값은 -1이며, 이는 이 프록시 모델이 정렬을 수행하지 않음을 의미합니다.

sort()도 참조하십시오 .

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

이 신호는 로케일 인식 설정이 ‘ sortLocaleAware ’로 변경될 때 발생합니다.

Qt::SortOrder QSortFilterProxyModel::sortOrder() const

현재 정렬에 사용 중인 순서를 반환합니다.

이 함수는 가장 최근에 사용된 정렬 순서를 반환합니다. 기본값은 ` Qt::AscendingOrder`입니다.

sort()도 참조하십시오 .

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

이 신호는 정렬 역할이 ‘ sortRole ’로 변경될 때 발생합니다.

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

QAbstractProxyModel::span(const QModelIndex &index) const를 재구현합니다.

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

QAbstractProxyModel::supportedDropActions() const를 재구현합니다.