- Qt 6.8
- Qt Charts
- C++ Classes
- QChartView
- Qt Charts | Commercial or GPLv3

# QChartView Class

The QChartView is a standalone widget that can display charts. More...

Header: | `#include <QChartView>`
Inherits: | QGraphicsView

- List of all members, including inherited members

## Public Types

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

## Public Functions

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

## Reimplemented Protected Functions

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

## Detailed Description

A chart view does not require a QGraphicsScene object to work. To display a chart in an existing QGraphicsScene, the QChart or QPolarChart class should be used instead.

See also QChart and QPolarChart.

## Member Type Documentation

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

This enum describes the different types of rubber band effects that can be applied to the rectangular zooming area.

Constant | Value | Description
--- | --- | ---
`QChartView::NoRubberBand` | `0x0` | No zooming area is specified, and therefore zooming is not enabled.
`QChartView::VerticalRubberBand` | `0x1` | The rubber band is locked to the size of the chart horizontally and can be pulled vertically to specify the zooming area.
`QChartView::HorizontalRubberBand` | `0x2` | The rubber band is locked to the size of the chart vertically and can be pulled horizontally to specify the zooming area.
`QChartView::RectangleRubberBand` | `0x3` | The rubber band is fixed to the point that was clicked and can be pulled both vertically and horizontally.
`QChartView::ClickThroughRubberBand` | `0x80` | An option on the above rubber band choices that allows left clicks to be passed on to chart items if those chart items accept clicks. To select this, OR it with one of the rubber band selection modes.

This enum was introduced in Qt 6.2.

The RubberBands type is a typedef for QFlags<RubberBand>. It stores an OR combination of RubberBand values.

## Member Function Documentation

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

Constructs a chart view object with the parent parent.

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

Constructs a chart view object with the parent parent to display the chart chart. The ownership of the chart is passed to the chart view.

### `[virtual noexcept]` QChartView::~QChartView()

Deletes the chart view object and the associated chart.

### QChart *QChartView::chart() const

Returns the pointer to the associated chart.

See also setChart().

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

Reimplements: QGraphicsView::mouseMoveEvent(QMouseEvent *event).

If the rubber band rectangle is displayed in the press event specified by event, the event data is used to update the rubber band geometry. Otherwise, the default QGraphicsView::mouseMoveEvent() implementation is called.

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

Reimplements: QGraphicsView::mousePressEvent(QMouseEvent *event).

If the left mouse button is pressed and the rubber band is enabled, the event event is accepted and the rubber band is displayed on the screen. This enables the user to select the zoom area.

If some other mouse button is pressed or the rubber band is disabled, the event is passed to QGraphicsView::mousePressEvent().

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

Reimplements: QGraphicsView::mouseReleaseEvent(QMouseEvent *event).

If the left mouse button is released and the rubber band is enabled, the event event is accepted and the view is zoomed into the rectangle specified by the rubber band. If releasing the right mouse button triggered the event, the view is zoomed out.

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

Reimplements: QGraphicsView::resizeEvent(QResizeEvent *event).

Resizes and updates the chart area using the data specified by event.

### QChartView::RubberBands QChartView::rubberBand() const

Returns the rubber band flags that are currently being used by the chart view.

See also setRubberBand().

### void QChartView::setChart(QChart *chart)

Sets the current chart to chart. The ownership of the new chart is passed to the chart view and the ownership of the previous chart is released.

To avoid memory leaks, the previous chart must be deleted.

See also chart().

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

Sets the rubber band flags to rubberBand. The selected flags determine the way zooming is performed.

Note: Rubber band zooming is not supported for polar charts.

See also rubberBand().