チャート
LineChart 折れ線グラフ
時間や順序に沿った数値の変化を折れ線で表示します。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
応答時間
ChartModel にデータ点とラベルを書き込み、setModel() を呼び出します。addSeries() で比較用の 2 つ目の系列を追加できます。
#include <FluentQt/Charts.h>
using namespace fluent::charts;
auto* chart = new LineChart(this);
chart->setObjectName("chartPresentation");
chart->setMinimumHeight(420);
chart->setTitle("Response time");
chart->setSubtitle("Milliseconds · 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);
chart->setValueSuffix(" ms");
chart->setYRange(0, 80);import fluentqt
from PySide6.QtCore import QPointF
chart = fluentqt.LineChart()
chart.setObjectName("chartPresentation")
chart.setMinimumHeight(420)
chart.setTitle('Response time')
chart.setSubtitle('Milliseconds · 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)
chart.setValueSuffix(" ms")
chart.setYRange(0, 80)API
宣言を表示一致する API メンバーはありません。
fluent::charts::LineChart
継承元 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] Hz にスロットリングします。非表示のチャートは更新を一時停止します。
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 スレッドから呼び出してください。直交座標チャートを現在の X 範囲に限定するには visibleRangeOnly = true を渡します。
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指定されたアクティブ状態に対するウィンドウ 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