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

QBarCategoryAxis Class

La classe QBarCategoryAxis ajoute des catégories aux axes d'un graphique. En savoir plus...

Header: #include <QBarCategoryAxis>
In QML: BarCategoryAxis
Inherits: QAbstractAxis
Status: Deprecated

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

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)

Fonctions publiques réimplémentées

virtual QAbstractAxis::AxisType type() const override

Signaux

void categoriesChanged()
void countChanged()
void maxChanged(const QString &max)
void minChanged(const QString &min)
void rangeChanged(const QString &min, const QString &max)

Description détaillée

QBarCategoryAxis peut être configuré pour afficher une ligne d'axe avec des repères, des lignes de quadrillage et des ombrages. Les catégories sont tracées entre les repères. Il peut également être utilisé avec une série de lignes, comme le montre la galerie « Graphiques avec widgets ».

Le code suivant illustre l'utilisation de 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);

Documentation des propriétés

categories : QStringList

Cette propriété contient les catégories d'un axe.

Fonctions d'accès :

QStringList categories()
void setCategories(const QStringList &categories)

Signal de notification :

void categoriesChanged()

[read-only] count : int

Cette propriété indique le nombre de catégories d'un axe.

Fonctions d'accès :

int count() const

Signal de notification :

void countChanged()

max : QString

Cette propriété contient la valeur maximale de l'axe.

Fonctions d'accès :

QString max() const
void setMax(const QString &max)

Signal de notification :

void maxChanged(const QString &max)

min : QString

Cette propriété contient la valeur minimale de l'axe.

Fonctions d'accès :

QString min() const
void setMin(const QString &min)

Signal de notification :

void minChanged(const QString &min)

Documentation des fonctions membres

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

Crée un objet « axe » qui est un enfant de parent.

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Supprime l'objet « axe ».

void QBarCategoryAxis::append(const QString &category)

Ajoute category à un axe. La valeur maximale de l’axe sera modifiée pour correspondre à la dernière category. Si aucune catégorie n’a été définie auparavant, la valeur minimale de l’axe sera également modifiée pour correspondre à category.

Une catégorie doit être une QString valide et ne peut pas être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

void QBarCategoryAxis::append(const QStringList &categories)

Ajoute categories à un axe. La valeur maximale de l'axe sera modifiée pour correspondre à la dernière catégorie de categories. Si aucune catégorie n'a été définie auparavant, la valeur minimale de l'axe sera également modifiée pour correspondre à la première catégorie de categories.

Une catégorie doit être un QString valide et ne peut pas être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

QString QBarCategoryAxis::at(int index) const

Renvoie la catégorie à l'adresse index. L'index doit être valide.

QStringList QBarCategoryAxis::categories()

Catégories de retours.

Remarque : fonctiongetter pour la propriété categories.

Voir aussi setCategories().

[signal] void QBarCategoryAxis::categoriesChanged()

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

Remarque : signalde notification pour la propriété categories.

[invokable] void QBarCategoryAxis::clear()

Supprime toutes les catégories. Définit les valeurs maximale et minimale de l'intervalle de l'axe sur QString::null.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

int QBarCategoryAxis::count() const

Renvoie le nombre de catégories.

Remarque : fonctiongetter pour la propriété count.

[signal] void QBarCategoryAxis::countChanged()

Ce signal est émis lorsque le nombre de catégories d'un axe change.

Remarque : signalde notification pour la propriété count.

void QBarCategoryAxis::insert(int index, const QString &category)

Ajoute « category » à l'axe à l'adresse index. « category » doit être une QString valide et ne doit pas exister déjà. Si « category » est ajouté au début ou à la fin d'autres catégories, les valeurs minimales et maximales de l'axe sont mises à jour en conséquence.

QString QBarCategoryAxis::max() const

Renvoie la catégorie maximale.

Remarque : fonctiongetter pour la propriété max.

Voir aussi setMax().

[signal] void QBarCategoryAxis::maxChanged(const QString &max)

Ce signal est émis lorsque la valeur de la propriété « max » de l'axe change.

Remarque : signalde notification pour la propriété « max ».

QString QBarCategoryAxis::min() const

Renvoie la catégorie minimale.

Remarque : fonctiongetter pour la propriété min.

Voir aussi setMin().

[signal] void QBarCategoryAxis::minChanged(const QString &min)

Ce signal est émis lorsque la valeur de la propriété « min » de l'axe change.

Remarque : signalde notification pour la propriété « min ».

[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

Ce signal est émis lorsque la valeur de l'axe « min » ou « max » change.

void QBarCategoryAxis::remove(const QString &category)

Supprime la catégorie « category » de l'axe. La suppression d'une catégorie qui définit actuellement la valeur maximale ou minimale de l'axe aura une incidence sur l'étendue de l'axe.

void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

Remplace oldCategory par newCategory. Si oldCategory n'existe pas sur l'axe, aucune action n'est effectuée. newCategory doit être une adresse QString valide et ne doit pas être dupliquée. Si la catégorie minimale ou maximale est remplacée, les valeurs minimales et maximales de l'axe sont mises à jour en conséquence.

void QBarCategoryAxis::setCategories(const QStringList &categories)

Définit categories et supprime les anciennes. La plage des axes est ajustée pour correspondre à la première et à la dernière catégorie de categories.

Une catégorie doit être une valeur valide de type « QString » et ne peut pas être dupliquée.

Remarque : fonctionde définition pour la propriété categories.

Voir également categories().

void QBarCategoryAxis::setMax(const QString &max)

Définit la valeur maximale de la catégorie sur « max ».

Remarque : fonctionde définition pour la propriété max.

Voir aussi max().

void QBarCategoryAxis::setMin(const QString &min)

Définit la catégorie minimale sur « min ».

Remarque : fonctionde définition pour la propriété min.

Voir aussi min().

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

Définit la plage de l'axe entre minCategory et maxCategory.

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

Réimplémente : ` QAbstractAxis::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.