Back to Qt.io
Contact Us Blog Download Qt

ChartView QML Type

Verwaltet die grafische Darstellung der Serien, Legenden und Achsen des Diagramms. Mehr...

Import Statement: import QtCharts 2.8
Inherited By:

PolarChartView

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Der Typ ChartView zeigt verschiedene Serientypen als Diagramme an.

Dieses Beispiel zeigt, wie man ein einfaches Liniendiagramm erstellt:

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

Dokumentation der Eigenschaften

animationDuration : int

Die Dauer der Animation für das Diagramm.


animationEasingCurve : easing

Die Lockerungskurve der Animation für das Diagramm.


animationOptions : enumeration

Die im Diagramm aktivierten Animationen:

KonstanteBeschreibung
ChartView.NoAnimationDie Animation ist im Diagramm deaktiviert. Dies ist der Standardwert.
ChartView.GridAxisAnimationsDie Rasterachsenanimation ist im Diagramm aktiviert.
ChartView.SeriesAnimationsDie Serienanimation ist im Diagramm aktiviert.
ChartView.AllAnimationsAlle Animationstypen sind im Diagramm aktiviert.

axes : list<AbstractAxis>

Die Achsen des Diagramms.


backgroundColor : color

Die Farbe des Diagrammhintergrunds. Standardmäßig wird die Hintergrundfarbe durch das Diagrammthema festgelegt.

Siehe auch theme.


backgroundRoundness : real

Der Durchmesser des Abrundungskreises an den Ecken des Diagrammhintergrunds.


count : int

Die Anzahl der zum Diagramm hinzugefügten Serien.


dropShadowEnabled : bool

Ob der Schlagschatteneffekt im Hintergrund aktiviert ist.

Bei der Einstellung true ist der Hintergrundschatteneffekt aktiviert. Wenn er auf false eingestellt ist, ist er deaktiviert.


legend : Legend

Die Legende des Diagramms. In der Legende werden alle dem Diagramm hinzugefügten Serien, Tortenstücke und Balkensätze aufgelistet.


locale : locale [since QtCharts 2.0]

Das Gebietsschema, das für die Formatierung verschiedener Diagrammbeschriftungen verwendet wird.

Beschriftungen werden nur lokalisiert, wenn localizeNumbers true ist, mit Ausnahme der Beschriftungen von DateTimeAxis, die immer die mit dieser Eigenschaft eingestellte QLocale verwenden.

Die Standardeinstellung ist das Standardgebietsschema der Anwendung, wenn das Diagramm erstellt wird.

Diese Eigenschaft wurde in QtCharts 2.0 eingeführt.

Siehe auch localizeNumbers.


localizeNumbers : bool [since QtCharts 2.0]

Ob Zahlen lokalisiert werden.

Bei true werden alle generierten Zahlen, die in verschiedenen Serien- und Achsenbeschriftungen erscheinen, unter Verwendung der mit der Eigenschaft locale eingestellten QLocale lokalisiert. Wenn false, wird immer das Gebietsschema C verwendet. Die Voreinstellung ist false.

Hinweis: Diese Eigenschaft wirkt sich nicht auf die Beschriftungen von DateTimeAxis aus, die immer die mit der Eigenschaft locale eingestellte QLocale verwenden.

Diese Eigenschaft wurde in QtCharts 2.0 eingeführt.

Siehe auch locale.


margins : Margins

Die minimal zulässigen Ränder zwischen dem Rand des Diagrammrechtecks und dem Plotbereich. Die Ränder werden für das Zeichnen des Titels, der Achsen und der Legende verwendet.


plotArea : rect

Das Rechteck, innerhalb dessen das Diagramm gezeichnet wird.

