QXYSeries Class
QXYSeries クラスは、すべての x および y 系列クラスの親クラスです。詳細...
| ヘッダー | #include <QXYSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| QML で | XYSeries |
| を継承： | QAbstractSeries |
| によって継承されています： |
- 継承されたメンバを含むすべてのメンバのリスト
- QXYSeries はQt Graphs C++ Classes for 2D に含まれます。
プロパティ
|
パブリック機能
| 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
DataPoint関数は、系列内のデータ点数を返します。
アクセス関数
| qsizetype | count() const |
通知シグナル
| void | countChanged() |
draggable : bool
シリーズがドラッグ可能かどうかを制御する。
マウス/タッチでシリーズをドラッグできるかどうかを制御する。デフォルトでは、draggable はfalse に設定されています。
アクセス関数：
| bool | isDraggable() const |
| void | setDraggable(bool newDraggable) |
通知シグナル：
| void | draggableChanged() |
pointDelegate : QQmlComponent*
このプロパティは、データポイントのマーカーとして使用されるカスタムQMLコンポーネントを保持します。
このコンポーネントで利用可能なダイナミックプロパティは以下の通りです：
| タイプ | 名前 | 説明 |
|---|---|---|
| ブール | pointSelected | この値は、ポイントが選択されているとき、つまりポイントインデックスがQXYSeries::selectedPoints にあるときに真になります。 |
| QColor | pointColor | 系列の色。こ の値はQGraphsTheme か、QXYSeries が色を上書き し てい る 場合はQXYSeries::color か ら 与え ら れます。 |
| QColor | pointBorderColor | 系列の境界色。この値はQGraphsTheme から来る。 |
| QColor | pointSelectedColor | シリーズの選択色。この値はQGraphsTheme から、またはQXYSeries が色を上書きする場合はQXYSeries::selectedColor から取得します。 |
| qreal | pointBorderWidth | 系列のボーダー幅。この値はQGraphsTheme から取得します。 |
| qreal | pointValueX | この位置のQXYPoint::x の値。 |
| qreal | pointValueY | この位置のQXYPoint::y の値。 |
これらのいずれかを使用するには、定義された名前のプロパティをカスタム・コンポーネントに追加します。例えば、"property color pointColor" や"property real pointValueX" など。
アクセス関数：
| QQmlComponent * | pointDelegate() const |
| void | setPointDelegate(QQmlComponent *newPointDelegate) |
通知シグナル：
| void | pointDelegateChanged() |
selectedColor : QColor
このプロパティは、選択された点の色を保持する。
アクセス関数
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
通知シグナル
| void | selectedColorChanged(QColor color) |
[read-only] selectedPoints : const QList<qsizetype>
このプロパティは、現在選択されている点のインデックスを保持する。
アクセス関数
| QList<qsizetype> | selectedPoints() const |
通知シグナル
| 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)
座標x とy を持つ点をシリーズに追加する。
注意： この関数はメタオブジェクトシステムや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()
シリーズ内のすべてのポイントの選択を解除します。
注意 ：この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
setPointSelected()も参照してください 。
[invokable] void QXYSeries::deselectPoint(qsizetype index)
指定されたindex の点の選択を解除する。
注： この関数はQXYSeries::selectedPointsChanged
Note: この関数はメタオブジェクトシステムや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 の点が選択された点の中にあれば真を、そうでなければ偽を返す。
注意 ：選択された点は、選択された色が指定されていれば、その色で描画されます。
注意 ：この関数はメタオブジェクトシステムや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)
座標x とy を持つ点を系列から削除します。点が存在しない場合は何もしません。
注意： この関数はメタオブジェクトシステムや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
注： これは、データ点を1つずつ置き換えたり、最初にすべてのデータをクリアしてから新しいデータを追加したりするよりもはるかに高速です。点の入れ替えが完了すると、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 で指定された位置にある点を、座標newX とnewY を持つ点で置き換えます。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
座標oldX とoldY を持つ点を、 座標newX とnewY を持つ点に置き換える。古い点が存在しない場合は何もしません。
注意： この関数はメタオブジェクトシステムや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
選択されているとマークされた点のインデックスのリストを返す。選択されたポイントは、ポイントの可視性に関係なく表示されます。
注： 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
Note: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照。
setPointSelected()も参照してください 。
© 2025 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.
