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)

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

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

append()も参照 。


bool remove(BarSet barset)

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


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。