Auf dieser Seite

CandlestickSeries QML Type

Stellt eine Datenreihe als Kerzendiagramm dar. Mehr...

Import Statement: import QtCharts 2.12
Since: QtCharts 2.2
In C++: QCandlestickSeries
Inherits:

AbstractSeries

Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Signale

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 }
    }
}

Screenshot mit einem Beispiel für eine Kerzenchart-Reihe, wobei die x-Achse Datums- und Zeitangaben darstellt


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.