このページでは

VBoxPlotModelMapper QML Type

箱ひげ図シリーズ用の縦型モデルマッパー。詳細...

Import Statement: import QtCharts 2.12
In C++: QVBoxPlotModelMapper
Status: Deprecated

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

プロパティ

詳細な説明

VBoxPlotModelMapper 型を使用すると、QAbstractItemModel クラスから派生したデータモデルを、チャートのデータソースとして利用できます。 垂直モデルマッパーは、データモデルとBoxPlotSeries 型との間に接続を作成するために使用され、データモデルの各列が箱ひげ図の項目を定義し、各行が箱ひげ図の項目の範囲および3つの中央値にマッピングされるようにします。

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

モデルマッパーは、箱ひげ図シリーズ内のすべての棒状の箱ひげ図項目が等しいサイズになることを保証します。したがって、ある箱ひげ図項目から値を追加または削除すると、箱ひげ図シリーズ内のすべての箱ひげ図項目に同じ変更が反映されます。

以下の QML コードスニペットは、3 つの箱ひげ図項目を持つ箱ひげ図シリーズを作成します(モデルに少なくとも 4 つの列があることを前提としています)。各箱ひげ図項目には、1 行目から始まるデータが含まれます。項目の名前は列ヘッダーによって定義されます。

BoxPlotSeries {
    VBoxPlotModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBoxSetColumn: 1
        lastBoxSetColumn: 3
        firstRow: 1
    }
}

HBoxPlotModelMapperも参照してください 。

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

firstBoxSetColumn : int

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

firstRow : int

箱ひげ図の系列において、各項目の最初の値が含まれるモデルの行。

デフォルト値は 0 です。

lastBoxSetColumn : int

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

model : SomeModel

マッパーで使用されるデータモデルです。このモデルを実装し、QMLから利用できるようにする必要があります。

注:このモデルは 、行や列の追加・削除、およびセル内のデータの変更に対応している必要があります。

rowCount : int

ボックスプロット系列のデータとしてマッピングされるモデルの行数。

デフォルト値は -1 です(数値はモデルの列数に制限されます)。

series : AbstractBarSeries

マッパーで使用される箱ひげ図のシリーズ。

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

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