レイアウト
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
#endifimport fluentqt
grid = fluentqt.DataGrid(self)
grid.setModel(project_proxy)
toolbar = fluentqt.DataGridToolBar(self)
toolbar.setDataGrid(grid)
toolbar.searchField().setPlaceholderText("Search projects…")
toolbar.addFilter("status", "Status", ["Active", "Review"])
toolbar.addFilter(
"owner",
"Owner",
["Maya", "Noah", "Priya", "Riley"]
)
# Apply searchText() and filters() in the application's proxy model.
toolbar.searchTextChanged.connect(apply_filters)
toolbar.filtersChanged.connect(apply_filters)
# Full example includes the proxy and Save view / Restore wiring.API
宣言を表示一致する API メンバーはありません。
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 = 0Dark = 1HighContrast = 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指定されたアクティブ状態に対するウィンドウ chrome の背景色。
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)PropertyBinder::bind() を介して、@p source の @p sourceProp をこの QWidget ホストの @p targetProp にバインドします。
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})この QWidget ホストに管理された直接バインディングを設定します。
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})この QWidget ホストに明示的依存関係を持つ C++ 式を設定します。
void addTransition(const StateTransition& transition)優先順位順に状態遷移を登録します。
void setBehavior(const char* propertyName, const PropertyAnimation& animation)writeProperty() またはバインディング経由で @p propertyName が書き込まれた際に使用されるデフォルトアニメーションを設定します。明示的な StateTransition ルールが優先され、C++ のセッターを直接呼び出した場合はアニメーションしません。
void clearBehavior(const char* propertyName)今後のマネージド書き込みに使用するデフォルトアニメーションを削除します。
bool writeProperty(const char* propertyName, const QVariant& value)バインディングを削除せずに Behavior 経由でホストプロパティに書き込みます。
Qt 基底クラスドキュメント:QWidget