Auf dieser Seite

GraphsView QML Type

Basistyp für alle „ Qt Graphs “-Ansichten. Mehr...

Import Statement: import QtGraphs

Eigenschaften

Methoden

Ausführliche Beschreibung

Diese Klasse fasst die Zeitreihen und Themen zusammen und zeichnet die Diagramme. 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]
        }
    }
}

Balkendiagramm mit den Werten für die Jahre 2023, 2024 und 2025

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

Dokumentation zu den Eigenschaften

axisX : AbstractAxis

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

Hinweis: Die Zuweisung derselben Achse zu mehreren „GraphsViews“ wird nicht unterstützt.

Siehe auch axisY.

axisXSmoothing : real

Steuert den Grad der Glättung (Antialiasing) der X-Achse des Diagramms. Standardmäßig beträgt die Glättung „ 1.0 “.

axisY : AbstractAxis

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

Hinweis: Die Zuweisung derselben Achse zu mehreren „GraphsViews“ wird nicht unterstützt.

Siehe auch axisX.

axisYSmoothing : real

Steuert den Grad der Glättung (Antialiasing) der Y-Achse des Diagramms. Standardmäßig beträgt der Glättungsgrad 1.0.

clipPlotArea : bool [since 6.10]

Legt fest, ob Diagrammelemente abgeschnitten werden sollen, wenn sie über den Darstellungsbereich hinausragen. Der Standardwert ist „ true “.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch „ plotArea “.

dynamicLabelMargins : bool

Diese Eigenschaft legt fest, ob die Ränder von Beschriftungen dynamisch angepasst werden.

Standardmäßig überlappen Beschriftungen, die breiter sind als der zugewiesene Rand, andere Diagrammelemente. Wenn diese Option aktiviert ist, reserviert der Renderer zusätzlichen Platz für solche Beschriftungen und positioniert die Achsen neu, um Überlappungen zu vermeiden.

gridSmoothing : real

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

marginBottom : real

Der Abstand am unteren Rand des Diagramms. Standardmäßig beträgt der Rand 20.

marginLeft : real

Der Abstand auf der linken Seite des Diagramms. Standardmäßig beträgt der Rand 20.

marginRight : real

Der Abstand am rechten Rand des Diagramms. Standardmäßig beträgt der Rand 20.

marginTop : real

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

orientation : Qt.Orientation

Legt die Ausrichtung des „ GraphsView “ fest. Wenn die Ausrichtung auf „ Qt.Horizontal “ gesetzt ist, tauschen „ axisX “ und „ axisY “ ihre Positionen, sodass „ axisX “ vertikal und „ axisY “ horizontal dargestellt wird. Diese Eigenschaft wird derzeit vom „ BarSeries “ verwendet. Der Standardwert ist „ Qt.Vertical “.

panStyle : enumeration [since 6.9]

Legt den Schwenkstil des „ GraphsView “ fest. Das Schwenken erfolgt durch die Anpassung der „pan“-Eigenschaft eines „ ValueAxis “. Der Standardwert ist „ GraphsView.PanStyle.None “.

KonstanteBeschreibung
GraphsView.PanStyle.NoneDas Schwenken ist deaktiviert.
GraphsView.PanStyle.DragDurch Ziehen mit der Maus oder per Touch-Geste wird die Ansicht verschoben.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

plotArea : rect [read-only, since 6.9]

Das Rechteck, in dem die Grafik 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 der „ GraphsView “ dargestellt werden. Wird automatisch mit den untergeordneten Elementen vom Typ „Serie“ der „ GraphsView “ gefüllt.

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

Siehe auch „ BarSeries “, „ LineSeries “ und „ ScatterSeries “.

shadowBarWidth : real

Legt die Breite des Schattens des Diagrammrasters fest. Standardmäßig ist die Schattenbreite auf „ 2.0 “ eingestellt.

shadowColor : color

Legt die Schattenfarbe des Diagrammrasters fest. Standardmäßig ist die Schattenfarbe auf „ black “ eingestellt.

shadowSmoothing : real

Steuert den Grad der Glättung (Antialiasing) der Schatten im Diagrammraster. 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-Versatz des Schattenrasters des Diagramms. Standardmäßig ist der X-Versatz des Schattenrasters auf „ 0.0 “ eingestellt.

shadowYOffset : real

Steuert den Y-Versatz des Schattenrasters des Diagramms. Standardmäßig ist der Y-Versatz des Schattenrasters auf „ 0.0 “ eingestellt.

theme : GraphsTheme

Das vom Diagramm verwendete Design. Legt die Farbgebung, Achsenlinien, Schriftarten usw. fest. Wenn kein Design festgelegt wurde, wird das Standarddesign verwendet.

zoomAreaDelegate : Component [since 6.9]

Legt das QML-Element fest, das gezeichnet wird, wenn der Benutzer eine Ziehbewegung ausführt, um einen Bereich zu vergrößern.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

zoomAreaEnabled : bool [since 6.9]

Der Zoom-Bereich wandelt das Ziehen mit der Maus oder per Touch in das Zeichnen eines Rahmens um, der durch ` zoomAreaDelegate` festgelegt wird. Beim Loslassen werden die Zoom- und Schwenk-Eigenschaften des Diagramms ` ValueAxis ` so geändert, dass die Ansicht nur noch den Bereich abdeckt, der sich mit dem gezeichneten Rahmen überschneidet.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Siehe auch zoomAreaDelegate.

zoomSensitivity : real [since 6.9]

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

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

zoomStyle : enumeration [since 6.9]

Legt den Zoomstil des „ GraphsView “ fest. Das Zoomen erfolgt durch Anpassung der Zoom-Eigenschaft „ ValueAxis “. Der Standardwert lautet „ GraphsView.ZoomStyle.None “.

KonstanteBeschreibung
GraphsView.ZoomStyle.NoneDas Zoomen ist deaktiviert.
GraphsView.ZoomStyle.CenterDas Zoomen per Pinch-Geste und mit dem Mausrad erfolgt in Richtung der Mitte der Diagrammansicht.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Methodendokumentation

void addSeries(AbstractSeries series)

Fügt einen „ series “ an „ GraphsView “ an. Ist „ series “ null, wird er nicht hinzugefügt. Gehört „ series “ bereits zum Graphen, wird er an das Ende verschoben.

bool hasSeries(AbstractSeries series)

Gibt „ true “ zurück, wenn sich „ series “ im Graphen befindet.

void insertSeries(int index, AbstractSeries series)

Fügt einen „ series “ an der durch „ index “ angegebenen Position ein. Ist „ series “ null, wird er nicht eingefügt. Gehört „ series “ bereits zum Graphen, wird er an die Position „ index “ verschoben.

void removeSeries(AbstractSeries series)

Entfernt den „ 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.