Sur cette page

QBarCategoryAxis Class

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

En-tête : #include <QBarCategoryAxis>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : BarCategoryAxis
Hérite de : QAbstractAxis

Types publics

(since 6.11) enum class LabelPosition { Center, OnValue }

Propriétés

Fonctions publiques

QBarCategoryAxis(QObject *parent = nullptr)
virtual ~QBarCategoryAxis() override
void append(const QString &category)
void append(const QStringList &categories)
QString at(qsizetype index) const
QStringList categories()
void clear()
qsizetype count() const
void insert(qsizetype index, const QString &category)
QBarCategoryAxis::LabelPosition labelPosition() const
QString max() const
QString min() const
void remove(const QString &category)
void remove(qsizetype index)
void replace(const QString &oldCategory, const QString &newCategory)
void setCategories(const QStringList &categories)
void setLabelPosition(QBarCategoryAxis::LabelPosition position)
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 labelPositionChanged(QBarCategoryAxis::LabelPosition position)
void maxChanged(const QString &max)
void minChanged(const QString &min)

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 dessinées entre les repères.

Documentation sur les types de membres

[since 6.11] enum class QBarCategoryAxis::LabelPosition

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

ConstanteValeurDescription
QBarCategoryAxis::LabelPosition::Center0Les étiquettes sont centrées par rapport à la catégorie.
QBarCategoryAxis::LabelPosition::OnValue1Les libellés sont positionnés à la limite supérieure de la catégorie.

Cette énumération a été introduite dans Qt 6.11.

Documentation de la propriété

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 : qsizetype

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

Fonctions d'accès :

qsizetype count() const

Signal de notification :

void countChanged()

[since 6.11] labelPosition : LabelPosition

Cette propriété définit l'emplacement 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 la valeur.

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

QBarCategoryAxis::LabelPosition labelPosition() const
void setLabelPosition(QBarCategoryAxis::LabelPosition position)

Signal de notification :

void labelPositionChanged(QBarCategoryAxis::LabelPosition position)

max : QString

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

La valeur maximale de l'axe. La valeur indiquée doit figurer dans categories.

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.

La valeur minimale sur l'axe. La valeur indiquée doit figurer dans categories.

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.

[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Supprime l'objet « axe ».

[invokable] void QBarCategoryAxis::append(const QString &category)

Ajoute category à un axe. La valeur maximale de l'axe sera modifiée pour correspondre à la dernière valeur de 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.

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

[invokable] 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 valeur valide de ` QString ` et ne peut pas être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

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

[invokable] QString QBarCategoryAxis::at(qsizetype index) const

Renvoie la catégorie disponible à l'adresse index.

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

QStringList QBarCategoryAxis::categories()

Catégories de retours.

Remarque : fonctiongetter pour la propriété categories.

Voir aussi setCategories().

[invokable] void QBarCategoryAxis::clear()

Supprime toutes les catégories. Définit les valeurs maximale et minimale de la plage 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.

qsizetype QBarCategoryAxis::count() const

Renvoie le nombre de catégories.

Remarque : fonctiongetter pour la propriété count.

[invokable] void QBarCategoryAxis::insert(qsizetype index, const QString &category)

Ajoute « category » à l'axe à l'adresse index. « category » doit être un QString valide et ne peut pas être dupliqué. 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.

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

QString QBarCategoryAxis::max() const

Renvoie la catégorie maximale.

Remarque : fonctiongetter pour la propriété max.

Voir également setMax().

QString QBarCategoryAxis::min() const

Renvoie la catégorie minimale.

Remarque : fonctiongetter pour la propriété min.

Voir aussi setMin().

[invokable] 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.

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

[invokable] void QBarCategoryAxis::remove(qsizetype index)

Supprime une catégorie à l'adresse index 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 plage de l'axe.

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

[invokable] 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 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.

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

void QBarCategoryAxis::setCategories(const QStringList &categories)

Définit categories et supprime les anciennes valeurs. 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 ` 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 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.