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::NoRubberBand | 0x0 | 확대/축소 영역이 지정되지 않았으므로 확대/축소 기능이 활성화되지 않습니다. |
QChartView::VerticalRubberBand | 0x1 | 고무줄은 차트의 가로 크기에 고정되어 있으며, 세로로 당겨서 확대/축소 영역을 지정할 수 있습니다. |
QChartView::HorizontalRubberBand | 0x2 | 러버 밴드는 차트의 세로 크기에 고정되어 있으며, 가로 방향으로 당겨서 확대/축소 영역을 지정할 수 있습니다. |
QChartView::RectangleRubberBand | 0x3 | 러버 밴드는 클릭한 지점에 고정되며, 수직 및 수평 방향으로 모두 당길 수 있습니다. |
QChartView::ClickThroughRubberBand | 0x80 | 위의 고무줄 선택 항목 중, 차트 항목이 클릭을 허용하는 경우 왼쪽 클릭이 해당 차트 항목으로 전달되도록 하는 옵션입니다. 이 옵션을 선택하려면 고무줄 선택 모드 중 하나와 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.