En esta página

QValue3DAxisFormatter Class

La clase `QValue3DAxisFormatter` es una clase base para los formateadores de ejes de valores. Más información...

Encabezado: #include <QValue3DAxisFormatter>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.1
En QML: ValueAxis3DFormatter
Heredado de: QObject
Heredado por:

QLogValue3DAxisFormatter

Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Funciones públicas

QValue3DAxisFormatter(QObject *parent = nullptr)
virtual ~QValue3DAxisFormatter()

Funciones protegidas

bool allowNegatives() const
bool allowZero() const
QValue3DAxis *axis() const
virtual QValue3DAxisFormatter *createNewInstance() const
QList<float> &gridPositions() const
QList<float> &labelPositions() const
QStringList &labelStrings() const
QLocale locale() const
void markDirty(bool labelsChange = false)
virtual void populateCopy(QValue3DAxisFormatter &copy) const
virtual float positionAt(float value) const
virtual void recalculate()
void setAllowNegatives(bool allow)
void setAllowZero(bool allow)
void setLocale(const QLocale &locale)
virtual QString stringForValue(qreal value, const QString &format) const
QList<float> &subGridPositions() const
virtual float valueAt(float position) const

Descripción detallada

Esta clase proporciona reglas de formato para un eje 3D de valor lineal. Crea una subclase si deseas implementar ejes de valor personalizados.

La clase base no tiene ninguna API pública más allá de los constructores y destructores. Está pensada para ser utilizada únicamente de forma interna. No obstante, las subclases pueden implementar propiedades públicas según sea necesario.

Véase también QValue3DAxis y QLogValue3DAxisFormatter.

Documentación de las funciones miembro

[explicit] QValue3DAxisFormatter::QValue3DAxisFormatter(QObject *parent = nullptr)

Crea un nuevo formateador de ejes 3D con el padre opcional « parent ».

[virtual noexcept] QValue3DAxisFormatter::~QValue3DAxisFormatter()

Elimina el valor «Formateador de ejes 3D».

[protected] bool QValue3DAxisFormatter::allowNegatives() const

Devuelve ` true ` si los valores negativos son válidos para el eje principal. La implementación por defecto siempre devuelve ` true`.

Véase también setAllowNegatives().

[protected] bool QValue3DAxisFormatter::allowZero() const

Devuelve ` true ` si «cero» es un valor válido para el eje principal. La implementación por defecto siempre devuelve ` true`.

Véase también setAllowZero().

[protected] QValue3DAxis *QValue3DAxisFormatter::axis() const

Devuelve el eje principal. Solo se debe acceder al eje principal mediante el método recalculate() para garantizar la seguridad entre subprocesos en entornos que utilicen un renderizador multihilo.

Véase también recalculate().

[virtual protected] QValue3DAxisFormatter *QValue3DAxisFormatter::createNewInstance() const

Crea un nuevo formateador de ejes 3D con valor vacío. Debe reimplementarse en una subclase.

Devuelve el nuevo formateador. El renderizador utiliza este método para almacenar en caché una copia del formateador. La propiedad de la nueva copia se transfiere al llamante.

[protected] QList<float> &QValue3DAxisFormatter::gridPositions() const

Devuelve una referencia al array de posiciones normalizadas de las líneas de la cuadrícula. El tamaño predeterminado del array es igual al número de segmentos del eje principal más uno, pero una implementación subclasificada del método recalculate() puede cambiar el tamaño del array de forma diferente. Los valores deben estar comprendidos entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos inclusive.

Véanse también QValue3DAxis::segmentCount y recalculate().

[protected] QList<float> &QValue3DAxisFormatter::labelPositions() const

Devuelve una referencia al array de posiciones normalizadas de las etiquetas. El tamaño predeterminado del array es igual al número de segmentos del eje principal más uno, pero una implementación subclasificada del método recalculate() puede cambiar el tamaño del array de otra forma. Los valores deben estar comprendidos entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos inclusive. Por defecto, la etiqueta en el índice cero corresponde al valor mínimo del eje.

Véanse también QValue3DAxis::segmentCount, QAbstract3DAxis::labels y recalculate().

[protected] QStringList &QValue3DAxisFormatter::labelStrings() const

Devuelve una referencia a la lista de cadenas que contiene las cadenas de etiqueta del formateador. El tamaño de la matriz debe ser igual al tamaño de la matriz de posiciones de las etiquetas, a las que también corresponden los índices.

