Auf dieser Seite

QCandlestickSeries Class

Die Klasse „QCandlestickSeries“ stellt Daten als Kerzendiagramme dar. Mehr...

Header: #include <QCandlestickSeries>
In QML: CandlestickSeries
Inherits: QAbstractSeries
Status: Deprecated

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eigenschaften

Öffentliche Funktionen

QCandlestickSeries(QObject *parent = nullptr)
virtual ~QCandlestickSeries()
bool append(QCandlestickSet *set)
bool append(const QList<QCandlestickSet *> &sets)
bool bodyOutlineVisible() const
qreal bodyWidth() const
QBrush brush() const
bool capsVisible() const
qreal capsWidth() const
void clear()
int count() const
QColor decreasingColor() const
QColor increasingColor() const
bool insert(int index, QCandlestickSet *set)
qreal maximumColumnWidth() const
qreal minimumColumnWidth() const
QPen pen() const
bool remove(QCandlestickSet *set)
bool remove(const QList<QCandlestickSet *> &sets)
void setBodyOutlineVisible(bool bodyOutlineVisible)
void setBodyWidth(qreal bodyWidth)
void setBrush(const QBrush &brush)
void setCapsVisible(bool capsVisible)
void setCapsWidth(qreal capsWidth)
void setDecreasingColor(const QColor &decreasingColor)
void setIncreasingColor(const QColor &increasingColor)
void setMaximumColumnWidth(qreal maximumColumnWidth)
void setMinimumColumnWidth(qreal minimumColumnWidth)
void setPen(const QPen &pen)
QList<QCandlestickSet *> sets() const
bool take(QCandlestickSet *set)

Neu implementierte öffentliche Funktionen

virtual QAbstractSeries::SeriesType type() const override

Signale

void bodyOutlineVisibilityChanged()
void bodyWidthChanged()
void brushChanged()
void candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
void candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
void capsVisibilityChanged()
void capsWidthChanged()
void clicked(QCandlestickSet *set)
void countChanged()
void decreasingColorChanged()
void doubleClicked(QCandlestickSet *set)
void hovered(bool status, QCandlestickSet *set)
void increasingColorChanged()
void maximumColumnWidthChanged()
void minimumColumnWidthChanged()
void penChanged()
void pressed(QCandlestickSet *set)
void released(QCandlestickSet *set)

Detaillierte Beschreibung

Diese Klasse dient als Container für einzelne Kerzenelemente. Bei Verwendung von ` QBarCategoryAxis` wird jedes Element in seiner eigenen Kategorie gezeichnet. ` QDateTimeAxis ` und ` QValueAxis ` können als Alternativen zu ` QBarCategoryAxis` verwendet werden. In diesem Fall wird jedes Kerzenelement entsprechend seinem Zeitstempelwert gezeichnet.

Hinweis: Die Zeitstempel müssen innerhalb einer „QCandlestickSeries“ eindeutig sein. Bei Verwendung von „ QBarCategoryAxis “ wird nur das erste der Kerzenelemente mit demselben Zeitstempel gezeichnet. Wenn das Diagramm mehrere Instanzen von „QCandlestickSeries“ enthält, werden Elemente aus verschiedenen Serien mit demselben Zeitstempel in derselben Kategorie gezeichnet. Bei Verwendung von „ QValueAxis “ oder „ QDateTimeAxis “ überlappen sich Kerzenelemente mit demselben Zeitstempel.

In der Galerie „Charts with Widgets“ erfahren Sie, wie Sie ein Kerzendiagramm erstellen.

Kerzendiagramm mit täglichen Aktienkursdaten, in dem grüne Kerzen einen Kursanstieg und rote Kerzen einen Kursrückgang über einen Monat hinweg anzeigen

Siehe auch „ QCandlestickSet“ , „ QBarCategoryAxis “, „ QDateTimeAxis “ und „ QValueAxis “.

Dokumentation zu den Eigenschaften

bodyOutlineVisible : bool

Diese Eigenschaft legt die Sichtbarkeit des Umrisses des Kerzenkörpers fest.

Zugriffsfunktionen:

bool bodyOutlineVisible() const
void setBodyOutlineVisible(bool bodyOutlineVisible)

Benachrichtigungssignal:

bodyWidth : qreal

Diese Eigenschaft gibt die relative Breite des Kerzenelements innerhalb seines eigenen Slots im Bereich von 0,0 bis 1,0 an.

Werte außerhalb dieses Bereichs werden auf 0,0 oder 1,0 begrenzt.

Zugriffsfunktionen:

qreal bodyWidth() const
void setBodyWidth(qreal bodyWidth)

Benachrichtigungssignal:

brush : QBrush

Diese Eigenschaft enthält den Pinsel, der zum Ausfüllen der Kerzenelemente verwendet wird.

Zugriffsfunktionen:

