Back to Qt.io
Contact Us Blog Download Qt

QCategoryAxis Class

QCategoryAxis クラスは、軸上に名前付き範囲を配置します。詳細...

Header: #include <QCategoryAxis>
In QML: CategoryAxis
Inherits: QValueAxis

パブリック・タイプ

enum AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue }

プロパティ

パブリック関数

QCategoryAxis(QObject *parent = nullptr)
virtual ~QCategoryAxis()
void append(const QString &categoryLabel, qreal categoryEndValue)
QStringList categoriesLabels()
int count() const
qreal endValue(const QString &categoryLabel) const
QCategoryAxis::AxisLabelsPosition labelsPosition() const
void remove(const QString &categoryLabel)
void replaceLabel(const QString &oldLabel, const QString &newLabel)
void setLabelsPosition(QCategoryAxis::AxisLabelsPosition position)
void setStartValue(qreal min)
qreal startValue(const QString &categoryLabel = QString()) const

再実装パブリック関数

virtual QAbstractAxis::AxisType type() const override

シグナル

void categoriesChanged()
void labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position)

詳細説明

このクラスは、ラベル付けされたカテゴリを追加することで、基礎となるデータを説明するために使用できます。QBarCategoryAxis とは異なり、QCategoryAxis ではカテゴリ範囲の幅を自由に指定できます。

QCategoryAxis の使用方法のコード例：

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

QCategoryAxis *axisY = new QCategoryAxis;
axisY->setMin(0);
axisY->setMax(52);
axisY->setStartValue(15);
axisY->append("First", 20);
axisY->append("Second", 37);
axisY->append("Third", 52);
chartView->chart()->setAxisY(axisY, series);

メンバ型ドキュメント

enum QCategoryAxis::AxisLabelsPosition

この enum は、カテゴリ・ラベルの位置を記述します。

定数値説明
QCategoryAxis::AxisLabelsPositionCenter0x0ラベルはカテゴリの中央に配置される。
QCategoryAxis::AxisLabelsPositionOnValue0x1ラベルはカテゴリの上限位置に配置される。

プロパティ Documentation

[read-only] categoriesLabels : const QStringList

このプロパティは、文字列リストとしてカテゴリラベルを保持する。

アクセス関数

QStringList categoriesLabels()

[read-only] count : const int

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

アクセス関数

int count() const

labelsPosition : AxisLabelsPosition

このプロパティは、カテゴリラベルの位置を保持します。軸の先頭と末尾のラベルは、値上に配置されると他の軸のラベルと重なる場合があります。

アクセス関数

QCategoryAxis::AxisLabelsPosition labelsPosition() const
void setLabelsPosition(QCategoryAxis::AxisLabelsPosition position)

通知信号

void labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position)

startValue : qreal

このプロパティは、軸上の最初のカテゴリの下端を保持する。

アクセス関数：

qreal startValue(const QString &categoryLabel = QString()) const
void setStartValue(qreal min)

メンバ関数 ドキュメント

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

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

[virtual noexcept] QCategoryAxis::~QCategoryAxis()

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

void QCategoryAxis::append(const QString &categoryLabel, qreal categoryEndValue)

新しいカテゴリをラベルcategoryLabel を持つ軸に追加します。カテゴリのラベルは一意である必要があります。categoryEndValue は、カテゴリの上限を指定します。これは、前のカテゴリの上限よりも大き くなければなりません。そうでない場合、メソッドは新しいカテゴリを追加せずに戻ります。

[signal] void QCategoryAxis::categoriesChanged()

このシグナルは、軸のカテゴリが変更されたときに出力されます。

QStringList QCategoryAxis::categoriesLabels()

カテゴリのラベルのリストを返します。

注釈 categoriesLabels プロパティのゲッター関数。

int QCategoryAxis::count() const

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

メモ： プロパティ count のゲッター関数。

qreal QCategoryAxis::endValue(const QString &categoryLabel) const

categoryLabel で指定されたカテゴリの上限を返します。

void QCategoryAxis::remove(const QString &categoryLabel)

categoryLabel ラベルによって指定されたカテゴリを軸から削除します。

void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel)

oldLabel で指定された既存のカテゴリ・ラベルをnewLabel で置換します。古いラベルが存在しない場合、メソッドは変更せずに戻ります。

void QCategoryAxis::setStartValue(qreal min)

min を軸の最初のカテゴリの下限値に設定します。軸にカテゴリが既に追加されている場合、渡された値は、既に定義されている最初のカテゴリ範囲の上限値未満である 必要があります。それ以外の場合は何も行われません。

注釈 startValue プロパティのセッター関数。

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

qreal QCategoryAxis::startValue(const QString &categoryLabel = QString()) const

categoryLabel で指定されたカテゴリの下限値を返す。

備考： プロパティ startValue のゲッター関数。

setStartValue()も参照 。

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

再インプリメント：QValueAxis::type() const.

軸のタイプを返します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundationによって発行されたGNU Free Documentation License version 1.3の条項の下でライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。