Véase también labelPositions().

[protected] QLocale QValue3DAxisFormatter::locale() const

Devuelve la configuración regional actual que está utilizando este formateador.

Véase también setLocale().

[protected] void QValue3DAxisFormatter::markDirty(bool labelsChange = false)

Marca este formateador como «sucio», lo que hace que el renderizador cree una nueva copia de su caché en la siguiente sincronización del renderizador. Una subclase debe llamar a este método siempre que se modifique el formateador de tal forma que afecte a los valores resueltos. Establece ` labelsChange ` en ` true ` si el cambio requiere regenerar las cadenas de las etiquetas de los ejes principales.

[virtual protected] void QValue3DAxisFormatter::populateCopy(QValue3DAxisFormatter &copy) const

Copia todos los valores necesarios para resolver posiciones, valores y cadenas con este formateador al método ` copy ` del formateador. Al reimplementar este método en una subclase, llama a la versión de la superclase en algún momento. El renderizador utiliza este método para almacenar en caché una copia del formateador.

Devuelve la nueva copia. La propiedad de la nueva copia se transfiere al llamante.

[virtual protected] float QValue3DAxisFormatter::positionAt(float value) const

Devuelve la posición normalizada a lo largo del eje para el valor dado value. El valor devuelto debe estar comprendido entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos incluidos, si el valor se encuentra dentro del rango del eje padre.

Reimplementa este método si la posición no puede determinarse mediante interpolación lineal entre los valores mínimo y máximo del eje principal.

Véase también recalculate() y valueAt().

[virtual protected] void QValue3DAxisFormatter::recalculate()

Reequilibra el tamaño y rellena los matrices de posiciones de las etiquetas y las líneas de la cuadrícula, así como la matriz de cadenas de etiquetas, y calcula los valores necesarios para asignar un valor a su posición. Se puede acceder al eje principal desde el interior de esta función.

Este método debe reimplementarse en una subclase si el contenido predeterminado de las matrices no resulta adecuado.

Consulte los métodos gridPositions(), subGridPositions(), labelPositions() y labelStrings() para obtener documentación sobre las matrices que deben redimensionarse y rellenarse.

Véanse también gridPositions(), subGridPositions(), labelPositions(), labelStrings() y axis().

[protected] void QValue3DAxisFormatter::setAllowNegatives(bool allow)

Permite que el eje principal tenga valores negativos si « allow » tiene el valor « true ».

Véase también allowNegatives().

[protected] void QValue3DAxisFormatter::setAllowZero(bool allow)

Permite que el eje principal tenga un valor cero si « allow » es « true ».

Véase también allowZero().

[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)

Establece la configuración de « locale » que utiliza este formateador. El gráfico establece automáticamente la configuración regional del formateador en la del gráfico cada vez que el eje padre se establece como eje activo del gráfico, el formateador de ejes se asigna a un eje vinculado al gráfico o cambia la configuración regional del gráfico.

Véase también locale() y QAbstract3DGraph::locale.

[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format) const

Devuelve la cadena de etiqueta formateada utilizando los valores especificados en ` value ` y ` format`.

Reimplementa este método en una subclase para resolver la cadena formateada para un ` value ` dado si las reglas de formateo predeterminadas especificadas para la propiedad ` QValue3DAxis::labelFormat ` no son suficientes.

Véase también recalculate(), labelStrings() y QValue3DAxis::labelFormat.

[protected] QList<float> &QValue3DAxisFormatter::subGridPositions() const

Devuelve una referencia al array de posiciones normalizadas de las líneas de la subcuadrícula. El tamaño predeterminado del array es igual al número de segmentos del eje principal multiplicado por el número de subsegmentos del eje principal menos uno; sin embargo, una implementación subclasificada del método recalculate() puede cambiar el tamaño del array de forma diferente. Los valores deben estar comprendidos entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos inclusive.

Véanse también QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount y recalculate().

[virtual protected] float QValue3DAxisFormatter::valueAt(float position) const

Devuelve el valor en la coordenada normalizada position a lo largo del eje. El valor position debe estar comprendido entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos inclusive, para obtener valores dentro del rango del eje principal.

Reimplementa este método si el valor no puede resolverse mediante interpolación lineal entre los valores mínimo y máximo del eje principal.

Véase también recalculate() y positionAt().

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