このページでは

QBarSet Class

QBarSet クラスは、棒グラフ内の 1 組の棒を表します。詳細...

ヘッダー: #include <QBarSet>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML内: BarSet
継承元: QObject

プロパティ

パブリック関数

QBarSet(const QString &label, QObject *parent = nullptr)
virtual ~QBarSet() override
void append(const QList<qreal> &values)
void append(qreal value)
qreal at(qsizetype index) const
QColor borderColor() const
qreal borderWidth() const
void clear()
QColor color() const
qsizetype count() const
void deselectAllBars()
void deselectBar(qsizetype index)
void deselectBars(const QList<qsizetype> &indexes)
void insert(qsizetype index, qreal value)
bool isBarSelected(qsizetype index) const
QString label() const
QColor labelColor() const
void remove(qsizetype index, qsizetype count = 1)
void replace(qsizetype index, qreal value)
void selectAllBars()
void selectBar(qsizetype index)
void selectBars(const QList<qsizetype> &indexes)
QList<qsizetype> selectedBars() const
QColor selectedColor() const
void setBarSelected(qsizetype index, bool selected)
void setBorderColor(QColor color)
void setBorderWidth(qreal borderWidth)
void setColor(QColor color)
void setLabel(const QString &label)
void setLabelColor(QColor color)
void setSelectedColor(QColor color)
void setValues(const QVariantList &values)
qreal sum() const
void toggleSelection(const QList<qsizetype> &indexes)
QVariantList values() const
QBarSet &operator<<(qreal value)
qreal operator[](qsizetype index) const

シグナル

void borderColorChanged(QColor color)
void borderWidthChanged(qreal width)
void colorChanged(QColor color)
void countChanged()
void labelChanged()
void labelColorChanged(QColor color)
void selectedBarsChanged(const QList<qsizetype> &indexes)
void selectedColorChanged(QColor color)
void update()
void updatedBars()
void valueAdded(qsizetype index, qsizetype count)
void valueChanged(qsizetype index)
void valueRemoved(qsizetype index, qsizetype count)
void valuesAdded(qsizetype index, qsizetype count)
void valuesChanged()
void valuesRemoved(qsizetype index, qsizetype count)

詳細な説明

棒グラフのセットには、各カテゴリごとに1つのデータ値が含まれます。セットの最初の値は最初のカテゴリに、2番目の値は2番目のカテゴリに、というように属するとみなされます。セットに含まれる値の数がカテゴリの数より少ない場合、欠損値はセットの末尾にあるものとみなされます。 セットの中間に欠損値がある場合は、数値「0」が使用されます。値が「0」のセットのラベルは表示されません。

QBarSeriesも参照してください 。

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

borderColor : QColor

このプロパティは、バーセットの枠線の色を指定します。

アクセス関数:

QColor borderColor() const
void setBorderColor(QColor color)

通知シグナル:

void borderColorChanged(QColor color)

borderWidth : qreal

このプロパティは、境界線の幅を指定します。デフォルトでは、幅は -1 となっており、これは境界線の幅がテーマによって定義されることを意味します。

アクセス関数:

qreal borderWidth() const
void setBorderWidth(qreal borderWidth)

Notifierシグナル:

void borderWidthChanged(qreal width)

color : QColor

このプロパティは、バーセットの塗りつぶし色を保持します。

アクセス関数:

QColor color() const
void setColor(QColor color)

通知シグナル:

void colorChanged(QColor color)

[read-only] count : qsizetype

このプロパティは、バーセットに含まれる値の数を保持します。

アクセス関数:

qsizetype count() const[see note below]

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

通知シグナル:

void countChanged()

label : QString

このプロパティには、バーセットのラベルが格納されます。

アクセス関数:

QString label() const
void setLabel(const QString &label)

通知シグナル:

void labelChanged()

labelColor : QColor

このプロパティは、バーセットのテキスト(ラベル)の色を指定します。

アクセス関数:

QColor labelColor() const
void setLabelColor(QColor color)

通知シグナル:

void labelColorChanged(QColor color)

[read-only] selectedBars : QList<qsizetype>

このプロパティは、現在選択されているバーのインデックスを保持します。

アクセス関数:

QList<qsizetype> selectedBars() const

通知シグナル:

void selectedBarsChanged(const QList<qsizetype> &indexes)

selectedColor : QColor

このプロパティは、選択されたセットの塗りつぶし色を保持します。

アクセス関数:

QColor selectedColor() const
void setSelectedColor(QColor color)

通知シグナル:

void selectedColorChanged(QColor color)

values : QVariantList

このプロパティには、バーセットの値が格納されます。

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

実数型のリストを値として設定した場合、それらがバーセットの値を直接定義します。

点型のリストを値として設定した場合、その点の x 座標が、バーセット内での 0 を基点とするインデックスを指定します。 バーセットのサイズは、最大の x 座標値 + 1 です。0 から最大値までの間の x 座標で点が欠落している場合、その点は値 0 となります。

アクセス関数:

QVariantList values() const
void setValues(const QVariantList &values)

通知シグナル:

void valuesChanged()

メンバ関数のドキュメント

[explicit] QBarSet::QBarSet(const QString &label, QObject *parent = nullptr)

ラベル「label 」を持ち、親要素が「parent 」である棒グラフセットを作成します。

[override virtual noexcept] QBarSet::~QBarSet()

バーセットを削除します。

[invokable] void QBarSet::append(const QList<qreal> &values)

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

