このページでは

HCandlestickModelMapper QML Type

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

Import Statement: import QtCharts 2.11
Since: QtCharts 2.2
In C++: QHCandlestickModelMapper

プロパティ

詳細説明

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

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

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

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

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

CandlestickSeriesCandlestickSetVCandlestickModelMapperも参照

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

closeColumn : int

シリーズ内のローソク足アイテムの終値が格納されているモデルのカラム。デフォルト値は -1 (無効なマッピング)。

firstSetRow : int

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

highColumn : int

シリーズ内のローソク足アイテムの高値を格納するモデルのカラム。デフォルト値は-1(無効なマッピング)。

lastSetRow : int

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

lowColumn : int

シリーズ内のローソク足アイテムの安値が格納されているモデルのカラム。デフォルト値は-1(無効なマッピング)。

model : QAbstractItemModel

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

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

openColumn : int

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

series : CandlestickSeries

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

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

timestampColumn : int

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

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