Back to Qt.io
Contact Us Blog Download Qt

QCandlestickSeries Class

Die Klasse QCandlestickSeries stellt Daten als Candlesticks dar. Mehr...

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

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)

Reimplementierte ö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 Candlestick-Elemente. Bei der Verwendung von QBarCategoryAxis wird jedes Element in seine eigene Kategorie gezeichnet. QDateTimeAxis und QValueAxis können als Alternative zu QBarCategoryAxis verwendet werden. In diesem Fall wird jedes Candlestick-Element entsprechend seinem Zeitstempelwert gezeichnet.

Hinweis: Die Zeitstempel müssen innerhalb einer QCandlestickSeries eindeutig sein. Bei Verwendung von QBarCategoryAxis wird nur das erste Candlestick-Element gezeichnet, das einen Zeitstempel hat. Wenn das Diagramm mehrere Instanzen von QCandlestickSeries enthält, werden Elemente aus verschiedenen Serien, die einen Zeitstempel gemeinsam haben, in dieselbe Kategorie gezeichnet. Bei Verwendung von QValueAxis oder QDateTimeAxis überlappen sich Candlestick-Elemente, die einen gemeinsamen Zeitstempel haben.

In der Galerie Diagramme mit Widgets erfahren Sie, wie Sie ein Candlestick-Diagramm erstellen können.

Siehe auch QCandlestickSet, QBarCategoryAxis, QDateTimeAxis, und QValueAxis.

Dokumentation der Eigenschaft

bodyOutlineVisible : bool

Diese Eigenschaft bestimmt die Sichtbarkeit des Umrisses des Leuchters.

Zugriffsfunktionen:

bool bodyOutlineVisible() const
void setBodyOutlineVisible(bool bodyOutlineVisible)

Melder-Signal:

void bodyOutlineVisibilityChanged()

bodyWidth : qreal

Diese Eigenschaft gibt die relative Breite des Candlestick-Elements 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 geklemmt.

Zugriffsfunktionen:

qreal bodyWidth() const
void setBodyWidth(qreal bodyWidth)

Melder-Signal:

void bodyWidthChanged()

brush : QBrush

Diese Eigenschaft enthält den Pinsel, der zum Füllen der Candlestick-Elemente verwendet wird.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void brushChanged()

capsVisible : bool

Diese Eigenschaft bestimmt die Sichtbarkeit der Kappen.

Zugriffsfunktionen:

bool capsVisible() const
void setCapsVisible(bool capsVisible)

Melder-Signal:

void capsVisibilityChanged()

capsWidth : qreal

Diese Eigenschaft gibt die relative Breite der Caps innerhalb eines Candlesticks im Bereich von 0,0 bis 1,0 an.

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

Zugriffsfunktionen:

qreal capsWidth() const
void setCapsWidth(qreal capsWidth)

Melder-Signal:

void capsWidthChanged()

[read-only] count : const int

Diese Eigenschaft enthält die Anzahl der Candlestick-Elemente in einer Serie.

Zugriffsfunktionen:

int count() const

Benachrichtigungssignal:

void countChanged()

decreasingColor : QColor

Diese Eigenschaft enthält die Farbe des Körpers des abnehmenden Kerzenleuchters.

Ein Candlestick ist abnehmend, wenn sein Eröffnungswert höher ist als der Schlusswert. Standardmäßig ist diese Eigenschaft auf die Pinselfarbe eingestellt, wobei der Alphakanal auf 128 gesetzt ist. Die Standardfarbe wird auch verwendet, wenn die Eigenschaft auf einen ungültigen Farbwert eingestellt ist.

Zugriffsfunktionen:

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

Melder-Signal:

void decreasingColorChanged()

increasingColor : QColor

Diese Eigenschaft enthält die Farbe des Körpers des steigenden Candlesticks.

Ein Candlestick ist steigend, wenn sein Schlusswert höher ist als der Eröffnungswert. Standardmäßig ist diese Eigenschaft auf die Pinselfarbe eingestellt. Die Standardfarbe wird auch verwendet, wenn die Eigenschaft auf einen ungültigen Farbwert eingestellt ist.

Zugriffsfunktionen:

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

Melder-Signal:

void increasingColorChanged()

maximumColumnWidth : qreal

Diese Eigenschaft gibt die maximale Breite der Candlestick-Elemente in Pixeln an. Ein negativer Wert bedeutet, dass es keine maximale Breite gibt. 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 Candlestick-Elemente in Pixeln an. Die Angabe eines negativen Wertes bedeutet, dass es keine Mindestbreite gibt. 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 Candlestick-Elemente gezeichnet werden.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void penChanged()

Member Function Dokumentation

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

Konstruiert eine leere QCandlestickSeries. Die Angabe parent ist optional.

