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)

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

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 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)

이 신호는 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 의 값으로 설정합니다.

기본값은 기본-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 과 2개의 포인트가 변경된 구성을 볼 수 있습니다. 변경된 두 포인트는 모두 직렬 구성에서 파생된 모양으로 다른 포인트보다 눈에 띄게 더 큽니다. 기본적으로 포인트에는 레이블이 없지만 인덱스 4의 포인트에는 QXYSeries::PointConfiguration::LabelVisibility 및 QXYSeries::PointConfiguration::LabelFormat 구성 값 덕분에 레이블이 있습니다. 인덱스 6의 포인트에는 QXYSeries::PointConfiguration::LabelFormat 구성 값 덕분에 사용자 지정 레이블인 이 포인트가 있습니다. 아래는 이러한 방식으로 생성된 차트의 예시입니다:

이 함수는 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)

selected 에서 지정한 대로 주어진 index 점을 선택 또는 선택 해제된 상태로 표시합니다.

이 함수는 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()도 참조하세요 .