En esta página

QBarCategoryAxis Class

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

Encabezado: #include <QBarCategoryAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: BarCategoryAxis
Heredan de: QAbstractAxis

Tipos públicos

(since 6.11) enum class LabelPosition { Center, OnValue }

Propiedades

Funciones públicas

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)

Funciones públicas reimplementadas

virtual QAbstractAxis::AxisType type() const override

Señales

void categoriesChanged()
void countChanged()
void labelPositionChanged(QBarCategoryAxis::LabelPosition position)
void maxChanged(const QString &max)
void minChanged(const QString &min)

Descripción detallada

QBarCategoryAxis se puede configurar para mostrar una línea de eje con marcas de graduación, líneas de cuadrícula y sombreados. Las categorías se dibujan entre las marcas de graduación.

Documentación sobre los tipos de miembros

[since 6.11] enum class QBarCategoryAxis::LabelPosition

Esta enumeración describe la posición de las etiquetas de las categorías.

ConstanteValorDescripción
QBarCategoryAxis::LabelPosition::Center0Las etiquetas están centradas en la categoría.
QBarCategoryAxis::LabelPosition::OnValue1Las etiquetas se sitúan en el límite superior de la categoría.

Esta enumeración se introdujo en Qt 6.11.

Documentación de la propiedad

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:

void categoriesChanged()

[read-only] count : qsizetype

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

Funciones de acceso:

qsizetype count() const

Señal de notificación:

void countChanged()

[since 6.11] labelPosition : LabelPosition

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 etiquetas de otros ejes cuando se colocan en función del valor.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QBarCategoryAxis::LabelPosition labelPosition() const
void setLabelPosition(QBarCategoryAxis::LabelPosition position)

Señal de notificación:

void labelPositionChanged(QBarCategoryAxis::LabelPosition position)

max : QString

Esta propiedad contiene el valor máximo del eje.

El valor máximo del eje. El valor indicado debe estar incluido en categories.

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.

El valor mínimo del eje. El valor indicado debe estar incluido en categories.

Funciones de acceso:

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

Señal de notificador:

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.

[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Elimina el objeto «axis».

[invokable] 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 previamente, 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.

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

[invokable] 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.

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

[invokable] QString QBarCategoryAxis::at(qsizetype index) const

Devuelve la categoría en index.

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

QStringList QBarCategoryAxis::categories()

Devuelve las categorías.

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

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

[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.

qsizetype QBarCategoryAxis::count() const

Devuelve el número de categorías.

Nota: Funcióngetter para la propiedad count.

[invokable] void QBarCategoryAxis::insert(qsizetype 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.

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

QString QBarCategoryAxis::max() const

Devuelve la categoría máxima.

Nota: Funcióngetter para la propiedad max.

Véase también setMax().

QString QBarCategoryAxis::min() const

Devuelve la categoría mínima.

Nota: Funcióngetter para la propiedad min.

Véase también setMin().

[invokable] void QBarCategoryAxis::remove(const QString &category)

Elimina la categoría « 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.

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

[invokable] void QBarCategoryAxis::remove(qsizetype index)

Elimina del eje una categoría situada en index. Si se elimina una categoría que actualmente establece el valor máximo o mínimo del eje, esto afectará al rango del eje.

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

[invokable] 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 un QString válido y no puede estar duplicado. Si se sustituye la categoría mínima o máxima, los valores mínimo y máximo del eje se actualizan en consecuencia.

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

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 QString válido 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.