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 |
- Lista de todos los miembros, incluidos los heredados
- QBarCategoryAxis forma parte de las clases C++ de «Qt Graphs » para 2D.
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.
| Constante | Valor | Descripción |
|---|---|---|
QBarCategoryAxis::LabelPosition::Center | 0 | Las etiquetas están centradas en la categoría. |
QBarCategoryAxis::LabelPosition::OnValue | 1 | Las 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:
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:
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.