En esta página

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

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:

Recorte de una captura de pantalla en el que se muestra el eje Y clasificado en primer, segundo y tercer lugar

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.

ConstanteValorDescripción
QCategoryAxis::AxisLabelsPositionCenter0x0Las etiquetas están centradas en la categoría.
QCategoryAxis::AxisLabelsPositionOnValue0x1Las 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.