Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QCategoryAxis Class

La classe QCategoryAxis place des plages nommées sur l'axe. Plus d'informations...

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

Types publics

enum AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue }

Propriétés

Fonctions publiques

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

Fonctions publiques réimplémentées

virtual QAbstractAxis::AxisType type() const override

Signaux

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

Description détaillée

Cette classe peut être utilisée pour expliquer les données sous-jacentes en ajoutant des catégories étiquetées. Contrairement à QBarCategoryAxis, QCategoryAxis permet de spécifier librement la largeur des plages de catégories.

Exemple de code sur l'utilisation de QCategoryAxis :

Capture d'écran montrant l'axe des ordonnées classées en première, deuxième et troisième catégories.

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);

Documentation sur les types de membres

enum QCategoryAxis::AxisLabelsPosition

Cette énumération décrit la position des étiquettes de catégorie.

ConstanteValeurDescription
QCategoryAxis::AxisLabelsPositionCenter0x0Les étiquettes sont centrées sur la catégorie.
QCategoryAxis::AxisLabelsPositionOnValue0x1Les étiquettes sont positionnées à la limite supérieure de la catégorie.

Documentation sur les propriétés

[read-only] categoriesLabels : QStringList

Cette propriété contient les libellés des catégories sous la forme d'une liste de chaînes de caractères.

Fonctions d'accès :

QStringList categoriesLabels()

[read-only] count : int

Cette propriété contient le nombre de catégories.

Fonctions d'accès :

int count() const

labelsPosition : AxisLabelsPosition

Cette propriété définit la position des étiquettes des catégories. Les étiquettes au début et à la fin des axes peuvent chevaucher les étiquettes d'autres axes lorsqu'elles sont positionnées sur la valeur.

Fonctions d'accès :

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

Signal de notification :

void labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position)

startValue : qreal

Ce bien se situe à l'extrémité inférieure de la première catégorie sur l'axe.

Fonctions d'accès :

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

Documentation des fonctions membres

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

Construit un objet axe qui est un enfant de parent.

[virtual noexcept] QCategoryAxis::~QCategoryAxis()

Détruit l'objet.

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

Ajoute une nouvelle catégorie à l'axe avec l'étiquette categoryLabel. L'étiquette d'une catégorie doit être unique. categoryEndValue indique la limite supérieure de la catégorie. Elle doit être supérieure à la limite supérieure de la catégorie précédente. Sinon, la méthode renvoie sans ajouter de nouvelle catégorie.

[signal] void QCategoryAxis::categoriesChanged()

Ce signal est émis lorsque les catégories de l'axe changent.

QStringList QCategoryAxis::categoriesLabels()

Renvoie la liste des étiquettes des catégories.

Note : Fonction Getter pour la propriété categoriesLabels.

int QCategoryAxis::count() const

Renvoie le nombre de catégories.

Note : Fonction Getter pour le nombre de propriétés.

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

Renvoie la limite supérieure de la catégorie spécifiée par categoryLabel.

void QCategoryAxis::remove(const QString &categoryLabel)

Supprime de l'axe une catégorie spécifiée par l'étiquette categoryLabel.

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

Remplace une étiquette de catégorie existante spécifiée par oldLabel par newLabel. Si l'ancienne étiquette n'existe pas, la méthode renvoie sans apporter de modifications.

void QCategoryAxis::setStartValue(qreal min)

Définit min comme étant la limite inférieure de la première catégorie de l'axe. Si des catégories ont déjà été ajoutées à l'axe, la valeur transmise doit être inférieure à la limite supérieure de la première catégorie déjà définie. Sinon, rien n'est fait.

Remarque : fonction de définition de la propriété startValue.

Voir également startValue().

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

Renvoie la limite inférieure de la catégorie spécifiée par categoryLabel.

Remarque : fonction Getter pour la propriété startValue.

Voir également setStartValue().

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

Réimplémente : QValueAxis::type() const.

Renvoie le type de l'axe.

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