QBarCategoryAxis Class
QBarCategoryAxis クラスは、チャートの軸にカテゴリを追加します。詳細...
| Header: | #include <QBarCategoryAxis> |
| In QML: | BarCategoryAxis |
| Inherits: | QAbstractAxis |
| Status: | Deprecated |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- categories : QStringList
- count : int
- max : QString
- min : QString
パブリック関数
| 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 : int
このプロパティは、軸のカテゴリ数を保持します。
アクセス関数：
| int | count() const |
通知信号:
| void | countChanged() |
max : QString
このプロパティは、軸上の最大値を保持します。
アクセス関数：
通知信号:
| void | maxChanged(const QString &max) |
min : QString
このプロパティは、軸上の最小値を保持します。
アクセス関数：
通知信号：
| 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()
カテゴリを返します。
注： プロパティ categoriesのゲッター 関数です。
関連項目： setCategories()。
[signal] void QBarCategoryAxis::categoriesChanged()
このシグナルは、軸のカテゴリが変更されたときに発せられます。
注： プロパティ `categories` に対する通知 シグナルです。
[invokable] void QBarCategoryAxis::clear()
すべてのカテゴリを削除します。軸の範囲の上限値と下限値を QString::null に設定します。
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
int QBarCategoryAxis::count() const
カテゴリの数を返します。
注： プロパティ「count」のゲッター 関数です。
[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 を再実装します。
軸の型を返します。
© 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.
