QXYSeries Class

メンバ関数のドキュメント

[virtual noexcept] QXYSeries::~QXYSeries()

シリーズを削除します。QChartインスタンスに追加されたシリーズは、そのインスタンスに属しており、QChartインスタンスが削除されると、シリーズも削除されます。

void QXYSeries::append(qreal x, qreal y)

座標x およびy を持つデータポイントをシリーズに追加します。

void QXYSeries::append(const QList<QPointF> &points)

points で指定されたデータポイントのリストを、シリーズに追加します。

void QXYSeries::append(const QPointF &point)

データポイント `point ` を系列に追加します。

const QPointF &QXYSeries::at(int index) const

内部の点列のうち、index で指定された位置にあるデータポイントを返します。

[signal] void QXYSeries::bestFitLineColorChanged(const QColor &color)

このシグナルは、最良近似直線に使用される色が「color 」に変化したときに発せられます。

[since 6.2] QPair<qreal, qreal> QXYSeries::bestFitLineEquation(bool &ok) const

最良近似直線の線形関数について、最初の数値が傾き係数、2番目の数値が切片となる数値のペアを返します。

これらの係数は、系列に渡された点に基づいて、最小二乗法を用いて計算されます。

パラメータ `ok ` は、その値を `false ` に設定することで失敗を報告し、`true` に設定することで成功を報告するために使用されます。

この関数は Qt 6.2 で導入されました。

QXYSeries::bestFitLineVisible()も参照してください 。

[signal] void QXYSeries::bestFitLineVisibilityChanged(bool visible)

このシグナルは、最良近似直線の可視性が「visible 」に変化したときに発せられます。

QBrush QXYSeries::brush() const

その系列のデータポイントを塗りつぶすために使用されたブラシを返します。

setBrush()も参照してください 。

void QXYSeries::clear()

系列からすべての点を削除します。

pointsRemoved()も参照してください 。

[since 6.2] void QXYSeries::clearPointConfiguration(const int index)

index にあるポイントの設定を削除し、系列の設定に基づいたデフォルトの外観に戻します。

この関数は Qt 6.2 で導入されました。

関連項目： clearPointsConfiguration() およびsetPointConfiguration()。

[since 6.2] void QXYSeries::clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key)

index のポイントから、key で指定された設定プロパティを削除し、系列の設定に基づくデフォルトの外観に戻します。

key で指定された色やサイズなどの設定タイプを、index にあるポイントから削除し、その設定プロパティがシリーズのプロパティで指定されたデフォルト値としてレンダリングされるようにします。

この関数は Qt 6.2 で導入されました。

clearPointsConfiguration() およびsetPointConfiguration()も参照してください 。

[since 6.2] void QXYSeries::clearPointsConfiguration()

シリーズ内のすべてのポイントの設定を削除し、シリーズの設定に基づいたデフォルトの外観に戻します。

この関数は Qt 6.2 で導入されました。

setPointConfiguration()も参照してください 。

[since 6.2] void QXYSeries::clearPointsConfiguration(const QXYSeries::PointConfiguration key)

key で指定された設定プロパティをすべてのポイントから削除し、系列の設定に基づいたデフォルトの外観に戻します。

key で指定された色やサイズなどの設定タイプを、設定がカスタマイズされているすべての点から削除し、その設定プロパティがシリーズのプロパティで指定されたデフォルト値としてレンダリングされるようにします。

この関数は Qt 6.2 で導入されました。

clearPointsConfiguration() およびsetPointConfiguration()も参照してください 。

[signal] void QXYSeries::clicked(const QPointF &point)

このシグナルは、ユーザーがチャート上のpoint という点をクリックしてマウスイベントを発生させたときに発信されます。

pressed()、released()、およびdoubleClicked()も参照してください 。

[since 6.2] void QXYSeries::colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient())

渡された値のリストに基づいて、ポイントの色を設定します。sourceData からの値はソートされ、gradient にマッピングされます。

シリーズに QColorAxis が関連付けられている場合、その軸からのグラデーションが使用されます。

この関数は Qt 6.2 で導入されました。

setPointConfiguration()、pointConfiguration()、およびQColorAxisも参照してください 。

