このページでは

HCandlestickModelMapper QML Type

ローソク足シリーズ用の水平型マッパー。詳細...

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

この型は非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

詳細な説明

モデルマッパーを使用すると、QAbstractItemModel クラスから派生したデータモデルを、チャートのデータソースとして利用できるようになります。 水平型モデルマッパーは、データモデルとCandlestickSeries との間に接続を確立するために使用され、データモデルの各行がローソク足アイテムを定義し、各列がローソク足アイテムの始値、高値、安値、終値、およびタイムスタンプの値にマッピングされるようにします。

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

モデルマッパーは、ローソク足シリーズ内のすべてのローソク足アイテムのサイズが等しくなるようにします。したがって、ローソク足アイテムに値を追加または削除すると、ローソク足シリーズ内のすべてのローソク足アイテムに対して同じ変更が反映されます。

以下の QML の例では、3 つのローソク足アイテムを持つローソク足シリーズを作成しています(モデルに少なくとも 4 行あることを前提としています)。各ローソク足アイテムには、timestamp、open、high、low、close 列で定義されたデータが含まれています。アイテムの名前は、行の縦方向のヘッダーによって定義されます。

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

CandlestickSeries 、CandlestickSet 、およびVCandlestickModelMapperも参照してください 。

プロパティのドキュメント

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.