BarSeries QML Type

データを棒グラフで表示します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• BarSeriesは、2D向けのQt Graphs QMLタイプの一部です。

プロパティ

• barDelegate : Component
• barSets : list<BarSet>
• barWidth : real
• barsType : enumeration
• borderColors : list<color>
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsMargin : real
• labelsPosition : enumeration
• labelsPrecision : real
• labelsVisible : bool
• seriesColors : list<color>

信号

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

方法

• bool append(BarSet barset)
• BarSet at(int index)
• Barset at(int index)
• void clear()
• int find(BarSet barset)
• BarSet insert(int index, BarSet barset)
• bool remove(BarSet barset)
• bool remove(int index)
• void removeMultiple(int index, int count)
• bool replace(list<BarSet> sets)
• bool replace(BarSet oldSet, BarSet newSet)
• bool replace(int index, BarSet barset)

詳細説明

デフォルトでは、データをカテゴリごとにグループ化された棒グラフの系列として描画します。各棒グラフセットから、カテゴリごとに1本の棒が系列に追加されます。また、横棒グラフや、棒グラフを積み上げ形式でグループ化することもサポートしています。

プロパティのドキュメント

barDelegate : Component

各バーを視覚化するために使用されるカスタムQMLコンポーネントです。各バーに対して、このコンポーネントのインスタンスが作成されます。これが定義されていない場合は、バーのデフォルトの矩形による視覚化が使用されます。

このコンポーネントで利用可能な動的プロパティは以下の通りです：

これらを使用するには、カスタムコンポーネントに定義された名前のプロパティを追加してください。例："property color barColor" および"property real barValue" 。

barSets : list<BarSet> [read-only]

このシリーズに追加されたセットの一覧。

barWidth : real

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

デフォルトでは、barWidthは0.5です（棒グラフは利用可能な幅の50%を占めます）。有効な値の範囲は0.0（0%）から1.0（100%）です。

barsType : enumeration

バー系列の型：

borderColors : list<color>

シリーズ内のすべてのオブジェクトに使用される枠線の色のリスト。

色の数よりも系列の数が多い場合、色リストはループし、リストの最初の色から再び繰り返されます。これが設定されていない場合（デフォルト）、GraphsTheme::borderColors の色が使用されます。

count : int [read-only]

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

labelsAngle : real

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

labelsFormat : string

棒グラフシリーズでラベルを表示する際に使用される形式。

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

labelsMargin : real

値ラベルの余白（ピクセル単位）。

この余白は、`labelsPosition `が`LabelsPosition.Center`以外に設定されている場合に使用されます。デフォルト値は`0`です。

labelsPosition : enumeration

データ値ラベルの位置：

関連項目： labelsVisible およびlabelsFormat 。

labelsPrecision : real

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

デフォルト値は 6 です。

labelsVisible : bool

棒グラフシリーズにおけるラベルの表示設定。デフォルトのラベル表示設定は「false 」です。

「barDelegate」も参照してください 。

seriesColors : list<color>

このシリーズのすべてのオブジェクトに使用される基本色のリスト。

シリーズの数が色数より多い場合、色リストはループし、リストの最初の色から再び開始されます。これが設定されていない場合（デフォルト）、GraphsTheme::seriesColors の色が使用されます。

Signal ドキュメント

barsetsAdded()

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

barsetsRemoved()

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

clicked(int index, BarSet barset)

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

doubleClicked(int index, BarSet barset)

このシグナルは、ユーザーが `barset` で指定されたバーセット内の、`index ` で指定されたバーをダブルクリックまたはダブルタップしたときに発せられます。このシグナルは、常に `clicked` の後に発生します。

pressed(int index, BarSet barset)

このシグナルは、ユーザーが `barset ` で指定されたバーセット内の、`index ` で指定されたバーをクリックまたはタップし、マウスボタンまたはジェスチャーを押し続けたときに発火します。

released(int index, BarSet barset)

このシグナルは、ユーザーが `barset` で指定されたバーセット内の、`index ` で指定されたバー上で、以前に押されていたマウスボタンまたはジェスチャーを離したときに発生します。

メソッドのドキュメント

bool append(BarSet barset)

barset で指定されたバーのセットをバー系列に追加し、その所有権を取得します。セットが null であるか、すでにその系列に属している場合は、追加されません。

追加に成功した場合は、true を返します。

insert()も参照してください 。

BarSet at(int index)

index で設定されたバーを返します。インデックスが無効な場合は null を返します。

Barset at(int index)

index で指定されたバーセットをシリーズから返します。それ以外の場合は、null を返します。

void clear()

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

int find(BarSet barset)

barset で指定されたバーセットの、当該シリーズ内でのインデックスを返します。該当するバーセットが見つからない場合は、-1 を返します。

BarSet insert(int index, BarSet barset)

barset で指定されたバーセットを、index で指定された位置のシリーズに挿入します。セットがnull である場合、またはすでにそのシリーズに属している場合は、セットは追加されません。挿入に成功した場合は、true を返します。

append()も参照してください 。

bool remove(BarSet barset)

barset で指定されたバーセットをシリーズから削除します。成功した場合は `true ` を返し、それ以外の場合は `false ` を返します。

bool remove(int index)

index で指定されたバーセットをシリーズから削除します。削除が成功した場合は `true ` を返し、そうでない場合は `false ` を返します。

void removeMultiple(int index, int count)

index およびcount で指定された範囲のバーセットを削除します。この呼び出しでは、1つの削除に失敗した場合でも、すべてのセットを順に処理します。

bool replace(list<BarSet> sets)

現在のすべてのバーセットを、sets に完全に置き換えます。サイズが一致している必要はありません。sets に設定されたバーセットのいずれかが無効な場合、false を返します。

bool replace(BarSet oldSet, BarSet newSet)

oldSet で指定されたバーセットを newSet に置き換えます。削除が成功した場合はtrue を返し、失敗した場合はfalse を返します。削除が成功した場合、oldSet は破棄されます。

bool replace(int index, BarSet barset)

index で指定された位置にあるバーを、シリーズから削除し、代わりにbarset を挿入します。成功した場合はtrue を返し、それ以外の場合はfalse を返します。