[signal] void QXYSeries::colorChanged(QColor color)

このシグナルは、線の色（ペン色）が「color 」に変更されたときに発生します。

int QXYSeries::count() const

系列に含まれるデータポイントの数を返します。

[since 6.2] void QXYSeries::deselectAllPoints()

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

この関数は Qt 6.2 で導入されました。

関連項目： setPointSelected()。

[since 6.2] void QXYSeries::deselectPoint(int index)

指定されたindex のポイントの選択を解除します。

この関数は Qt 6.2 で導入されました。

setPointSelected()も参照してください 。

[since 6.2] void QXYSeries::deselectPoints(const QList<int> &indexes)

indexes リスト内の複数の通過済みポイントを「選択解除済み」としてマークします。

この関数は Qt 6.2 で導入されました。

setPointSelected()も参照してください 。

[signal] void QXYSeries::doubleClicked(const QPointF &point)

このシグナルは、ユーザーがチャート上のデータポイントpoint をダブルクリックしたときに発信されます。point は、最初のクリックが発生したポイントです。

pressed()、released()、clicked()も参照してください 。

[signal] void QXYSeries::hovered(const QPointF &point, bool state)

このシグナルは、チャート上の点point にマウスをホバーさせたときに発生します。マウスをその点の上に移動させると、state がtrue に変わり、マウスを再びその点から離すと、false に変わります。

void QXYSeries::insert(int index, const QPointF &point)

データポイント `point ` を、`index` で指定された位置に系列に挿入します。

pointAdded()も参照してください 。

[since 6.2] bool QXYSeries::isPointSelected(int index)

指定されたindex の座標が選択された点に含まれている場合はtrueを返し、そうでない場合はfalseを返します。

この関数は Qt 6.2 で導入されました。

関連項目： selectedPoints()、setPointSelected()、およびsetSelectedColor()。

[since 6.2] const QImage &QXYSeries::lightMarker() const

シリーズの各ポイントにマーカーを描画するために使用される画像を取得します。

デフォルト値は QImage() であり、これはライトマーカーが描画されないことを意味します。

ライトマーカーは、このシリーズのデータポイントを視覚化するものであり、setPointsVisible （true）の代替機能となります。これらの機能は互いに独立して有効化できます。

QScatterSeries の要素とは異なり、ライトマーカーはQGraphicsItem によって表現されるのではなく、単に描画されるだけです（オブジェクトは作成されません）。ただし、QXYSeries のマウスイベントシグナルの挙動は同じであり、ライトマーカーをクリック、押下、またはホバーすると、その点の正確なドメイン値が取得されます。 線をクリックした場合は、依然としてその中間領域の値が取得されます。ライトマーカーは、描画およびイベントの両面において、線より上方に位置しています。

この機能は Qt 6.2 で導入されました。

QXYSeries::setLightMarker()も参照してください 。

[signal, since 6.2] void QXYSeries::lightMarkerChanged(const QImage &lightMarker)

このシグナルは、ライトマーカーの画像が「lightMarker 」に変化したときに発火します。

この関数はQt 6.2で導入されました。

QXYSeries::setLightMarker()も参照してください 。

[since 6.2] qreal QXYSeries::markerSize() const

シリーズ内のポイントをレンダリングするために使用されるマーカーのサイズを取得します。

デフォルトのサイズは、QXYSeries の具体的な型によって異なります。QScatterSeriesのデフォルトは15.0、QLineSeriesのデフォルトはシリーズのペンサイズ×1.5です。

この関数は Qt 6.2 で導入されました。

setMarkerSize() およびQScatterSeries::markerSizeも参照してください 。

[signal] void QXYSeries::markerSizeChanged(qreal size)

このシグナルは、マーカーのサイズがsize に変更されたときに発せられます。

QPen QXYSeries::pen() const

その系列のデータポイントの輪郭を描画するために使用されたペンを返します。

setPen()も参照してください 。

[signal] void QXYSeries::penChanged(const QPen &pen)

この信号は、ペンが「pen 」の状態に変わったときに発信されます。

[signal] void QXYSeries::pointAdded(int index)

このシグナルは、index で指定された位置に点が追加されたときに発生します。

