Auf dieser Seite

HCandlestickModelMapper QML Type

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

Import Statement: import QtCharts 2.12
Since: QtCharts 2.2
In C++: QHCandlestickModelMapper
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 horizontaler Model Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ CandlestickSeries “ herzustellen, sodass jede Zeile im Datenmodell ein Candlestick-Element definiert und jede Spalte den Werten für Eröffnungskurs, Höchstkurs, Tiefstkurs, Schlusskurs und Zeitstempel des Candlestick-Elements zugeordnet wird.

Zur Bearbeitung der Daten können sowohl die Eigenschaften des Modells als auch die der Candlestick-Reihe 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 Candlestick-Reihe mit drei Candlestick-Elementen (vorausgesetzt, das Modell enthält mindestens vier Zeilen). Jedes Candlestick-Element enthält Daten, die durch die Spalten „timestamp“, „open“, „high“, „low“ und „close“ definiert sind. Der Name eines Elements wird durch die vertikale Kopfzeile der Zeile definiert.

CandlestickSeries {
    HCandlestickModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        timestampColumn: 1
        openColumn: 2
        highColumn: 3
        lowColumn: 4
        closeColumn: 5
        firstSetRow: 1
        lastSetRow: 3
    }
}

Siehe auch CandlestickSeries, CandlestickSet und VCandlestickModelMapper.

Dokumentation zu den Eigenschaften

closeColumn : int

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

firstSetRow : int

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

highColumn : int

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

lastSetRow : int

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

lowColumn : int

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

model : QAbstractItemModel

Das vom Mapper verwendete, auf dem „ 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 Daten in den Zellen unterstützen.

openColumn : int

Die Spalte 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 (wobei deren Daten erhalten bleiben).

timestampColumn : int

Die Spalte des Modells, die die Zeitstempelwerte der Kerzenelemente 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.