Графики
AreaChart Диаграмма с областями
Отображает тренд в виде закрашенной области под линией.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Активные сеансы
Используется как LineChart: привяжите данные с помощью setModel() и добавьте ещё одну серию через addSeries().
#include <FluentQt/Charts.h>
using namespace fluent::charts;
auto* chart = new AreaChart(this);
chart->setObjectName("chartPresentation");
chart->setMinimumHeight(420);
chart->setTitle("Active sessions");
chart->setSubtitle("Sessions · last 7 days");
auto* model = new ChartModel(chart);
model->setName("Primary");
const QStringList labels = {"Mon", "Mon, 04:48", "Mon, 09:36", "Mon, 14:24", "Mon, 19:12", "Tue",
"Tue, 04:48", "Tue, 09:36", "Tue, 14:24", "Tue, 19:12", "Wed", "Wed, 04:48",
"Wed, 09:36", "Wed, 14:24", "Wed, 19:12", "Thu", "Thu, 04:48", "Thu, 09:36",
"Thu, 14:24", "Thu, 19:12", "Fri", "Fri, 04:48", "Fri, 09:36", "Fri, 14:24",
"Fri, 19:12", "Sat", "Sat, 04:48", "Sat, 09:36", "Sat, 14:24", "Sat, 19:12",
"Sun"};
model->setPoints(
{{0, 27}, {1, 32}, {2, 28}, {3, 34}, {4, 30}, {5, 36}, {6, 34}, {7, 32},
{8, 41}, {9, 39}, {10, 37}, {11, 42}, {12, 46}, {13, 43}, {14, 40}, {15, 46},
{16, 42}, {17, 47}, {18, 52}, {19, 48}, {20, 54}, {21, 59}, {22, 56}, {23, 61},
{24, 57}, {25, 60}, {26, 58}, {27, 64}, {28, 59}, {29, 66}, {30, 62}},
labels);
chart->setModel(model);
auto* secondary = new ChartModel(chart);
secondary->setName("Secondary");
secondary->setPoints(
{{0, 14}, {1, 18}, {2, 16}, {3, 20}, {4, 17}, {5, 22}, {6, 20}, {7, 18},
{8, 25}, {9, 23}, {10, 22}, {11, 26}, {12, 29}, {13, 27}, {14, 25}, {15, 28},
{16, 26}, {17, 31}, {18, 34}, {19, 30}, {20, 35}, {21, 41}, {22, 38}, {23, 42},
{24, 39}, {25, 43}, {26, 40}, {27, 44}, {28, 41}, {29, 46}, {30, 43}}, labels);
chart->addSeries(secondary);import fluentqt
from PySide6.QtCore import QPointF
chart = fluentqt.AreaChart()
chart.setObjectName("chartPresentation")
chart.setMinimumHeight(420)
chart.setTitle('Active sessions')
chart.setSubtitle('Sessions · last 7 days')
model = fluentqt.ChartModel(chart)
model.setName("Primary")
values = [27, 32, 28, 34, 30, 36, 34, 32, 41, 39, 37, 42, 46, 43, 40,
46, 42, 47, 52, 48, 54, 59, 56, 61, 57, 60, 58, 64, 59, 66,
62]
labels = ['Mon', 'Mon, 04:48', 'Mon, 09:36', 'Mon, 14:24',
'Mon, 19:12', 'Tue', 'Tue, 04:48', 'Tue, 09:36',
'Tue, 14:24', 'Tue, 19:12', 'Wed', 'Wed, 04:48',
'Wed, 09:36', 'Wed, 14:24', 'Wed, 19:12', 'Thu',
'Thu, 04:48', 'Thu, 09:36', 'Thu, 14:24', 'Thu, 19:12',
'Fri', 'Fri, 04:48', 'Fri, 09:36', 'Fri, 14:24',
'Fri, 19:12', 'Sat', 'Sat, 04:48', 'Sat, 09:36',
'Sat, 14:24', 'Sat, 19:12', 'Sun']
model.setPoints(
[QPointF(i, y) for i, y in enumerate(values)],
labels
)
chart.setModel(model)
secondary = fluentqt.ChartModel(chart)
secondary.setName("Secondary")
secondary_values = [14, 18, 16, 20, 17, 22, 20, 18, 25, 23, 22, 26, 29, 27, 25,
28, 26, 31, 34, 30, 35, 41, 38, 42, 39, 43, 40, 44, 41, 46,
43]
secondary.setPoints(
[QPointF(i, y) for i, y in enumerate(secondary_values)],
labels
)
chart.addSeries(secondary)API
ОбъявлениеНет подходящих элементов API.
fluent::charts::AreaChart
Наследует ChartView
Виджет диаграммы с областями на основе ChartModel.
Конструкторы
Унаследовано от fluent::charts::ChartView
Перечисления
enum ChartTypeLineAreaBarHorizontalBarPieDonutScatterSparkline
Методы
void setModel(ChartModel* model)Задаёт одиночную модель графика (управляется вызывающим кодом); передайте nullptr для очистки.
bool addSeries(ChartModel* model)Добавляет модель серии (до 32, управляется вызывающим кодом); дубликаты игнорируются. Pie и Donut отображают только seriesModel(0); для них предпочтительнее setModel().
void setChartType(ChartType type)Изменяет тип диаграммы в универсальном ChartView; специализированные подклассы сохраняют фиксированный тип.
QString valueSuffix() constСуффикс единицы измерения, добавляемый к отображаемому значению (например, " ms" или "%").
void setValueSuffix(const QString& suffix)Суффикс единицы измерения, добавляемый к отображаемому значению (например, " ms" или "%").
bool isLoading() constПоказывает состояние загрузки, пока данные подготавливаются извне.
void setLoading(bool loading)Показывает состояние загрузки, пока данные подготавливаются извне.
void setYRange(double minimum, double maximum)Задаёт конечный возрастающий диапазон по оси Y (например, [0, 100]); некорректные диапазоны игнорируются.
void setMaximumPointCount(int count)Задаёт лимит точек выборки в диапазоне [512, 65536], ограниченный шириной области просмотра.
void setMaximumFrameRate(int rate)Ограничивает частоту обновлений модели в диапазоне [1, 60] Гц; скрытые диаграммы приостанавливают обновления.
void setXRange(double minimum, double maximum)Задаёт конечный возрастающий диапазон по оси X; некорректные диапазоны игнорируются.
void setCurrentPoint(int series, int row)Перемещает курсор данных на строку ряда; передайте -1 для сброса.
int renderedPointCount() constКоличество отобранных точек с последнего прохода отрисовки.
QImage exportImage(double scale = 1.0)Экспортирует изображение диаграммы в заданном масштабе (без курсора наведения и контура фокуса); вызывайте в потоке GUI.
QByteArray exportPng(double scale = 1.0)Кодирует exportImage() в байты PNG, возвращая пустой результат при ошибке.
QByteArray exportCsv(bool visibleRangeOnly = false) constЭкспортирует необработанные строки модели в UTF-8 CSV (столбцы: series, name, x, y, label, unit); вызывайте в потоке GUI. Передайте visibleRangeOnly = true, чтобы ограничить декартовы диаграммы текущим диапазоном X.
void copyImage(double scale = 1.0)Копирует PNG-изображение диаграммы в буфер обмена и испускает imageCopied().
void copyData(bool visibleRangeOnly = false)Копирует экспортированные строки CSV в буфер обмена и испускает dataCopied(). Должен вызываться в потоке GUI (вызовы из других потоков испускают dataCopied(false)).
Свойства
ChartType chartType- Чтение
chartType()ЗаписьsetChartType()УведомлениеchartTypeChanged() QString title- Чтение
title()ЗаписьsetTitle()УведомлениеtitleChanged() QString subtitle- Чтение
subtitle()ЗаписьsetSubtitle()УведомлениеsubtitleChanged() QString valueSuffixСуффикс единицы измерения, добавляемый к отображаемому значению (например, " ms" или "%").
ЧтениеvalueSuffix()ЗаписьsetValueSuffix()УведомлениеvalueSuffixChanged()QString centerText- Чтение
centerText()ЗаписьsetCenterText()УведомлениеcenterTextChanged() QString centerCaption- Чтение
centerCaption()ЗаписьsetCenterCaption()УведомлениеcenterCaptionChanged() bool loadingПоказывает состояние загрузки, пока данные подготавливаются извне.
ЧтениеisLoading()ЗаписьsetLoading()УведомлениеloadingChanged()bool autoYRange- Чтение
isAutoYRange()УведомлениеyRangeChanged() bool legendVisible- Чтение
isLegendVisible()ЗаписьsetLegendVisible()УведомлениеlegendVisibleChanged() int maximumPointCount- Чтение
maximumPointCount()ЗаписьsetMaximumPointCount()УведомлениеmaximumPointCountChanged() int maximumFrameRate- Чтение
maximumFrameRate()ЗаписьsetMaximumFrameRate()УведомлениеmaximumFrameRateChanged() bool autoRange- Чтение
isAutoRange()УведомлениеxRangeChanged()
Сигналы
void valueSuffixChanged(const QString& suffix)Суффикс единицы измерения, добавляемый к отображаемому значению (например, " ms" или "%").
void loadingChanged(bool loading)Показывает состояние загрузки, пока данные подготавливаются извне.
void rangeActivated(int series, int first, int last)Испускается при активации отображаемой точки или интервала [first, last).
Унаследовано от 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: QWidget