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 |
- Liste de tous les membres, y compris les membres hérités
- QBarCategoryAxis fait partie des classes C++ d'Qt Graphs s pour le 2D.
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.
| Constante | Valeur | Description |
|---|---|---|
QBarCategoryAxis::LabelPosition::Center | 0 | Les étiquettes sont centrées par rapport à la catégorie. |
QBarCategoryAxis::LabelPosition::OnValue | 1 | Les 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 :
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 :
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.