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 로 식별되는 구성 속성을 제거하고, 시리즈 설정에서 파생된 기본 모양을 복원합니다.

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)

index 에 지정된 위치에 데이터 포인트 point 를 시계에 삽입합니다. .

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). 이는 밝은 마커가 그려지지 않음을 의미합니다. null 값의 QImage (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);

이 예제에서는 10개의 점을 가진 기본 QLineSeries와, 두 점의 구성이 변경된 모습을 볼 수 있습니다. 변경된 두 점은 다른 점들보다 눈에 띄게 크며, 시리즈 구성에서 파생된 모양을 가지고 있습니다. 기본적으로 점에는 레이블이 없지만, 인덱스 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()도 참조하십시오 .