注:この関数は 、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::append(qreal value)

value で指定された新しい値を、バーセットの末尾に追加します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] qreal QBarSet::at(qsizetype index) const

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

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

QColor QBarSet::borderColor() const

バーセットの線の色を返します。

注: プロパティ borderColorのゲッター 関数です。

関連項目: setBorderColor()。

[invokable] void QBarSet::clear()

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

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

QColor QBarSet::color() const

バーセットの塗りつぶし色を返します。

注: プロパティ colorのゲッター 関数です。

関連項目: setColor()。

[invokable] qsizetype QBarSet::count() const

バーセットに含まれる値の数を返します。

注:この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

注: プロパティ countのゲッター 関数です。

[invokable] void QBarSet::deselectAllBars()

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

注: QBarSet::selectedBarsChangedを発行します 。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::deselectBar(qsizetype index)

index にあるバーの選択を解除します。

注: QBarSet::selectedBarsChangedを発火します 。

注:この関数は 、メタオブジェクトシステムを介して、および QML から呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)

indexes リスト内で通過した複数のバーを「選択解除済み」としてマークします。

注: QBarSet::selectedBarsChangedを発行します 。

注:この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::insert(qsizetype index, qreal value)

index で指定された位置にvalue を挿入します。挿入された値の後の値は、1つずつ上に移動します。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] bool QBarSet::isBarSelected(qsizetype index) const

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

注: QBarSet::setSelectedColor を使用して色が指定されている場合、選択された バーは指定された色で描画されます。

注:この関数は 、メタオブジェクトシステムを介して、または QML から呼び出すことができます。Q_INVOKABLE を参照してください。

selectedBars()、setBarSelected()、およびsetSelectedColor()も参照してください 。

QString QBarSet::label() const

バーセットのラベルを返します。

注: プロパティ labelのゲッター 関数です。

関連項目: setLabel()。

QColor QBarSet::labelColor() const

バーセットのテキストの色を返します。

注: プロパティ labelColorのゲッター 関数です。

関連項目: setLabelColor()。

[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)

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

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::replace(qsizetype index, qreal value)

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

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QBarSet::selectAllBars()

セット内のすべてのバーを選択状態としてマークします。

注: QBarSet::selectedBarsChangedを発行します 。

注:この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::selectBar(qsizetype index)

index にあるバーを選択済みとしてマークします。

注: QBarSet::selectedBarsChangedを発行します 。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)

indexes リスト内で通過した複数のバーを選択済みとしてマークします。

注: QBarSet::selectedBarsChangedを発行します 。

注:この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

QList<qsizetype> QBarSet::selectedBars() const

「selected」としてマークされたバーのリストを返します。

注: プロパティ `selectedBars`のゲッター関数です 。

関連項目: setBarSelected()。

[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)

このシグナルは、選択されたバーが変更されたときに発火します。indexes は、選択されたバーのインデックスを格納したリストです。

注: プロパティ `selectedBars` に対する通知 シグナルです。

QColor QBarSet::selectedColor() const

選択されたバーの色を返します。

これは、選択済みとしてマークされたバーの塗りつぶし(ブラシ)色です。指定がない場合は、QBarSet::color の値がデフォルトとして使用されます。

注: プロパティ selectedColor のゲッター 関数です。

関連項目: setSelectedColor() およびcolor 。

[invokable] void QBarSet::setBarSelected(qsizetype index, bool selected)

selected で指定された設定に従って、index のバーを選択状態または非選択状態に設定します。

注:選択された バーは、指定されている場合、選択色を使用して描画されます。QBarSet::selectedBarsChanged を発行します。

注:この関数は 、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。

isBarSelected() およびsetSelectedColor()も参照してください 。

void QBarSet::setBorderColor(QColor color)

color に設定されたバーセットの線の色を設定します。

注: プロパティ `borderColor`のセッター 関数です。

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

void QBarSet::setColor(QColor color)

color に設定されたバーセットの塗りつぶし色を設定します。

注: color プロパティのセッター 関数です。

関連項目: color()。

void QBarSet::setLabel(const QString &label)

label を、バーセットの新しいラベルとして設定します。

注: プロパティ `label`のセッター 関数です。

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

void QBarSet::setLabelColor(QColor color)

color に設定されたバーのテキストの色を設定します。

注: labelColor プロパティのセッター 関数です。

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

void QBarSet::setSelectedColor(QColor color)

選択した小節のcolor を設定します。

注: プロパティ `selectedColor`のセッター 関数です。

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

[invokable] qreal QBarSet::sum() const

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

注:この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)

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

注: QBarSet::selectedBarsChangedを発火します 。

注:この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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

[signal] void QBarSet::update()

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

[signal] void QBarSet::updatedBars()

このセット内のバーが更新されると、このシグナルが発生します。

[signal] void QBarSet::valueAdded(qsizetype index, qsizetype count)

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

[signal] void QBarSet::valueChanged(qsizetype index)

このシグナルは、index で指定された位置の値が変更されたときに発生します。

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

[signal] void QBarSet::valueRemoved(qsizetype index, qsizetype count)

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

[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype count)

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

append() およびinsert()も参照してください 。

[signal] void QBarSet::valuesRemoved(qsizetype index, qsizetype count)

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

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

QBarSet &QBarSet::operator<<(qreal value)

value で指定された実数値を、バーセットの末尾に追加するための利便性のための演算子です。

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

qreal QBarSet::operator[](qsizetype index) const

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

© 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.