[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()

Zerstört die Serie. Entfernt die Serie aus dem Diagramm.

bool QCandlestickSeries::append(QCandlestickSet *set)

Fügt ein einzelnes, durch set angegebenes Candlestick-Element zur Serie hinzu und übernimmt es. Wenn das Element null ist oder sich bereits in der Serie befindet, wird es nicht angefügt. Gibt true zurück, wenn das Anhängen erfolgreich war, andernfalls false.

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

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

[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()

Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit des Umrisses des Candlestick-Elements ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft bodyOutlineVisible.

Siehe auch bodyOutlineVisible.

[signal] void QCandlestickSeries::bodyWidthChanged()

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

Hinweis: Benachrichtigungssignal für die Eigenschaft bodyWidth.

Siehe auch bodyWidth.

[signal] void QCandlestickSeries::brushChanged()

Dieses Signal wird ausgegeben, wenn sich der Candlestick-Elementpinsel ändert.

Hinweis: Benachrichtigungssignal 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 Candlestick-Elemente zur Serie hinzugefügt werden.

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

Dieses Signal wird ausgegeben, wenn die durch sets angegebenen Candlestick-Elemente aus der Serie entfernt werden.

[signal] void QCandlestickSeries::capsVisibilityChanged()

Dieses Signal wird ausgesendet, wenn sich die Sichtbarkeit der Candlestick-Elementkappen ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft capsVisible.

Siehe auch capsVisible.

[signal] void QCandlestickSeries::capsWidthChanged()

Dieses Signal wird ausgegeben, wenn sich die Kappenbreite des Candlestick-Elements ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft capsWidth.

Siehe auch capsWidth.

void QCandlestickSeries::clear()

Entfernt alle Candlestick-Elemente aus der Serie und löscht sie dauerhaft.

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

Dieses Signal wird ausgegeben, wenn das durch set angegebene Candlestick-Element im Diagramm angeklickt wird.

int QCandlestickSeries::count() const

Gibt die Anzahl der Candlestick-Elemente in der Serie zurück.

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

[signal] void QCandlestickSeries::countChanged()

Dieses Signal wird ausgelöst, wenn sich die Anzahl der Candlestick-Elemente in der Serie ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft count.

Siehe auch count.

[signal] void QCandlestickSeries::decreasingColorChanged()

Dieses Signal wird ausgegeben, wenn sich die Farbe des Candlestick-Elements mit abnehmender Tendenz ändert.

Hinweis: Meldesignal für die Eigenschaft decreasingColor.

Siehe auch decreasingColor.

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

Dieses Signal wird ausgegeben, wenn das durch set angegebene Candlestick-Element im Diagramm doppelt angeklickt wird.

[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)

Dieses Signal wird ausgegeben, wenn der Mauszeiger in einem Diagramm über das durch set angegebene Candlestick-Element bewegt wird.

Wenn die Maus über das Element bewegt wird, wird status zu true, und wenn die Maus wieder wegbewegt wird, wird sie zu false.

[signal] void QCandlestickSeries::increasingColorChanged()

Dieses Signal wird ausgegeben, wenn sich die Farbe des Candlestick-Elements erhöht.

Hinweis: Meldesignal für die Eigenschaft increasingColor.

Siehe auch increasingColor.

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

Fügt das durch set angegebene Candlestick-Element an der durch index angegebenen Position in die Serie ein. Das Element wird in Besitz genommen. Wenn das Element null ist oder bereits zur Serie gehört, wird es nicht eingefügt. Gibt true zurück, wenn das Einfügen erfolgreich war, andernfalls false.

[signal] void QCandlestickSeries::maximumColumnWidthChanged()

Dieses Signal wird bei einer Änderung der maximalen Spaltenbreite von Candlestick-Elementen ausgegeben.

Hinweis: Benachrichtigungssignal für die Eigenschaft maximumColumnWidth.

Siehe auch maximumColumnWidth.

[signal] void QCandlestickSeries::minimumColumnWidthChanged()

Dieses Signal wird ausgegeben, wenn sich die minimale Spaltenbreite von Candlestick-Elementen ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft minimumColumnWidth.

Siehe auch minimumColumnWidth.

[signal] void QCandlestickSeries::penChanged()

Dieses Signal wird ausgegeben, wenn sich der Stift des Candlesticks ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft pen.

Siehe auch pen.

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

Dieses Signal wird ausgegeben, wenn der Benutzer auf das durch set angegebene Candlestick-Element klickt und die Maustaste gedrückt hält.

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

Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem durch set angegebenen Candlestick-Element loslässt.

bool QCandlestickSeries::remove(QCandlestickSet *set)

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

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

Entfernt eine durch sets angegebene Liste von Candlestick-Elementen aus der Serie. Wenn eines der Elemente null ist, bereits aus der Serie entfernt wurde oder mehr als einmal in der Liste erscheint, 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 Serie zurück. Die Eigentümerschaft der Elemente ändert sich nicht.

bool QCandlestickSeries::take(QCandlestickSet *set)

Entnimmt ein einzelnes Candlestick-Element, angegeben durch set, aus der Serie. Das Element wird 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 den vollen Besitz zu übernehmen.

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

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QAbstractSeries::type.

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

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