XYSeries QML Type (Uncreatable)
すべての x および y シリーズ型の親型です。詳細...
| Import Statement: | import QtGraphs |
| In C++: | QXYSeries |
| Inherits: | |
| Inherited By: |
注:これは生成不可能な型です。QMLではインスタンス化できません。
- 継承されたメンバーを含む、すべてのメンバーの一覧
- XYSeriesは、Qt Graphs の2D用QML型の一部です。
プロパティ
- color : color
- count : int
- draggable : bool
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
- values : list<variant>
(since 6.12)
信号
- clicked(point point)
- colorChanged(color color)
- doubleClicked(point point)
- draggableChanged()
- pointMarkerChanged()
- pointReplaced(int index)
- pointsAdded(int start, int end)
(since 6.9) - pointsReplaced()
- pressed(point point)
- released(point point)
- selectedColorChanged(color color)
- selectedPointsChanged()
方法
- void append(list<point> points)
- void append(point point)
- void append(real x, real y)
- point at(int index)
- void clear()
- void deselectAllPoints()
- void deselectPoint(int index)
- void deselectPoints(list<int> indexes)
- int find(point point)
- void insert(int index, point point)
- bool isPointSelected(int index)
- void remove(int index)
- void remove(point point)
- void remove(real x, real y)
- void removeMultiple(int index, int count)
- void replace(list<point> points)
- void replace(int index, point newPoint)
- void replace(point oldPoint, point newPoint)
- void replace(int index, real newX, real newY)
- void replace(real oldX, real oldY, real newX, real newY)
- void selectAllPoints()
- void selectPoint(int index)
- void selectPoints(list<int> indexes)
- void setPointSelected(int index, bool selected)
- bool take(point point)
- void toggleSelection(list<int> indexes)
詳細な説明
XYSeries では、データポイントは X 座標と Y 座標を定義する点型のリストとして定義されます。
プロパティのドキュメント
color : color
このシリーズのメインカラーです。LineSeries では線の色を指し、ScatterSeries では点の色のことを指します。
count : int [read-only]
系列に含まれるデータポイントの数を返します。
draggable : bool
シリーズをマウスやタッチ操作でドラッグできるかどうかを制御します。デフォルトでは、draggable はfalse に設定されています。
pointDelegate : Component
データポイントのマーカーとして使用されるカスタムQMLコンポーネントです。
このコンポーネントで利用可能な動的プロパティは以下の通りです:
| タイプ | 名前 | 説明 |
|---|---|---|
| bool | pointSelected | この値は、点が選択されている場合に true になります。 |
| 色 | pointColor | シリーズの色。この値は、GraphsTheme から取得されるか、XYSeries が色を上書きしている場合はXYSeries::color から取得されます。 |
| Color | pointBorderColor | シリーズの枠線の色。この値は、GraphsTheme から取得されます。 |
| 色 | pointSelectedColor | シリーズの選択時の色。この値は、GraphsTheme から取得されるか、XYSeries が色を上書きしている場合はXYSeries::selectedColor から取得されます。 |
| real | pointBorderWidth | シリーズの境界線の幅。この値は、GraphsTheme から取得されます。 |
| real | pointValueX | この位置におけるXYPoint::x の値。 |
| 実数 | pointValueY | この位置におけるXYPoint::y の値。 |
| int | pointIndex | ポイントのインデックス。0 からポイント総数 - 1 までの範囲です。[6.9 以降] |
これらを使用するには、定義された名前のプロパティをカスタムコンポーネントに追加してください。例:"property color pointColor" および"property real pointValueX" 。
selectedColor : color
選択したポイントの色。
selectedPoints : list<int> [read-only]
現在選択されているポイントのインデックス。
values : list<variant> [since 6.12]
このプロパティを使用すると、XYSeries の座標を宣言的に設定できます。変数リストには、座標または数値を指定できます。数値を指定した場合、valueMapping を使用して、その数値を座標の X 成分として解釈するか、Y 成分として解釈するかを指定できます。
このプロパティは Qt 6.12 で導入されました。
シグナルのドキュメント
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)
座標がx およびy の点を、この系列に追加します。
point at(int index)
index で指定された位置にある座標を返します。インデックスが無効な場合は(0, 0)を返します。
void clear()
その系列からすべての点を削除します。
void deselectAllPoints()
シリーズ内のすべてのポイントの選択を解除します。
注:以下のイベントを発火します QXYSeries::selectedPointsChanged
関連項目: setPointSelected()。
void deselectPoint(int index)
指定されたindex のポイントの選択を解除します。
注:以下を発行します QXYSeries::selectedPointsChanged
関連項目 :setPointSelected()
void deselectPoints(list<int> indexes)
indexes リスト内の複数の通過済みポイントを「選択解除済み」としてマークします。
注:以下を発行します QXYSeries::selectedPointsChanged
関連項目: setPointSelected()。
int find(point point)
point で定義された条件に一致する最初の点のインデックスを検索して返します。点が見つからない場合は-1を返します。
void insert(int index, point point)
座標point を持つ点を、index で指定された位置に系列に挿入します。インデックスが0または0未満の場合、その点は点のリストの先頭に追加されます。インデックスが系列内の点の数以上である場合、その点は点のリストの末尾に追加されます。
bool isPointSelected(int index)
指定されたindex の座標が選択された点に含まれている場合はtrueを返し、そうでない場合はfalseを返します。
注:選択された 点は、色が指定されている場合、その色で描画されます。
関連項目: selectedPoints 、setPointSelected()、およびselectedColor 。
void remove(int index)
index で指定された位置にあるポイントを、系列から削除します。
void remove(point point)
座標point を持つ点を系列から削除します。その点が存在しない場合は、何も行いません。
void remove(real x, real y)
座標x およびy を持つ点を系列から削除します。その点が存在しない場合は、何も行いません。
void removeMultiple(int index, int count)
`count ` で指定されたポイント数を、`index` で指定された位置から始まる系列から削除します。
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 で指定された位置にある点を、座標newX およびnewY を持つ点に置き換えます。
void replace(real oldX, real oldY, real newX, real newY)
座標oldX およびoldY の点を、座標newX およびnewY の点に置き換えます。元の点が存在しない場合は、何も行いません。
void selectAllPoints()
系列内のすべての点を「選択済み」としてマークします。
注:以下を出力します QXYSeries::selectedPointsChanged
関連項目: setPointSelected()。
void selectPoint(int index)
index が選択済みであることを示します。
注:以下を発行します QXYSeries::selectedPointsChanged
関連項目: setPointSelected()
void selectPoints(list<int> indexes)
indexes リスト内の複数の通過点を「選択済み」としてマークします。
注:以下を発行します QXYSeries::selectedPointsChanged
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 にある点の選択状態を、反対の状態に変更します。
注:以下を発行します QXYSeries::selectedPointsChanged
関連項目: 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.