QValue3DAxisFormatter Class

Documentación de funciones miembro

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

Construye un nuevo formateador de ejes 3D con el padre opcional parent.

[virtual noexcept] QValue3DAxisFormatter::~QValue3DAxisFormatter()

Borra el valor Formateador de ejes 3D.

[protected] bool QValue3DAxisFormatter::allowNegatives() const

Devuelve true si los valores negativos son valores válidos para el eje padre. 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 padre. La implementación por defecto siempre devuelve true.

Véase también setAllowZero().

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

Devuelve el eje padre. Sólo se debe acceder al eje padre en el método recalculate() para mantener la seguridad de los hilos en entornos que utilicen un renderizador con hilos.

Véase también recalculate().

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

Crea un nuevo formateador de ejes 3D de valor vacío. Debe ser reimplementado 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 a la persona que llama.

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

Devuelve una referencia a la matriz de posiciones normalizadas de las líneas de la cuadrícula. El tamaño de la matriz por defecto es igual al recuento de segmentos del eje padre más uno, pero una implementación subclasificada del método recalculate() puede redimensionar la matriz 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éase también QValue3DAxis::segmentCount y recalculate().

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

Devuelve una referencia a la matriz de posiciones normalizadas de etiquetas. El tamaño predeterminado de la matriz es igual al recuento de segmentos del eje padre más uno, pero una implementación subclasificada del método recalculate() puede redimensionar la matriz de forma diferente. 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éase 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 etiquetas del formateador. El tamaño del array debe ser igual al tamaño del array de posiciones de etiquetas, al que también corresponden los índices.

Véase también labelPositions().

[protected] QLocale QValue3DAxisFormatter::locale() const

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

Véase también setLocale().

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

Marca este formateador como sucio, indicando al renderizador que haga una nueva copia de su caché en la próxima sincronización del renderizador. Este método debería ser llamado por una subclase siempre que el formateador sea cambiado de forma que afecte a los valores resueltos. Establezca labelsChange a true si el cambio requiere regenerar las cadenas de etiquetas del eje padre.

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

Copia todos los valores necesarios para resolver posiciones, valores y cadenas con este formateador en copy del formateador. Cuando reimplemente este método en una subclase, llame 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 a quien la llama.

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

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

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

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

[virtual protected] void QValue3DAxisFormatter::recalculate()

Redimensiona y rellena las matrices de posición de etiquetas y líneas de rejilla y la matriz de cadenas de etiquetas, además de calcular los valores necesarios para asignar un valor a su posición. Se puede acceder al eje padre desde esta función.

Este método debe ser reimplementado en una subclase si los contenidos de la matriz por defecto no son adecuados.

Ver los métodos gridPositions(), subGridPositions(), labelPositions(), y labelStrings() para documentación sobre los arrays que necesitan ser redimensionados y rellenados.

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

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

Permite que el eje padre tenga valores negativos si allow es true.

Véase también allowNegatives().

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

Permite que el eje padre tenga un valor cero si allow es true.

Véase también allowZero().

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

Establece la locale que utiliza este formateador. El gráfico establece automáticamente la configuración regional del formateador a la configuración regional de un gráfico siempre que el eje padre se establezca como eje activo del gráfico, el formateador de ejes se establezca a un eje adjunto al gráfico o la configuración regional del gráfico cambie.

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

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

Devuelve la cadena formateada de la etiqueta utilizando las propiedades value y format especificadas.

Reimplemente 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 a la matriz de posiciones de línea de submalla normalizada. El tamaño de la matriz por defecto es igual al recuento de segmentos del eje padre multiplicado por el recuento de subsegmentos del eje padre menos uno, pero una implementación subclasificada del método recalculate() puede redimensionar la matriz 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éase también QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, y recalculate().

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

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

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

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