このページでは

BoxPlotSeries QML Type

データを箱ひげ図で表示します。詳細...

Import Statement: import QtCharts 2.11
In C++: QBoxPlotSeries
Inherits:

AbstractSeries

プロパティ

信号

方法

  • void append(BoxSet box)
  • void append(string label, VariantList values)
  • BoxSet at(int index)
  • void clear()
  • void insert(int index, string label, VariantList values)
  • void remove(QBoxSet boxset)

詳細説明

箱ひげ図系列は、箱ひげ項目のコンテナとして機能する。複数の系列からの項目は、インデックス値に従ってカテゴリにグループ化されます。

BarCategoryAxis クラスは、チャートの軸にカテゴリを追加するために使用されます。カテゴリ・ラベルは一意でなければなりません。複数の箱ひげ項目に同じカテゴリー・ラベルが定義されている場合、最初のものだけが描画されます。

次のQMLコード・スニペットは、単純な箱ひげグラフの作成方法を示しています:

import QtQuick 2.0
import QtCharts 2.0

ChartView {
    title: "Box Plot series"
    width: 400
    height: 300
    theme: ChartView.ChartThemeBrownSand
    legend.alignment: Qt.AlignBottom

    BoxPlotSeries {
        id: plotSeries
        name: "Income"
        BoxSet { label: "Jan"; values: [3, 4, 5.1, 6.2, 8.5] }
        BoxSet { label: "Feb"; values: [5, 6, 7.5, 8.6, 11.8] }
        BoxSet { label: "Mar"; values: [3.2, 5, 5.7, 8, 9.2] }
        BoxSet { label: "Apr"; values: [3.8, 5, 6.4, 7, 8] }
        BoxSet { label: "May"; values: [4, 5, 5.2, 6, 7] }
    }
}

スクリーンショットは、1月から5月までの5ヶ月間の収入を箱ひげ図にしたもの。


BoxSet およびBarCategoryAxisも参照して ください。

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

axisX : AbstractAxis

シリーズに使用されるX軸。axisX とaxisXTop の両方を未定義のままにすると、BarCategoryAxis が系列に作成される。

axisXTopも参照

axisXTop : AbstractAxis

チャートビューの上部に描画される、シリーズに使用されるX軸。

注: axisX または axisXTop のどちらか一方のみを指定でき、両方を指定することはできない。

axisXも参照のこと

axisY : AbstractAxis

シリーズに使用されるY軸。axisY とaxisYRight の両方を未定義のままにすると、ValueAxis が作成されます。

axisYRightも参照

axisYRight : AbstractAxis

シリーズに使用されるY軸で、チャートビュー上で右側に描画される。

注: axisY または axisYRight のどちらか一方のみを指定でき、両方を指定することはできない。

axisYも参照

boxOutlineVisible : bool

ボックスのアウトラインの可視性。

boxWidth : real

箱ひげアイテムの幅。この値は、そのカテゴリ内での項目の相対的な幅を示します。値は 0.0 から 1.0 の間で指定します。負の値は 0.0 に置き換えられ、1.0 より大きい値は 1.0 に置き換えられます。

brushFilename : string

シリーズのブラシとして使用するファイル名。

count : int [read-only]

箱ひげ図系列における箱ひげ項目の数。

シグナル・ドキュメント

boxsetsAdded(list sets)

このシグナルは、sets で指定された箱ひげアイテムがシリーズに追加されたときに発せられる。

対応するシグナルハンドラはonBoxsetsAdded()

注: 対応するハンドラはonBoxsetsAdded

boxsetsRemoved(list sets)

このシグナルは、sets で指定された箱ひげアイテムがシリーズから削除されたときに発せられる。

対応するシグナルハンドラはonBoxsetsRemoved()

注: 対応するハンドラはonBoxsetsRemoved

clicked(BoxSet boxset)

このシグナルは、boxset で指定されたボックス・アンド・ウィスカー・アイテムをユーザーがチャート内でクリックしたときに発せられる。

対応するシグナルハンドラはonClicked() です。

注: 対応するハンドラはonClicked です。

doubleClicked(BoxSet boxset)

このシグナルは、boxset で指定されたボックスとウィスカのアイテムを、ユーザがチャート内でダブルクリックしたときに発せられる。

対応するシグナルハンドラはonDoubleClicked() です。

注: 対応するハンドラはonDoubleClicked です。

hovered(bool status, BoxSet boxset)

このシグナルは、チャート内のboxset で指定されたボックス&ウィスカー項目の上にマウスが置かれたときに発せられる。マウスがアイテムの上に移動すると、statustrue に変わり、再びマウスが離れるとfalse に変わる。

対応するシグナル・ハンドラはonHovered() である。

注: 対応するハンドラはonHovered

pressed(BoxSet boxset)

このシグナルは、ユーザーがチャート上でboxset を押したときに発せられる。

対応するシグナル・ハンドラはonPressed です。

注: 対応するハンドラはonPressed です。

released(BoxSet boxset)

このシグナルは、チャートのboxset で指定されたボックスとウィスカーのアイテム上でユーザーがマウスを離したときに発せられる。

対応するシグナルハンドラはonReleased() です。

注: 対応するハンドラはonReleased です。

メソッド・ドキュメント

void append(BoxSet box)

box で指定された箱ひげアイテムをシリーズに追加する。

void append(string label, VariantList values)

label で指定されたラベルとvalues で指定された値を持つ新しい箱ひげアイテムをシリーズに追加する。

BoxSet at(int index)

index で指定した位置にある箱ひげアイテムを返します。

void clear()

シリーズからすべての箱ひげアイテムを削除し、永久に削除します。

void insert(int index, string label, VariantList values)

label で指定されたラベルとvalues で指定された値を持つ新しい箱ひげアイテムを、index で指定された位置のシリーズに挿入する。

void remove(QBoxSet boxset)

boxset で指定された箱ひげアイテムをシリーズから削除します。

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