Der Plotbereich schließt den durch die Ränder definierten Bereich nicht ein. Standardmäßig wird die Größe des Diagramms angepasst, wenn es sich innerhalb eines ChartView befindet. Wenn ein explizites Rechteck für den Darstellungsbereich festgelegt ist, wird dies beachtet; um zum Standardverhalten zurückzukehren, muss es auf Qt.rect(0, 0, 0, 0) gesetzt werden.

Siehe auch margins.


plotAreaColor : color

Die Farbe des Hintergrunds für den Diagrammbereich. Standardmäßig verwendet der Hintergrund des Diagrammbereichs die Hintergrundfarbe des Diagramms, die durch das Diagrammthema festgelegt ist.

Siehe auch backgroundColor und theme.


theme : enumeration

Das vom Diagramm verwendete Thema.

Ein Thema ist eine integrierte Sammlung von UI-Stil-bezogenen Einstellungen, die auf alle visuellen Elemente eines Diagramms angewendet werden, wie z. B. Farben, Stifte, Pinsel und Schriftarten von Reihen, sowie Achsen, Titel und Legende. Das Beispiel Qml Oszilloskop veranschaulicht, wie man ein Thema festlegt.

Hinweis: Wenn Sie das Thema ändern, werden alle zuvor auf die Reihe angewendeten Anpassungen überschrieben.

Die folgenden Werte werden unterstützt:

KonstanteBeschreibung
ChartView.ChartThemeLightDas helle Thema, das das Standardthema ist.
ChartView.ChartThemeBlueCeruleanDas azurblaue Thema.
ChartView.ChartThemeDarkDas dunkle Thema.
ChartView.ChartThemeBrownSandDas Thema Sandbraun.
ChartView.ChartThemeBlueNcsDas blaue Thema des natürlichen Farbsystems (NCS).
ChartView.ChartThemeHighContrastDas Thema "Hoher Kontrast".
ChartView.ChartThemeBlueIcyDas Thema Eisblau.
ChartView.ChartThemeQtDas Qt-Thema.

title : string

Der Titel wird als Überschrift am oberen Rand des Diagramms angezeigt. Diagrammtitel unterstützen die HTML-Formatierung.

Siehe auch titleColor.


titleColor : color

Die Farbe des Titeltextes.


titleFont : font

Die Titelschriftart des Diagramms.

Für weitere Informationen siehe font.


Signal Dokumentation

seriesAdded(AbstractSeries series)

Dieses Signal wird ausgegeben, wenn die Serie series zum Diagramm hinzugefügt wird.

Hinweis: Der entsprechende Handler ist onSeriesAdded.


seriesRemoved(AbstractSeries series)

Dieses Signal wird ausgegeben, wenn die Serie series aus dem Diagramm entfernt wird. Das Serienobjekt wird ungültig, wenn der Signalhandler abgeschlossen ist.

Hinweis: Der entsprechende Handler ist onSeriesRemoved.


Dokumentation der Methode

Axis axisX(AbstractSeries series)

Die x-Achse des series.

Siehe auch setAxisX().


Axis axisY(AbstractSeries series)

Die y-Achse der series.

Siehe auch setAxisY().


AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)

Fügt dem Diagramm eine Reihe vom Typ type mit dem Namen name und optional den Achsen axisX und axisY hinzu. Ein Beispiel:

// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);

Die folgenden Aufzählungswerte können als Werte von type verwendet werden:

KonstanteBeschreibung
ChartView.SeriesTypeLineEine Linienreihe.
ChartView.SeriesTypeAreaEine Flächenreihe.
ChartView.SeriesTypeBarEine Balkenreihe.
ChartView.SeriesTypeStackedBarEine gestapelte Balkenreihe.
ChartView.SeriesTypePercentBarEine prozentuale Balkenreihe.
ChartView.SeriesTypeBoxPlotEine Boxplot-Reihe.
ChartView.SeriesTypeCandlestickEine Candlestick-Reihe.
ChartView.SeriesTypePieEine Tortenreihe.
ChartView.SeriesTypeScatterEine Streuungsreihe.
ChartView.SeriesTypeSplineEine Spline-Reihe.
ChartView.SeriesTypeHorizontalBarEine horizontale Balkenreihe.
ChartView.SeriesTypeHorizontalStackedBarEine horizontale gestapelte Balkenreihe.
ChartView.SeriesTypeHorizontalPercentBarEine horizontale prozentuale Balkenreihe.

