このページでは

BoxPlotSeries QML Type

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

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

AbstractSeries

Status: Deprecated

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

プロパティ

信号

方法

  • 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]

箱ひげ図の系列に含まれる項目の数。

Signal ドキュメント

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 で指定された箱ひげ図の項目にマウスをホバーさせたときに発生します。マウスがその項目上を移動すると、status はtrue に変化し、マウスが再びその項目から離れると、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.