BarSeries QML Type

データを棒グラフで表示します。もっと見る...

• 継承されたメンバを含む、全メンバの一覧
• BarSeries はQt Graphs QML Types for 2D に含まれます。

プロパティ

• 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)

詳細説明

デフォルトでは、カテゴリごとにグループ化された一連のバーとしてデータを描画します。また、横棒や積み重ね棒のグループ化もサポートします。

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

barDelegate : Component

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

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

これらのいずれかを使用するには、定義された名前のプロパティをカスタム・コンポーネントに追加します。例えば、"property color barColor" や"property real barValue" などです。

barSets : list<BarSet> [read-only]

シリーズに追加されたセットのリスト。

barWidth : real

幅の単位はX軸の単位である。バーの最小幅はゼロであり、負の値はゼロとして扱われる。幅をゼロに設定すると、x軸のスケールに関係なく、画面上のバーの幅は1ピクセルになる。ゼロより幅の広いバーは、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 の色が使用されます。

シグナルのドキュメント

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)

index で指定された位置のシリーズに、barset で指定されたバーセットを挿入する。セットが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 を返す。