Qt Proxy Model: сортировка и фильтрация данных в Qt/QML (2026)

Qt Proxy Model позволяет изменять порядок строк, скрывать ненужные данные и добавлять вычисляемые столбцы без изменения исходной модели. Вы получаете отдельный слой между данными и интерфейсом. С личным VPS SANSARA вы развернёте окружение Qt/QML за несколько минут: регистрация → данные в кабинете → импорт в клиент → готовый защищённый канал к вашему серверу. Настройка Qt Proxy Model сводится к созданию класса-наследника QSortFilterProxyModel и подключению его к QML-представлению.

Коротко:

• Qt Proxy Model — это прокси-слой между исходной моделью и виджетом (QTableView, ListView).
• Позволяет сортировать строки по столбцам, фильтровать по условиям, добавлять виртуальные столбцы.
• Работает в Qt Widgets и Qt Quick (QML), поддерживает C++ и QML-интеграцию.
• С личным VPS SANSARA вы получаете выделенный узел для сборки и тестирования Qt-приложений без общего пула.
• Telegram-бот SANSARA помогает управлять сервером и получать уведомления без прямого доступа к терминалу.

Что это и кому подходит

Qt Proxy Model — это класс-обёртка над любой QAbstractItemModel (QSqlTableModel, QStandardItemModel, QFileSystemModel и др.). Он не меняет исходные данные, а только преобразует их представление: меняет порядок строк, скрывает часть записей, добавляет вычисляемые столбцы.

Кому подходит:

• Разработчикам Qt Widgets, которые хотят добавить сортировку по клику на заголовок таблицы.
• Разработчикам Qt Quick (QML), которым нужна фильтрация списков по тексту поиска.
• Тем, кто работает с базами данных через QSqlTableModel и хочет фильтровать записи на стороне клиента.
• Командам, которые тестируют интерфейсы на разных устройствах через личный VPS SANSARA.

Если вы уже используете Qt Model/View, прокси-модель упростит добавление интерактивной сортировки и фильтрации без переписывания логики данных.

Как настроить по шагам (с личным VPS SANSARA)

Шаг 1. Подготовка окружения на личном VPS

1. 01Зарегистрируйтесь в SANSARA и получите личный VPS.
2. 02В кабинете выберите локацию (9+ стран), создайте сервер.
3. 03Импортируйте конфигурацию в клиент на вашем устройстве.
4. 04Защищённый канал к вашему выделенному узлу готов.

На сервере установите Qt (например, через пакетный менеджер или официальный установщик). Для тестирования интерфейсов подойдёт минимальный набор: Qt Core, Qt GUI, Qt Widgets или Qt Quick.

Шаг 2. Создание прокси-модели в C++

Пример для таблицы с пользователями:

`cpp // usersmodel.h class UsersModel : public QSqlTableModel { Q_OBJECT public: explicit UsersModel(QObject *parent = nullptr); };

// usersproxymodel.h

class UsersProxyModel : public QSortFilterProxyModel { Q_OBJECT public: explicit UsersProxyModel(QObject *parent = nullptr); protected: bool filterAcceptsRow(int source_row, const QModelIndex &source_parent) const override; bool lessThan(const QModelIndex &left, const QModelIndex &right) const override; }; `

`cpp // usersproxymodel.cpp UsersProxyModel::UsersProxyModel(QObject *parent) : QSortFilterProxyModel(parent) { setFilterCaseSensitivity(Qt::CaseInsensitive); }

bool UsersProxyModel::filterAcceptsRow(int source_row, const QModelIndex &source_parent) const { // Фильтруем по имени (столбец 1) и email (столбец 2) auto idxName = sourceModel()->index(source_row, 1, source_parent); auto idxEmail = sourceModel()->index(source_row, 2, source_parent); QString name = sourceModel()->data(idxName).toString(); QString email = sourceModel()->data(idxEmail).toString(); QString filter = filterRegExp().pattern(); return name.contains(filter, Qt::CaseInsensitive) || email.contains(filter, Qt::CaseInsensitive); }

bool UsersProxyModel::lessThan(const QModelIndex &left, const QModelIndex &right) const { // Сортировка по алфавиту для строковых столбцов QVariant leftData = sourceModel()->data(left); QVariant rightData = sourceModel()->data(right); return leftData.toString().toLower() < rightData.toString().toLower(); } `

