GraphsView QML Type
Basistyp für alle „ Qt Graphs “-Ansichten. Mehr...
| Import Statement: | import QtGraphs |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „GraphsView“ ist Teil der „Qt Graphs QML Types for 2D“.
Eigenschaften
- axisX : AbstractAxis
- axisXSmoothing : real
- axisY : AbstractAxis
- axisYSmoothing : real
- clipPlotArea : bool
(since 6.10) - dynamicLabelMargins : bool
- gridSmoothing : real
- marginBottom : real
- marginLeft : real
- marginRight : real
- marginTop : real
- orientation : Qt.Orientation
- panStyle : enumeration
(since 6.9) - plotArea : rect
(since 6.9) - seriesList : list
- shadowBarWidth : real
- shadowColor : color
- shadowSmoothing : real
- shadowVisible : bool
- shadowXOffset : real
- shadowYOffset : real
- theme : GraphsTheme
- zoomAreaDelegate : Component
(since 6.9) - zoomAreaEnabled : bool
(since 6.9) - zoomSensitivity : real
(since 6.9) - zoomStyle : enumeration
(since 6.9)
Methoden
- void addSeries(AbstractSeries series)
- bool hasSeries(AbstractSeries series)
- void insertSeries(int index, AbstractSeries series)
- void removeSeries(AbstractSeries series)
- void removeSeries(int index)
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 QtGraphsDanach 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 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 “.
| Konstante | Beschreibung |
|---|---|
GraphsView.PanStyle.None | Das Schwenken ist deaktiviert. |
GraphsView.PanStyle.Drag | Durch 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 “.
| Konstante | Beschreibung |
|---|---|
GraphsView.ZoomStyle.None | Das Zoomen ist deaktiviert. |
GraphsView.ZoomStyle.Center | Das 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.