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軸の単位と同じです。棒グラフの最小幅は 0 であり、負の値は 0 として扱われます。幅を 0 に設定すると、x軸のスケールに関係なく、画面上の棒グラフの幅は 1 ピクセルになります。0 より広い棒グラフは、x軸のスケールに基づいて拡大縮小されます。

count : int [read-only]

バー系列に含まれるバーセットの数。

labelsAngle : real

値ラベルの角度（度単位）。

labelsFormat : string

棒グラフの系列でラベルを表示する際に使用される形式。

「 QAbstractBarSeries::labelsFormat 」、「labelsVisible 」、および「labelsPosition 」も参照してください 。

labelsPosition : enumeration

データ値ラベルの位置：

関連項目： labelsVisible およびlabelsFormat 。

labelsPrecision : real

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

デフォルト値は 6 です。

labelsVisible : bool

棒グラフシリーズにおけるラベルの表示状態。

Signal ドキュメント

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 ` を返します。