En esta página

QAbstractAxis Class

La clase `QAbstractAxis` es una clase base que se utiliza para clases de ejes especializadas. Más información...

Encabezado: #include <QAbstractAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: AbstractAxis
Heredado de: QObject
Heredado por:

QBarCategoryAxis, QDateTimeAxis, QLogValueAxis y QValueAxis

Tipos públicos

enum class AxisType { Value, BarCategory, DateTime, LogValue }

Propiedades

Funciones públicas

virtual ~QAbstractAxis() override
Qt::Alignment alignment() const
QColor color() const
void hide()
bool isGridVisible() const
bool isLineVisible() const
bool isSubGridVisible() const
bool isTitleVisible() const
bool isVisible() const
QQmlComponent *labelDelegate() const
qreal labelsAngle() const
bool labelsVisible() const
void setAlignment(Qt::Alignment alignment)
void setColor(QColor color)
void setGridVisible(bool visible = true)
void setLabelDelegate(QQmlComponent *newLabelDelegate)
void setLabelsAngle(qreal angle)
void setLabelsVisible(bool visible = true)
void setLineVisible(bool visible = true)
void setMax(const QVariant &max)
void setMin(const QVariant &min)
void setRange(const QVariant &min, const QVariant &max)
void setSubColor(QColor color)
void setSubGridVisible(bool visible = true)
void setTextElideMode(Qt::TextElideMode elideMode)
void setTitleColor(QColor color)
void setTitleFont(const QFont &font)
void setTitleText(const QString &title)
void setTitleVisible(bool visible = true)
void setVisible(bool visible = true)
void show()
QColor subColor() const
Qt::TextElideMode textElideMode() const
QColor titleColor() const
QFont titleFont() const
QString titleText() const
virtual QAbstractAxis::AxisType type() const = 0

Señales

void alignmentChanged(Qt::Alignment alignment)
void colorChanged(QColor newColor)
void gridVisibleChanged(bool visible)
void labelDelegateChanged()
void labelsAngleChanged(qreal angle)
void labelsVisibleChanged(bool visible)
void lineVisibleChanged(bool visible)
void subColorChanged(QColor newColor)
void subGridVisibleChanged(bool visible)
void textElideModeChanged(Qt::TextElideMode elideMode)
void titleColorChanged(QColor color)
void titleFontChanged(const QFont &font)
void titleTextChanged(const QString &title)
void titleVisibleChanged(bool visible)
void update()
void visibleChanged(bool visible)

Descripción detallada

Cada serie solo puede vincularse a un eje horizontal y a un eje vertical.

Las propiedades y la visibilidad de los distintos elementos de los ejes, como la línea del eje, el título, las etiquetas y las líneas de cuadrícula, se pueden controlar de forma individual.

Documentación sobre tipos de miembros

enum class QAbstractAxis::AxisType

Este tipo de enumeración especifica el tipo del objeto de eje.

ConstanteValor
QAbstractAxis::AxisType::Value0
QAbstractAxis::AxisType::BarCategory1
QAbstractAxis::AxisType::DateTime2
QAbstractAxis::AxisType::LogValue (since Qt 6.12)3

Documentación de la propiedad

[since 6.9] alignment : Qt::Alignment

Esta propiedad determina la alineación del eje.

Puede ser « Qt::AlignLeft », « Qt::AlignRight », « Qt::AlignBottom » o « Qt::AlignTop ».

Esta enumeración se introdujo en Qt 6.9.

Funciones de acceso:

Qt::Alignment alignment() const
void setAlignment(Qt::Alignment alignment)

Señal de notificador:

void alignmentChanged(Qt::Alignment alignment)

color : QColor

Esta propiedad determina el color que se utiliza para dibujar las marcas principales y la línea del eje.

Anula el color del tema, incluso si este cambia.

Funciones de acceso:

QColor color() const
void setColor(QColor color)

Señal del notificador:

void colorChanged(QColor newColor)

gridVisible : bool

Esta propiedad controla la visibilidad de las líneas de la cuadrícula. Por defecto, el valor es « true ».

Funciones de acceso:

bool isGridVisible() const
void setGridVisible(bool visible = true)

Señal de notificación:

void gridVisibleChanged(bool visible)

labelDelegate : QQmlComponent*

Esta propiedad contiene un componente QML personalizado que se utiliza como etiqueta para el eje. Este componente debe ser un componente « Text » o contener «texto de cadena de propiedad», de modo que a esta propiedad se le asigne el valor de la etiqueta.

Funciones de acceso:

QQmlComponent *labelDelegate() const
void setLabelDelegate(QQmlComponent *newLabelDelegate)

Señal de notificación:

void labelDelegateChanged()

labelsAngle : qreal

Esta propiedad almacena el ángulo de las etiquetas de los ejes en grados.

Funciones de acceso:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

Señal de notificación:

void labelsAngleChanged(qreal angle)

labelsVisible : bool

Esta propiedad determina si las etiquetas de los ejes están visibles. Por defecto, el valor es « true ».

Funciones de acceso:

bool labelsVisible() const
void setLabelsVisible(bool visible = true)

Señal de notificación:

void labelsVisibleChanged(bool visible)

lineVisible : bool

Esta propiedad determina la visibilidad de la línea del eje. Por defecto, el valor es « true ».

Funciones de acceso:

