AbstractBarSeries QML Type

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

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : enumeration
• labelsPrecision : real
• labelsVisible : bool

信号

• barsetsAdded()
• barsetsRemoved()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• hovered(bool status, int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

方法

• BarSet append(string label, VariantList values)
• BarSet at(int index)
• void 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も参照 。

axisY : AbstractAxis

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

axisYRightも参照 。

axisYRight : AbstractAxis

チャートビューの右側に描画される、系列に使用されるY軸。

axisYも参照のこと 。

barWidth : real

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

count : int [read-only]

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

labelsAngle : real

値ラベルの角度（度）。

labelsFormat : string

棒グラフのラベルの表示形式。

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

labelsPosition : enumeration

データ値のラベルの位置：

labelsVisible およびlabelsFormatも参照 。

labelsPrecision : real

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

デフォルト値は6。

labelsVisible : bool

棒グラフのラベルの可視性。

シグナルのドキュメント

barsetsAdded()

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

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

barsetsRemoved()

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

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

clicked(int index, BarSet barset)

このシグナルは、barset で指定されたバー・セットのうち、index で指定されたバーをユーザーがクリックしたときに発せられる。

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

doubleClicked(int index, BarSet barset)

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

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

hovered(bool status, int index, BarSet barset)

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

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

pressed(int index, BarSet barset)

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

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

released(int index, BarSet barset)

このシグナルは、barset で指定されたバーセットのうち、index で指定されたバーの上でマウスを離したときに発せられる。

対応するシグナルハンドラは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 を返します。

void clear()

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

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

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

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

append()も参照 。

bool remove(BarSet barset)

barset で指定されたバーセットをシリーズから削除する。成功すればtrue を返し、そうでなければfalse を返す。