QBarCategoryAxis Class

QBarCategoryAxis クラスは、グラフの軸にカテゴリを追加します。詳細...

ヘッダー:	`#include <QBarCategoryAxis>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`
QML内：	BarCategoryAxis
継承元:	QAbstractAxis

継承されたメンバーを含む、すべてのメンバーの一覧
QBarCategoryAxisは、Qt Graphs の2D用C++クラスの一部です。

パブリック型

(since 6.11) enum class LabelPosition { Center, OnValue }

プロパティ

categories : QStringList
count : qsizetype
(since 6.11) labelPosition : LabelPosition

max : QString
min : QString

パブリック関数

	QBarCategoryAxis(QObject *parent = nullptr)
virtual	~QBarCategoryAxis() override
void	append(const QString &category)
void	append(const QStringList &categories)
QString	at(qsizetype index) const
QStringList	categories()
void	clear()
qsizetype	count() const
void	insert(qsizetype index, const QString &category)
QBarCategoryAxis::LabelPosition	labelPosition() const
QString	max() const
QString	min() const
void	remove(const QString &category)
void	remove(qsizetype index)
void	replace(const QString &oldCategory, const QString &newCategory)
void	setCategories(const QStringList &categories)
void	setLabelPosition(QBarCategoryAxis::LabelPosition position)
void	setMax(const QString &max)
void	setMin(const QString &min)
void	setRange(const QString &minCategory, const QString &maxCategory)

再実装されたパブリック関数

virtual QAbstractAxis::AxisType type() const override

シグナル

void	categoriesChanged()
void	countChanged()
void	labelPositionChanged(QBarCategoryAxis::LabelPosition position)
void	maxChanged(const QString &max)
void	minChanged(const QString &min)

詳細な説明

QBarCategoryAxis は、目盛り、グリッド線、および陰影付きの軸線を表示するように設定できます。目盛りの間にはカテゴリが描画されます。

メンバ型のドキュメント

`[since 6.11]` enum class QBarCategoryAxis::LabelPosition

この列挙型は、カテゴリラベルの位置を表します。

定数	値	説明
`QBarCategoryAxis::LabelPosition::Center`	`0`	ラベルはカテゴリの中央に配置されます。
`QBarCategoryAxis::LabelPosition::OnValue`	`1`	ラベルはカテゴリの上端に配置されます。

この列挙型は Qt 6.11 で導入されました。

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

categories : QStringList

このプロパティは、軸のカテゴリを保持します。

アクセス関数：

QStringList	categories()
void	setCategories(const QStringList &categories)

通知信号：

void	categoriesChanged()

`[read-only]` count : qsizetype

このプロパティは、軸のカテゴリ数を保持します。

アクセス関数：

qsizetype count() const

通知信号:

void	countChanged()

`[since 6.11]` labelPosition : LabelPosition

このプロパティは、カテゴリラベルの位置を指定します。軸の始点および終点にあるラベルは、値に基づいて配置された場合、他の軸のラベルと重なることがあります。

この列挙型は Qt 6.11 で導入されました。

アクセス関数:

QBarCategoryAxis::LabelPosition	labelPosition() const
void	setLabelPosition(QBarCategoryAxis::LabelPosition position)

通知シグナル:

void	labelPositionChanged(QBarCategoryAxis::LabelPosition position)

max : QString

このプロパティは、軸上の最大値を保持します。

軸上の最大値。指定された値はcategories に含まれている必要があります。

アクセス関数：

QString	max() const
void	setMax(const QString &max)

通知信号:

void	maxChanged(const QString &max)

min : QString

このプロパティは、軸上の最小値を保持します。

軸上の最小値。指定された値は、categories に含まれている必要があります。

アクセス関数：

QString	min() const
void	setMin(const QString &min)

通知信号：

void	minChanged(const QString &min)

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

`[explicit]` QBarCategoryAxis::QBarCategoryAxis(QObject **parent* = nullptr)

parent の子となる軸オブジェクトを作成します。

`[override virtual noexcept]` QBarCategoryAxis::~QBarCategoryAxis()

軸オブジェクトを破棄します。

`[invokable]` void QBarCategoryAxis::append(const QString &category)

軸にcategory を追加します。軸の最大値は、最後のcategory に合わせて変更されます。以前にカテゴリが定義されていなかった場合、軸の最小値もcategory に合わせて変更されます。

カテゴリは有効なQString でなければならず、重複してはなりません。重複するカテゴリは追加されません。

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

`[invokable]` void QBarCategoryAxis::append(const QStringList &categories)

軸にcategories を追加します。軸の最大値は、categories の最後のカテゴリに合わせて変更されます。以前にカテゴリが定義されていなかった場合、軸の最小値もcategories の最初のカテゴリに合わせて変更されます。

カテゴリは有効なQString でなければならず、重複してはなりません。重複するカテゴリは追加されません。

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

