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つの数値の組を返し、最初の数値は最良適合直線の線形関数の勾配係数、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 で識別される構成プロパティを削除し、系列の設定に由来するデフォルトの外観を復元します。

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

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

[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.0QLineSeries のデフォルトはシリーズのペンのサイズ * 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)

このシグナルは、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()：選択された系列点のマーカー描画に使用される画像を返します。

デフォルト値は 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()も参照して ください。