Back to Qt.io
Contact Us Blog Download Qt

AbstractBarSeries QML Type

すべての棒系列型の抽象親型。詳細...

Import Statement: import QtCharts 2.8
In C++: QAbstractBarSeries
Inherits:

AbstractSeries

Inherited By:

BarSeries, HorizontalBarSeries, HorizontalPercentBarSeries, HorizontalStackedBarSeries, PercentBarSeries, and StackedBarSeries

プロパティ

信号

方法

  • BarSet append(string label, VariantList values)
  • BarSet at(int index)
  • clear()
  • BarSet insert(int index, string label, VariantList values)
  • bool remove(BarSet barset)

詳細説明

棒グラフでは、棒は、各カテゴリに1つのデータ値を含む棒セットとして定義されます。バーの位置はカテゴリによって指定され、その高さはデータ値によって指定されます。複数のバー セットを含むバー シリーズは、同じカテゴリに属するバーをグループ化します。棒グラフの表示方法は、棒グラフの作成に選択されたタイプによって決まります：BarSeries StackedBarSeries,PercentBarSeries,HorizontalBarSeries,HorizontalStackedBarSeries, またはHorizontalPercentBarSeries 。

棒グラフの主軸にBarCategoryAxis 型ではなくValueAxis 型を使用した場合、棒グラフはカテゴリのインデックス値を中心にグループ化されます。

次の QML コード・スニペットは、BarSeries 型とBarCategoryAxis 型を使って単純な棒グラフを作成する方法を示しています：

ChartView {
    title: "Bar Chart"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}


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

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 も参照 。


barWidth : real

幅の単位はX軸の単位である。棒グラフの最小幅はゼロで、負の値はゼロとして扱われる。幅をゼロに設定すると、x軸のスケールに関係なく、画面上のバーの幅は1ピクセルになります。ゼロより幅の広いバーは、x軸のスケールを使用して拡大縮小される。

注： BarSeries タイプで使用する場合、この値は、単一のバーの幅ではなく、バーのグループの幅を指定する。


count : int [read-only]

バー・シリーズのバー・セットの数。


labelsAngle : real

値ラベルの角度（度）。


labelsFormat : string

棒系列内のラベルの表示形式。

QAbstractBarSeries::labelsFormat 、labelsVisible 、labelsPositionも参照 。


labelsPosition : enumeration

データ値ラベルの位置：

定数説明
AbstractBarSeries.LabelsCenterラベルはバーの中央に配置される。
AbstractBarSeries.LabelsInsideEndラベルは上部のバーの内側にある。
AbstractBarSeries.LabelsInsideBaseラベルが下のバーの内側にある。
AbstractBarSeries.LabelsOutsideEndラベルは上部のバーの外側にある。

labelsVisible およびlabelsFormatも参照のこと 。


labelsPrecision : real

値ラベルに表示される最大有効桁数。

デフォルト値は 6。


labelsVisible : bool

棒系列内のラベルの可視性。


シグナル ドキュメント

barsetsAdded()

このシグナルは、バー・セットがシリーズに追加されたときに発せられる。

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

注： 対応するハンドラはonBarsetsAdded 。


barsetsRemoved()

このシグナルは、バーセットがシリーズから削除されたときに発せられる。

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

注： 対応するハンドラはonBarsetsRemoved です。


clicked(int index, BarSet barset)

このシグナルは、barset で指定されたバー セットで、index で指定されたバーをクリックしたときに発行されます。

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

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


doubleClicked(int index, BarSet barset)

このシグナルは、barset で指定されたバーセット内のindex で指定されたバーをユーザーがダブルクリックしたときに発行されます。

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

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


hovered(bool status, int index, BarSet barset)

このシグナルは、barset で指定されたバーセット内のindex で指定されたバーの上にマウスが置かれたときに発せられる。マウスがバーの上に移動すると、status はtrue に変わり、マウスが再び離れるとfalse に変わります。

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

注： 対応するハンドラはonHovered です。


pressed(int index, BarSet barset)

このシグナルは、barset で指定されたバー・セットで、index で指定されたバーをユーザーがクリックし、マウス・ボタンを押し続けたときに発せられる。

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

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


released(int index, BarSet barset)

このシグナルは、barset で指定されたバーセット内の、index で指定されたバーで、ユーザがマウスの押下を離したときに発せられる。

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

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


メソッド・ドキュメント

BarSet append(string label, VariantList values)

label とvalues を持つ新しいバーセットをインデックスに追加します。values は実数値のリストです。

例えば

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

index のバー・セットを返します。インデックスが有効でない場合は、NULL を返します。


clear()

シリーズからすべてのバー セットを削除します。


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

label とvalues を持つ新しいバー セットをindex に追加します。values は、実数値のリストまたはXYPoint タイプのリストです。

インデックス値が 0 以下の場合、新しいバー・セットがバー・シリーズに追加されます。インデックス値がバー・シリーズのバー・セットの数以上の場合、新しいバー・セットがバー・シリーズに追加される。

append()も参照 。


bool remove(BarSet barset)

barset で指定したバーセットをシリーズから削除する。成功した場合はtrue を返し、失敗した場合はfalse を返す。


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