`[invokable]` QString QBarCategoryAxis::at(qsizetype index) const

index にあるカテゴリを返します。

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

QStringList QBarCategoryAxis::categories()

カテゴリを返します。

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

関連項目： setCategories()。

`[invokable]` void QBarCategoryAxis::clear()

すべてのカテゴリを削除します。軸の範囲の上限値と下限値を QString::null に設定します。

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

qsizetype QBarCategoryAxis::count() const

カテゴリの数を返します。

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

`[invokable]` void QBarCategoryAxis::insert(qsizetype index, const QString &category)

index の軸にcategory を挿入します。category は有効なQString でなければならず、重複してはなりません。category が他のカテゴリの前または後に追加された場合、軸上の最小値と最大値はそれに応じて更新されます。

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

QString QBarCategoryAxis::max() const

最大値のカテゴリを返します。

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

関連項目： setMax()。

QString QBarCategoryAxis::min() const

最小のカテゴリを返します。

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

関連項目： setMin()。

`[invokable]` void QBarCategoryAxis::remove(const QString &category)

軸から「category 」を削除します。現在、軸の最大値または最小値を設定しているカテゴリを削除すると、軸の範囲に影響します。

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

`[invokable]` void QBarCategoryAxis::remove(qsizetype index)

index にあるカテゴリを軸から削除します。現在、軸の最大値または最小値を設定しているカテゴリを削除すると、軸の範囲に影響します。

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

`[invokable]` void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

oldCategory をnewCategory に置き換えます。軸上にoldCategory が存在しない場合は、何もしません。newCategory は有効なQString である必要があり、重複してはなりません。最小または最大のカテゴリが置き換えられた場合、軸上の最小値および最大値はそれに応じて更新されます。

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

void QBarCategoryAxis::setCategories(const QStringList &categories)

categories を設定し、古いものを破棄します。軸の範囲は、categories の最初のカテゴリと最後のカテゴリに合わせて調整されます。

カテゴリは有効なQString でなければならず、重複してはなりません。

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

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

void QBarCategoryAxis::setMax(const QString &max)

最大カテゴリを「max 」に設定します。

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

関連項目：max()も参照してください 。

void QBarCategoryAxis::setMin(const QString &min)

カテゴリの最小値を「min 」に設定します。

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

関連項目： min()。

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

軸の範囲を `minCategory ` から `maxCategory` まで設定します。

`[override virtual]` QAbstractAxis::AxisType QBarCategoryAxis::type() const

QAbstractAxis::type() const を再実装します。

軸の型を返します。

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

QBarCategoryAxis Class

パブリック型

プロパティ

パブリック関数

再実装されたパブリック関数

シグナル

詳細な説明

メンバ型のドキュメント

[since 6.11] enum class QBarCategoryAxis::LabelPosition

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

categories : QStringList

[read-only] count : qsizetype

[since 6.11] labelPosition : LabelPosition

max : QString

min : QString

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

[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)

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

[invokable] void QBarCategoryAxis::append(const QString &category)

[invokable] void QBarCategoryAxis::append(const QStringList &categories)

[invokable] QString QBarCategoryAxis::at(qsizetype index) const

QStringList QBarCategoryAxis::categories()

[invokable] void QBarCategoryAxis::clear()

qsizetype QBarCategoryAxis::count() const

[invokable] void QBarCategoryAxis::insert(qsizetype index, const QString &category)

QString QBarCategoryAxis::max() const

QString QBarCategoryAxis::min() const

[invokable] void QBarCategoryAxis::remove(const QString &category)

[invokable] void QBarCategoryAxis::remove(qsizetype index)

[invokable] void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

void QBarCategoryAxis::setCategories(const QStringList &categories)

void QBarCategoryAxis::setMax(const QString &max)

void QBarCategoryAxis::setMin(const QString &min)

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

[override virtual] QAbstractAxis::AxisType QBarCategoryAxis::type() const

`[since 6.11]` enum class QBarCategoryAxis::LabelPosition

`[read-only]` count : qsizetype

`[since 6.11]` labelPosition : LabelPosition

`[explicit]` QBarCategoryAxis::QBarCategoryAxis(QObject **parent* = nullptr)

`[override virtual noexcept]` QBarCategoryAxis::~QBarCategoryAxis()

`[invokable]` void QBarCategoryAxis::append(const QString &category)

`[invokable]` void QBarCategoryAxis::append(const QStringList &categories)

`[invokable]` QString QBarCategoryAxis::at(qsizetype index) const

`[invokable]` void QBarCategoryAxis::clear()

`[invokable]` void QBarCategoryAxis::insert(qsizetype index, const QString &category)

`[invokable]` void QBarCategoryAxis::remove(const QString &category)

`[invokable]` void QBarCategoryAxis::remove(qsizetype index)

`[invokable]` void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

`[override virtual]` QAbstractAxis::AxisType QBarCategoryAxis::type() const