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 の2D 用 C++ クラスの一部です。
パブリック型
(since 6.12) enum class | ValueMapping { X, Y } |
プロパティ
|
|
パブリック関数
| 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) |
| void | setStepSize(qreal stepSize) |
| void | setValueMapping(QXYSeries::ValueMapping newHint) |
| void | setValueMin(qreal newMin) |
| void | setValues(QVariantList values) |
| qreal | stepSize() const |
| bool | take(QPointF point) |
| void | toggleSelection(const QList<qsizetype> &indexes) |
| QXYSeries::ValueMapping | valueMapping() const |
| qreal | valueMin() const |
| QVariantList | values() const |
シグナル
| void | colorChanged(QColor color) |
| void | countChanged() |
| void | draggableChanged() |
| void | pointDelegateChanged() |
| void | pointReplaced(qsizetype index) |
(since 6.9) void | pointsAdded(qsizetype start, qsizetype end) |
| void | pointsReplaced() |
| void | selectedColorChanged(QColor color) |
| void | selectedPointsChanged() |
| void | stepSizeChanged(qreal newStepSize) |
| void | valueMappingChanged(QXYSeries::ValueMapping newHint) |
| void | valueMinChanged(qreal newMin) |
| void | valuesChanged(const QVariantList &values) |
詳細な説明
QXYSeries では、データポイントは、X および Y の位置を定義する `QPointF` のリストとして定義されます。
QLineSeries およびQScatterSeriesも参照してください 。
メンバ型のドキュメント
[since 6.12] enum class QXYSeries::ValueMapping
この列挙型は、values における単純な数値の解釈方法を定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QXYSeries::ValueMapping::X | 0 | 各数値は X 値です。Y は、インデックスとstepSize から生成されます。 |
QXYSeries::ValueMapping::Y | 1 | 各数値は Y 値であり、X は `valueMin ` および `stepSize` から生成されます。 |
この列挙型は Qt 6.12 で導入されました。
プロパティのドキュメント
color : QColor
このプロパティは、シリーズのメインカラーを指定します。QLineSeries の場合、これは線の色を、QScatterSeries の場合、点の色を指定します。
アクセス関数：
| QColor | color() const |
| void | setColor(QColor newColor) |
通知シグナル:
| void | colorChanged(QColor color) |
[read-only] count : qsizetype
系列に含まれるデータポイントの数を返します。
アクセス関数：
| qsizetype | count() const |
通知信号：
| void | countChanged() |
draggable : bool
シリーズをドラッグ可能にするかどうかを制御します。
シリーズをマウスやタッチ操作でドラッグできるかどうかを制御します。デフォルトでは、draggable はfalse に設定されています。
アクセス関数：
| bool | isDraggable() const |
| void | setDraggable(bool newDraggable) |
通知シグナル:
| void | draggableChanged() |
pointDelegate : QQmlComponent*
このプロパティには、データポイントのマーカーとして使用されるカスタムQMLコンポーネントが格納されます。
このコンポーネントで使用可能な動的プロパティは以下の通りです：
| タイプ | 名前 | 説明 |
|---|---|---|
| bool | pointSelected | この値は、点が選択されている場合（つまり、その点のインデックスがQXYSeries::selectedPoints に含まれている場合）にtrueになります。 |
| 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 の値。 |
| int | pointIndex | ポイントのインデックス。0 からポイント総数 - 1 までの範囲です。[6.9 以降] |
これらを使用するには、カスタムコンポーネントに定義された名前のプロパティを追加してください。例："property color pointColor" および"property real pointValueX" 。
アクセス関数：
| QQmlComponent * | pointDelegate() const |
| void | setPointDelegate(QQmlComponent *newPointDelegate) |
Notifierシグナル:
| void | pointDelegateChanged() |
selectedColor : QColor
このプロパティには、選択されたポイントの色が格納されます。
アクセス関数：
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
通知シグナル:
| void | selectedColorChanged(QColor color) |
[read-only] selectedPoints : QList<qsizetype>
このプロパティには、現在選択されている点のインデックスが格納されます。
アクセス関数：
| QList<qsizetype> | selectedPoints() const |
通知シグナル:
| void | selectedPointsChanged() |
[since 6.12] stepSize : qreal
このプロパティは、values を使用して単純な数値からシリーズを生成する際、自動生成される X（または Y）値間のステップサイズを指定します。
デフォルト値は 1 です。
この列挙型は Qt 6.12 で導入されました。
アクセス関数:
| qreal | stepSize() const |
| void | setStepSize(qreal stepSize) |
通知シグナル:
| void | stepSizeChanged(qreal newStepSize) |
関連項目: values 、valueMapping 、およびvalueMin 。
[since 6.12] valueMapping : ValueMapping
values 内の数値の解釈方法を制御します。
values に `QPointF ` 値ではなく単純な数値が含まれている場合、このプロパティによって、各数値が点の X 成分か Y 成分かを決定します。
この列挙型はQt 6.12で導入されました。
アクセス関数:
| QXYSeries::ValueMapping | valueMapping() const |
| void | setValueMapping(QXYSeries::ValueMapping newHint) |
通知シグナル:
| void | valueMappingChanged(QXYSeries::ValueMapping newHint) |
関連項目： values 、valueMin 、およびstepSize 。
[since 6.12] valueMin : qreal
このプロパティは、values において、単純な数値から点を生成する際に使用される X（または Y）の最小値を保持します。
valueMapping がValueMapping::Y に設定されている場合、各点のX値を生成するためにstepSize と組み合わせて使用されます。
デフォルト値は 0 です。
この列挙型は Qt 6.12 で導入されました。
アクセス関数:
| qreal | valueMin() const |
| void | setValueMin(qreal newMin) |
通知シグナル:
| void | valueMinChanged(qreal newMin) |
values 、valueMapping 、およびstepSizeも参照してください 。
[since 6.12] values : QVariantList
このプロパティには、宣言的に設定された系列の点が格納されます。
バリアントリストには、QPointF の値または数値を含めることができます。数値が指定された場合、valueMapping によって、各数値がX成分として解釈されるかY成分として解釈されるかが決まります。
この列挙型は Qt 6.12 で導入されました。
アクセス関数：
| QVariantList | values() const |
| void | setValues(QVariantList values) |
通知シグナル:
| void | valuesChanged(const QVariantList &values) |
関連項目: valueMapping 、valueMin 、およびstepSize 。
メンバ関数のドキュメント
[invokable] void QXYSeries::append(QPointF point)
座標point を持つ点をシリーズに追加します。
注：この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QXYSeries::append(const QList<QPointF> &points)
座標points を持つポイントをシリーズに追加します。
注：これは 、データポイントを1つずつ追加するよりもはるかに高速です。ポイントの追加が完了すると、pointsAdded を発行します。
注：この関数は 、メタオブジェクトシステムや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()
シリーズ内のすべてのポイントの選択を解除します。
注：以下を発行します QXYSeries::selectedPointsChanged
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
setPointSelected()も参照してください 。
[invokable] void QXYSeries::deselectPoint(qsizetype index)
指定されたindex のポイントの選択を解除します。
注：以下を発火します QXYSeries::selectedPointsChanged
注：この関数は 、メタオブジェクトシステムや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 または 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, since 6.9] void QXYSeries::pointsAdded(qsizetype start, qsizetype end)
このシグナルは、点のリストが追加されたときに発火します。新しく追加された点のインデックスは、start からend の範囲にあります。
この関数は Qt 6.9 で導入されました。
[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)
count で指定されたポイント数を、index で指定された位置から始まるシリーズから削除します。
注：この関数は 、メタオブジェクトシステムおよび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 が選択済みであることを示します。
注: 以下を発行します QXYSeries::selectedPointsChanged
注：この関数は 、メタオブジェクトシステムおよび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
注：この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
setPointSelected()も参照してください 。
© 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.
