Fluent-Qt

Компоновка

DataGridToolBar Панель инструментов DataGrid

Предоставляет поиск, фасетные фильтры, а также управление видимостью, порядком и закреплением столбцов DataGrid.

Пример

DataGridToolBar Панель инструментов DataGrid: Фильтрация и упорядочивание проектов

Использование

Фильтрация и упорядочивание проектов

Подключите критерии поиска и фильтрации к прокси-модели для фильтрации строк; меню Columns управляет видимостью, порядком и закреплением столбцов.

#include <FluentQt/Layout.h>
using namespace fluent::layout;

#ifndef GALLERY_DATAGRIDWORKSPACESAMPLE_H
#define GALLERY_DATAGRIDWORKSPACESAMPLE_H

#include <FluentQt/FluentQt.h>
#include <QHeaderView>
#include <QHBoxLayout>
#include <QSortFilterProxyModel>
#include <QStandardItemModel>
#include <QVBoxLayout>

namespace fluent::gallery {

// Filtering rules and saved views are application policy, outside DataGrid.
// zh_CN: 筛选规则与保存视图属于应用策略,不放入 DataGrid。
class ProjectFilterModel final : public QSortFilterProxyModel {
public:
    using QSortFilterProxyModel::QSortFilterProxyModel;
    void setCriteria(const QString& search, const QVariantMap& filters)
    {
        m_search = search.trimmed();
        m_filters = filters;
        invalidateFilter();
    }

protected:
    bool filterAcceptsRow(int row, const QModelIndex& parent) const override
    {
        bool matchesText = m_search.isEmpty();
        for (int c = 0; c < sourceModel()->columnCount(parent); ++c)
            matchesText |=
                sourceModel()->index(row, c, parent).data().toString().contains(m_search, Qt::CaseInsensitive);
        if (!matchesText)
            return false;
        for (const auto& pair : {qMakePair(QStringLiteral("owner"), 1), qMakePair(QStringLiteral("status"), 2)}) {
            const auto values = m_filters.value(pair.first).toStringList();
            if (!values.isEmpty() && !values.contains(sourceModel()->index(row, pair.second, parent).data().toString()))
                return false;
        }
        return true;
    }

private:
    QString m_search;
    QVariantMap m_filters;
};

class DataGridWorkspaceSample final : public layout::Card {
public:
    explicit DataGridWorkspaceSample(QWidget* parent = nullptr) : Card(parent)
    {
        setObjectName(QStringLiteral("dataGridWorkspace"));
        setBorderVisible(false);
        setMaximumWidth(864);
        setMinimumWidth(300);
        setMinimumHeight(480);
        auto* body = new QVBoxLayout(this);
        body->setContentsMargins(24, 24, 24, 24);
        body->setSpacing(12);
        auto* title = new textfields::Label(QStringLiteral("Projects"), this);
        title->setFluentTypography(Typography::FontRole::Subtitle);
        body->addWidget(title);
        auto* description = new textfields::Label(QStringLiteral("Search, combine filters, and arrange your columns."),
            this);
        description->setFluentTypography(Typography::FontRole::Caption);
        description->setTextColorRole(textfields::Label::TextColorRole::Secondary);
        description->setWordWrap(true);
        body->addWidget(description);

        m_toolbar = new layout::DataGridToolBar(this);
        m_toolbar->searchField()->setPlaceholderText(QStringLiteral("Search projects…"));
        m_toolbar->addFilter(QStringLiteral("status"), QStringLiteral("Status"),
            {QStringLiteral("Active"), QStringLiteral("Review")});
        m_toolbar->addFilter(QStringLiteral("owner"), QStringLiteral("Owner"),
            {QStringLiteral("Maya"), QStringLiteral("Noah"), QStringLiteral("Priya"), QStringLiteral("Riley")});
        body->addWidget(m_toolbar);

        m_model = new QStandardItemModel(this);
        m_model->setHorizontalHeaderLabels(
            {QStringLiteral("Project"), QStringLiteral("Owner"), QStringLiteral("Status"), QStringLiteral("Priority")});
        m_model->setHeaderData(3, Qt::Horizontal, int(Qt::AlignRight | Qt::AlignVCenter), Qt::TextAlignmentRole);
        const QStringList names{QStringLiteral("Aurora"), QStringLiteral("Beacon"), QStringLiteral("Canvas"),
            QStringLiteral("Delta"), QStringLiteral("Ember"), QStringLiteral("Fjord"), QStringLiteral("Grove"),
            QStringLiteral("Harbor")};
        const QStringList owners{QStringLiteral("Maya"), QStringLiteral("Noah"), QStringLiteral("Priya"),
            QStringLiteral("Riley")};
        for (int r = 0; r < names.size(); ++r) {
            auto* priority = new QStandardItem;
            priority->setData(r % 4 + 1, Qt::EditRole);
            priority->setTextAlignment(Qt::AlignRight | Qt::AlignVCenter);
            m_model->appendRow({new QStandardItem(names.at(r)), new QStandardItem(owners.at(r % 4)),
                new QStandardItem(r % 3 == 0 ? QStringLiteral("Review") : QStringLiteral("Active")), priority});
        }
        m_proxy = new ProjectFilterModel(this);
        m_proxy->setSourceModel(m_model);
        m_grid = new collections::DataGrid(this);
        m_grid->setObjectName(QStringLiteral("workspaceDataGrid"));
        m_grid->setAccessibleName(QStringLiteral("Projects"));
        m_grid->setModel(m_proxy);
        m_grid->setBorderVisible(false);
        m_grid->setPlaceholderText(QStringLiteral("No projects match these filters."));
        m_grid->setSelectionBehavior(QAbstractItemView::SelectRows);
        m_grid->setSelectionMode(collections::SelectionMode::Extended);
        m_grid->setSortingEnabled(true);
        m_grid->sortByColumn(0, Qt::AscendingOrder);
        m_grid->setEditTriggers(QAbstractItemView::DoubleClicked | QAbstractItemView::EditKeyPressed);
        m_grid->setColumnWidth(0, 300);
        m_grid->setColumnWidth(1, 180);
        m_grid->setColumnWidth(2, 160);
        m_grid->setColumnWidth(3, 176);
        m_grid->setMinimumHeight(220);
        m_toolbar->setDataGrid(m_grid);
        body->addWidget(m_grid, 1);

        auto* footer = new QHBoxLayout;
        m_summary = new textfields::Label(this);
        m_summary->setObjectName(QStringLiteral("dataGridSummary"));
        m_summary->setFluentTypography(Typography::FontRole::Caption);
        m_summary->setTextColorRole(textfields::Label::TextColorRole::Secondary);
        m_summary->setWordWrap(true);
        footer->addWidget(m_summary, 1);
        auto* save = new basicinput::Button(QStringLiteral("Save view"), this);
        save->setObjectName(QStringLiteral("dataGridSaveView"));
        auto* restore = new basicinput::Button(QStringLiteral("Restore"), this);
        restore->setObjectName(QStringLiteral("dataGridRestoreView"));
        restore->setEnabled(false);
        footer->addWidget(save);
        footer->addWidget(restore);
        body->addLayout(footer);
        connect(save, &QAbstractButton::clicked, this, [this, restore] {
            m_savedColumns = m_grid->saveColumnState();
            m_savedSearch = m_toolbar->searchText();
            m_savedFilters = m_toolbar->filters();
            restore->setEnabled(true);
            status_info::Toast::showOrUpdateToast(this, QStringLiteral("gallery.action-feedback"),
                QStringLiteral("View saved for this demo"), status_info::Toast::Success, 2200, status_info::Toast::Top,
                QMargins(16, 50, 16, 16));
        });
        connect(restore, &QAbstractButton::clicked, this, [this] {
            m_grid->restoreColumnState(m_savedColumns);
            m_toolbar->clearFilters();
            m_toolbar->setSearchText(m_savedSearch);
            for (auto it = m_savedFilters.cbegin(); it != m_savedFilters.cend(); ++it)
                m_toolbar->setFilterValues(it.key(), it.value().toStringList());
            updateSummary();
            status_info::Toast::showOrUpdateToast(this, QStringLiteral("gallery.action-feedback"),
                QStringLiteral("View restored"), status_info::Toast::Success, 2200, status_info::Toast::Top,
                QMargins(16, 50, 16, 16));
        });
        const auto filter = [this] {
            m_proxy->setCriteria(m_toolbar->searchText(), m_toolbar->filters());
            updateSummary();
        };
        connect(m_toolbar, &layout::DataGridToolBar::searchTextChanged, this, filter);
        connect(m_toolbar, &layout::DataGridToolBar::filtersChanged, this, filter);
        connect(m_grid->selectionModel(), &QItemSelectionModel::selectionChanged, this, [this] { updateSummary(); });
        m_grid->selectRow(2);
        updateSummary();
    }

private:
    void updateSummary()
    {
        m_summary->setText(QStringLiteral("%1 of %2 projects · %3 selected")
                .arg(m_proxy->rowCount())
                .arg(m_model->rowCount())
                .arg(m_grid->selectionModel()->selectedRows().size()));
    }
    layout::DataGridToolBar* m_toolbar = nullptr;
    collections::DataGrid* m_grid = nullptr;
    QStandardItemModel* m_model = nullptr;
    ProjectFilterModel* m_proxy = nullptr;
    textfields::Label* m_summary = nullptr;
    QByteArray m_savedColumns;
    QString m_savedSearch;
    QVariantMap m_savedFilters;
};
} // namespace fluent::gallery
#endif

