Back to Qt.io
Contact Us Blog Download Qt

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.

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 Reihen in dieser Ansicht verwendet wird.

Siehe auch axisX.


axisYSmoothing : real

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


gridSmoothing : real

Steuert den Grad der Glättung (Antialiasing) des Diagrammgitters. Standardmäßig beträgt die Glättung 1.0.


marginBottom : real

Die Menge des leeren Raums am unteren Rand des Diagramms. Standardmäßig beträgt der Rand 20.


marginLeft : real

Die Größe des leeren Bereichs auf der linken Seite des Diagramms. Der Standardwert für den Rand ist 20.


marginRight : real

Die Menge des leeren Platzes auf der rechten Seite des Diagramms. Der Standardwert für den Rand ist 20.


marginTop : real

Die Menge des leeren Platzes am oberen Rand des Diagramms. Der Standardwert für den Rand ist 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

Bestimmt den Schwenkstil von GraphsView. Das Schwenken funktioniert durch Manipulation der Schwenkeigenschaft von 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 gerendert werden. Wird automatisch mit den Serientyp-Kindern von 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

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


shadowXOffset : real

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


shadowYOffset : real

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


theme : GraphsTheme

Das vom Diagramm verwendete Thema. Bestimmt die 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 beim Ziehen mit der Maus und bei Berührungen, 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

Legt fest, wie schnell sich der Zoomwert beim Zoomen ändert.


zoomStyle : enumeration

Legt den Zoom-Stil des GraphsView fest. Das Zoomen funktioniert über die ValueAxis Zoom-Eigenschaft. Der Standardwert ist GraphsView.ZoomStyle.None.

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

Methode Dokumentation

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 series im Graphen enthalten ist.


insertSeries(int index, AbstractSeries series)

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


removeSeries(AbstractSeries series)

Entfernt series aus dem Diagramm.


removeSeries(int index)

Entfernt die durch index angegebene Reihe aus dem Diagramm.


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