BarCategoryAxis QML Type
グラフの軸にカテゴリを追加します。詳細...
| Import Statement: | import QtGraphs |
| In C++: | QBarCategoryAxis |
| Inherits: |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- BarCategoryAxisは、Qt Graphs の2D用QMLタイプの一部です。
プロパティ
- categories : list
- count : int
- labelPosition : enumeration
(since 6.11) - max : string
- min : string
信号
- categoriesChanged()
- categoryRangeChanged(string min, string max)
- countChanged()
- maxChanged(string max)
- minChanged(string min)
方法
- void append(list categories)
- void append(string category)
- string at(int index)
- void clear()
- void insert(int index, string category)
- void remove(int index)
- void remove(string category)
- void replace(string oldCategory, string newCategory)
詳細な説明
BarCategoryAxis タイプは、目盛り、グリッド線、および陰影付きの軸線を表示するように設定できます。カテゴリは目盛りの間に描画されます。
以下の QML スニペットは、BarCategoryAxis の使用方法を示しています:
GraphsView {
anchors.fill: parent
axisX: BarCategoryAxis {
categories: ["2023", "2024", "2025"]
lineVisible: false
}
axisY: ValueAxis { }
BarSeries {
BarSet {
values: [7, 6, 9]
}
}
}プロパティのドキュメント
categories : list
軸のカテゴリ。
count : int [read-only]
軸のカテゴリ数。
labelPosition : enumeration [since 6.11]
| 定数 | 説明 |
|---|---|
BarCategoryAxis.Center | ラベルはカテゴリの中央に配置されます。 |
BarCategoryAxis.OnValue | ラベルは、カテゴリの上端の境界に配置されます。 |
このプロパティは Qt 6.11 で導入されました。
max : string
軸上の最大値。指定された値は、categories に含まれている必要があります。
min : string
軸上の最小値。指定する値は、categories に含まれている必要があります。
シグナルのドキュメント
categoriesChanged()
このシグナルは、軸のカテゴリが変更されたときに発生します。
注: 対応するハンドラは onCategoriesChanged です。
categoryRangeChanged(string min, string max)
このシグナルは、軸のカテゴリの範囲が変更されたときに発火します。min およびmax は、新しい範囲の最小値と最大値です。
注: 対応するハンドラは onCategoryRangeChanged です。
countChanged()
このシグナルは、軸のカテゴリ数が変更されたときに発火します。
注: 対応するハンドラは onCountChanged です。
maxChanged(string max)
このシグナルは、軸の最大値がmax に変更されたときに発火します。
注: 対応するハンドラは onMaxChanged です。
minChanged(string min)
このシグナルは、軸の最小値がmin に変更されたときに発行されます。
注: 対応するハンドラは onMinChanged です。
メソッドのドキュメント
void append(list categories)
軸にcategories を追加します。軸の最大値は、categories の最後のカテゴリに合わせて変更されます。以前にカテゴリが定義されていなかった場合、軸の最小値もcategories の最初のカテゴリに合わせて変更されます。
カテゴリは有効なQString でなければならず、重複してはなりません。重複するカテゴリは追加されません。
void append(string category)
軸に「category 」を追加します。軸の最大値は、最後の「category 」に合わせて変更されます。以前にカテゴリが定義されていなかった場合、軸の最小値も「category 」に合わせて変更されます。
カテゴリは有効なQString でなければならず、重複してはなりません。重複するカテゴリは追加されません。
string at(int index)
index にあるカテゴリを返します。
void clear()
すべてのカテゴリを削除します。軸の範囲の上限値と下限値を QString::null に設定します。
void insert(int index, string category)
index の軸に「category 」を追加します。category は有効な「QString 」である必要があり、重複してはなりません。category が他のカテゴリの前または後に追加された場合、軸の最小値と最大値はそれに応じて更新されます。
void remove(int index)
index にあるカテゴリを軸から削除します。現在、軸の最大値または最小値を設定しているカテゴリを削除すると、軸の範囲に影響します。
void remove(string category)
軸から「category 」を削除します。現在、軸の最大値または最小値を設定しているカテゴリを削除すると、軸の範囲に影響が出ます。
void replace(string oldCategory, string newCategory)
oldCategory をnewCategory に置き換えます。軸上にoldCategory が存在しない場合は、何も行われません。newCategory は有効なQString である必要があり、重複してはなりません。最小カテゴリまたは最大カテゴリが置き換えられた場合、軸上の最小値および最大値はそれに応じて更新されます。
© 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.