Auf dieser Seite

VCandlestickModelMapper QML Type

Vertikaler Modell-Mapper für eine Kerzenchart-Reihe. Mehr...

Import Statement: import QtCharts 2.12
Since: QtCharts 2.2
In C++: QVCandlestickModelMapper
Status: Deprecated

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

Eigenschaften

Ausführliche Beschreibung

Modell-Mapper ermöglichen die Verwendung eines aus der Klasse „ QAbstractItemModel “ abgeleiteten Datenmodells als Datenquelle für ein Diagramm. Ein vertikaler Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ CandlestickSeries “ herzustellen, sodass jede Spalte im Datenmodell ein Candlestick-Element definiert und jede Zeile den Werten für Eröffnungskurs, Höchstkurs, Tiefstkurs, Schlusskurs und Zeitstempel des Candlestick-Elements zugeordnet wird.

Zur Bearbeitung der Daten können sowohl Modell- als auch Candlestick-Reihen-Eigenschaften verwendet werden. Der Modell-Mapper sorgt dafür, dass die Candlestick-Reihe und das Datenmodell synchron bleiben.

Der Modell-Mapper stellt sicher, dass alle Kerzenelemente in der Kerzenserie die gleiche Größe haben. Daher führt das Hinzufügen oder Entfernen eines Werts aus einem Kerzenelement dazu, dass dieselbe Änderung an allen Kerzenelementen in der Kerzenserie vorgenommen wird.

Das folgende QML-Beispiel erstellt eine Kerzenchart-Reihe mit drei Kerzenelementen (vorausgesetzt, das Modell verfügt über mindestens vier Spalten). Jedes Kerzenelement enthält Daten, die durch die Zeilen „timestamp“, „open“, „high“, „low“ und „close“ definiert sind. Der Name eines Elements wird durch die horizontale Spaltenüberschrift bestimmt.

CandlestickSeries {
    VCandlestickModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        timestampRow: 1
        openRow: 2
        highRow: 3
        lowRow: 4
        closeRow: 5
        firstSetColumn: 1
        lastSetColumn: 3
    }
}

Siehe auch „ CandlestickSeries “, „ CandlestickSet “ und „ HCandlestickModelMapper “.

Dokumentation zu den Eigenschaften

closeRow : int

Die Zeile des Modells, die die Schlusskurse der Kerzenelemente in der Reihe enthält. Der Standardwert ist -1 (ungültige Zuordnung).

firstSetColumn : int

Die Spalte des Modells, die als Datenquelle für das erste Element verwendet wird. Der Standardwert ist -1 (ungültige Zuordnung).

highRow : int

Die Zeile des Modells, die die höchsten Werte der Kerzenelemente in der Reihe enthält. Der Standardwert ist -1 (ungültige Zuordnung).

lastSetColumn : int

Die Spalte des Modells, die als Datenquelle für das letzte Element verwendet wird. Der Standardwert ist -1 (ungültige Zuordnung).

lowRow : int

Die Zeile des Modells, die die Tiefstwerte der Kerzenelemente in der Reihe enthält. Der Standardwert ist -1 (ungültige Zuordnung).

model : QAbstractItemModel

Das vom Mapper verwendete, auf „ QAbstractItemModel “ basierende Modell. Das Modell muss implementiert und für QML verfügbar gemacht werden.

Hinweis: Das verwendete Modell muss das Hinzufügen und Entfernen von Zeilen oder Spalten sowie das Ändern der Zelldaten unterstützen.

openRow : int

Die Zeile des Modells, die die Eröffnungswerte der Kerzenelemente in der Reihe enthält. Der Standardwert ist -1 (ungültige Zuordnung).

series : CandlestickSeries

Das auf der CandlestickSeries basierende Objekt, das vom Mapper verwendet wird.

Alle Daten der Serie werden verworfen, wenn diese dem Mapper zugewiesen wird. Wenn eine neue Serie angegeben wird, wird die Verbindung zur alten Serie getrennt (die Daten der alten Serie bleiben jedoch erhalten).

timestampRow : int

Die Zeile des Modells, die die Zeitstempelwerte der Candlestick-Elemente in der Reihe enthält. Der Standardwert ist -1 (ungültige Zuordnung).

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