QBrush brush() const
void setBrush(const QBrush &brush)

Notifier-Signal:

void brushChanged()

capsVisible : bool

Diese Eigenschaft legt die Sichtbarkeit der Großbuchstaben fest.

Zugriffsfunktionen:

bool capsVisible() const
void setCapsVisible(bool capsVisible)

Benachrichtigungssignal:

capsWidth : qreal

Diese Eigenschaft gibt die relative Breite der Ober- und Unterkanten innerhalb einer Kerze im Bereich von 0,0 bis 1,0 an.

Werte außerhalb dieses Bereichs werden auf 0,0 oder 1,0 begrenzt.

Zugriffsfunktionen:

qreal capsWidth() const
void setCapsWidth(qreal capsWidth)

Benachrichtigungssignal:

[read-only] count : int

Diese Eigenschaft gibt die Anzahl der Kerzenelemente in einer Reihe an.

Zugriffsfunktionen:

int count() const

Benachrichtigungssignal:

void countChanged()

decreasingColor : QColor

Diese Eigenschaft legt die Farbe des Körpers einer fallenden Kerze fest.

Eine Kerze gilt als fallend, wenn ihr Eröffnungswert höher ist als ihr Schlusswert. Standardmäßig ist diese Eigenschaft auf die Pinsel-Farbe gesetzt, wobei der Alphakanal auf 128 eingestellt ist. Die Standardfarbe wird auch verwendet, wenn die Eigenschaft auf einen ungültigen Farbwert gesetzt ist.

Zugriffsfunktionen:

QColor decreasingColor() const
void setDecreasingColor(const QColor &decreasingColor)

Benachrichtigungssignal:

increasingColor : QColor

Diese Eigenschaft gibt die Farbe des Körpers einer steigenden Kerze an.

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.

Zugriffsfunktionen:

QColor increasingColor() const
void setIncreasingColor(const QColor &increasingColor)

Benachrichtigungssignal:

maximumColumnWidth : qreal

Diese Eigenschaft gibt die maximale Breite der Kerzenelemente in Pixeln an. Die Angabe eines negativen Werts bedeutet, dass keine maximale Breite festgelegt ist. Alle negativen Werte werden in -1,0 umgewandelt.

Zugriffsfunktionen:

qreal maximumColumnWidth() const
void setMaximumColumnWidth(qreal maximumColumnWidth)

Benachrichtigungssignal:

minimumColumnWidth : qreal

Diese Eigenschaft gibt die Mindestbreite der Kerzenelemente in Pixeln an. Die Angabe eines negativen Werts bedeutet, dass keine Mindestbreite vorhanden ist. Alle negativen Werte werden in -1,0 umgewandelt.

Zugriffsfunktionen:

qreal minimumColumnWidth() const
void setMinimumColumnWidth(qreal minimumColumnWidth)

Benachrichtigungssignal:

pen : QPen

Diese Eigenschaft enthält den Stift, mit dem die Linien der Kerzenelemente gezeichnet werden.

Zugriffsfunktionen:

QPen pen() const
void setPen(const QPen &pen)

Benachrichtigungssignal:

void penChanged()

Dokumentation der Member-Funktionen

[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)

Erstellt eine leere „QCandlestickSeries“. Die „ parent “ ist optional.

[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()

Löscht die Reihe. Entfernt die Reihe aus dem Diagramm.

bool QCandlestickSeries::append(QCandlestickSet *set)

Fügt der Reihe ein einzelnes Kerzenelement 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 Anhängen erfolgreich war, andernfalls ` false `.

bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)

Fügt der Reihe eine Liste von Candlestick-Elementen hinzu, die durch „ sets “ angegeben werden, und übernimmt die Verantwortung dafür. Wenn eines der Elemente null ist, bereits zur Reihe gehört oder mehr als einmal in der Liste vorkommt, wird nichts angehängt. Gibt „ true “ zurück, wenn alle Elemente erfolgreich angehängt wurden, andernfalls „ false “.

