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
- categories : QStringList
- count : int
- max : QString
- min : QString
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:
| void | categoriesChanged() |
[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:
Señal de notificación:
| void | maxChanged(const QString &max) |
min : QString
Esta propiedad contiene el valor mínimo del eje.
Funciones de acceso:
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.