bool isLineVisible() const
void setLineVisible(bool visible = true)

Señal del notificador:

void lineVisibleChanged(bool visible)

subColor : QColor

Esta propiedad define el color utilizado para dibujar las submarcas.

Anula el color del tema incluso si este cambia.

Funciones de acceso:

QColor subColor() const
void setSubColor(QColor color)

Señal de notificador:

void subColorChanged(QColor newColor)

subGridVisible : bool

Esta propiedad determina la visibilidad de las líneas de la subcuadrícula.

Solo se aplica a los ejes que admiten líneas de subcuadrícula. Por defecto, el valor es « true ».

Funciones de acceso:

bool isSubGridVisible() const
void setSubGridVisible(bool visible = true)

Señal de notificación:

void subGridVisibleChanged(bool visible)

[since 6.10] textElideMode : Qt::TextElideMode

Esta propiedad especifica la ubicación de los puntos suspensivos en el texto que se sale del espacio disponible.

Puede ser « Qt::ElideLeft », « Qt::ElideRight », « Qt::ElideMiddle » o « Qt::ElideNone ». Por defecto, el valor es « Qt::ElideNone ».

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

Qt::TextElideMode textElideMode() const
void setTextElideMode(Qt::TextElideMode elideMode)

Señal del notificador:

void textElideModeChanged(Qt::TextElideMode elideMode)

titleColor : QColor

Esta propiedad define el color que se utiliza para dibujar el texto del título.

Funciones de acceso:

QColor titleColor() const
void setTitleColor(QColor color)

Señal de notificación:

void titleColorChanged(QColor color)

titleFont : QFont

Esta propiedad define el tipo de letra del título del eje.

Funciones de acceso:

QFont titleFont() const
void setTitleFont(const QFont &font)

Señal de notificación:

void titleFontChanged(const QFont &font)

titleText : QString

Esta propiedad contiene el título del eje.

Está vacía por defecto. Los títulos de los ejes admiten formato HTML.

Funciones de acceso:

QString titleText() const
void setTitleText(const QString &title)

Señal del notificador:

void titleTextChanged(const QString &title)

titleVisible : bool

Esta propiedad determina la visibilidad del título del eje.

Por defecto, el valor es « true ».

Funciones de acceso:

bool isTitleVisible() const
void setTitleVisible(bool visible = true)

Señal de notificación:

void titleVisibleChanged(bool visible)

visible : bool

Esta propiedad determina la visibilidad del eje. Por defecto, el valor es « true ».

Funciones de acceso:

bool isVisible() const
void setVisible(bool visible = true)

Señal del notificador:

void visibleChanged(bool visible)

Documentación de funciones de miembro

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

Elimina el objeto «eje». Cuando el eje se añade a un gráfico, el objeto «gráfico» asume la propiedad del mismo.

void QAbstractAxis::hide()

Oculta los ejes, las etiquetas y las líneas de la cuadrícula.

void QAbstractAxis::setLineVisible(bool visible = true)

Determina si la línea del eje y las marcas de graduación son « visible ».

Nota: Funciónde configuración para la propiedad ` lineVisible`.

Véase también isLineVisible().

void QAbstractAxis::setMax(const QVariant &max)

Establece el valor máximo que se muestra en el eje. Dependiendo del tipo concreto de eje, el parámetro « max » se convierte al tipo de valor adecuado. Si la conversión no es posible, la llamada a la función no realiza ninguna acción.

void QAbstractAxis::setMin(const QVariant &min)

Establece el valor mínimo que se muestra en el eje. Dependiendo del tipo concreto de eje, el parámetro « min » se convierte al tipo de valor adecuado. Si la conversión no es posible, la llamada a la función no produce ningún efecto.

void QAbstractAxis::setRange(const QVariant &min, const QVariant &max)

Establece el rango que se muestra en el eje. Dependiendo del tipo concreto de eje, los parámetros « min » y « max » se convierten a los tipos de valores adecuados. Si la conversión no es posible, la llamada a la función no realiza ninguna acción.

void QAbstractAxis::setTitleColor(QColor color)

Establece el color utilizado para dibujar los títulos en ` color`.

Nota: Funciónde asignación para la propiedad titleColor.

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

void QAbstractAxis::setTitleFont(const QFont &font)

Establece la fuente utilizada para dibujar los títulos en « font ».

Nota: Funciónde asignación para la propiedad titleFont.

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

void QAbstractAxis::setVisible(bool visible = true)

Establece la visibilidad del eje, las etiquetas y las líneas de cuadrícula en « visible ».

Nota: Funciónde asignación para la propiedad visible.

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

void QAbstractAxis::show()

Muestra los ejes, las etiquetas y las líneas de la cuadrícula.

QColor QAbstractAxis::titleColor() const

Devuelve el color utilizado para dibujar los títulos.

Nota: Funcióngetter para la propiedad titleColor.

Véase también setTitleColor().

QFont QAbstractAxis::titleFont() const

Devuelve la fuente utilizada para dibujar los títulos.

Nota: Funcióngetter para la propiedad titleFont.

Véase también setTitleFont().

[pure virtual] QAbstractAxis::AxisType QAbstractAxis::type() const

Devuelve el tipo del eje.

[signal] void QAbstractAxis::update()

Esta señal se emite cuando es necesario actualizar el 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.