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. Plus d'informations...

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

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 marques de pointage, des lignes de grille et des nuances. Les catégories sont dessinées entre les points. Il peut également être utilisé avec une série de lignes, comme le montre la galerie Charts with 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 sur les 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é contient 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 sur l'axe.

Fonctions d'accès :

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

Signal de notification :

void minChanged(const QString &min)

Member Function Documentation

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

Construit un objet axe qui est l'enfant de parent.

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Détruit 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 ê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 une catégorie valide QString et ne peut être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

QString QBarCategoryAxis::at(int index) const

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

QStringList QBarCategoryAxis::categories()

Renvoie les catégories.

Note : Fonction Getter pour les catégories de propriétés.

Voir également setCategories().

[signal] void QBarCategoryAxis::categoriesChanged()

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

Note : Signal de notification pour la propriété categories.

[invokable] void QBarCategoryAxis::clear()

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

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

int QBarCategoryAxis::count() const

Renvoie le nombre de catégories.

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

[signal] void QBarCategoryAxis::countChanged()

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

Note : Signal de notification pour la propriété count.

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

Insère category dans l'axe à index. category doit être un QString valide et ne peut être dupliqué. Si category est ajouté ou annexé à 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.

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

Voir également setMax().

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

Ce signal est émis lorsque la valeur max de l'axe change.

Note : Signal de notification pour la propriété max.

QString QBarCategoryAxis::min() const

Renvoie la catégorie minimale.

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

Voir également setMin().

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

Ce signal est émis lorsque la valeur min de l'axe change.

Note : Signal de notification pour la propriété min.

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

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

void QBarCategoryAxis::remove(const QString &category)

Supprime 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 la portée de l'axe.

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

Remplace oldCategory par newCategory. Si oldCategory n'existe pas sur l'axe, rien n'est fait. newCategory doit être un QString valide et ne peut être dupliqué. 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 rejette les anciennes. La plage d'axes est ajustée pour correspondre à la première et à la dernière catégorie de categories.

Une catégorie doit être une QString valide et ne peut pas être dupliquée.

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

Voir également categories().

void QBarCategoryAxis::setMax(const QString &max)

Fixe la catégorie maximale à max.

Note : Fonction de définition de la propriété max.

Voir également max().

void QBarCategoryAxis::setMin(const QString &min)

Fixe la catégorie minimale à min.

Note : Fonction de définition de la propriété min.

Voir également min().

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

Définit la plage de l'axe de minCategory à 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.