Коллекции
DataGrid Таблица данных
Отображает большие наборы строк и столбцов из модели с заголовками, сортировкой, выделением и редактированием через делегаты.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Закреплённые столбцы и редактирование
Прокручивайте по горизонтали — столбец Project остаётся видимым. Дважды щёлкните ячейку или нажмите F2 для редактирования.
#include <FluentQt/Collections.h>
using namespace fluent::collections;
auto* grid = new DataGrid(this);
grid->setAccessibleName("Pinned projects");
auto* model = new QStandardItemModel(grid);
model->setHorizontalHeaderLabels({"Project", "Owner", "Status"});
model->appendRow({new QStandardItem("Aurora"),
new QStandardItem("Maya"), new QStandardItem("Active")});
model->appendRow({new QStandardItem("Beacon"),
new QStandardItem("Noah"), new QStandardItem("Review")});
grid->setModel(model);
grid->setSelectionBehavior(QAbstractItemView::SelectRows);
grid->setEditTriggers(QAbstractItemView::DoubleClicked | QAbstractItemView::EditKeyPressed);
grid->setColumnWidth(0, 240);
grid->setColumnWidth(1, 220);
grid->setColumnWidth(2, 240);
grid->setColumnPinned(0, true);
grid->setMaximumWidth(600);
grid->setFixedHeight(180);import fluentqt
from PySide6.QtGui import QStandardItem, QStandardItemModel
from PySide6.QtWidgets import QAbstractItemView
grid = fluentqt.DataGrid()
grid.setAccessibleName('Pinned projects')
model = QStandardItemModel(grid)
model.setHorizontalHeaderLabels(['Project', 'Owner', 'Status'])
model.appendRow(
[QStandardItem("Aurora"), QStandardItem("Maya"), QStandardItem("Active")]
)
model.appendRow(
[QStandardItem("Beacon"), QStandardItem("Noah"), QStandardItem("Review")]
)
grid.setModel(model)
grid.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows)
grid.setEditTriggers(
QAbstractItemView.EditTrigger.DoubleClicked
| QAbstractItemView.EditTrigger.EditKeyPressed
)
grid.setColumnWidth(0, 240)
grid.setColumnWidth(1, 220)
grid.setColumnWidth(2, 240)
grid.setColumnPinned(0, True)
grid.setMaximumWidth(600)
grid.setFixedHeight(180)API
ОбъявлениеНет подходящих элементов API.
fluent::collections::DataGrid
Наследует QTableView · FluentElement · QMLPlus
Табличное представление на основе модели элементов Qt с поддержкой выбора, сортировки и редактирования по требованию.
Конструкторы
Деструкторы
Методы
void setModel(QAbstractItemModel* model) overrideЗадаёт табличную модель элементов (управляется вызывающим кодом) и обновляет состояние таблицы.
void setSelectionModel(QItemSelectionModel* selectionModel) overrideЗадаёт модель выделения (управляется вызывающим кодом).
void setColumnPinned(int column, bool pinned)Закрепляет или открепляет логический столбец у начального края таблицы.
void setColumnVisible(int column, bool visible)Показывает или скрывает логический столбец и испускает columnLayoutChanged() при изменении видимости.
QByteArray saveColumnState() constСериализует порядок столбцов, их ширину, видимость, флаги закрепления и индикатор сортировки.
bool restoreColumnState(const QByteArray& state)Восстанавливает ранее сохранённую компоновку столбцов для той же схемы модели; некорректные данные игнорируются.
fluent::scrolling::ScrollBar* verticalFluentScrollBar() constВозвращает вертикальную наложенную полосу прокрутки Fluent.
fluent::scrolling::ScrollBar* horizontalFluentScrollBar() constВозвращает горизонтальную наложенную полосу прокрутки Fluent.
Свойства
SelectionMode selectionMode- Чтение
selectionMode()ЗаписьsetSelectionMode()УведомлениеselectionModeChanged() QString placeholderText- Чтение
placeholderText()ЗаписьsetPlaceholderText()УведомлениеplaceholderTextChanged() bool borderVisible- Чтение
isBorderVisible()ЗаписьsetBorderVisible()УведомлениеborderVisibleChanged() bool backgroundVisible- Чтение
isBackgroundVisible()ЗаписьsetBackgroundVisible()УведомлениеbackgroundVisibleChanged() bool scrollChainingEnabled- Чтение
isScrollChainingEnabled()ЗаписьsetScrollChainingEnabled()УведомлениеscrollChainingEnabledChanged() bool animationEnabled- Чтение
isAnimationEnabled()ЗаписьsetAnimationEnabled()УведомлениеanimationEnabledChanged()
Сигналы
Типы и псевдонимы
Дополнения PySide6
Защищённые члены
Методы
Унаследовано от 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Цвет фона рамки окна для заданного состояния активации.
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 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 = {})Устанавливает 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: QTableView