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

勾配係数関数は、一次関数の勾配と切片を返す。

これらの係数は、シリーズに渡されたポイントに基づいて最小二乗法を使用して計算されます。

パラメータ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 で指定 さ れてい る 構成プ ロ パテ ィ を削除 し 、 そのシリーズの設定に由来す る デ フ ォ ル ト の外観を復元。

index の点から、 色や サイズな どの構成種別 を、 構成のカ ス タ マ イ ズに よ っ てkey で指定 さ れてい る も のを除去 し 、 その構成プ ロ パテ ィ を、 その系列のプ ロ パテ ィ で指定 さ れてい る デ フ ォ ル ト と し て表示で き る よ う に し ます。

この関数は 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 の点が選択された点の中にあれば真を、そうでなければ偽を返す。

この関数は 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 のデフォルトはシリーズのペンのサイズ * 1.5 です。QLineSeries

この関数は 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)

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

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)

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

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()も参照してください 。

[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)、つまりライトマーカーは描画されません。この関数を NULLQImage (QImage()) で呼び出すことで、デフォルト（無効）に戻すことができます。

ライト・マーカーは、この系列のデータ・ポイントを視覚化するものであり、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);

この例では、デフォルトのQLineSeries 、10点と、変更後の2点を見ることができる。変更された両ポイントは、シリーズ構成に由来する外観で、他のポイントよりも目に見えて大きくなっている。デフォルトでは、点にはラベルがありませんが、QXYSeries::PointConfiguration::LabelVisibility とQXYSeries::PointConfiguration::LabelFormat の設定値のおかげで、インデックス4の点にはラベルが付いています。インデックス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()も参照 。