QAbstractSeries Class
QAbstractSeries クラスは、2D シリーズ用のすべてのQt Graphs の基底クラスです。詳細...
| ヘッダー: | #include <QAbstractSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML内: | AbstractSeries |
| 継承元: | QObject およびQQmlParserStatus |
| 継承元: | QAreaSeries、QBarSeries 、QCustomSeries 、QPieSeries 、およびQXYSeries |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QAbstractSeries は、Qt Graphs の2D 用 C++ クラスの一部です。
パブリック型
| enum class | SeriesType { Line, Bar, Scatter, Pie, Spline, …, Custom } |
プロパティ
|
パブリック関数
| virtual | ~QAbstractSeries() override |
| QAbstractAxis * | axisX() const |
| QAbstractAxis * | axisY() const |
| void | hide() |
| bool | isHoverable() const |
| bool | isHovered() const |
| bool | isSelectable() const |
| bool | isVisible() const |
| const QList<QLegendData> | legendData() const |
| QString | name() const |
| qreal | opacity() const |
| QQmlListProperty<QObject> | seriesChildren() |
| void | setAxisX(QAbstractAxis *newAxisX) |
| void | setAxisY(QAbstractAxis *newAxisY) |
| void | setHoverable(bool newHoverable) |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setSelectable(bool selectable) |
| void | setValuesMultiplier(qreal valuesMultiplier) |
| void | setVisible(bool visible = true) |
| void | setZValue(int newDrawOrder) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| qreal | valuesMultiplier() const |
| int | zValue() const |
シグナル
| void | axisXChanged(QAbstractAxis *newAxis) |
| void | axisYChanged(QAbstractAxis *newAxis) |
| void | hover(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverEnter(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverExit(const QString &seriesName, QPointF position) |
| void | hoverableChanged() |
| void | hoveredChanged(bool hovered) |
| void | legendDataChanged() |
| void | nameChanged() |
| void | opacityChanged() |
| void | selectableChanged() |
| void | valuesMultiplierChanged() |
| void | visibleChanged() |
| void | zValueChanged(int z) |
関連項目： QLineSeries 、QSplineSeries 、QScatterSeries 、QBarSeries 、およびQXYSeries 。
メンバ型のドキュメント
enum class QAbstractSeries::SeriesType
この列挙型は、シリーズのタイプを表します。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | 折れ線グラフ。 |
QAbstractSeries::SeriesType::Bar | 2 | 棒グラフ。 |
QAbstractSeries::SeriesType::Scatter | 4 | 散布図。 |
QAbstractSeries::SeriesType::Pie | 3 | 円グラフ。 |
QAbstractSeries::SeriesType::Spline | 5 | スプライングラフ。 |
QAbstractSeries::SeriesType::Area | 1 | 面積グラフ。 |
QAbstractSeries::SeriesType::Custom | 6 | カスタムグラフ。 |
プロパティのドキュメント
[since 6.10] axisX : QAbstractAxis*
この系列のX軸。
この系列に使用される x 軸。GraphsView で定義された軸とは別の軸を作成し、グラフごとに複数の軸をユーザーに表示します。
この列挙型は Qt 6.10 で導入されました。
アクセス関数：
| QAbstractAxis * | axisX() const |
| void | setAxisX(QAbstractAxis *newAxisX) |
Notifierシグナル:
| void | axisXChanged(QAbstractAxis *newAxis) |
[since 6.10] axisY : QAbstractAxis*
この系列のY軸。
この系列に使用されるY軸です。GraphsView で定義された軸とは別の軸を作成し、グラフごとに複数の軸をユーザーに表示します。
この列挙型は Qt 6.10 で導入されました。
アクセス関数：
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Notifierシグナル：
| void | axisYChanged(QAbstractAxis *newAxis) |
hoverable : bool
シリーズにマウス/タッチでホバーできるかどうかを制御します。
シリーズにマウスやタッチでホバーできるかどうかを制御します。デフォルトでは、hoverable はfalse に設定されています。
アクセス関数:
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
通知シグナル:
| void | hoverableChanged() |
[read-only] hovered : bool
シリーズにマウスがホバーしているかどうかを確認します。
マウスやタッチが現在シリーズ上にホバーしているかどうかを確認するために使用できます。
アクセス関数：
| bool | isHovered() const |
Notifierシグナル:
| void | hoveredChanged(bool hovered) |
QAbstractSeries ::hoveredも参照してください 。
[read-only] legendData : QList<QLegendData>
グラフ内のデータセットの凡例マーカーを作成するために必要な情報が含まれています。
アクセス関数：
| const QList<QLegendData> | legendData() const |
通知信号：
| void | legendDataChanged() |
関連項目： QLegendData 。
name : QString
このプロパティには、シリーズの名前が格納されます。
この名前は、その系列の凡例に表示され、HTML 書式設定に対応しています。
アクセス関数：
| QString | name() const |
| void | setName(const QString &name) |
通知信号:
| void | nameChanged() |
opacity : qreal
このプロパティは、シリーズの不透明度を指定します。
デフォルトでは、不透明度は 1.0 です。有効な値の範囲は 0.0（透明）から 1.0（不透明）までです。
アクセス関数：
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
通知シグナル：
| void | opacityChanged() |
selectable : bool
このシリーズが選択可能かどうかを制御します。
そのシリーズがマウスやタッチ操作で選択可能かどうかを制御します。デフォルトでは、selectable はfalse に設定されています。
アクセス関数：
| bool | isSelectable() const |
| void | setSelectable(bool selectable) |
通知シグナル：
| void | selectableChanged() |
[read-only] seriesChildren : const QQmlListProperty<QObject>
シリーズの子オブジェクトの一覧。これは、QMLのseries要素内で、childrenというプロパティ名を明示的に使用することなく、子オブジェクトを指定できるようにするデフォルトのプロパティです。
アクセス関数：
| QQmlListProperty<QObject> | seriesChildren() |
[read-only] type : const SeriesType
このプロパティは、系列の型を保持します。
アクセス関数：
| virtual QAbstractSeries::SeriesType | type() const = 0 |
valuesMultiplier : qreal
シリーズの値の表示サイズを制御します。
この変数を使用すると、系列の値を0から実際の値のサイズまでスケーリングするようにアニメーション化できます。デフォルトでは、valuesMultiplierは1.0です。有効な値の範囲は0.0（高さ0）から1.0（フル値）までです。
アクセス関数：
| qreal | valuesMultiplier() const |
| void | setValuesMultiplier(qreal valuesMultiplier) |
通知シグナル：
| void | valuesMultiplierChanged() |
visible : bool
シリーズの可視性。
この系列に使用される可視性。デフォルトでは、visible はtrue に設定されています。
アクセス関数：
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
通知シグナル：
| void | visibleChanged() |
[since 6.10] zValue : int
系列の描画順序を制御します
GraphsView のシリーズ一覧は、zValue プロパティによってソートされます。各シリーズタイプは一度にレンダリングされるため、この順序は主に各シリーズタイプ内の内部順序として機能します。各シリーズタイプ内で最も高い zValue が、シリーズタイプ間のレンダリング順序を決定します。デフォルト値は 0 です。
この列挙型は Qt 6.10 で導入されました。
アクセス関数：
| int | zValue() const |
| void | setZValue(int newDrawOrder) |
通知シグナル:
| void | zValueChanged(int z) |
メンバ関数のドキュメント
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
グラフ系列の仮想デストラクタ。
void QAbstractSeries::hide()
シリーズの表示状態を「false 」に設定します。
setVisible() およびisVisible()も参照してください 。
[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)
このシグナルは、シリーズのホバー状態が変化したときに発火します。シリーズ名は `seriesName` に、マウス／タッチの位置は `position` に、シリーズの値は `value` に格納されています。
注：この シグナルは、hoverable がtrueに設定されている場合にのみ発火します。
注： 円グラフの場合 、この値は（位置の角度、ホバー中のセグメントの開始角度）を表します。
[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)
このシグナルは、シリーズのホバーが始まったときに発火します。シリーズ名は `seriesName` に、マウス／タッチの位置は `position` に、シリーズの値は `value` に格納されています。
注：この シグナルは、hoverable がtrueに設定されている場合にのみ発火します。
注： 円グラフの場合 、この値は（位置の角度、ホバー中のスライスの開始角度）を表します。
[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)
このシグナルは、シリーズのホバー状態が終了したときに発火します。シリーズ名は `seriesName` に、マウス／タッチの位置は `position` に格納されています。
注：この シグナルは、hoverable がtrueに設定されている場合にのみ発火します。
void QAbstractSeries::show()
シリーズの表示状態を「true 」に設定します。
setVisible() およびisVisible()も参照してください 。
© 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.
