Back to Qt.io
Contact Us Blog Download Qt
En esta página

QBarCategoryAxis Class

La clase QBarCategoryAxis añade categorías a los ejes de un gráfico. Más...

Header: #include <QBarCategoryAxis>
In QML: BarCategoryAxis
Inherits: QAbstractAxis

Propiedades

Funciones públicas

QBarCategoryAxis(QObject *parent = nullptr)
virtual ~QBarCategoryAxis()
void append(const QString &category)
void append(const QStringList &categories)
QString at(int index) const
QStringList categories()
void clear()
int count() const
void insert(int index, const QString &category)
QString max() const
QString min() const
void remove(const QString &category)
void replace(const QString &oldCategory, const QString &newCategory)
void setCategories(const QStringList &categories)
void setMax(const QString &max)
void setMin(const QString &min)
void setRange(const QString &minCategory, const QString &maxCategory)

Funciones públicas reimplementadas

virtual QAbstractAxis::AxisType type() const override

Señales

void categoriesChanged()
void countChanged()
void maxChanged(const QString &max)
void minChanged(const QString &min)
void rangeChanged(const QString &min, const QString &max)

Descripción Detallada

QBarCategoryAxis puede configurarse para mostrar una línea de eje con marcas de tick, líneas de cuadrícula y sombras. Las categorías se dibujan entre las marcas. También se puede utilizar con una serie de líneas, como se demuestra en la Galería de Gráficos con Widgets.

El siguiente código ilustra cómo utilizar QBarCategoryAxis:

QChartView *chartView = new QChartView;
QBarSeries *series = new QBarSeries;
// ...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();

QBarCategoryAxis *axisX = new QBarCategoryAxis;
QStringList categories;
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
axisX->append(categories);
axisX->setRange("Feb", "May");
chartView->chart()->setAxisX(axisX, series);

Documentación de Propiedades

categories : QStringList

Esta propiedad contiene las categorías de un eje.

Funciones de acceso:

QStringList categories()
void setCategories(const QStringList &categories)

Señal del notificador:

void categoriesChanged()

[read-only] count : int

Esta propiedad contiene el número de categorías de un eje.

Funciones de acceso:

int count() const

Señal del notificador:

void countChanged()

max : QString

Esta propiedad contiene el valor máximo del eje.

Funciones de acceso:

QString max() const
void setMax(const QString &max)

Señal del notificador:

void maxChanged(const QString &max)

min : QString

Esta propiedad mantiene el valor mínimo en el eje.

Funciones de acceso:

QString min() const
void setMin(const QString &min)

Señal del notificador:

void minChanged(const QString &min)

Documentación de la función miembro

[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)

Construye un objeto eje hijo de parent.

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Destruye el objeto eje.

void QBarCategoryAxis::append(const QString &category)

Añade category a un eje. El valor máximo del eje cambiará para coincidir con el último category. Si no se ha definido ninguna categoría anteriormente, el valor mínimo del eje también cambiará para coincidir con category.

Una categoría debe ser válida en QString y no puede estar duplicada. Las categorías duplicadas no se añadirán.

void QBarCategoryAxis::append(const QStringList &categories)

Añade categories a un eje. El valor máximo del eje se modificará para que coincida con la última categoría de categories. Si no se han definido categorías previamente, el valor mínimo del eje también se modificará para que coincida con la primera categoría de categories.

Una categoría debe ser válida en QString y no puede estar duplicada. Las categorías duplicadas no se añadirán.

QString QBarCategoryAxis::at(int index) const

Devuelve la categoría en index. El índice debe ser válido.

QStringList QBarCategoryAxis::categories()

Devuelve categorías.

Nota: Función Getter para categorías de propiedades.

Véase también setCategories().

[signal] void QBarCategoryAxis::categoriesChanged()

Esta señal se emite cuando cambian las categorías del eje.

Nota: Señal notificadora para la propiedad categories.

[invokable] void QBarCategoryAxis::clear()

Elimina todas las categorías. Establece los valores máximo y mínimo del rango del eje a QString::null.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

int QBarCategoryAxis::count() const

Devuelve el número de categorías.

Nota: Función Getter para la propiedad count.

[signal] void QBarCategoryAxis::countChanged()

Esta señal se emite cuando cambia el número de categorías de un eje.

Nota: Señal notificadora para la propiedad count.

void QBarCategoryAxis::insert(int index, const QString &category)

Inserta category en el eje en index. category tiene que ser un QString válido y no puede estar duplicado. Si category se antepone o añade a otras categorías, los valores mínimo y máximo del eje se actualizan en consecuencia.

QString QBarCategoryAxis::max() const

Devuelve la categoría máxima.

Nota: Función Getter para la propiedad max.

Véase también setMax().

[signal] void QBarCategoryAxis::maxChanged(const QString &max)

Esta señal se emite cuando cambia el valor max del eje.

Nota: Señal notificadora para la propiedad max.

QString QBarCategoryAxis::min() const

Devuelve la categoría mínima.

Nota: Función Getter para la propiedad min.

Véase también setMin().

[signal] void QBarCategoryAxis::minChanged(const QString &min)

Esta señal se emite cuando cambia el valor min del eje.

Nota: Señal notificadora para la propiedad min.

[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

Esta señal se emite cuando cambia el valor min o max del eje.

void QBarCategoryAxis::remove(const QString &category)

Elimina category del eje. Eliminar una categoría que actualmente establece el valor máximo o mínimo en el eje afectará al rango del eje.

void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

Sustituye oldCategory por newCategory. Si oldCategory no existe en el eje, no se hace nada. newCategory tiene que ser un QString válido y no puede duplicarse. Si se sustituye la categoría mínima o máxima, los valores mínimo y máximo del eje se actualizan en consecuencia.

void QBarCategoryAxis::setCategories(const QStringList &categories)

Establece categories y descarta los antiguos. El rango del eje se ajusta para que coincida con la primera y la última categoría de categories.

Una categoría tiene que ser una QString válida y no puede estar duplicada.

Nota: Función Setter para la propiedad categories.

Véase también categories().

void QBarCategoryAxis::setMax(const QString &max)

Establece la categoría máxima en max.

Nota: Función Setter para la propiedad max.

Véase también max().

void QBarCategoryAxis::setMin(const QString &min)

Establece la categoría mínima en min.

Nota: Función Setter para la propiedad min.

Véase también min().

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

Establece el rango del eje de minCategory a maxCategory.

[override virtual] QAbstractAxis::AxisType QBarCategoryAxis::type() const

Reimplementa: QAbstractAxis::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.