Шаг 3. Подключение к виджету

`cpp // main.cpp UsersModel *model = new UsersModel(this); model->setTable("users"); model->select();

UsersProxyModel *proxyModel = new UsersProxyModel(this); proxyModel->setSourceModel(model);

QTableView *view = new QTableView; view->setModel(proxyModel); view->setSortingEnabled(true); // Включить сортировку по клику на заголовок `

Шаг 4. Тестирование на личном VPS SANSARA

• Соберите приложение на вашем VPS.
• Запустите его локально или через X11-форвардинг / удалённый доступ.
• Проверьте сортировку и фильтрацию: ввод текста в QLineEdit должен обновлять proxyModel->setFilterFixedString(text).

Telegram-бот SANSARA удобен для получения уведомлений о сборке или перезапуске сервиса.

Устройства: iPhone, Android, Windows, macOS

Qt Proxy Model работает везде, где работает Qt. Разница только в способе развёртывания и тестирования.

На всех платформах логика прокси-модели одинакова: вы настраиваете её в C++ и подключаете к ListView (QML) или QTableView (Widgets). SANSARA даёт стабильный выделенный узел, чтобы сборки и тесты не зависели от нагрузки общего пула.

Частые ошибки и как их избежать

1. 01Забыли вызвать setSourceModel

Без установки исходной модели прокси ничего не показывает. Всегда проверяйте порядок: создали исходную модель → создали прокси → proxy->setSourceModel(source).

1. 01Фильтрация работает некорректно из-за регистра

По умолчанию фильтр чувствителен к регистру. Используйте setFilterCaseSensitivity(Qt::CaseInsensitive).

1. 01Сортировка не срабатывает по клику на заголовок

В Qt Widgets нужно явно включить сортировку: view->setSortingEnabled(true). В QML используйте SortFilterProxyModel из сторонних библиотек или свой QAbstractProxyModel.

1. 01Прокси-модель не обновляется при изменении исходных данных

Если исходная модель правильно испускает сигналы dataChanged, прокси обновляется автоматически. Проверьте, что ваша модель наследует QAbstractItemModel и правильно уведомляет об изменениях.

1. 01Путаница между индексами source и proxy

В filterAcceptsRow и lessThan индексы относятся к исходной модели. Используйте sourceModel()->data(index).

1. 01Попытка фильтровать по несмысловым столбцам

Фильтрация по ID или техническим полям сбивает пользователя. Фильтруйте по имени, описанию, email — тем полям, которые видит пользователь.

FAQ

`cpp QVariant UsersProxyModel::data(const QModelIndex &index, int role) const { if (role == Qt::DisplayRole && index.column() == computedColumnIndex) { // Собираем данные из исходной модели auto first = sourceModel()->data(createIndex(index.row(), 1)).toString(); auto last = sourceModel()->data(createIndex(index.row(), 2)).toString(); return QString("%1 %2").arg(first).arg(last); } return QSortFilterProxyModel::data(index, role); } `

`cpp bool UsersProxyModel::lessThan(const QModelIndex &left, const QModelIndex &right) const { int statusLeft = sourceModel()->data(left.sibling(left.row(), statusCol)).toInt(); int statusRight = sourceModel()->data(right.sibling(right.row(), statusCol)).toInt(); if (statusLeft != statusRight) return statusLeft < statusRight; // Сначала статус с меньшим значением // Затем по дате QDateTime dateLeft = sourceModel()->data(left.sibling(left.row(), dateCol)).toDateTime(); QDateTime dateRight = sourceModel()->data(right.sibling(right.row(), dateCol)).toDateTime(); return dateLeft < dateRight; } `

Итог

• Используйте QSortFilterProxyModel для добавления сортировки и фильтрации без изменения исходных данных.
• На личном VPS SANSARA разверните Qt-окружение за несколько минут через кабинет и импорт конфигурации.
• Подключайте прокси-модель к QTableView (Widgets) или ListView (QML) для интерактивных таблиц и списков.
• Избегайте типичных ошибок: не забывайте setSourceModel, настраивайте чувствительность к регистру, проверяйте сигналы обновления данных.
• Используйте выделенный узел SANSARA и Telegram-бота для стабильного тестирования на всех устройствах: iPhone, Android, Windows, macOS.