VCandlestickModelMapper QML Type

ローソク足シリーズの垂直モデルマッパー。詳細...

Import Statement: import QtCharts 2.8
Since: QtCharts 2.2
In C++: QVCandlestickModelMapper

プロパティ

詳細説明

モデルマッパーは、QAbstractItemModel クラスから派生したデータモデルをチャートのデータソースとして使用することを可能にします。垂直モデルマッパーはデータモデルとCandlestickSeries の間の接続を作成するために使用され、データモデルの各カラムがローソク足アイテムを定義し、各行がローソク足アイテムのオープン、ハイ、ロー、クローズ、タイムスタンプ値にマッピングされます。

モデルとローソク足シリーズの両方のプロパティは、データを操作するために使用することができます。モデルマッパーはローソク足とデータモデルを同期させます。

モデルマッパーは、ローソク足シリーズのすべてのローソク足アイテムのサイズが等しいことを保証します。従って、ローソク足アイテムに値を追加または削除すると、ローソク足シリーズ内の全てのローソク足アイテムに同じ変更が行われます。

以下の QML の例では、3 つのローソク足アイテムを持つローソク足シリーズを作成しています(モデルには少なくとも 4 つの列があると仮定しています)。各ローソク足アイテムは、タイムスタンプ、オープン、ハイ、ロー、クローズ行で定義されたデータを含みます。項目の名前は、列の水平ヘッダーによって定義される。

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

CandlestickSeriesCandlestickSetHCandlestickModelMapperも参照

プロパティ・ドキュメンテーション

closeRow : int

シリーズ内のローソク足アイテムのクローズ値を含むモデルの行。デフォルト値は -1(無効なマッピング)。


firstSetColumn : int

最初の項目のデータ・ソースとして使用されるモデルの列。デフォルト値は-1(無効なマッピング)。


highRow : int

シリーズ内のローソク足アイテムの高値が含まれるモデルの行。デフォルト値は-1(無効なマッピング)。


lastSetColumn : int

最後の項目のデータソースとして使用されるモデルの列。デフォルト値は-1(無効なマッピング)。


lowRow : int

シリーズ内のローソク足アイテムの安値が含まれるモデルの行。デフォルト値は -1(無効なマッピング)。


model : QAbstractItemModel

マッパーが使用するQAbstractItemModel ベースのモデル。このモデルはQMLに実装され、公開されていなければなりません。

注: 使用されるモデルは、行や列の追加や削除、セルのデータの変更をサポートしていなければなりません。


openRow : int

モデルの行で、シリーズ内のローソク足アイテムのオープン値を含みます。デフォルト値は-1(無効なマッピング)。


マッパーが使用するCandlestickSeries ベースのオブジェクト。

マッパーに設定されると、シリーズ内の全てのデータは破棄されます。新しい系列が指定されると、古い系列は切り離されます(ただしデータは保持されます)。


timestampRow : int

シリーズ内のローソク足アイテムのタイムスタンプ値を含むモデルの行。デフォルト値は-1(無効なマッピング)。


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