【Qt】【模型-视图架构】代理模型示例

news2025/1/18 20:30:57

文章目录

1. 基本排序/过滤模型Basic Sort/Filter Model Example
2. 自定义排序/过滤模型Custom Sort/Filter Model Example
- FilterLineEdit类定义及实现
- MySortFilterProxyModel类定义及实现

1. 基本排序/过滤模型Basic Sort/Filter Model Example

官方提供的基本排序/过滤模型示例说明了如何使用QSortFilterProxyModel执行基本的排序和过滤。

窗口界面显如下：

基本代理模型示例

在继承QWidget类的子类Widget中设计显示。从界面上可以看出总共有两个QGroupBox。上方的QGroupBox中是显示原始模型的树试图，下方的QGroupBox中是显示代理模型的树视图，并且可以交互式地选择使用的过滤模式、语法、哪一列、大小写是否敏感。

代码中，Widget类提供一个公共的函数setSourceModel()，在创建Widget对象后未显示窗口前，调用该函数，为两个树视图设置数据模型。

在main.cpp中向模型中添加数据。

参考官方示例编写的代码参考：https://github.com/Innern/Qt/tree/master/ModelView/Examples/02_BasicSortFilterModel。

官方示例中Sorted/filtered Model组合框中使用的是网格布局，参考代码中使用垂直布局。

2. 自定义排序/过滤模型Custom Sort/Filter Model Example

官方提供的Custom Sort/Filter Model Example说明了如何使用QSortFilterProxyModel的子类为试图提供代理模型。

代理模型通过将源模型的索引映射到对应于不同位置的新索引供试图使用，从而转换源模型的结构。

如下图是基本排序/过滤模型与自定义排序/过滤模型示例应用程序窗口界面：

自定义代理模型示例

自定义代理模型中包括三个类：

FilterLineEdit，继承自QLineEdit类，实现行编辑器的更多操作，如上右图的Filter pattern设置。
MySortFilterProxyModel类继承自QSortFilterProxyModel，提供一个自定义的代理模型；
Widget类提供主窗口界面显示

FilterLineEdit类定义及实现

FilterLineEdit继承自QLineEdit，子类化行编辑器。

该类在左侧提供了一个工具按钮，该工具按钮包含一个菜单栏，菜单栏中可以选择过滤模型的模式。

使用Q_PROPETRY宏声明了支持元对象系统的属性，如下：

    Q_OBJECT
    Q_PROPERTY(Qt::CaseSensitivity caseSensitivity READ caseSensitivity WRITE setCaseSensitivity)
    Q_PROPERTY(PatternSyntax patternSyntax READ patternSyntax WRITE setPatternSyntax)
public:
    explicit FilterLineEdit(QWidget *parent = nullptr);

    Qt::CaseSensitivity caseSensitivity() const;
    void setCaseSensitivity(Qt::CaseSensitivity caseSensitivity);

    enum PatternSyntax{
        RegularExpression,
        Wildcard,
        FixedString
    };
    Q_ENUM(PatternSyntax)

    PatternSyntax patternSyntax() const;
    void setPatternSyntax(PatternSyntax syntax);

提供信号filterChanged()，当文本内容改变或选择的过滤选项改变时，触发该信号。

MySortFilterProxyModel类定义及实现

MySortFilterProxyModel类继承自QSortFilterProxyModel类。QAbstractProxyModel及其子类是从QAbstractItemModel派生来的，关于普通模型子类化的许多相同建议也适用于代理模型。

QSortFilterProxyModel的许多默认函数实现都是为了调用相关源模型中的等效函数而编写的。对于具有更复杂行为的源模型，可能需要覆盖这种简单的代理机制。

MySortFilterProxyModel类从QSortFilterProxyModel类派生，以确保筛选器能够识别有效的日期范围，并控制排序行为。

MySortFilterProxyModel类定义如下：

class MySortFilterProxyModel : public QSortFilterProxyModel
{
    Q_OBJECT
public:
    explicit MySortFilterProxyModel(QObject *parent = nullptr);

    QDate filterMinimumDate() const;
    void setFilterMinimumDate(const QDate &date);
    QDate filterMaximumDate() const;
    void setFilterMaximumDate(const QDate &date);

protected:
    // 仅接受具有有效日期的行
    bool filterAcceptsRow(int source_row, const QModelIndex &source_parent) const override;
    // 使模型能够按照发件人的电子邮件地址对其排序。
    bool lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const override;

private:
    // 判断输入的日期是否有效
    bool dateInRange(const QDate &date) const;

private:
    QDate minimumData;
    QDate MaximumDate;
};