QXYSeries Class

QXYSeries クラスは、すべての x および y 系列クラスの親クラスです。詳細...

Header: #include <QXYSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: XYSeries
Inherits: QAbstractSeries
Inherited By:

QLineSeries, QScatterSeries, and QSplineSeries

プロパティ

パブリック関数

void append(QPointF point)
void append(const QList<QPointF> &points)
void append(qreal x, qreal y)
QPointF at(qsizetype index) const
void clear()
QColor color() const
qsizetype count() const
void deselectAllPoints()
void deselectPoint(qsizetype index)
void deselectPoints(const QList<qsizetype> &indexes)
qsizetype find(QPointF point) const
void insert(qsizetype index, QPointF point)
bool isDraggable() const
bool isPointSelected(qsizetype index) const
QQmlComponent *pointDelegate() const
QList<QPointF> points() const
void remove(QPointF point)
void remove(qsizetype index)
void remove(qreal x, qreal y)
void removeMultiple(qsizetype index, qsizetype count)
void replace(const QList<QPointF> &points)
void replace(QPointF oldPoint, QPointF newPoint)
void replace(qsizetype index, QPointF newPoint)
void replace(qsizetype index, qreal newX, qreal newY)
void replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
void selectAllPoints()
void selectPoint(qsizetype index)
void selectPoints(const QList<qsizetype> &indexes)
QColor selectedColor() const
QList<qsizetype> selectedPoints() const
void setColor(QColor newColor)
void setDraggable(bool newDraggable)
void setPointDelegate(QQmlComponent *newPointDelegate)
void setPointSelected(qsizetype index, bool selected)
void setSelectedColor(QColor color)
bool take(QPointF point)
void toggleSelection(const QList<qsizetype> &indexes)

シグナル

void colorChanged(QColor color)
void countChanged()
void draggableChanged()
void pointDelegateChanged()
void pointReplaced(qsizetype index)
void pointsReplaced()
void selectedColorChanged(QColor color)
void selectedPointsChanged()

詳細説明

QXYSeries では、データポイントはQPointF のリストとして定義されます。

QLineSeries およびQScatterSeriesも参照してください

プロパティの説明

color : QColor

このプロパティは、シリーズのメインカラーを保持します。QLineSeries では線の色、QScatterSeries では点の色を意味する。

アクセス関数:

QColor color() const
void setColor(QColor newColor)

通知シグナル:

void colorChanged(QColor color)

[read-only] count : const qsizetype

Notifierシグナル: シリーズのデータポイント数を返す。

アクセス関数

qsizetype count() const

Notifierシグナル:系列内のデータポイント数を返す:

void countChanged()

draggable : bool

シリーズがドラッグ可能かどうかを制御する。

マウス/タッチでシリーズをドラッグできるかどうかを制御する。デフォルトでは、draggablefalse に設定されている。

アクセス関数:

bool isDraggable() const
void setDraggable(bool newDraggable)

通知シグナル:

void draggableChanged()

pointDelegate : QQmlComponent*

このプロパティはデータポイントのマーカーとして使用されるカスタムQMLコンポーネントを保持します。

このコンポーネントで利用可能なダイナミックプロパティは以下の通りです:

タイプ名前説明
ブールpointSelectedこの値は、ポイントが選択されているとき、つまりポイントインデックスがQXYSeries::selectedPoints にあるときに真になります。
QColorpointColor系列の色。こ の値はQGraphsTheme か、QXYSeries が色を上書き し てい る 場合はQXYSeries::color か ら 与え ら れます。
QColorpointBorderColor系列の境界色。この値はQGraphsTheme から来る。
QColorpointSelectedColorシリーズの選択色。この値はQGraphsTheme から、またはQXYSeries が色を上書きする場合はQXYSeries::selectedColor から取得します。
qrealpointBorderWidth系列のボーダー幅。この値はQGraphsTheme から取得します。
qrealpointValueXこの位置のQXYPoint::x の値。
qrealpointValueYこの位置のQXYPoint::y の値。

これらのいずれかを使用するには、定義された名前のプロパティをカスタム・コンポーネントに追加します。例えば、"property color pointColor""property real pointValueX" など。

アクセス関数:

QQmlComponent *pointDelegate() const
void setPointDelegate(QQmlComponent *newPointDelegate)

通知シグナル:

void pointDelegateChanged()

selectedColor : QColor

このプロパティは、選択されたシリーズのメインカラーを保持します。QLineSeries では線の色、QScatterSeries では点の色を意味します。

アクセス関数:

QColor selectedColor() const
void setSelectedColor(QColor color)

通知シグナル:

void selectedColorChanged(QColor color)

[read-only] selectedPoints : const QList<qsizetype>

このプロパティは、現在選択されている点のインデックスを保持する。

アクセス関数:

QList<qsizetype> selectedPoints() const

Notifier signal: このプロパティは、現在選択されている点のインデックスを保持する:

void selectedPointsChanged()

メンバ関数ドキュメント

[invokable] void QXYSeries::append(QPointF point)