append() およびinsert()も参照してください 。

[since 6.2] QHash<QXYSeries::PointConfiguration, QVariant> QXYSeries::pointConfiguration(const int index) const

index におけるポイントの設定を表すマップを返します。

ポイントの設定を使用すると、各ポイントの外観のさまざまな側面を変更できます。

この関数は Qt 6.2 で導入されました。

setPointConfiguration()も参照してください 。

[signal] void QXYSeries::pointLabelsClippingChanged(bool clipping)

このシグナルは、データポイントのラベルのクリッピングがclipping に変更されたときに発信されます。

[signal] void QXYSeries::pointLabelsColorChanged(const QColor &color)

このシグナルは、データポイントのラベルに使用される色が「color 」に変化したときに発せられます。

[signal] void QXYSeries::pointLabelsFontChanged(const QFont &font)

このシグナルは、データポイントのラベルに使用されるフォントが「font 」に変更されたときに発生します。

[signal] void QXYSeries::pointLabelsFormatChanged(const QString &format)

このシグナルは、データポイントのラベルの形式が「format 」に変更されたときに発せられます。

[signal] void QXYSeries::pointLabelsVisibilityChanged(bool visible)

このシグナルは、データポイントのラベルの可視性が「visible 」に変化したときに発火します。

[signal] void QXYSeries::pointRemoved(int index)

このシグナルは、index で指定された位置からポイントが削除されたときに発せられます。

remove()も参照してください 。

[signal] void QXYSeries::pointReplaced(int index)

このシグナルは、index で指定された位置の点が置き換えられたときに発生します。

replace()も参照してください 。

QList<QPointF> QXYSeries::points() const

シリーズに含まれるポイントを返します。

[since 6.2] QXYSeries::PointsConfigurationHash QXYSeries::pointsConfiguration() const

ポイントのインデックスをキーとし、ポイントの設定を値とするマップを返します。

この関数は Qt 6.2 で導入されました。

setPointsConfiguration()、setPointConfiguration()、およびpointConfiguration()も参照してください 。

[signal] void QXYSeries::pointsRemoved(int index, int count)

count で指定された数のポイントが、index で指定された位置から順に削除された際に、このシグナルが発生します。

removePoints() およびclear()も参照してください 。

[signal] void QXYSeries::pointsReplaced()

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

replace()も参照してください 。

[signal] void QXYSeries::pressed(const QPointF &point)

このシグナルは、ユーザーがチャート上のデータポイントpoint をクリックしてマウスボタンを押し続けたときに発生します。

clicked()、released()、およびdoubleClicked()も参照してください 。

[signal] void QXYSeries::released(const QPointF &point)

このシグナルは、ユーザーが `point` で指定されたデータポイント上でマウスのクリックを解除したときに発火します。

pressed()、clicked()、およびdoubleClicked()も参照してください 。

void QXYSeries::remove(const QPointF &point)

系列からデータポイント `point ` を削除します。

pointRemoved()も参照してください 。

void QXYSeries::remove(int index)

index で指定された位置にあるポイントをシリーズから削除します。

pointRemoved()も参照してください 。

void QXYSeries::remove(qreal x, qreal y)

座標が `x ` および `y ` の点を系列から削除します。

pointRemoved()も参照してください 。

void QXYSeries::removePoints(int index, int count)

count で指定されたポイント数を、index で指定された位置から始まるシリーズから削除します。

pointsRemoved()も参照してください 。

void QXYSeries::replace(const QList<QPointF> &points)

現在のデータポイントを、points で指定されたデータポイントに置き換えます。

pointsReplaced()も参照してください 。

void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint)

oldPoint で指定された点を、newPoint で指定された点に置き換えます。

pointReplaced()も参照してください 。

void QXYSeries::replace(int index, const QPointF &newPoint)

index で指定された位置にある点を、newPoint で指定された点に置き換えます。

pointReplaced()も参照してください 。

void QXYSeries::replace(int index, qreal newX, qreal newY)

index で指定された位置にある点を、座標がnewX およびnewY である点に置き換えます。

pointReplaced()も参照してください 。

void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

座標oldX およびoldY を持つ点を、座標newX およびnewY を持つ点に置き換えます。元の点が存在しない場合は何も行いません。