[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()

Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit des Umrisses des Kerzenkörpers ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ bodyOutlineVisible “.

Siehe auch „ bodyOutlineVisible “.

[signal] void QCandlestickSeries::bodyWidthChanged()

Dieses Signal wird ausgelöst, wenn sich die Breite des Kerzenelements ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ bodyWidth “.

Siehe auch „ bodyWidth “.

[signal] void QCandlestickSeries::brushChanged()

Dieses Signal wird ausgelöst, wenn sich der „Candlestick Item Brush“ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ brush “.

Siehe auch „ brush “.

[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)

Dieses Signal wird ausgegeben, wenn die durch „ sets “ angegebenen Kerzenelemente zur Reihe hinzugefügt werden.

[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)

Dieses Signal wird ausgelöst, wenn die durch „ sets “ angegebenen Kerzenelemente aus der Reihe entfernt werden.

[signal] void QCandlestickSeries::capsVisibilityChanged()

Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit der Kerzenelement-Kappen ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ capsVisible “.

Siehe auch „ capsVisible “.

[signal] void QCandlestickSeries::capsWidthChanged()

Dieses Signal wird ausgelöst, wenn sich die Breite des Candlestick-Elements ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ capsWidth “.

Siehe auch „ capsWidth “.

void QCandlestickSeries::clear()

Entfernt alle Kerzenelemente aus der Reihe und löscht sie endgültig.

[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)

Dieses Signal wird ausgelöst, wenn auf das durch „ set “ angegebene Kerzenelement im Chart geklickt wird.

int QCandlestickSeries::count() const

Gibt die Anzahl der Kerzenelemente in der Reihe zurück.

Hinweis: Getter -Funktion für die Eigenschaft „count“.

[signal] void QCandlestickSeries::countChanged()

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Kerzenelemente in der Reihe ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ count “.

Siehe auch „ count “.

[signal] void QCandlestickSeries::decreasingColorChanged()

Dieses Signal wird ausgelöst, wenn sich die Farbe des abnehmenden Kerzenelements ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ decreasingColor “.

Siehe auch „ decreasingColor “.

[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)

Dieses Signal wird ausgelöst, wenn auf das durch „ set “ angegebene Kerzenelement im Chart doppelgeklickt wird.

[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *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 “.

[signal] void QCandlestickSeries::increasingColorChanged()

Dieses Signal wird ausgegeben, wenn sich die Farbe des Candlestick-Elements „increasing“ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ increasingColor “.

Siehe auch „ increasingColor “.

bool QCandlestickSeries::insert(int index, QCandlestickSet *set)

Fügt das durch ` set ` angegebene Kerzenchart-Element an der durch ` index` angegebenen Position in die Reihe ein. Übernimmt das Eigentum an dem Element. Ist das Element null oder gehört es bereits zur Reihe, wird es nicht eingefügt. Gibt ` true ` zurück, wenn das Einfügen erfolgreich war, andernfalls ` false `.

[signal] void QCandlestickSeries::maximumColumnWidthChanged()

Dieses Signal wird ausgegeben, wenn sich die maximale Spaltenbreite der Kerzenelemente ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ maximumColumnWidth “.

Siehe auch „ maximumColumnWidth “.

[signal] void QCandlestickSeries::minimumColumnWidthChanged()

Dieses Signal wird ausgegeben, wenn sich die minimale Spaltenbreite der Kerzenelemente ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ minimumColumnWidth “.

Siehe auch „ minimumColumnWidth “.

[signal] void QCandlestickSeries::penChanged()

Dieses Signal wird ausgelöst, wenn sich die Farbe des Kerzenstifts ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ pen “.

Siehe auch „ pen “.

[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)

Dieses Signal wird ausgelöst, wenn der Benutzer auf das durch „ set “ angegebene Kerzenelement klickt und die Maustaste gedrückt hält.

[signal] void QCandlestickSeries::released(QCandlestickSet *set)

Dieses Signal wird ausgelöst, wenn der Benutzer den Maustaste-Klick auf das durch „ set “ angegebene Kerzenchart-Element loslässt.

bool QCandlestickSeries::remove(QCandlestickSet *set)

Entfernt ein einzelnes Candlestick-Element, das durch ` set` angegeben wird, aus der Reihe. Gibt ` true ` zurück, wenn das Element erfolgreich gelöscht wurde, andernfalls ` false `.

bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)

Entfernt eine Liste von Candlestick-Elementen, die durch ` sets ` angegeben sind, aus der Reihe. Wenn eines der Elemente null ist, bereits aus der Reihe entfernt wurde oder mehr als einmal in der Liste vorkommt, wird nichts entfernt. Gibt ` true ` zurück, wenn alle Elemente erfolgreich entfernt wurden, andernfalls ` false `.

QList<QCandlestickSet *> QCandlestickSeries::sets() const

Gibt die Liste der Candlestick-Elemente in der Reihe zurück. Die Eigentumsverhältnisse der Elemente ändern sich dabei nicht.

bool QCandlestickSeries::take(QCandlestickSet *set)

Entnimmt ein einzelnes Kerzenchart-Element aus der Serie, das durch ` set` angegeben wird. Das Element wird dabei nicht gelöscht. Gibt ` true ` zurück, wenn der Entnahmevorgang erfolgreich war, andernfalls ` false `.

Hinweis: Die Serie bleibt das übergeordnete Objekt des Elements. Sie müssen das übergeordnete Objekt festlegen, um die vollständige Eigentümerschaft zu übernehmen.

[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QAbstractSeries::type “ neu.

Gibt den Typ der Reihe zurück (QAbstractSeries::SeriesTypeCandlestick).

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