QValue3DAxisFormatter Class
La clase `QValue3DAxisFormatter` es una clase base para los formateadores de ejes de valores 3D. Más información...
| Encabezado: | #include <QValue3DAxisFormatter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Value3DAxisFormatter |
| Heredado de: | QObject |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- QValue3DAxisFormatter forma parte de las clases C++ deQt Graphs para 3D.
Funciones públicas
| QValue3DAxisFormatter(QObject *parent = nullptr) | |
| virtual | ~QValue3DAxisFormatter() override |
Funciones protegidas
| bool | allowNegatives() const |
| bool | allowZero() const |
| QValue3DAxis * | axis() const |
| virtual QValue3DAxisFormatter * | createNewInstance() const |
| QList<float> | gridPositions() && |
| const QList<float> & | gridPositions() const & |
| QList<float> | labelPositions() && |
| const QList<float> & | labelPositions() const & |
| QStringList | labelStrings() && |
| const QStringList & | labelStrings() const & |
| QLocale | locale() const |
| void | markDirty(bool labelsChange = false) |
| virtual void | populateCopy(QValue3DAxisFormatter ©) |
| virtual float | positionAt(float value) const |
| virtual void | recalculate() |
| void | setAllowNegatives(bool allow) |
| void | setAllowZero(bool allow) |
| void | setGridPoitions(QList<float> gridPositions) |
| void | setLabelStrings(QStringList labelStrings) |
| void | setLocale(const QLocale &locale) |
| void | setSubGridPositions(QList<float> subGridPositions) |
| void | setlabelPositions(QList<float> labelPositions) |
| virtual QString | stringForValue(qreal value, const QString &format) |
| QList<float> | subGridPositions() && |
| 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. Subclasifícala 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 ».
[override 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 «zero» 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() &&
Devuelve una matriz de posiciones normalizadas de las líneas de la cuadrícula por valor. El tamaño predeterminado de la matriz 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 de la matriz de forma diferente.
Véase también QValue3DAxis::segmentCount y recalculate().
[protected] const 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.
Véase también QValue3DAxis::segmentCount y recalculate().
[protected] QList<float> QValue3DAxisFormatter::labelPositions() &&
Devuelve una matriz de posiciones normalizadas de las etiquetas por valor. El tamaño predeterminado de la matriz es igual al número de segmentos del eje principal más uno, pero una implementación subclasificada del método recalculate() puede modificar el tamaño de la matriz de forma diferente. Por defecto, la etiqueta en el índice cero se corresponde con el valor mínimo del eje.
Véanse también QValue3DAxis::segmentCount, QAbstract3DAxis::labels y recalculate().
[protected] const 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 modificar el tamaño del array de otra forma. 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() &&
Devuelve una lista de cadenas por valor que contiene las cadenas de etiqueta del formateador.
Véase también setLabelStrings() y labelPositions().
[protected] const QStringList &QValue3DAxisFormatter::labelStrings() const &
Devuelve una referencia a la lista de cadenas que contiene las cadenas de etiqueta del formateador.
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 modificado, 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 ©)
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 inclusive, si el valor se encuentra dentro del rango del eje principal.
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()
Reejunta 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. Desde el interior de esta función se puede acceder al eje principal.
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 los 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 » es « 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::setGridPoitions(QList<float> gridPositions)
Establece una lista de nuevas posiciones de la cuadrícula a partir de gridPositions. Los valores deben estar comprendidos entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos incluidos.
Véanse también QValue3DAxis::segmentCount, recalculate() y gridPositions.
[protected] void QValue3DAxisFormatter::setLabelStrings(QStringList labelStrings)
Establece una lista de nuevas cadenas de etiquetas a partir de labelStrings. El tamaño de la matriz debe ser igual al tamaño de la matriz de posiciones de etiquetas, a la que también corresponden los índices.
Véase también labelPositions() y labelStrings().
[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)
Establece el objeto « 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 principal se configura 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 Q3DGraphsWidgetItem::locale.
[protected] void QValue3DAxisFormatter::setSubGridPositions(QList<float> subGridPositions)
Establece una lista de nuevas posiciones de subcuadrícula a partir de subGridPositions. Los valores deben estar comprendidos entre 0.0 (el valor mínimo) y 1.0 (el valor máximo), ambos incluidos.
Véase también QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate() y subGridPositions.
[protected] void QValue3DAxisFormatter::setlabelPositions(QList<float> labelPositions)
Establece una lista de nuevas posiciones de etiquetas a partir de labelPositions. 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, QAbstract3DAxis::labels, recalculate() y labelPositions().
[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format)
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 formato predeterminadas especificadas para la propiedad QValue3DAxis::labelFormat no son suficientes.
Véase también recalculate(), labelStrings() y QValue3DAxis::labelFormat.
[protected] QList<float> QValue3DAxisFormatter::subGridPositions() &&
Devuelve una matriz de posiciones normalizadas de las líneas de la subcuadrícula por valor. El tamaño predeterminado de la matriz es igual al número de segmentos del eje principal multiplicado por el número de subsegmentos del eje principal menos uno, pero una implementación de una subclase del método recalculate() puede cambiar el tamaño de la matriz de forma diferente.
Véase también setSubGridPositions(), QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount y recalculate().
[protected] const QList<float> &QValue3DAxisFormatter::subGridPositions() const &
Devuelve una referencia a la matriz de posiciones normalizadas de las líneas de la subcuadrícula. El tamaño predeterminado de la matriz 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 modificar el tamaño de la matriz de otra forma.
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 de 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éanse 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.