pointReplaced()も参照してください 。

[since 6.2] void QXYSeries::selectAllPoints()

系列内のすべての点を「選択済み」としてマークします。

この関数は Qt 6.2 で導入されました。

setPointSelected()も参照してください 。

[since 6.2] void QXYSeries::selectPoint(int index)

index が選択済みであることを示す。

この関数は Qt 6.2 で導入されました。

setPointSelected()も参照してください 。

[since 6.2] void QXYSeries::selectPoints(const QList<int> &indexes)

indexes リスト内の複数の通過点を「選択済み」としてマークします。

この関数は Qt 6.2 で導入されました。

setPointSelected()も参照してください 。

[signal] void QXYSeries::selectedColorChanged(const QColor &color)

このシグナルは、選択されたポイントの色が「color 」に変化したときに発せられます。

[since 6.2] const QImage &QXYSeries::selectedLightMarker() const

選択された系列のデータポイントにマーカーを描画するために使用される画像を返します。

デフォルト値は QImage() であり、通常のlightMarker() が描画されます。

通常のデータポイントよりも薄いマーカーを好むが、選択されたデータポイントを区別したい場合には、これはselectedColor と同等です。

この関数は Qt 6.2 で導入されました。

setSelectedLightMarker()、lightMarker()、selectedColor 、およびsetPointSelected()も参照してください 。

[since 6.2] QList<int> QXYSeries::selectedPoints() const

「選択済み」としてマークされたポイントのインデックスのリストを返します。選択されたポイントは、ポイントの表示設定にかかわらず表示されます。

この関数は Qt 6.2 で導入されました。

setPointSelected() およびpointsVisible()も参照してください 。

[signal] void QXYSeries::selectedPointsChanged()

このシグナルは、ポイントの選択が変更されたときに送信されます。

[virtual] void QXYSeries::setBrush(const QBrush &brush)

チャート上の点を描画するために使用するブラシを「brush 」に設定します。ブラシが定義されていない場合は、チャートテーマの設定に基づくブラシが使用されます。

brush() およびQChart::setTheme()も参照してください 。

[since 6.2] void QXYSeries::setLightMarker(const QImage &lightMarker)

lightMarker の値として、系列の各点にマーカーを描画するために使用される画像を設定します。

デフォルト値は default-QImage() （QImage::isNull() == true）であり、これはライトマーカーが描画されないことを意味します。QImage （QImage()）を null に設定してこの関数を呼び出すことで、デフォルト（無効）の状態に戻すことができます。

ライトマーカーは、この系列のデータポイントを可視化するものであり、その意味でsetPointsVisible(true) の代替手段となります。このメソッドでライトマーカーが設定された場合、setPointsVisible(true) で設定された可視ポイントは表示されません。

QScatterSeries の要素とは異なり、ライトマーカーはQGraphicsItem によって表現されるのではなく、単に描画されるだけです（オブジェクトは作成されません）。ただし、QXYSeries のマウスイベントシグナルの挙動は同じであるため、ライトマーカーをクリック、押下、またはホバーすると、その点の正確なドメイン値が取得できます。 線をクリックした場合は、依然としてその中間領域の値が取得されます。ライトマーカーは、描画およびイベントの両方の観点から、線の上方に位置しています。

この機能は Qt 6.2 で導入されました。

QXYSeries::lightMarker()も参照してください 。

[since 6.2] void QXYSeries::setMarkerSize(qreal size)

シリーズ内のポイントをレンダリングするために使用されるマーカーのsize を設定します。

デフォルトのサイズは 15.0 です。

この関数は Qt 6.2 で導入されました。

「QScatterSeries::markerSize」も参照してください 。

[virtual] void QXYSeries::setPen(const QPen &pen)

チャート上の点を描画する際に使用するペンを「pen 」に設定します。ペンが定義されていない場合は、チャートのテーマに設定されているペンが使用されます。

pen() およびQChart::setTheme()も参照してください 。

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration)

index にあるポイントの外観を、希望するconfiguration に基づいてカスタマイズできるようになります。

ポイントの設定を使用すると、各ポイントの外観に関するさまざまな側面を変更できます。

