Back to Qt.io
Contact Us Blog Download Qt
このページでは

BarSet QML Type

棒グラフの1組の棒を表します。詳細...

Import Statement: import QtGraphs
In C++: QBarSet

プロパティ

信号

方法

詳細説明

バーセットは、各カテゴリに 1 つのデータ値を含みます。セットの最初の値は最初のカテゴリに属し、2 番目の値は 2 番目のカテゴリに属し、以下同様であると仮定されます。セットの値がカテゴリの数より少ない場合、欠損値はセットの末尾にあると仮定されます。セットの途中の欠損値については、ゼロという数値が使用される。ゼロ値のセットのラベルは表示されません。

BarSeriesも参照してください 。

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

borderColor : color

バー・セットのボーダー・カラー。

borderWidth : real

デフォルトでは、幅は-1です。つまり、ボーダーの幅はテーマによって定義されます。

color : color

バーセットの塗りつぶし色。

count : int [read-only]

バー・セットの値の数。

label : string

バー・セットのラベル。

labelColor : color

バー・セットのテキスト（ラベル）の色。

selectedBars : list [read-only]

現在選択されているバーのインデックス。

selectedColor : color

選択されたセットの塗りつぶし色。

values : list<variant>

バー・セットの値。値として、real またはpoint 型のリストを設定できます。

値として実数型のリストを設定すると、それらは直接バー・セットの値を定義する。

値として点型のリストを設定した場合、点の x 座標は、小節集合におけるゼロ・ベースのインデックスを指定する。棒集合のサイズは、x座標の最高値＋1である。点がゼロから最高値の間のどのx座標でも欠けている場合、その点は値ゼロを得る。

例えば、以下のバーセットは等しい値を持つ：

myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];

信号ドキュメント

borderColorChanged(color)

このシグナルは、バー・セットのボーダー・カラーがcolor に変更されたときに発行される。

注： 対応するハンドラはonBorderColorChanged です。

borderWidthChanged(real width)

このシグナルは、バーセットのボーダー幅が変更されたときに発せられる。新しい幅はwidth です。

注意: 対応するハンドラはonBorderWidthChanged です。

colorChanged(color)

このシグナルは、バーセットの塗りつぶし色がcolor に変更されたときに発行される。

注： 対応するハンドラはonColorChanged です。

countChanged()

このシグナルは、バーセットの値カウントが変化したときに発せられる。

注: 対応するハンドラはonCountChanged です。

labelChanged()

このシグナルは、バーセットのラベルが変更されたときに発行される。

注： 対応するハンドラはonLabelChanged 。

labelも参照のこと 。

labelColorChanged(color)

このシグナルは、バーセットのテキスト（ラベル）の色がcolor に変更されたときに発行される。

注： 対応するハンドラはonLabelColorChanged です。

selectedBarsChanged(list<int> indexes)

indexes は選択されたバーのインデックスのリストである。

注: 対応するハンドラはonSelectedBarsChanged です。

selectedColorChanged(color color)

このシグナルは、選択されているバーの色が変更されたときに発せられる。新しい色はcolor です。

注： 対応するハンドラはonSelectedColorChanged です。

update()

このシグナルはバーセットが更新されたときに発せられる。

注意: 対応するハンドラはonUpdate です。

updatedBars()

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

注意: 対応するハンドラはonUpdatedBars です。

valueAdded(int index, int count)

このシグナルは、バーセットに新しい値が追加されたときに発行される。index は最初に挿入された値の位置を示し、count は挿入された値の数を示す。

注： 対応するハンドラはonValueAdded です。

valueChanged(int index)

このシグナルは、index で指定された位置の値が変更されたときに発せられる。

注： 対応するハンドラはonValueChanged です。

valueRemoved(int index, int count)

このシグナルは、バーセットから値が削除されたときに発せられる。index は最初に削除された値の位置を示し、count は削除された値の数を示す。

注: 対応するハンドラはonValueRemoved です。

valuesAdded(int index, int count)

このシグナルは、バーセットに新しい値が追加されたときに発行される。index は最初に挿入された値の位置を示し、count は挿入された値の数を示す。

注： 対応するハンドラはonValuesAdded です。

valuesChanged()

このシグナルは、バー・セットの値が変更されたときに発せられる。

注： 対応するハンドラはonValuesChanged です。

valuesRemoved(int index, int count)

このシグナルは、バーセットから値が削除されたときに発せられる。index は最初に削除された値の位置を示し、count は削除された値の数を示す。

注: 対応するハンドラはonValuesRemoved です。

メソッド・ドキュメント

void append(list<real> values)

values で指定された実数値のリストをバー・セットの最後に追加します。

append()も参照 。

void append(real value)

value で指定された新しい値をバー・セットの最後に追加する。

real at(int index)

バーセットからindex で指定された値を返す。インデックスが範囲外の場合、0.0 が返される。

void clear()

セットからすべての値を削除します。

int count()

BARSET関数は、バー・セット内の値の数を返します。

void deselectAllBars()

セット内のすべてのバーの選択を解除します。

注: BarSet::selectedBarsChanged を発する。

setBarSelected()も参照 。

void deselectBar(int index)

index のバーの選択を解除する。

注： BarSet::selectedBarsChanged を発する。

setBarSelected()も参照 。

void deselectBars(list<int> indexes)

indexes リストで渡された複数のバーを非選択としてマークする。

注: BarSet::selectedBarsChanged を発する。

setBarSelected()も参照のこと 。

void insert(int index, real value)

index で指定された位置にvalue を挿入する。挿入された値に続く値は、1つ上の位置に移動する。

remove()も参照のこと 。

bool isBarSelected(int index)

指定されたindex のバーが選択されたバーの中にある場合はtrue を、そうでない場合はfalse を返します。

注意: 選択されたバーは、BarSet::setSelectedColor を使用して指定された場合、選択された色を使用して描画されます。

selectedBars 、setBarSelected()、selectedColorも参照 。

void remove(int index, int count)

index で指定された値から、count で指定された数の値をバーセットから削除する。

count を省略すると、index で指定された値のみが削除されます。

void replace(int index, real value)

index で指定された位置に設定されたバーに、value で指定された値を追加する。

void selectAllBars()

セット内のすべての小節を選択としてマークします。

注: BarSet::selectedBarsChanged を発する。

setBarSelected()も参照 。

void selectBar(int index)

index のバーを選択されたものとしてマークする。

注: BarSet::selectedBarsChanged を発する。

setBarSelected()も参照 。

void selectBars(list<int> indexes)

indexes リストで渡された複数の小節を選択としてマークする。

注: BarSet::selectedBarsChanged を発する。

setBarSelected()も参照のこと 。

void setBarSelected(int index, bool selected)

selected で指定されたように、index のバーを選択または非選択としてマークします。

注意： 選択されたバーは、選択された色が指定されている場合、その色を使って描画されます。BarSet::selectedBarsChanged を出力します。

isBarSelected() およびselectedColorも参照 。

real sum()

バーセット内のすべての値の合計を返します。

void toggleSelection(list<int> indexes)

指定されたindexes のバーの選択状態を、反対の状態に変更する。

注: BarSet::selectedBarsChanged を発する。

setBarSelected()も参照 。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.