QCategoryAxis Class
La classe QCategoryAxis place des plages nommées sur l'axe. En savoir plus...
| Header: | #include <QCategoryAxis> |
| In QML: | CategoryAxis |
| Inherits: | QValueAxis |
| Status: | Deprecated |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue } |
Propriétés
- categoriesLabels : QStringList
- count : int
- labelsPosition : AxisLabelsPosition
- startValue : qreal
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 permet d'expliquer les données sous-jacentes en ajoutant des catégories étiquetées. Contrairement à QBarCategoryAxis, QCategoryAxis permet de définir librement la largeur des plages de catégories.
Exemple de code illustrant l'utilisation de 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);Documentation sur les types de membres
enum QCategoryAxis::AxisLabelsPosition
Cette énumération décrit la position des libellés de catégorie.
| Constante | Valeur | Description |
|---|---|---|
QCategoryAxis::AxisLabelsPositionCenter | 0x0 | Les étiquettes sont centrées par rapport à la catégorie. |
QCategoryAxis::AxisLabelsPositionOnValue | 0x1 | Les libellés sont positionnés à 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 forme de 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 libellés de catégorie. Les libellés situés au début et à la fin des axes peuvent chevaucher ceux d'autres axes lorsqu'ils sont positionnés sur une valeur.
Fonctions d'accès :
| QCategoryAxis::AxisLabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) |
Signal de notification :
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
startValue : qreal
Cette propriété correspond à la partie 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 sur les fonctions membres
[explicit] QCategoryAxis::QCategoryAxis(QObject *parent = nullptr)
Crée 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 » spécifie la limite supérieure de la catégorie. Elle doit être supérieure à la limite supérieure de la catégorie précédente. Dans le cas contraire, la méthode renvoie une erreur 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 libellés des catégories.
Remarque : fonction de lecture (getter ) pour la propriété categoriesLabels.
int QCategoryAxis::count() const
Renvoie le nombre de catégories.
Remarque : fonctiongetter pour la propriété count.
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 la catégorie spécifiée par le libellé « categoryLabel ».
void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel)
Remplace le nom d'une catégorie existante spécifié par ` oldLabel ` par ` newLabel`. Si l'ancien nom n'existe pas, la méthode se termine sans effectuer de modification.
void QCategoryAxis::setStartValue(qreal min)
Définit la propriété « min » comme la limite inférieure de la première catégorie sur l'axe. Si des catégories ont déjà été ajoutées à l'axe, la valeur transmise doit être inférieure à la valeur supérieure de l'intervalle de la première catégorie déjà définie. Dans le cas contraire, aucune action n'est effectuée.
Remarque : fonctionde définition de la propriété startValue.
Voir aussi startValue().
qreal QCategoryAxis::startValue(const QString &categoryLabel = QString()) const
Renvoie la limite inférieure de la catégorie spécifiée par ` categoryLabel`.
Remarque : fonctiongetter pour la propriété startValue.
Voir aussi 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.