fluent::layout::DataGridToolBar

Наследует QWidget · FluentElement · QMLPlus

Панель инструментов с полем поиска, фильтрами множественного выбора и меню видимости столбцов для DataGrid. Испускает сигналы при изменении текста поиска или фильтров; фильтрация данных остаётся на стороне приложения.

Конструкторы

Деструкторы

Методы

void setDataGrid(fluent::collections::DataGrid* grid)

Привязывает целевой DataGrid (по-прежнему управляется вызывающим кодом и не удаляется этой панелью инструментов).

fluent::basicinput::MultiSelectComboBox* addFilter(const QString& key, const QString& label, const QStringList& options)

Добавляет выпадающий фильтр с множественным выбором, принадлежащий панели инструментов; пустые и повторяющиеся ключи игнорируются.

void setFilterValues(const QString& key, const QStringList& values)

Выбирает совпадающие значения параметров для заданного ключа фильтра, игнорируя неизвестные или дублирующиеся значения.

Свойства

fluent::collections::DataGrid* dataGrid
Чтение dataGrid()Запись setDataGrid()Уведомление dataGridChanged()
QString searchText
Чтение searchText()Запись setSearchText()Уведомление searchTextChanged()
QVariantMap filters
Чтение filters()Уведомление filtersChanged()

