Back to Qt.io
Contact Us Blog Download Qt

QBarCategoryAxis Class

QBarCategoryAxis クラスは、チャートの軸にカテゴリを追加します。詳細...

Header: #include <QBarCategoryAxis>
In QML: BarCategoryAxis
Inherits: QAbstractAxis

プロパティ

パブリック関数

QBarCategoryAxis(QObject *parent = nullptr)
virtual ~QBarCategoryAxis()
void append(const QString &category)
void append(const QStringList &categories)
QString at(int index) const
QStringList categories()
void clear()
int count() const
void insert(int index, const QString &category)
QString max() const
QString min() const
void remove(const QString &category)
void replace(const QString &oldCategory, const QString &newCategory)
void setCategories(const QStringList &categories)
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 maxChanged(const QString &max)
void minChanged(const QString &min)
void rangeChanged(const QString &min, const QString &max)

詳細説明

QBarCategoryAxisは、目盛り、グリッド線、および陰影を持つ軸線を表示するように設定できます。カテゴリは目盛りの間に描画されます。これは、ウィジェット付きチャート・ギャラリーで示されているように、線分系列でも使用できます。

次のコードは、QBarCategoryAxisの使用方法を示しています：

QChartView *chartView = new QChartView;
QBarSeries *series = new QBarSeries;
// ...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();

QBarCategoryAxis *axisX = new QBarCategoryAxis;
QStringList categories;
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
axisX->append(categories);
axisX->setRange("Feb", "May");
chartView->chart()->setAxisX(axisX, series);

プロパティ・ドキュメンテーション

categories : QStringList

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

アクセス関数：

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

通知シグナル：

void categoriesChanged()

[read-only] count : const int

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

アクセス関数：

int count() const

通知シグナル：

void countChanged()

max : QString

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

アクセス関数

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

ノーティファイア信号：

void maxChanged(const QString &max)

min : QString

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

アクセス関数

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

通知シグナル：

void minChanged(const QString &min)

メンバ関数説明

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

parent の子である軸オブジェクトを構築する。

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

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

void QBarCategoryAxis::append(const QString &category)

category を軸に追加する。軸の最大値は、最後のcategory に一致するように変更されます。カテゴリが以前に定義されていない場合、軸の最小値もcategory に一致するように変更されます。

カテゴリは有効なQString でなければならず、重複することはできない。重複したカテゴリは追加されない。

void QBarCategoryAxis::append(const QStringList &categories)

categories を軸に追加します。軸の最大値は、categories の最後のカテゴリに一致するように変更されます。 前にカテゴリが定義されていない場合、軸の最小値も、categories の最初のカテゴリに一致するように変更されます。

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

QString QBarCategoryAxis::at(int index) const

index にあるカテゴリーを返します。インデックスは有効でなければならない。

QStringList QBarCategoryAxis::categories()

カテゴリーを返します。

注： プロパティ・カテゴリのゲッター関数。

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

[signal] void QBarCategoryAxis::categoriesChanged()

このシグナルは、軸のカテゴリが変更されたときに発行される。

注意: プロパティ用のノーティファイアシグナルcategories 。

[invokable] void QBarCategoryAxis::clear()

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

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

int QBarCategoryAxis::count() const

カテゴリーの数を返す。

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

[signal] void QBarCategoryAxis::countChanged()

このシグナルは、軸のカテゴリ数が変更されたときに発行される。

注： プロパティcount に対するノーティファイアシグナル。

void QBarCategoryAxis::insert(int index, const QString &category)

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

QString QBarCategoryAxis::max() const

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

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

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

[signal] void QBarCategoryAxis::maxChanged(const QString &max)

このシグナルは、軸のmax 値が変更されたときに発信される。

注: プロパティmax のノーティファイアシグナル。

QString QBarCategoryAxis::min() const

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

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

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

[signal] void QBarCategoryAxis::minChanged(const QString &min)

このシグナルは、軸のmin 値が変更されたときに発信される。

注: プロパティmin のノーティファイアシグナル。

[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

この信号は、軸のmin またはmax の値が変化したときに発せられる。

void QBarCategoryAxis::remove(const QString &category)

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

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

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

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.

軸の型を返します。

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