このページでは

XYSeries QML Type

すべてのxおよびy系列型の親型。詳細...

Import Statement: import QtGraphs
In C++: QXYSeries
Inherits:

AbstractSeries

Inherited By:

LineSeries, ScatterSeries, and SplineSeries

プロパティ

信号

方法

詳細説明

XYSeriesでは、データポイントはXとYの位置を定義するポイントタイプのリストとして定義されます。

プロパティの説明

color : color

シリーズのメインカラー。LineSeries の場合は線の色、ScatterSeries の場合は点の色。

count : int [read-only]

データ点数関数は、系列のデータ点数を返します。

draggable : bool

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

pointDelegate : Component

データポイントのマーカーとして使用されるカスタムQMLコンポーネント。

このコンポーネントで利用可能な動的プロパティは以下の通りです:

タイプ名前説明
ブールポイント選択この値は、ポイントが選択されているときに真になります。
点の色シリーズの色。この値はGraphsTheme から、またはXYSeries が色を上書きする場合はXYSeries::color から取得します。
点境界色系列の境界色。この値はGraphsTheme に由来する。
選択色シリーズの選択色。この値はGraphsTheme から、またはXYSeries が色を上書きする場合はXYSeries::selectedColor から取得します。
実数pointBorderWidth系列の境界幅。この値はGraphsTheme から得られる。
実数pointValueXこの位置でのXYPoint::x の値。
実数pointValueYこの位置のXYPoint::y の値。
intpointIndexポイントのインデックス。0からポイント数-1まで。 [6.9以降]。

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

selectedColor : color

選択されたポイントの色。

selectedPoints : list<int> [read-only]

現在選択されているポイントのインデックス。

信号ドキュメント

clicked(point point)

このシグナルは、ユーザーがグラフ内のpoint をクリックまたはタップしたときに発せられる。

注: 対応するハンドラはonClicked です。

colorChanged(color color)

このシグナルは、線の色がcolor に変わったときに発せられる。

注: 対応するハンドラはonColorChanged

doubleClicked(point point)

このシグナルは、ユーザーがグラフ内のデータpoint をダブルクリックまたはダブルタップしたときに発せられる。point は最初の押下がトリガーされたポイントである。このシグナルは常にclicked の後に発生します。

注: 対応するハンドラはonDoubleClicked

draggableChanged()

このシグナルは、シリーズがマウス/タッチでドラッグ可能になったり、固定されたりしたときに発せられる。

注: 対応するハンドラはonDraggableChanged です。

pointMarkerChanged()

このシグナルはポイントが変更されたときに発せられる。

注: 対応するハンドラはonPointMarkerChanged です。

pointReplaced(int index)

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

注: 対応するハンドラはonPointReplaced

[since 6.9] pointsAdded(int start, int end)

このシグナルは、点のリストが追加されたときに発せられる。新しく追加された点のインデックスはstart からend の間である。

注: 対応するハンドラはonPointsAdded です。

このシグナルは Qt 6.9 で導入されました。

pointsReplaced()

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

注: 対応するハンドラはonPointsReplaced です。

pressed(point point)

このシグナルは、ユーザーがグラフ内のデータpoint を押し、マウスボタンまたはジェスチャーを押し続けたときに発せられます。

注: 対応するハンドラはonPressed です。

released(point point)

このシグナルは、ユーザーがそれまで押していたマウスボタンやジェスチャーをデータpoint 上で離したときに発せられる。

注: 対応するハンドラはonReleased です。

selectedColorChanged(color color)

このシグナルは、選択されたシリーズの色がcolor に変わったときに発せられる。

注: 対応するハンドラはonSelectedColorChanged

selectedPointsChanged()

このシグナルは、選択された点のセットが変更されたときに発せられる。

注意: 対応するハンドラはonSelectedPointsChanged です。

メソッドのドキュメント

void append(list<point> points)

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

注意: これはデータポイントを1つずつ追加するよりもはるかに高速です。ポイントが追加されると、pointsAdded

void append(point point)

座標point を持つ点を系列に追加する。

void append(real x, real y)

座標xy を持つ点を系列に追加する。

point at(int index)

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

void clear()

シリーズからすべてのポイントを削除する。

void deselectAllPoints()

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

setPointSelected()も参照

void deselectPoint(int index)

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

setPointSelected()も参照

void deselectPoints(list<int> indexes)

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

setPointSelected()も参照のこと

int find(point point)

point で定義されているように、最初に見つかった一致点のインデックスを検索して返します。点が見つからなければ -1 を返す。

void insert(int index, point point)

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

bool isPointSelected(int index)

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

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

selectedPointssetPointSelected()、selectedColorも参照してください

void remove(int index)

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

void remove(point point)

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

void remove(real x, real y)

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

void removeMultiple(int index, int count)

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

void replace(list<point> points)

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

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

void replace(int index, point newPoint)

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

void replace(point oldPoint, point newPoint)

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

void replace(int index, real newX, real newY)

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

void replace(real oldX, real oldY, real newX, real newY)

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

void selectAllPoints()

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

setPointSelected()も参照

void selectPoint(int index)

index 、選択された点をマークする。

setPointSelected()も参照のこと

void selectPoints(list<int> indexes)

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

setPointSelected()も参照のこと

void setPointSelected(int index, bool selected)

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

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

isPointSelected(),selectAllPoints(),selectedColorも参照

bool take(point point)

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

void toggleSelection(list<int> indexes)

指定されたindexes の点の選択状態を反対の状態に変更する。

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.