座標point を持つ点をシリーズに追加する。

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

[invokable] void QXYSeries::append(const QList<QPointF> &points)

座標points の点を系列に追加する。

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

[invokable] void QXYSeries::append(qreal x, qreal y)

座標xy の点を系列に追加します。

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

[invokable] QPointF QXYSeries::at(qsizetype index) const

index で指定された位置にある点を返します。インデックスが有効でない場合は(0, 0)を返します。

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

[invokable] void QXYSeries::clear()

全ての点を系列から削除します。

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

[invokable] void QXYSeries::deselectAllPoints()

シリーズ内のすべてのポイントの選択を解除します。

注意: この関数はQXYSeries::selectedPointsChanged

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

setPointSelected()も参照してください

[invokable] void QXYSeries::deselectPoint(qsizetype index)

指定されたindex の点の選択を解除する。

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

setPointSelected()も参照

[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

indexes リストで渡された複数の点を非選択としてマークします。

注意: この関数はQXYSeries::selectedPointsChanged

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

setPointSelected()も参照してください

[invokable] qsizetype QXYSeries::find(QPointF point) const

point で定義されているように、最初にマッチする点を見つけ、そのインデックスを返します。点が見つからない場合は -1 を返します。

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

[invokable] void QXYSeries::insert(qsizetype index, QPointF point)

座標point を持つ点を、直列のindex で指定された位置に挿入します。インデックスが0以下の場合、点は点のリストに追加されます。インデックスが系列内の点の数以上の場合、点は点のリストに追加される。

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

[invokable] bool QXYSeries::isPointSelected(qsizetype index) const

与えられたindex の点が選択された点の中にあればtrueを返し、そうでなければfalseを返します。

注意 :選択された点は、選択された色が指定されていれば、その色を使って描画されます。

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

selectedPoints,setPointSelected(),setSelectedColor()も参照してください

[signal] void QXYSeries::pointReplaced(qsizetype index)

このシグナルは、index で指定された位置で点が置き換えられると発せられます。

replace()も参照のこと

QList<QPointF> QXYSeries::points() const

シリーズのポイントを返す。

[signal] void QXYSeries::pointsReplaced()

このシグナルは、すべての点が置換されたときに発せられる。

[invokable] void QXYSeries::remove(QPointF point)

座標point を持つ点を系列から削除します。その点が存在しない場合は何もしない。

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

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

index で指定された位置の点を系列から削除します。

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

[invokable] void QXYSeries::remove(qreal x, qreal y)

座標xy の点を系列から削除します。点が存在しない場合は何もしません。

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

[invokable] void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

index で指定された位置から、count で指定された数の点を系列から削除する。

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

[invokable] void QXYSeries::replace(const QList<QPointF> &points)

で指定された点で現在の点を置き換えます。points

注: この関数は、データ点を一つずつ置き換えたり、最初にすべてのデータをクリアし てから新しいデータを追加したりするよりもはるかに高速です。点の入れ替えが完了すると、pointsReplaced

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

[invokable] void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

座標oldPoint を持つ点を座標newPoint を持つ点で置き換えます。古い点が存在しない場合は何もしません。

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

[invokable] void QXYSeries::replace(qsizetype index, QPointF newPoint)

index で指定された位置にある点を、座標newPoint を持つ点で置き換えます。

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

[invokable] void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

index で指定された位置にある点を、座標newXnewY を持つ点で置き換えます。

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

[invokable] void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

座標oldXoldY を持つ点を、座標newXnewY を持つ点に置き換えます。古い点が存在しない場合は何もしません。

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

[invokable] void QXYSeries::selectAllPoints()

シリーズ内のすべての点を選択されたものとしてマークします、

注: この関数はQXYSeries::selectedPointsChanged

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

setPointSelected()も参照してください

[invokable] void QXYSeries::selectPoint(qsizetype index)

index の点を選択されたものとしてマークする。

注: この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照。

setPointSelected()も参照

[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

indexes リストで渡された複数の点を選択されたものとしてマークします。

注意: この関数はQXYSeries::selectedPointsChanged

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

setPointSelected()も参照

QList<qsizetype> QXYSeries::selectedPoints() const

selected としてマークされた点のインデックスのリストを返す。選択された点は、点の可視性に関係なく表示されます。

注: selectedPoints プロパティのゲッター関数。

setPointSelected() も参照

[invokable] void QXYSeries::setPointSelected(qsizetype index, bool selected)

指定されたindex の点を、selected で指定された選択または非選択としてマークする。

注意 :選択された点は、選択された色が指定されている場合、その色を使って描画されます。を発する。QXYSeries::selectedPointsChanged

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

isPointSelected(),selectAllPoints(),setSelectedColor()も参照してください

[invokable] bool QXYSeries::take(QPointF point)

見つかった場合、point で指定された点を系列から取り出します。操作が成功すればtrue を返す。

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

[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

与えられたindexes の点の選択状態を、逆の状態に変更する。

注: この関数はQXYSeries::selectedPointsChanged

注: この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照。

setPointSelected()も参照してください

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。