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 |
プロパティ
- delegate : QQmlComponent*
パブリック機能
| 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 | setDelegate(QQmlComponent *newDelegate) |
パブリックスロット
| void | clear() |
シグナル
| void | delegateChanged() |
保護された関数
| 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) |
通知シグナル：
| 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)
index の位置にdata で定義されたデータ項目を追加する。
注意： この関数はメタオブジェクトシステムや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 を参照してください。
[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.
