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.

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:
| void | bodyOutlineVisibilityChanged() |
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:
| void | bodyWidthChanged() |
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:
| void | capsVisibilityChanged() |
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:
| void | capsWidthChanged() |
[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:
| void | decreasingColorChanged() |
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:
| void | increasingColorChanged() |
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:
| void | maximumColumnWidthChanged() |
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:
| void | minimumColumnWidthChanged() |
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.