이 페이지에서

QChartView Class

QChartView는 차트를 표시할 수 있는 독립형 위젯입니다. 더 보기...

Header: #include <QChartView>
Inherits: QGraphicsView
Status: Deprecated

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것이 좋습니다.

공개 유형

(since 6.2) enum RubberBand { NoRubberBand, VerticalRubberBand, HorizontalRubberBand, RectangleRubberBand, ClickThroughRubberBand }
flags RubberBands

공개 함수

QChartView(QWidget *parent = nullptr)
QChartView(QChart *chart, QWidget *parent = nullptr)
virtual ~QChartView()
QChart *chart() const
QChartView::RubberBands rubberBand() const
void setChart(QChart *chart)
void setRubberBand(const QChartView::RubberBands &rubberBand)

재구현된 보호된 함수

virtual void mouseMoveEvent(QMouseEvent *event) override
virtual void mousePressEvent(QMouseEvent *event) override
virtual void mouseReleaseEvent(QMouseEvent *event) override
virtual void resizeEvent(QResizeEvent *event) override

상세 설명

차트 뷰는 작동하기 위해 ` QGraphicsScene ` 객체가 필요하지 않습니다. 기존 ` QGraphicsScene`에 차트를 표시하려면 대신 ` QChart ` 또는 ` QPolarChart ` 클래스를 사용해야 합니다.

QChart 및 QPolarChart도 참조하십시오 .

멤버 유형 설명서

[since 6.2] enum QChartView::RubberBand
flags QChartView::RubberBands

이 열거형은 직사각형 확대/축소 영역에 적용할 수 있는 다양한 고무줄 효과 유형을 설명합니다.

상수값설명
QChartView::NoRubberBand0x0확대/축소 영역이 지정되지 않았으므로 확대/축소 기능이 활성화되지 않습니다.
QChartView::VerticalRubberBand0x1고무줄은 차트의 가로 크기에 고정되어 있으며, 세로로 당겨서 확대/축소 영역을 지정할 수 있습니다.
QChartView::HorizontalRubberBand0x2러버 밴드는 차트의 세로 크기에 고정되어 있으며, 가로 방향으로 당겨서 확대/축소 영역을 지정할 수 있습니다.
QChartView::RectangleRubberBand0x3러버 밴드는 클릭한 지점에 고정되며, 수직 및 수평 방향으로 모두 당길 수 있습니다.
QChartView::ClickThroughRubberBand0x80위의 고무줄 선택 항목 중, 차트 항목이 클릭을 허용하는 경우 왼쪽 클릭이 해당 차트 항목으로 전달되도록 하는 옵션입니다. 이 옵션을 선택하려면 고무줄 선택 모드 중 하나와 OR 연산자를 사용하여 결합하십시오.

이 열거형은 Qt 6.2에서 도입되었습니다.

RubberBands 유형은 QFlags<RubberBand>에 대한 typedef입니다. 이 유형은 RubberBand 값들의 OR 조합을 저장합니다.

멤버 함수 설명서

[explicit] QChartView::QChartView(QWidget *parent = nullptr)

parent 를 부모로 하는 차트 뷰 객체를 생성합니다.

[explicit] QChartView::QChartView(QChart *chart, QWidget *parent = nullptr)

차트 chart 를 표시하기 위해 상위 객체 parent 를 가진 차트 뷰 객체를 생성합니다. 차트의 소유권은 차트 뷰로 전달됩니다.

[virtual noexcept] QChartView::~QChartView()

차트 뷰 객체와 관련 차트를 삭제합니다.

QChart *QChartView::chart() const

연관된 차트의 포인터를 반환합니다.

setChart()도 참조하십시오 .

[override virtual protected] void QChartView::mouseMoveEvent(QMouseEvent *event)

QGraphicsView::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.

event 에서 지정한 누름 이벤트에 러버밴드 사각형이 표시되어 있는 경우, 이벤트 데이터를 사용하여 러버밴드의 기하학적 구조를 업데이트합니다. 그렇지 않은 경우, 기본 QGraphicsView::mouseMoveEvent() 구현이 호출됩니다.

[override virtual protected] void QChartView::mousePressEvent(QMouseEvent *event)

QGraphicsView::mousePressEvent(QMouseEvent *event)를 재구현합니다.

마우스 왼쪽 버튼이 눌리고 러버밴드 기능이 활성화된 경우, event 이벤트가 수신되며 화면에 러버밴드가 표시됩니다. 이를 통해 사용자는 확대/축소 영역을 선택할 수 있습니다.

다른 마우스 버튼이 눌리거나 러버밴드가 비활성화된 경우, 이벤트는 QGraphicsView::mousePressEvent()로 전달됩니다.

[override virtual protected] void QChartView::mouseReleaseEvent(QMouseEvent *event)

QGraphicsView::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.

마우스 왼쪽 버튼을 놓았을 때 러버밴드 기능이 활성화되어 있으면, event 이벤트가 수신되며 뷰가 러버밴드로 지정된 직사각형 영역으로 확대됩니다. 마우스 오른쪽 버튼을 놓았을 때 이벤트가 발생하면 뷰가 축소됩니다.

[override virtual protected] void QChartView::resizeEvent(QResizeEvent *event)

QGraphicsView::resizeEvent(QResizeEvent *event)를 재구현합니다.

event 에서 지정한 데이터를 사용하여 차트 영역의 크기를 조정하고 업데이트합니다.

QChartView::RubberBands QChartView::rubberBand() const

차트 뷰에서 현재 사용 중인 고무줄 플래그를 반환합니다.

setRubberBand()도 참조하십시오 .

void QChartView::setChart(QChart *chart)

현재 차트를 ` chart`로 설정합니다. 새 차트의 소유권은 차트 뷰로 전달되며, 이전 차트의 소유권은 해제됩니다.

메모리 누수를 방지하려면 이전 차트를 반드시 삭제해야 합니다.

chart()도 참조하십시오 .

void QChartView::setRubberBand(const QChartView::RubberBands &rubberBand)

고무줄 플래그를 ‘ rubberBand ’로 설정합니다. 선택된 플래그에 따라 확대/축소 방식이 결정됩니다.

참고: 극좌표 차트에서는고무줄 확대/축소 기능이 지원되지 않습니다.

rubberBand()도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.