Auf dieser Seite

GraphsView QML Type

Basistyp für alle Qt Graphs Ansichten. Mehr...

Import Statement: import QtGraphs

Eigenschaften

Methoden

Detaillierte Beschreibung

Diese Klasse sammelt die Serien und Themen zusammen und zeichnet die Graphen. Um diesen Typ zu verwenden, müssen Sie das Modul Qt Graphs importieren:

import QtGraphs

Danach können Sie GraphsView in Ihren qml-Dateien verwenden:

import QtQuick
import QtGraphs

GraphsView {
    anchors.fill: parent
    theme: GraphsTheme {
        colorScheme: GraphsTheme.ColorScheme.Dark
        seriesColors: ["#E0D080", "#B0A060"]
        borderColors: ["#807040", "#706030"]
        grid.mainColor: "#ccccff"
        grid.subColor: "#eeeeff"
        axisY.mainColor: "#ccccff"
        axisY.subColor: "#eeeeff"
    }
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis {
        min: 0
        max: 10
        subTickCount: 4
    }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
        BarSet {
            values: [9, 8, 6]
        }
    }
}

Siehe auch BarSeries, LineSeries, BarCategoryAxis, ValueAxis, und GraphsTheme.

Dokumentation der Eigenschaften

axisX : AbstractAxis

Die x-Achse, die für die Serie in dieser Ansicht verwendet wird.

Hinweis: Die Einstellung derselben Achse für mehrere GraphsViews wird nicht unterstützt.

Siehe auch axisY.

axisXSmoothing : real

Steuert den Grad der Glättung (Antialiasing) der X-Achse des Diagramms. Die Standardeinstellung für die Glättung ist 1.0.

axisY : AbstractAxis

Die y-Achse, die für die Serie in dieser Ansicht verwendet wird.

Hinweis: Die Einstellung derselben Achse für mehrere GraphsViews wird nicht unterstützt.

Siehe auch axisX.

axisYSmoothing : real

Steuert den Grad der Glättung (Antialiasing) der Y-Achse des Diagramms. Die Standardeinstellung für die Glättung ist 1.0.

clipPlotArea : bool [since 6.10]

Steuert, ob Diagrammelemente abgeschnitten werden sollen, wenn sie außerhalb eines Plotbereichs liegen. Der Standardwert ist true.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch plotArea.

gridSmoothing : real

Steuert den Grad der Glättung (Antialiasing) des Diagrammrasters. Die Standardeinstellung für die Glättung ist 1.0.

marginBottom : real

Die Menge an leerem Platz am unteren Rand des Diagramms. Standardmäßig beträgt der Rand 20.

marginLeft : real

Der Leerraum links vom Diagramm. Standardmäßig beträgt der Rand 20.

marginRight : real

Der Leerraum rechts vom Diagramm. Standardmäßig beträgt der Rand 20.

marginTop : real

Der Leerraum am oberen Rand des Diagramms. Standardmäßig beträgt der Rand 20.

orientation : Qt.Orientation

Bestimmt die Ausrichtung von GraphsView. Wenn die Ausrichtung Qt.Horizontal ist, tauschen axisX und axisY die Positionen, so dass axisX vertikal und axisY horizontal gerendert wird. Diese Eigenschaft wird derzeit von BarSeries verwendet. Der Standardwert ist Qt.Vertical.

panStyle : enumeration

Legt den Schwenkstil des GraphsView fest. Das Schwenken funktioniert durch Manipulation der Schwenk-Eigenschaft eines ValueAxis. Der Standardwert ist GraphsView.PanStyle.None.

KonstanteBeschreibung
GraphsView.PanStyle.NoneSchwenken ist deaktiviert.
GraphsView.PanStyle.DragDurch Ziehen mit der Maus und Berührung wird die Ansicht geschwenkt.

plotArea : rect [read-only, since 6.9]

