QBarCategoryAxis Class
La classe QBarCategoryAxis ajoute des catégories aux axes d'un graphique. Plus d'informations...
| 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éritages : | QAbstractAxis |
- Liste de tous les membres, y compris les membres hérités
- QBarCategoryAxis fait partie de Qt Graphs Classes C++ pour 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 marques de pointage, des lignes de grille et des nuances. Les catégories sont dessinées entre les points.
Type de membre Documentation
[since 6.11] enum class QBarCategoryAxis::LabelPosition
Cette énumération décrit la position des étiquettes de catégorie.
| Constante | Valeur | Description |
|---|---|---|
QBarCategoryAxis::LabelPosition::Center | 0 | Les étiquettes sont centrées sur la catégorie. |
QBarCategoryAxis::LabelPosition::OnValue | 1 | Les étiquettes sont positionnées à la limite supérieure de la catégorie. |
Cette liste a été introduite dans Qt 6.11.
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 : qsizetype
Cette propriété contient 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 la position des étiquettes des catégories. Les étiquettes au début et à la fin des axes peuvent chevaucher les étiquettes d'autres axes lorsqu'elles sont positionnées sur la valeur.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QBarCategoryAxis::LabelPosition | labelPosition() const |
| void | setLabelPosition(QBarCategoryAxis::LabelPosition position) |
Signal Notificateur :
| void | labelPositionChanged(QBarCategoryAxis::LabelPosition position) |
max : QString
Cette propriété contient la valeur maximale de l'axe.
La valeur maximale sur l'axe. La valeur donnée doit être contenue 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 donnée doit être contenue dans categories.
Fonctions d'accès :
Signal Notificateur :
| void | minChanged(const QString &min) |
Member Function Documentation
[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)
Construit un objet axe qui est l'enfant de parent.
[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()
Détruit 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 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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 catégorie valide QString et ne peut être dupliquée. Les catégories dupliquées ne seront pas ajoutées.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QString QBarCategoryAxis::at(qsizetype index) const
Renvoie la catégorie à index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QStringList QBarCategoryAxis::categories()
Renvoie les catégories.
Note : Fonction Getter pour les catégories de propriétés.
Voir également setCategories().
[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.
qsizetype QBarCategoryAxis::count() const
Renvoie le nombre de catégories.
Note : Fonction Getter pour le nombre de propriétés.
[invokable] void QBarCategoryAxis::insert(qsizetype 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é à d'autres catégories, les valeurs minimales et maximales de l'axe sont mises à jour en conséquence.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QString QBarCategoryAxis::max() const
Renvoie la catégorie maximale.
Note : Fonction Getter pour la propriété max.
Voir également setMax().
QString QBarCategoryAxis::min() const
Renvoie la catégorie minimale.
Note : Fonction Getter pour la propriété min.
Voir également setMin().
[invokable] 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QBarCategoryAxis::remove(qsizetype index)
Supprime une catégorie de l'axe à l'adresse index. 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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, 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
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.
