Qt 是目前最先進、最完整的跨平臺C++開發工具。它不僅完全實現了一次編寫，所有平臺無差別運行，更提供了幾乎所有開發過程中需要用到的工具。如今，Qt已被運用于超過70個行業、數千家企業，支持數百萬設備及應用。

自定義排序/篩選模型示例說明了如何子類化來執行高級排序和篩選。

類提供了對在另一個模型和視圖之間傳遞的數據進行排序和過濾的支持。

模型通過將它提供的模型索引映射到對應于不同位置的新索引來轉換源模型的結構，以供視圖使用。這種方法允許對給定的源模型進行視圖重構，而不需要對底層數據進行任何轉換，也不需要在內存中復制數據。

自定義排序/篩選模型示例由兩個類組成：

• MySortFilterProxyModel類提供了一個自定義代理模型。
• Window類提供了主應用程序窗口，使用自定義代理模型對標準項模型進行排序和篩選。

我們將首先查看MySortFilterProxyModel類，了解如何實現自定義代理模型；然后查看Window類，來了解如何使用該模型；最后我們將快速查看main()函數。

Qt技術交流群：166830288      歡迎一起進群討論

MySortFilterProxyModel類定義

MySortFilterProxyModel類繼承了類。

由于QAbstractProxyModel及其子類派生自QAbstractItemModel，許多關于常規模型子類化的建議也適用于代理模型。

另一方面值得注意的是，的許多默認函數實現都是這樣編寫的，以便它們調用相關源模型中的等效函數。對于具有更復雜行為的源模型，可能需要重寫這個簡單的代理機制。在本例中，我們從QSortFilterProxyModel類派生出來，以確保我們的過濾器可以識別有效的日期范圍，并控制排序操作。

class MySortFilterProxyModel : public QSortFilterProxyModel
{
Q_OBJECT

public:
MySortFilterProxyModel(QObject *parent = nullptr);

QDate filterMinimumDate() const { return minDate; }
void setFilterMinimumDate(QDate date);

QDate filterMaximumDate() const { return maxDate; }
void setFilterMaximumDate(QDate date);

protected:
bool filterAcceptsRow(int sourceRow, const QModelIndex &sourceParent) const override;
bool lessThan(const QModelIndex &left, const QModelIndex &right) const override;

private:
bool dateInRange(QDate date) const;

QDate minDate;
QDate maxDate;
};

我們希望能夠通過指定給定的時間段來過濾數據，因此實現了自定義的setFilterMinimumDate()和setFilterMaximumDate()函數，以及相應的filterMinimumDate()和filterMaximumDate()函數。我們重新實現了QSortFilterProxyModel的filterAcceptsRow()函數，來只接受具有有效日期的行，并且QSortFilterProxyModel::lessThan()能夠根據發件人的電子郵件地址對其進行排序。最后，實現了一個dateInRange()方便函數，用于確定日期是否有效。

MySortFilterProxyModel類實現

MySortFilterProxyModel構造函數很簡單，它將父形參傳遞給基類構造函數：

MySortFilterProxyModel::MySortFilterProxyModel(QObject *parent)
: QSortFilterProxyModel(parent)
{
}

MySortFilterProxyModel實現中最有趣的部分是QSortFilterProxyModel的filterAcceptsRow()和lessThan()函數的重新實現，讓我們首先看一下定制的lessThan()函數。

bool MySortFilterProxyModel::lessThan(const QModelIndex &left,
const QModelIndex &right) const
{
QVariant leftData = sourceModel()->data(left);
QVariant rightData = sourceModel()->data(right);

我們想按發件人的電子郵件地址對他們進行分類，lessThan()函數在排序時用作<操作符。默認實現處理一個類型集合，包括QDateTime和String，但為了能夠根據發件人的電子郵件地址進行排序，我們必須首先在給定的字符串中識別地址：

if (leftData.userType() == QMetaType::QDateTime) {
return leftData.toDateTime() < rightData.toDateTime();
} else {
static const QRegularExpression emailPattern("[\\w\\.]*@[\\w\\.]*");

QString leftString = leftData.toString();
if (left.column() == 1) {
const QRegularExpressionMatch match = emailPattern.match(leftString);
if (match.hasMatch())
leftString = match.captured(0);
}
QString rightString = rightData.toString();
if (right.column() == 1) {
const QRegularExpressionMatch match = emailPattern.match(rightString);
if (match.hasMatch())
rightString = match.captured(0);
}

return QString::localeAwareCompare(leftString, rightString) < 0;
}
}

我們使用qregulareexpression為正在尋找的地址定義一個模式，match()函數返回一個QRegularExpressionMatch對象，其中包含匹配結果，如果有匹配，hasMatch()返回true。匹配的結果可以用QRegularExpressionMatch的capture()函數檢索，整個匹配的索引為0，括號內的子表達式的索引從1開始(不包括非捕獲括號)。

bool MySortFilterProxyModel::filterAcceptsRow(int sourceRow,
const QModelIndex &sourceParent) const
{
QModelIndex index0 = sourceModel()->index(sourceRow, 0, sourceParent);
QModelIndex index1 = sourceModel()->index(sourceRow, 1, sourceParent);
QModelIndex index2 = sourceModel()->index(sourceRow, 2, sourceParent);

return (sourceModel()->data(index0).toString().contains(filterRegularExpression())
|| sourceModel()->data(index1).toString().contains(filterRegularExpression()))
&& dateInRange(sourceModel()->data(index2).toDate());
}

另一方面，如果給定的行應該包含在模型中，則filterAcceptsRow()函數將返回true。在我們的示例中，如果主題或發送方中有一個包含給定的正則表達式，并且日期有效，則行被接受。

bool MySortFilterProxyModel::dateInRange(QDate date) const
{
return (!minDate.isValid() || date > minDate)
&& (!maxDate.isValid() || date < maxDate);
}

我們使用自定義dateInRange()函數來確定日期是否有效。

為了能夠通過指定給定的時間段來過濾數據，我們還實現了獲取和設置最小和最大日期的函數：

void MySortFilterProxyModel::setFilterMinimumDate(QDate date)
{
minDate = date;
invalidateFilter();
}

void MySortFilterProxyModel::setFilterMaximumDate(QDate date)
{
maxDate = date;
invalidateFilter();
}

get函數filterMinimumDate()和filterMaximumDate()很簡單，在頭文件中作為內聯函數實現。

這就完成了我們的自定義代理模型，接下來的文章將介紹如何在應用程序中使用它。

Qt Widget組件推薦

• QtitanRibbon - Ribbon UI組件：是一款遵循Microsoft Ribbon UI Paradigm for Qt技術的Ribbon UI組件，QtitanRibbon致力于為Windows、Linux和Mac OS X提供功能完整的Ribbon組件。
• QtitanChart - Qt類圖表組件：是一個C ++庫，代表一組控件，這些控件使您可以快速地為應用程序提供漂亮而豐富的圖表。
• QtitanDataGrid - Qt網格組件：提供了一套完整的標準 QTableView 函數和傳統組件無法實現的獨特功能。使您能夠將不同來源的各類數據加載到一個快速、靈活且功能強大的可編輯網格中，支持排序、分組、報告、創建帶狀列、拖放按鈕和許多其他方便的功能。
• QtitanDocking：允許您像 Visual Studio 一樣為您的偉大應用程序配備可停靠面板和可停靠工具欄。黑色、白色、藍色調色板完全支持 Visual Studio 2019 主題！