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 プロパティを使用してこれを変更することができます。

デフォルトでは、QModelIndexes に関連付けられた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 を再実装します。