ポイントの設定は、QXYSeries::pointConfiguration をキー、QVariant を値とするハッシュマップとして表されます。例：

QLineSeries *series = new QLineSeries();
series->setName("Customized series");
series->setPointsVisible(true);

*series << QPointF(0, 6) << QPointF(2, 4) << QPointF(3, 6) << QPointF(7, 4) << QPointF(10, 5)
        << QPointF(11, 1) << QPointF(13, 3) << QPointF(17, 6) << QPointF(18, 3)
        << QPointF(20, 2);

QChart *chart = new QChart();
chart->addSeries(series);
chart->createDefaultAxes();

QHash<QXYSeries::PointConfiguration, QVariant> conf;
conf[QXYSeries::PointConfiguration::Color] = QColor(Qt::red);
conf[QXYSeries::PointConfiguration::Size] = 8;
conf[QXYSeries::PointConfiguration::LabelVisibility] = true;

series->setPointConfiguration(4, conf);

conf.remove(QXYSeries::PointConfiguration::Color);
conf[QXYSeries::PointConfiguration::LabelFormat] = "This Point";
series->setPointConfiguration(6, conf);

この例では、10個のデータ点を持つデフォルトのQLineSeriesが表示されており、そのうち2つのデータ点の設定が変更されています。設定が変更された2つのデータ点は、他のデータ点よりも明らかに大きく表示されており、その外観はシリーズの設定に基づいています。デフォルトではデータ点にラベルは付きませんが、インデックス4のデータ点には、QXYSeries::PointConfiguration::LabelVisibility およびQXYSeries::PointConfiguration::LabelFormat の設定値によりラベルが付いています。 インデックス6のデータポイントには、QXYSeries::PointConfiguration::LabelFormat という設定値のおかげで、「This Point」というカスタムラベルが付いています。以下に、この方法で作成されたチャートの例を示します：

この関数は Qt 6.2 で導入されました。

pointConfiguration()、pointsConfiguration()、およびclearPointsConfiguration()も参照してください 。

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value)

ポイントの設定の特定の側面をカスタマイズできるようにします。

この関数は Qt 6.2 で導入されました。

pointsConfiguration()も参照してください 。

[since 6.2] void QXYSeries::setPointSelected(int index, bool selected)

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

この関数は Qt 6.2 で導入されました。

isPointSelected()、setPointSelected()、およびsetSelectedColor()も参照してください 。

[since 6.2] void QXYSeries::setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant>> &pointsConfiguration)

pointsConfiguration で指定された複数のポイントの設定をカスタマイズできるようにします。

この関数は Qt 6.2 で導入されました。

pointsConfiguration()も参照してください 。

[since 6.2] void QXYSeries::setSelectedLightMarker(const QImage &selectedLightMarker)

選択した系列のデータポイントにマーカーを描画する際に使用する画像を、selectedLightMarker に設定します。

デフォルト値は QImage() であり、これは通常のlightMarker() が描画されることを意味します。

通常のデータポイントよりも薄いマーカーを好むが、選択されたデータポイントを区別したい場合、これは `selectedColor ` と同等の機能です。

この関数は Qt 6.2 で導入されました。

selectedLightMarker()、lightMarker()、selectedColor 、およびsetPointSelected()も参照してください 。

[since 6.2] void QXYSeries::sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize)

渡された値のリストに基づいて、点のサイズを設定します。sourceData からの値はソートされ、minSize からmaxSize の範囲内の点サイズにマッピングされます。

この関数は Qt 6.2 で導入されました。

setPointConfiguration() およびpointConfiguration()も参照してください 。

[since 6.2] void QXYSeries::toggleSelection(const QList<int> &indexes)

指定されたindexes にある点の選択状態を、その反対の状態に変更します。これにより

この関数は Qt 6.2 で導入されました。

setPointSelected()も参照してください 。

QXYSeries &QXYSeries::operator<<(const QList<QPointF> &points)

points で指定されたデータポイントのリストをシリーズに追加するためのストリーム演算子。

append()も参照してください 。

QXYSeries &QXYSeries::operator<<(const QPointF &point)

データポイント `point ` を系列に追加するためのストリーム演算子。

append()も参照してください 。