CandlestickSeries QML Type
Stellt eine Datenreihe als Kerzendiagramm dar. Mehr...
| Import Statement: | import QtCharts 2.12 |
| Since: | QtCharts 2.2 |
| In C++: | QCandlestickSeries |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- bodyOutlineVisible : bool
- bodyWidth : real
- brushFilename : string
- capsVisible : bool
- capsWidth : real
- count : int
- decreasingColor : color
- increasingColor : color
- maximumColumnWidth : real
- minimumColumnWidth : real
Signale
- candlestickSetsAdded(list<CandlestickSet> sets)
- candlestickSetsRemoved(list<CandlestickSet> sets)
- clicked(CandlestickSet set)
- doubleClicked(CandlestickSet set)
- hovered(bool status, CandlestickSet set)
- pressed(CandlestickSet set)
- released(CandlestickSet set)
Methoden
- bool append(CandlestickSet set)
- CandlestickSet at(int index)
- void clear()
- bool insert(int index, CandlestickSet set)
- bool remove(CandlestickSet set)
Ausführliche Beschreibung
Der Typ „CandlestickSeries“ dient als Container für einzelne Candlestick-Elemente. Bei Verwendung von „ BarCategoryAxis “ wird jedes Element in einer eigenen Kategorie gezeichnet. Als Alternative zu „ BarCategoryAxis “ können „ DateTimeAxis “ und „ ValueAxis “ verwendet werden. In diesem Fall wird jedes Candlestick-Element entsprechend seinem Zeitstempelwert gezeichnet.
Hinweis: Die Zeitstempel müssen innerhalb einer `CandlestickSeries` eindeutig sein. Bei Verwendung von „ BarCategoryAxis “ wird nur das erste der Kerzenelemente gezeichnet, die denselben Zeitstempel haben. Wenn das Diagramm mehrere Instanzen von „CandlestickSeries“ enthält, werden Elemente aus verschiedenen Serien, die denselben Zeitstempel haben, in derselben Kategorie gezeichnet. Bei Verwendung von „ ValueAxis “ oder „ DateTimeAxis “ überlappen sich Kerzenelemente mit demselben Zeitstempel.
Der folgende QML-Code zeigt, wie man ein einfaches Kerzendiagramm erstellt:
import QtQuick 2.5
import QtCharts 2.2
ChartView {
title: "Candlestick Series"
width: 400
height: 300
CandlestickSeries {
name: "Acme Ltd."
increasingColor: "green"
decreasingColor: "red"
CandlestickSet { timestamp: 1435708800000; open: 690; high: 694; low: 599; close: 660 }
CandlestickSet { timestamp: 1435795200000; open: 669; high: 669; low: 669; close: 669 }
CandlestickSet { timestamp: 1436140800000; open: 485; high: 623; low: 485; close: 600 }
CandlestickSet { timestamp: 1436227200000; open: 589; high: 615; low: 377; close: 569 }
CandlestickSet { timestamp: 1436313600000; open: 464; high: 464; low: 254; close: 254 }
}
}
Siehe auch CandlestickSet, BarCategoryAxis, DateTimeAxis und ValueAxis.
Dokumentation zu den Eigenschaften
axisX : AbstractAxis
Die für die Reihe verwendete x-Achse. Wenn Sie sowohl „axisX“ als auch „ axisXTop “ nicht definieren, wird für die Reihe eine Wertachse erstellt.
Siehe auch „ axisXTop “ und „ ValueAxis “.
axisXTop : AbstractAxis
Die für die Reihe verwendete x-Achse, die über der Diagrammansicht eingeblendet wird.
Hinweis: Sie können entweder „ axisX “ oder „axisXTop“ angeben, nicht beides.
Siehe auch „ axisX “.
axisY : AbstractAxis
Die für die Reihe verwendete y-Achse. Wenn Sie sowohl „axisY“ als auch „ axisYRight “ nicht definieren, wird für die Reihe eine Werteachse erstellt.
Siehe auch „ axisYRight “ und „ ValueAxis “.
axisYRight : AbstractAxis
Die für die Reihe verwendete y-Achse, die in der Diagrammansicht nach rechts ausgerichtet ist.
Hinweis: Sie können entweder „ axisY “ oder „axisYRight“ angeben, jedoch nicht beides.
Siehe auch „ axisY “.
bodyOutlineVisible : bool
Die Sichtbarkeit der Umrisse des Kerzenkörpers.
bodyWidth : real
Die relative Breite des Kerzenelements innerhalb seines eigenen Slots im Bereich von 0,0 bis 1,0. Werte außerhalb dieses Bereichs werden auf 0,0 oder 1,0 begrenzt.
brushFilename : string
Der Name der Datei, die als Pinselbild für die Serie verwendet wird.
capsVisible : bool
Die Sichtbarkeit der Kappen.
capsWidth : real
Die relative Breite der Ober- und Unterkanten innerhalb einer Kerze im Bereich von 0,0 bis 1,0. Werte außerhalb dieses Bereichs werden auf 0,0 oder 1,0 begrenzt.
count : int [read-only]
Die Anzahl der Kerzenelemente in einer Reihe.
decreasingColor : color
Die Farbe des Körpers eines fallenden Kerzenelements. Eine Kerze gilt als fallend, wenn ihr Eröffnungswert höher ist als ihr Schlusswert. Standardmäßig ist diese Eigenschaft auf die Pinsel-Farbe eingestellt, wobei der Alphakanal auf 128 gesetzt ist. Die Standardfarbe wird auch verwendet, wenn die Eigenschaft auf einen ungültigen Farbwert gesetzt ist.
increasingColor : color
Die Farbe des Körpers eines steigenden Kerzencharts. Eine Kerze gilt als steigend, wenn ihr Schlusskurs höher ist als ihr Eröffnungskurs. Standardmäßig ist diese Eigenschaft auf die Pinselfarbe gesetzt. Die Standardfarbe wird auch verwendet, wenn die Eigenschaft auf einen ungültigen Farbwert gesetzt ist.
maximumColumnWidth : real
Die maximale Breite der Kerzenelemente in Pixeln. Die Angabe eines negativen Werts bedeutet, dass keine maximale Breite festgelegt ist. Alle negativen Werte werden in -1,0 umgewandelt.
minimumColumnWidth : real
Die Mindestbreite der Kerzenelemente in Pixeln. Die Angabe eines negativen Werts bedeutet, dass keine Mindestbreite festgelegt ist. Alle negativen Werte werden in -1,0 umgewandelt.
Signal-Dokumentation
candlestickSetsAdded(list<CandlestickSet> sets)
Dieses Signal wird ausgelöst, wenn die durch „ sets “ angegebenen Kerzenelemente zur Reihe hinzugefügt werden.
Der zugehörige Signal-Handler ist onCandlestickSetsAdded.
Hinweis: Der entsprechende Handler lautet „ onCandlestickSetsAdded “.
candlestickSetsRemoved(list<CandlestickSet> sets)
Dieses Signal wird ausgelöst, wenn die durch „ sets “ angegebenen Kerzenelemente aus der Reihe entfernt werden.
Der zugehörige Signal-Handler lautet „ onCandlestickSetsRemoved “.
Hinweis: Der entsprechende Handler lautet „ onCandlestickSetsRemoved “.
clicked(CandlestickSet set)
Dieses Signal wird ausgelöst, wenn auf das durch „ set “ angegebene Kerzenelement im Chart geklickt wird.
Der zugehörige Signal-Handler lautet „ onClicked “.
Hinweis: Der zugehörige Handler lautet „ onClicked “.
doubleClicked(CandlestickSet set)
Dieses Signal wird ausgelöst, wenn auf das durch set angegebene Kerzenelement im Chart doppelgeklickt wird.
Der zugehörige Signal-Handler lautet „ onDoubleClicked “.
Hinweis: Der entsprechende Handler lautet onDoubleClicked.
hovered(bool status, CandlestickSet set)
Dieses Signal wird ausgelöst, wenn der Mauszeiger in einem Chart über das durch „ set “ angegebene Kerzenelement bewegt wird.
Wenn die Maus über das Element bewegt wird, wechselt „ status “ zu „ true “, und wenn die Maus wieder wegbewegt wird, wechselt es zu „ false “.
Der zugehörige Signal-Handler ist „ onHovered “.
Hinweis: Der entsprechende Handler ist „ onHovered “.
pressed(CandlestickSet set)
Dieses Signal wird ausgelöst, wenn der Benutzer auf das durch „ set “ angegebene Kerzenchart-Element klickt und die Maustaste gedrückt hält.
Der zugehörige Signal-Handler lautet „ onPressed “.
Hinweis: Der zugehörige Handler lautet „ onPressed “.
released(CandlestickSet set)
Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf das durch set angegebene Candlestick-Element aufhebt.
Der zugehörige Signal-Handler lautet „ onReleased “.
Hinweis: Der entsprechende Handler ist onReleased.
Methodendokumentation
bool append(CandlestickSet set)
Fügt der Reihe ein einzelnes Candlestick-Element hinzu, das durch „ set “ angegeben wird, und übernimmt dessen Eigentumsrechte. Ist das Element null oder befindet es sich bereits in der Reihe, wird es nicht angehängt.
Gibt „ true “ zurück, wenn das Hinzufügen erfolgreich war, andernfalls „ false “.
CandlestickSet at(int index)
Gibt das Candlestick-Element an der durch ` index` angegebenen Position zurück. Gibt `null` zurück, wenn der Index ungültig ist.
void clear()
Entfernt alle Kerzenelemente aus der Reihe und löscht sie endgültig.
bool insert(int index, CandlestickSet set)
Fügt das durch ` set ` angegebene Candlestick-Element an der durch ` index` angegebenen Position in die Serie ein. Übernimmt das Eigentumsrecht an dem Element. Ist das Element null oder gehört es bereits zur Serie, wird es nicht eingefügt.
Gibt „ true “ zurück, wenn das Einfügen erfolgreich war, andernfalls „ false “.
bool remove(CandlestickSet set)
Entfernt ein einzelnes Candlestick-Element, das durch ` set` angegeben wird, aus der Reihe.
Gibt „ true “ zurück, wenn der Eintrag erfolgreich gelöscht wurde, andernfalls „ false “.
© 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.