En esta página

QBarCategoryAxis Class

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

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

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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 se puede configurar para mostrar una línea de eje con marcas de escala, líneas de cuadrícula y sombreados. Las categorías se dibujan entre las marcas de escala. También se puede utilizar con una serie de líneas, tal y como se muestra en la galería «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 de notificación:

[read-only] count : int

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

Funciones de acceso:

int count() const

Señal de notificación:

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 de notificación:

void maxChanged(const QString &max)

min : QString

Esta propiedad contiene el valor mínimo del eje.

Funciones de acceso:

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

Señal de notificación:

void minChanged(const QString &min)

Documentación de funciones de miembro

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

Crea un objeto de eje que es un elemento secundario de parent.

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Elimina el objeto «axis».

void QBarCategoryAxis::append(const QString &category)

Añade « category » a un eje. El valor máximo del eje se modificará para que coincida con el último « category ». Si no se han definido categorías anteriormente, el valor mínimo del eje también se modificará para que coincida con « category ».

Una categoría debe ser un QString válido 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 un QString válido 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 las categorías.

Nota: Funcióngetter para la propiedad «categories».

Véase también ` setCategories()`.

[signal] void QBarCategoryAxis::categoriesChanged()

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

Nota: Señalde notificación 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 en QString::null.

Nota: Esta función se puede invocar 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óngetter 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ñalde notificación para la propiedad « count ».

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

Inserta « category » en el eje en « index ». « category » debe ser un « QString » válido y no puede estar duplicado. Si « category » se antepone o se añade al final de 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óngetter 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 de la propiedad « max » del eje.

Nota: Señalde notificación para la propiedad « max ».

QString QBarCategoryAxis::min() const

Devuelve la categoría mínima.

Nota: Funcióngetter 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 de la propiedad « min » del eje.

Nota: Señalde notificación para la propiedad « min ».

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

Esta señal se emite cuando cambia el valor de un eje « min » o « max ».

void QBarCategoryAxis::remove(const QString &category)

Elimina « category » del eje. Si se elimina una categoría que actualmente establece el valor máximo o mínimo del eje, esto 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 realiza ninguna acción. newCategory debe ser una dirección válida de QString y no puede estar duplicada. 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 de los ejes se ajusta para que coincida con la primera y la última categoría de categories.

Una categoría debe ser un valor válido de « QString » y no puede estar duplicada.

Nota: Funciónde asignación 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ónde asignación 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ónde asignación para la propiedad min.

Véase también ` min()`.

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

Establece el rango del eje entre minCategory y 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.