QCategoryAxis Class
La clase `QCategoryAxis` coloca rangos con nombre en el eje. Más información...
| Header: | #include <QCategoryAxis> |
| In QML: | CategoryAxis |
| Inherits: | QValueAxis |
| Status: | Deprecated |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Tipos públicos
| enum | AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue } |
Propiedades
- categoriesLabels : QStringList
- count : int
- labelsPosition : AxisLabelsPosition
- startValue : qreal
Funciones públicas
| QCategoryAxis(QObject *parent = nullptr) | |
| virtual | ~QCategoryAxis() |
| void | append(const QString &categoryLabel, qreal categoryEndValue) |
| QStringList | categoriesLabels() |
| int | count() const |
| qreal | endValue(const QString &categoryLabel) const |
| QCategoryAxis::AxisLabelsPosition | labelsPosition() const |
| void | remove(const QString &categoryLabel) |
| void | replaceLabel(const QString &oldLabel, const QString &newLabel) |
| void | setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) |
| void | setStartValue(qreal min) |
| qreal | startValue(const QString &categoryLabel = QString()) const |
Funciones públicas reimplementadas
| virtual QAbstractAxis::AxisType | type() const override |
Señales
| void | categoriesChanged() |
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
Descripción detallada
Esta clase se puede utilizar para explicar los datos subyacentes añadiendo categorías etiquetadas. A diferencia de ` QBarCategoryAxis`, `QCategoryAxis` permite especificar libremente los anchos de los rangos de las categorías.
Código de ejemplo sobre cómo utilizar QCategoryAxis:

QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);
QCategoryAxis *axisY = new QCategoryAxis;
axisY->setMin(0);
axisY->setMax(52);
axisY->setStartValue(15);
axisY->append("First", 20);
axisY->append("Second", 37);
axisY->append("Third", 52);
chartView->chart()->setAxisY(axisY, series);Documentación sobre los tipos de miembros
enum QCategoryAxis::AxisLabelsPosition
Esta enumeración describe la posición de las etiquetas de las categorías.
| Constante | Valor | Descripción |
|---|---|---|
QCategoryAxis::AxisLabelsPositionCenter | 0x0 | Las etiquetas están centradas en la categoría. |
QCategoryAxis::AxisLabelsPositionOnValue | 0x1 | Las etiquetas se sitúan en el límite superior de la categoría. |
Documentación de la propiedad
[read-only] categoriesLabels : QStringList
Esta propiedad contiene las etiquetas de categoría en forma de lista de cadenas.
Funciones de acceso:
| QStringList | categoriesLabels() |
[read-only] count : int
Esta propiedad contiene el número de categorías.
Funciones de acceso:
| int | count() const |
labelsPosition : AxisLabelsPosition
Esta propiedad determina la posición de las etiquetas de categoría. Las etiquetas situadas al principio y al final de los ejes pueden solaparse con las de otros ejes cuando se colocan en función del valor.
Funciones de acceso:
| QCategoryAxis::AxisLabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) |
Señal de notificación:
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
startValue : qreal
Esta propiedad representa el extremo inferior de la primera categoría en el eje.
Funciones de acceso:
| qreal | startValue(const QString &categoryLabel = QString()) const |
| void | setStartValue(qreal min) |
Documentación de las funciones de miembro
[explicit] QCategoryAxis::QCategoryAxis(QObject *parent = nullptr)
Crea un objeto de eje que es un elemento secundario de parent.
[virtual noexcept] QCategoryAxis::~QCategoryAxis()
Destruye el objeto.
void QCategoryAxis::append(const QString &categoryLabel, qreal categoryEndValue)
Añade una nueva categoría al eje con la etiqueta « categoryLabel ». La etiqueta de una categoría debe ser única. « categoryEndValue » especifica el límite superior de la categoría. Debe ser mayor que el límite superior de la categoría anterior. De lo contrario, el método finaliza sin añadir ninguna nueva categoría.
[signal] void QCategoryAxis::categoriesChanged()
Esta señal se emite cuando cambian las categorías del eje.
QStringList QCategoryAxis::categoriesLabels()
Devuelve la lista de las etiquetas de las categorías.
Nota: Funcióngetter para la propiedad categoriesLabels.
int QCategoryAxis::count() const
Devuelve el número de categorías.
Nota: Funcióngetter para la propiedad «count».
qreal QCategoryAxis::endValue(const QString &categoryLabel) const
Devuelve el límite máximo de la categoría especificada por « categoryLabel ».
void QCategoryAxis::remove(const QString &categoryLabel)
Elimina del eje una categoría especificada por la etiqueta « categoryLabel ».
void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel)
Sustituye una etiqueta de categoría existente especificada por ` oldLabel ` por ` newLabel`. Si la etiqueta anterior no existe, el método devuelve un valor sin realizar ningún cambio.
void QCategoryAxis::setStartValue(qreal min)
Establece ` min ` como el límite inferior de la primera categoría del eje. Si ya se han añadido categorías al eje, el valor pasado debe ser inferior al valor superior del intervalo de la primera categoría ya definida. De lo contrario, no se realiza ninguna acción.
Nota: Funciónde asignación para la propiedad startValue.
Véase también startValue().
qreal QCategoryAxis::startValue(const QString &categoryLabel = QString()) const
Devuelve el límite inferior de la categoría especificada por ` categoryLabel`.
Nota: Funcióngetter para la propiedad startValue.
Véase también setStartValue().
[override virtual] QAbstractAxis::AxisType QCategoryAxis::type() const
Reimplementa: ` QValueAxis::type()` const.
Devuelve el tipo del eje.
© 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.