Das Rechteck, innerhalb dessen das Diagramm gezeichnet wird. Dies ist der Bereich GraphsView abzüglich der Achsenbereiche und Ränder.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch marginTop, marginBottom, marginLeft, und marginRight.

seriesList : list [read-only]

Liste der Serien, die von GraphsView wiedergegeben werden. Wird automatisch mit den untergeordneten Elementen des Serientyps GraphsView gefüllt.

Dies ist die Standardeigenschaft, so dass untergeordnete Elemente automatisch in die Serienliste aufgenommen werden.

Siehe auch BarSeries, LineSeries, und ScatterSeries.

shadowBarWidth : real

Steuert die Schattenbreite des Diagrammrasters. Standardmäßig ist die Schattenbreite auf 2.0 eingestellt.

shadowColor : color

Steuert die Schattenfarbe des Diagrammrasters. Standardmäßig ist die Schattenfarbe auf black eingestellt.

shadowSmoothing : real

Steuert die Stärke der Schattenglättung (Antialiasing) des Diagrammrasters. Standardmäßig ist die Schattenglättung auf 4.0 eingestellt.

shadowVisible : bool

Steuert, ob der Schatten des Diagrammrasters sichtbar ist. Standardmäßig ist die Sichtbarkeit des Schattens auf false eingestellt.

shadowXOffset : real

Steuert den Schatten-X-Offset des Diagrammrasters. Standardmäßig ist der Schatten-X-Versatz auf 0.0 eingestellt.

shadowYOffset : real

Steuert den Y-Versatz des Diagrammgitters. Standardmäßig ist der Y-Versatz des Schattens auf 0.0 eingestellt.

theme : GraphsTheme

Das für das Diagramm verwendete Thema. Bestimmt Farbgebung, Achsenlinien, Schriftarten usw. Wenn kein Thema festgelegt wurde, wird das Standardthema verwendet.

zoomAreaDelegate : Component

Bestimmt das QML-Element, das gezeichnet wird, wenn der Benutzer eine Ziehbewegung ausführt, um in einen Bereich hineinzuzoomen.

zoomAreaEnabled : bool

Der Zoombereich ändert sich durch Ziehen mit der Maus und durch Berühren, um einen durch zoomAreaDelegate festgelegten Rahmen zu zeichnen. Beim Loslassen werden die Zoom- und Schwenkeigenschaften des Diagramms ValueAxis so geändert, dass die Ansicht nur den Bereich abdeckt, der von der gezeichneten Box durchschnitten wird.

Siehe auch zoomAreaDelegate.

zoomSensitivity : real

Bestimmt, wie schnell sich der Zoomwert beim Zoomen ändert.

zoomStyle : enumeration

Bestimmt den Zoom-Stil von GraphsView. Das Zoomen funktioniert über die ValueAxis Zoom-Eigenschaft. Der Standardwert ist GraphsView.ZoomStyle.None.

KonstanteBeschreibung
GraphsView.ZoomStyle.NoneDas Zoomen ist deaktiviert.
GraphsView.ZoomStyle.CenterPinch-Zoom und Mausrad zoomen in die Mitte der Diagrammansicht.

Methode Dokumentation

void addSeries(AbstractSeries series)

Fügt eine series an GraphsView an. Wenn die series null ist, wird sie nicht hinzugefügt. Wenn series bereits zum Diagramm gehört, wird es an das Ende verschoben.

bool hasSeries(AbstractSeries series)

Gibt true zurück, wenn die series im Diagramm enthalten ist.

void insertSeries(int index, AbstractSeries series)

Fügt eine series an der durch index angegebenen Position ein. Ist series gleich Null, wird es nicht eingefügt. Wenn series bereits zum Graphen gehört, wird es in index verschoben.

void removeSeries(AbstractSeries series)

Entfernt die series aus dem Diagramm.

void removeSeries(int index)

Entfernt die durch index angegebene Reihe aus dem Diagramm.

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