QBarCategoryAxis Class
La clase QBarCategoryAxis añade categorías a los ejes de un gráfico. Más...
| Cabecera: | #include <QBarCategoryAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | BarCategoryAxis |
| Hereda: | QAbstractAxis |
- Lista de todos los miembros, incluyendo los heredados
- QBarCategoryAxis es parte de Qt Graphs C++ Classes for 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 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.
Documentación del tipo de miembro
[since 6.11] enum class QBarCategoryAxis::LabelPosition
Este enum describe la posición de las etiquetas de categoría.
| Constante | Valor | Descripción |
|---|---|---|
QBarCategoryAxis::LabelPosition::Center | 0 | Las etiquetas están centradas en la categoría. |
QBarCategoryAxis::LabelPosition::OnValue | 1 | Las etiquetas se posicionan en el límite superior de la categoría. |
Este enum 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 del notificador:
| void | categoriesChanged() |
[read-only] count : qsizetype
Esta propiedad contiene el número de categorías de un eje.
Funciones de acceso:
| qsizetype | count() const |
Señal del notificador:
| void | countChanged() |
[since 6.11] labelPosition : LabelPosition
Esta propiedad contiene la posición de las etiquetas de categoría. Las etiquetas del principio y del final de los ejes pueden solaparse con las etiquetas de otros ejes cuando se posicionan sobre el valor.
Esta propiedad se introdujo en Qt 6.11.
Funciones de acceso:
| QBarCategoryAxis::LabelPosition | labelPosition() const |
| void | setLabelPosition(QBarCategoryAxis::LabelPosition position) |
Señal del notificador:
| void | labelPositionChanged(QBarCategoryAxis::LabelPosition position) |
max : QString
Esta propiedad contiene el valor máximo del eje.
El valor máximo del eje. El valor dado debe estar contenido en categories.
Funciones de acceso:
Señal del notificador:
| void | maxChanged(const QString &max) |
min : QString
Esta propiedad contiene el valor mínimo del eje.
El valor mínimo del eje. El valor dado debe estar contenido en categories.
Funciones de acceso:
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.
[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()
Destruye el objeto eje.
[invokable] 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.
Nota: Esta función puede invocarse 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 válida en QString y no puede estar duplicada. Las categorías duplicadas no se añadirán.
Nota: Esta función puede invocarse 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QStringList QBarCategoryAxis::categories()
Devuelve categorías.
Nota: Función Getter para categorías de propiedades.
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 a QString::null.
Nota: Esta función puede invocarse 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ón Getter para la propiedad count.
[invokable] void QBarCategoryAxis::insert(qsizetype 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.
Nota: Esta función puede invocarse 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ón Getter para la propiedad max.
Véase también setMax().
QString QBarCategoryAxis::min() const
Devuelve la categoría mínima.
Nota: Función Getter para la propiedad min.
Véase también setMin().
[invokable] void QBarCategoryAxis::remove(const QString &category)
Elimina category del eje. La eliminación de una categoría que actualmente establece el valor máximo o mínimo en el eje afectará al rango del eje.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QBarCategoryAxis::remove(qsizetype index)
Elimina una categoría en index del eje. Eliminar una categoría que actualmente establece el valor máximo o mínimo en el eje afectará al rango del eje.
Nota: Esta función puede invocarse 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 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.
Nota: Esta función puede invocarse 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 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.