Сигналы

Унаследовано от fluent::FluentElement

Перечисления

enum Theme

Глобальная визуальная тема, используемая при разрешении дизайн-токенов.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Методы

static void setTheme(Theme theme)

Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.

static void setThemeDeferred(Theme theme)

Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.

static Theme currentTheme()

Возвращает текущую активную глобальную тему.

static bool themeUsesDarkAppearance(Theme theme)

Возвращает, использует ли тема токены тёмного оформления и материалов.

static void refreshTheme()

Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.

static int themeGeneration()

Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.

Theme effectiveTheme() const

Определяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.

bool effectiveThemeUsesDarkAppearance() const

Возвращает, использует ли действующая тема этого элемента тёмную основу оформления.

bool setThemeOverrides(const QJsonObject& overrides)

Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.

QJsonObject themeOverrides() const

Возвращает заданные переопределения этого элемента.

void clearThemeOverrides()

Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.

const Colors& themeColorsRef() const

Доступ без копирования к активному набору цветов для горячих путей отрисовки.

Material::AcrylicToken themeAcrylic() const

Токены материалов, возвышения и адаптивной компоновки.

QColor themeBackdrop(bool active) const

Цвет фона рамки окна для заданного состояния активации.

virtual void onThemeUpdated()

Вызывается после изменения глобальной темы.

Типы и псевдонимы

struct Colors

Снимки дизайн-токенов, возвращаемые компонентам.

Унаследовано от fluent::QMLPlus

Методы

AnchorLayout::Anchors* anchors()

Возвращает изменяемые привязки для хоста QWidget.

void setState(const QString& name)

Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.

void addState(const QMLState& state)

Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.

void evaluateStates()

Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.

QMLPlusRuntime* runtime()

Возвращает лениво создаваемый наблюдатель состояния, принадлежащий этому хосту.

void setAnchors(const AnchorLayout::Anchors& anchors)

Заменяет все привязки хоста и инвалидирует родительскую компоновку.

void resetAnchors()

Очищает все привязки хоста и делает родительский макет недействительным.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().

BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})

Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.

void addTransition(const StateTransition& transition)

Регистрирует переход состояния в порядке приоритета.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.

void clearBehavior(const char* propertyName)

Удаляет анимацию по умолчанию для последующих управляемых записей.

bool writeProperty(const char* propertyName, const QVariant& value)

Записывает свойство хоста через Behavior без удаления его привязки.

Документация базового класса Qt: QWidget