isZoomed()

Gibt true zurück, wenn eine Reihe einen gezoomten Bereich hat.


point mapToPosition(point value, AbstractSeries series)

Gibt die Position des Wertes value in der Reihe series im Diagramm zurück.


point mapToValue(point position, AbstractSeries series)

Gibt den Wert in der Reihe series zurück, der sich an der Position position im Diagramm befindet.


removeAllSeries()

Entfernt alle Serien aus dem Diagramm und löscht alle Serienobjekte dauerhaft.


removeSeries(AbstractSeries series)

Entfernt die Reihe series aus dem Diagramm und löscht das Reihenobjekt dauerhaft.


scrollDown(real pixels)

Scrollt um die in pixels angegebene Anzahl von Pixeln nach unten. Dies ist eine bequeme Methode, die sich z. B. für die Tastaturnavigation eignet.


scrollLeft(real pixels)

Scrollt um die in pixels angegebene Anzahl von Pixeln nach links. Dies ist eine bequeme Methode, die sich z. B. für die Navigation mit den Tasten eignet.


scrollRight(real pixels)

Scrollt nach rechts um die in pixels angegebene Anzahl von Pixeln. Dies ist eine bequeme Methode, die sich z. B. für die Navigation mit den Tasten eignet.


scrollUp(real pixels)

Scrollt um die in pixels angegebene Anzahl von Pixeln nach oben. Dies ist eine bequeme Methode, die sich z. B. für die Navigation mit den Tasten eignet.


AbstractSeries series(int index)

Gibt die Serie mit dem Index index im Diagramm zurück. Zusammen mit der Eigenschaft count des Diagramms ermöglicht dies das Durchlaufen der Serien eines Diagramms in einer Schleife.

Siehe auch count.


AbstractSeries series(string name)

Gibt die erste Serie im Diagramm mit dem Namen name zurück. Wenn es keine Serie mit diesem Namen gibt, wird null zurückgegeben.


setAxisX(AbstractAxis axis, AbstractSeries series)

Setzt die x-Achse von series auf axis.

Siehe auch axisX().


setAxisY(AbstractAxis axis, AbstractSeries series)

Setzt die y-Achse von series auf axis.

Siehe auch axisY().


zoom(real Faktor)

Zoomt um den benutzerdefinierten Faktor factor in das Diagramm hinein.

Ein Faktor über 1,0 zoomt in die Ansicht hinein und ein Faktor zwischen 0,0 und 1,0 zoomt aus ihr heraus.


zoomIn()

Vergrößert die Ansicht um einen Faktor von zwei.


zoomIn(rect rectangle)

Vergrößert die Ansicht bis zu einer maximalen Höhe, bei der das Rechteck rectangle noch vollständig sichtbar ist.

Hinweis: Dies wird für Polardiagramme nicht unterstützt.


zoomOut()

Zoomt um den Faktor zwei aus der Ansicht heraus.

Hinweis: Dies hat keine Auswirkung, wenn das Ergebnis einen ungültigen logarithmischen Achsenbereich enthalten würde.


zoomReset()

Setzt die Reihenbereiche auf den Stand vor dem Aufruf einer Zoom-Methode zurück.

Hinweis: Dadurch werden auch die Einstellungen für den Bildlauf und den expliziten Achsenbereich zurückgesetzt, die zwischen dem ersten Zoomvorgang und dem Aufruf dieser Methode festgelegt wurden. Wenn keine Zoom-Operation durchgeführt wurde, bewirkt diese Methode nichts.


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