QChartView Class

QChartView ist ein eigenständiges Widget, das Diagramme anzeigen kann. Mehr...

Header: #include <QChartView>
Inherits: QGraphicsView

Öffentliche Typen

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

Öffentliche Funktionen

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)

Reimplementierte geschützte Funktionen

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

Detaillierte Beschreibung

Eine Diagrammansicht benötigt kein QGraphicsScene Objekt, um zu funktionieren. Um ein Diagramm in einem bestehenden QGraphicsScene anzuzeigen, sollte stattdessen die Klasse QChart oder QPolarChart verwendet werden.

Siehe auch QChart und QPolarChart.

Dokumentation der Mitgliedstypen

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

Diese Aufzählung beschreibt die verschiedenen Arten von Gummibandeffekten, die auf den rechteckigen Zoombereich angewendet werden können.

KonstanteWertBeschreibung
QChartView::NoRubberBand0x0Es ist kein Zoombereich angegeben, daher ist das Zoomen nicht aktiviert.
QChartView::VerticalRubberBand0x1Das Gummiband ist horizontal an die Größe des Diagramms gebunden und kann vertikal gezogen werden, um den Zoombereich festzulegen.
QChartView::HorizontalRubberBand0x2Das Gummiband ist vertikal an die Größe des Diagramms gebunden und kann horizontal gezogen werden, um den Zoombereich festzulegen.
QChartView::RectangleRubberBand0x3Das Gummiband ist an dem Punkt fixiert, auf den geklickt wurde, und kann sowohl vertikal als auch horizontal gezogen werden.
QChartView::ClickThroughRubberBand0x80Eine Option bei den oben genannten Gummibandoptionen, die es ermöglicht, Linksklicks an Diagrammelemente weiterzugeben, wenn diese Diagrammelemente Klicks akzeptieren. Um diese Option auszuwählen, muss sie mit einem der Gummiband-Auswahlmodi verknüpft werden.

Dieses Enum wurde in Qt 6.2 eingeführt.

Der RubberBands-Typ ist ein Typedef für QFlags<RubberBand>. Er speichert eine ODER-Kombination von RubberBand-Werten.

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Diagrammansicht-Objekt mit dem übergeordneten parent.

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

Konstruiert ein Diagrammansichtsobjekt mit dem übergeordneten parent, um das Diagramm chart anzuzeigen. Die Eigentümerschaft des Diagramms wird an die Diagrammansicht übergeben.

[virtual noexcept] QChartView::~QChartView()

Löscht das Objekt Diagrammansicht und das zugehörige Diagramm.

QChart *QChartView::chart() const

Gibt den Zeiger auf das zugehörige Diagramm zurück.

Siehe auch setChart().

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

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

Wenn das Gummibandrechteck in dem durch event angegebenen Druckereignis angezeigt wird, werden die Ereignisdaten zur Aktualisierung der Gummibandgeometrie verwendet. Andernfalls wird die Standardimplementierung QGraphicsView::mouseMoveEvent() aufgerufen.

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

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

Wenn die linke Maustaste gedrückt wird und das Gummiband aktiviert ist, wird das Ereignis event akzeptiert und das Gummiband wird auf dem Bildschirm angezeigt. Dies ermöglicht dem Benutzer die Auswahl des Zoombereichs.

Wenn eine andere Maustaste gedrückt wird oder das Gummiband deaktiviert ist, wird das Ereignis an QGraphicsView::mousePressEvent() übergeben.

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

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

Wenn die linke Maustaste losgelassen wird und das Gummiband aktiviert ist, wird das Ereignis event akzeptiert und die Ansicht wird in das durch das Gummiband festgelegte Rechteck gezoomt. Wurde das Ereignis durch das Loslassen der rechten Maustaste ausgelöst, wird die Ansicht herausgezoomt.

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

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

Ändert die Größe und aktualisiert den Diagrammbereich unter Verwendung der durch event angegebenen Daten.

QChartView::RubberBands QChartView::rubberBand() const

Gibt die Gummiband-Flags zurück, die derzeit von der Diagrammansicht verwendet werden.

Siehe auch setRubberBand().

void QChartView::setChart(QChart *chart)

Setzt das aktuelle Diagramm auf chart. Der Besitz des neuen Diagramms wird an die Diagrammansicht übergeben und der Besitz des vorherigen Diagramms wird freigegeben.

Um Speicherlecks zu vermeiden, muss das vorherige Diagramm gelöscht werden.

Siehe auch chart().

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

Setzt die Gummibandflags auf rubberBand. Die ausgewählten Flags bestimmen die Art und Weise, wie der Zoom durchgeführt wird.

Hinweis: Gummiband-Zooming wird für Polardiagramme nicht unterstützt.

Siehe auch rubberBand().

© 2025 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.