このページでは

QCustomSeries Class

QCustomSeries クラスを使用すると、カスタマイズされたグラフタイプを表示することができます。詳細...

ヘッダー: #include <QCustomSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
以下のように: Qt 6.11
QML における: CustomSeries
継承元: QAbstractSeries

プロパティ

パブリック関数

void append()
void append(const QVariantMap &data)
QQmlComponent *delegate() const
void insert(qsizetype index)
void insert(qsizetype index, const QVariantMap &data)
qreal mapX(qreal x)
qreal mapY(qreal y)
void remove(qsizetype index)
void setCustomSeriesPainter(QCustomSeriesCanvasRenderer *painter)
void setDelegate(QQmlComponent *newDelegate)

パブリックスロット

void clear()

シグナル

保護された関数

virtual void updateDelegate(QQuickItem *item, qsizetype index)

詳細な説明

QCustomSeries を使用して、カスタマイズされたグラフを作成します。これは、各要素のカスタムデータにアクセスできる散布図と考えてください。

QCustomSeries は、グラフに追加された各アイテムをレンダリングするために使用されるデリゲートを定義します。各アイテムには、QVariantMap に格納されたユーザー定義データが含まれます。グラフ内でのアイテムのインデックスも、自動的にデータマップに追加されます。このシリーズは、デリゲートに基づいて作成された各要素にこのマップを渡します。デリゲートは、データの使用方法を決定します。

QGraphsView の軸によって定義されたレンダリング座標にデータをマッピングするには、mapX およびmapY 関数を使用します。

注: 現在 、カスタム系列内の個々の要素は互いに情報を共有しません。このため、カスタム線形系列を実装することはできません。

プロパティのドキュメント

delegate : QQmlComponent*

このデリゲートは、指定されたカスタムデータに対応する要素をQMLに挿入するために使用されます。データはCustomSeries 自体で定義され、「data」プロパティを通じてデリゲートされた要素に渡されます。

アクセス関数:

QQmlComponent *delegate() const
void setDelegate(QQmlComponent *newDelegate)

Notifierシグナル:

void delegateChanged()

メンバ関数のドキュメント

[invokable] void QCustomSeries::append()

シリーズに空のデータ項目を追加します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QCustomSeries::append(const QVariantMap &data)

data で定義されたデータ項目をシリーズに追加します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[slot] void QCustomSeries::clear()

すべてのデータ項目を消去します。

[invokable] void QCustomSeries::insert(qsizetype index)

位置index にあるシリーズに、空のデータ項目を追加します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QCustomSeries::insert(qsizetype index, const QVariantMap &data)

data で定義されたデータ項目を、位置index のシリーズに追加します。

注:この関数は 、メタオブジェクトシステムを介して、および QML から呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] qreal QCustomSeries::mapX(qreal x)

x の軸空間座標をレンダリング空間に変換した値を返します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] qreal QCustomSeries::mapY(qreal y)

y の軸空間座標を、レンダリング空間座標に変換して返します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QCustomSeries::remove(qsizetype index)

位置index にあるデータ項目を削除します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

void QCustomSeries::setCustomSeriesPainter(QCustomSeriesCanvasRenderer *painter)

高性能なキャンバスペインターバックエンドが使用されている場合、このシリーズを描画するために使用されるキャンバスペインターレンダラーとして `painter ` を設定します。

QCustomSeries painter の所有権を取得します。これは、次にこのシリーズが同期される際に CanvasPainter-backend レンダラーによって採用され、その後はレンダリングスレッド上でレンダラーによってのみ破棄されます。 が直接破棄することは決してありません。最初の同期の前に が置き換えられたりクリアされたりした場合、あるいはその前にこのシリーズが破棄された場合、 自身がこれを削除します。QCustomSeries painter QCustomSeries

[virtual protected] void QCustomSeries::updateDelegate(QQuickItem *item, qsizetype index)

グラフレンダラーによって呼び出され、データを表すitem およびデータ項目に対応するindex へのアクセスを提供します。

QQuickItem インスタンスに対してカスタムプロパティ値を実装するには、このメソッドをオーバーライドしてください。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.