Q3DGraphsWidgetItem Class

Documentación de propiedades

activeTheme : QGraphsTheme*

Esta propiedad contiene el tema activo del gráfico.

Establece activeTheme como el tema activo que se utilizará para el gráfico. Llama implícitamente a addTheme() para transferir la propiedad del tema a este gráfico.

Si activeTheme es nulo, se crea un tema temporal por defecto. Este tema temporal se destruye si posteriormente se establece explícitamente algún tema. Las propiedades del tema pueden modificarse incluso después de establecerlo, y las modificaciones surten efecto inmediatamente.

Funciones de acceso:

Señal del notificador:

ambientLightStrength : float

Esta propiedad contiene la intensidad de la luz ambiental para todo el gráfico.

Este valor determina la uniformidad y el brillo con que se muestran los colores en todo el gráfico, independientemente de la posición de la luz.

El valor debe estar comprendido entre 0.0f y 1.0f.

Funciones de acceso:

Señal del notificador:

aspectRatio : qreal

Esta propiedad contiene la relación de la escala del gráfico entre el eje más largo en el plano horizontal y el eje y.

Por defecto es 2.0.

Funciones de acceso:

Señal del notificador:

Véase también horizontalAspectRatio.

cameraPreset : QtGraphs3D::CameraPreset

La posición preestablecida de la cámara que la cámara está utilizando actualmente. El valor puede establecerse a uno de los valores del enum CameraPreset. Esta propiedad se puede utilizar para establecer un ángulo de cámara predefinido desde el que se ve el gráfico.

Por defecto, el valor predefinido de la cámara es CameraPreset::FrontLow.

Funciones de acceso:

Señal de notificador:

cameraTargetPosition : QVector3D

Esta propiedad contiene la posición del objetivo de la cámara como un vector o vértice en el espacio 3D.

Por defecto es QVector3D(0.0, 0.0, 0.0).

Los valores de coordenadas válidos están entre -1.0...1.0, donde los valores de borde indican los bordes del rango de ejes correspondiente. Cualquier valor fuera de este rango se fija al borde.

Funciones de acceso:

Señal del notificador:

cameraXRotation : float

Esta propiedad contiene el ángulo de rotación X de la cámara alrededor del punto objetivo en grados.

Funciones de acceso:

Señal del notificador:

cameraYRotation : float

Esta propiedad contiene el ángulo de rotación Y de la cámara alrededor del punto objetivo en grados.

Funciones de acceso:

Señal del notificador:

cameraZoomLevel : float

Esta propiedad contiene el nivel de zoom de la cámara en porcentaje.

El valor por defecto de 100.0f significa que no hay zoom establecido en la cámara. El valor está limitado por las propiedades minCameraZoomLevel y maxCameraZoomLevel.

Funciones de acceso:

Señal del notificador:

Véase también minCameraZoomLevel y maxCameraZoomLevel.

[read-only] currentFps : int

Esta propiedad contiene los resultados de renderizado del último segundo.

Los resultados se almacenan en esta propiedad de sólo lectura cuando la medición de FPS está activada. Se tarda al menos un segundo en actualizar este valor después de activar la medición.

Funciones de acceso:

Señal del notificador:

Véase también measureFps.

[since 6.11] cutoffMargin : qreal

Esta propiedad contiene el valor utilizado para el espacio entre los límites de los ejes y la posición en la que se eliminan los elementos del gráfico.

Esta propiedad se introdujo en Qt 6.11.

Funciones de acceso:

Notificador de señal:

gridLineType : QtGraphs3D::GridLineType

Esta propiedad indica si el tipo de líneas de la cuadrícula es QtGraphs3D::GridLineType::Shader o QtGraphs3D::GridLineType::Geometry.

Este valor afecta a todas las líneas de la rejilla.

Funciones de acceso:

Señal del notificador:

Véase también QtGraphs3D::GridLineType.

horizontalAspectRatio : qreal

Esta propiedad contiene la relación de la escala del gráfico entre el eje x y el eje z.

El valor de 0.0 indica un escalado automático según los rangos de los ejes. Por defecto es 0.0.

No tiene efecto en Q3DBarsWidgetItem, que maneja la escala en el plano horizontal a través de las propiedades barThickness y barSpacing. Los gráficos polares también ignoran esta propiedad.

Funciones de acceso:

Señal notificadora:

Véase también aspectRatio, polar, Q3DBarsWidgetItem::barThickness, y Q3DBarsWidgetItem::barSpacing.

labelMargin : float

Esta propiedad especifica el margen para la colocación de las etiquetas de los ejes.

Los valores negativos colocan las etiquetas dentro del área de trazado, mientras que los valores positivos las colocan fuera del área de trazado. La rotación automática de las etiquetas se desactiva cuando el valor es negativo. Valor por defecto 0.1

Funciones de acceso:

Señal del notificador:

Véase también QAbstract3DAxis::labelAutoAngle.

lightColor : QColor

Esta propiedad contiene el color para la luz ambiental y especular.

Este valor afecta a la luz especificada en Q3DScene.

Funciones de acceso:

Señal del notificador:

lightStrength : float

Esta propiedad contiene la intensidad de la luz especular para todo el gráfico.

El valor debe estar entre 0.0f y 10.0f.

Este valor afecta a la luz especificada en Q3DScene.

Funciones de acceso:

Señal notificadora:

locale : QLocale

Esta propiedad contiene la configuración regional utilizada para dar formato a varias etiquetas numéricas.

Por defecto es "C".

Funciones de acceso:

Señal de notificador:

Véase también QValue3DAxis::labelFormat.

margin : qreal

Esta propiedad contiene el valor absoluto utilizado para el espacio que queda entre el borde del área del gráfico trazable y el borde del fondo del gráfico.

Si el valor del margen es negativo, los márgenes se determinan automáticamente y pueden variar en función del tamaño de los elementos de la serie y del tipo de gráfico. El valor se interpreta como una fracción del margen del eje y si las relaciones de aspecto del gráfico no se han modificado respecto a los valores por defecto. Por defecto es -1.0.

Funciones de acceso:

Señal del notificador:

maxCameraXRotation : float

Esta propiedad contiene el ángulo máximo de rotación X de la cámara alrededor del punto objetivo en grados. El valor por defecto es 180.0

Funciones de acceso:

Señal del notificador:

maxCameraYRotation : float

Esta propiedad contiene el ángulo máximo de rotación Y de la cámara alrededor del punto objetivo en grados. El valor por defecto es 90.0

Funciones de acceso:

Señal del notificador:

maxCameraZoomLevel : float

Esta propiedad contiene el nivel máximo permitido de zoom de la cámara.

Si el nivel máximo se establece en un nuevo valor inferior al nivel mínimo existente, el nivel mínimo también se ajusta al nuevo máximo. Si el cameraZoomLevel actual está fuera de los nuevos límites, también se ajusta. Por defecto es 500.0f.

Funciones de acceso:

Señal de aviso:

Véase también cameraZoomLevel y minCameraZoomLevel.

measureFps : bool

Esta propiedad mantiene si el renderizado se realiza de forma continua en lugar de bajo demanda.

Si true, el renderizado es continuo y se actualiza el valor de la propiedad currentFps. Por defecto es false.

Funciones de acceso:

Señal del notificador:

Véase también currentFps.

minCameraXRotation : float

Esta propiedad contiene el ángulo mínimo de rotación X de la cámara alrededor del punto objetivo en grados. El valor por defecto es -180.0

Funciones de acceso:

Señal del notificador:

minCameraYRotation : float

Esta propiedad contiene el ángulo mínimo de rotación Y de la cámara alrededor del punto objetivo en grados. El valor por defecto es 0.0

Funciones de acceso:

Señal del notificador:

minCameraZoomLevel : float

Esta propiedad contiene el nivel mínimo permitido de zoom de la cámara.

Si el nivel mínimo se establece en un nuevo valor superior al nivel máximo existente, el nivel máximo también se ajusta al nuevo mínimo. Si el zoomLevel actual está fuera de los nuevos límites, también se ajusta. El minCameraZoomLevel no puede establecerse por debajo de 1.0f. Por defecto es 10.0f.

Funciones de acceso:

Señal notificadora:

Véase también cameraZoomLevel y maxCameraZoomLevel.

msaaSamples : int

Esta propiedad contiene el número de muestras utilizadas en MSAA.

Establece el número de muestras MSAA utilizadas en samples. El número de muestras puede ser 0, 2, 4 u 8.

Funciones de acceso:

Señal del notificador:

optimizationHint : QtGraphs3D::OptimizationHint

Especifica si se utiliza el modo predeterminado o heredado para la optimización del renderizado.

El modo predeterminado utiliza el renderizado por instancias y proporciona el conjunto completo de funciones con el mejor nivel de rendimiento en la mayoría de los sistemas. El modo estático optimiza la representación de gráficos y es ideal para grandes conjuntos de datos que no cambian. Es más lento con cambios de datos dinámicos y rotaciones de elementos. La selección no está optimizada, por lo que no es aconsejable utilizar el modo estático con conjuntos de datos masivos. La optimización estática sólo funciona en gráficos de dispersión. El modo heredado representa todos los elementos del gráfico individualmente, sin instanciación. Sólo debe utilizarse si el modo predeterminado no funciona, es decir, si el sistema de destino no admite la creación de instancias. El valor predeterminado es QtGraphs3D::OptimizationHint::Default.

Funciones de acceso:

Señal notificadora:

Véase también QAbstract3DSeries::mesh.

orthoProjection : bool

Esta propiedad indica si se utiliza la proyección ortográfica para mostrar el gráfico.

Por defecto es false.

Funciones de acceso:

Señal notificadora:

Véase también QAbstract3DAxis::labelAutoAngle.

polar : bool

Esta propiedad mantiene si los ejes horizontales se convierten en ejes polares.

Si true, el eje x se convierte en el eje angular y el eje z en el eje radial. El modo polar no está disponible para los gráficos de barras.

Por defecto es false.

Funciones de acceso:

Señal notificadora:

Véase también orthoProjection y radialLabelOffset.

[read-only] queriedGraphPosition : QVector3D

Esta propiedad contiene los últimos valores de posición del gráfico consultados a lo largo de cada eje.

Esta propiedad de sólo lectura contiene los resultados de Q3DScene::graphPositionQuery. Los valores están normalizados al rango [-1, 1]. Si la posición consultada estaba fuera de los límites del gráfico, los valores no reflejarán la posición real, sino que indicarán una posición indefinida fuera del rango [-1, 1]. El valor será indefinido hasta que se realice una consulta.

No existe una única coordenada 3D correcta que coincida con una posición concreta de la pantalla, por lo que, para ser coherentes, las consultas se realizan siempre contra los lados interiores de una caja invisible que rodea el gráfico.

Funciones de acceso:

Señal del notificador:

Véase también Q3DScene::graphPositionQuery.

radialLabelOffset : float

Esta propiedad contiene el desplazamiento horizontal normalizado para las etiquetas de los ejes polares radiales.

El valor 0.0 indica que las etiquetas deben dibujarse junto a la línea de rejilla del eje angular 0. El valor 1.0 indica que las etiquetas se dibujan en su lugar habitual en el borde del fondo del gráfico. El valor por defecto es 1.0.

Esta propiedad se ignora si el valor de la propiedad polar es false.

Funciones de acceso:

Señal de notificador:

Véase también polar.

rotationEnabled : bool

Esta propiedad indica si este manejador de entrada permite la rotación del gráfico.

Por defecto es true.

Funciones de acceso:

Señal del notificador:

[read-only] scene : Q3DScene* const

Esta propiedad contiene el puntero Q3DScene que puede ser utilizado para manipular la escena y acceder a los elementos de la escena.

Esta propiedad es de sólo lectura.

Funciones de acceso:

[read-only] selectedElement : QtGraphs3D::ElementType

Esta propiedad contiene el elemento seleccionado en el gráfico.

Esta propiedad puede utilizarse para consultar el tipo de elemento seleccionado. El tipo es válido hasta que se realiza una nueva selección en el gráfico y se emite la señal selectedElementChanged.

La señal puede utilizarse, por ejemplo, para implementar gestores de entrada personalizados, como se muestra en el ejemplo de la Galería gráfica en la pestaña Scatter Graph.

Funciones de acceso:

Señal de notificador:

Véase también selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBarsWidgetItem::selectedSeries(), Q3DScatterWidgetItem::selectedSeries(), Q3DSurfaceWidgetItem::selectedSeries() y Q3DScene::setSelectionQueryPosition().

selectionEnabled : bool

Esta propiedad indica si este manejador de entrada permite la selección desde el gráfico.

Por defecto es true.

Funciones de acceso:

Señal de notificador:

selectionMode : QtGraphs3D::SelectionFlags

Modo de selección del elemento.

Una combinación de SelectionFlags. Por defecto, Item. Diferentes tipos de gráficos soportan diferentes modos de selección.

Funciones de acceso:

Señal del notificador:

Véase también QtGraphs3D::SelectionFlags.

shadowQuality : QtGraphs3D::ShadowQuality

Esta propiedad contiene la calidad de la sombra.

Es uno de los valores del enum ShadowQuality. Por defecto, Medium.

Funciones de acceso:

Señal notificadora:

Véase también QtGraphs3D::ShadowQuality.

shadowStrength : float

Esta propiedad contiene la intensidad de la sombra para todo el gráfico.

Cuanto mayor sea el número, más oscuras serán las sombras. El valor debe estar entre 0.0 y 100.0.

Este valor afecta a la luz especificada en Q3DScene.

Funciones de acceso:

Señal del notificador:

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

Especifica qué técnica de transparencia utilizar. El valor por defecto es Default. Al renderizar gráficos de superficie transparentes, utilice Approximate o Accurate. Default debe utilizarse para otros tipos de gráficos.

Esta propiedad se introdujo en Qt 6.9.

Funciones de acceso:

Señal de notificador:

Véase también QtGraphs3D::TransparencyTechnique.

wrapCameraXRotation : bool

Esta propiedad mantiene el comportamiento de los límites mínimo y máximo en la rotación X.

Si se establece en true, la rotación X de la cámara se envuelve del mínimo al máximo y del máximo al mínimo. Si se establece en false, la rotación X de la cámara se limita al sector determinado por los valores mínimo y máximo. Por defecto está ajustado a true.

Funciones de acceso:

Señal de notificación:

wrapCameraYRotation : bool

Esta propiedad mantiene el comportamiento de los límites mínimo y máximo en la rotación Y.

Si true, la rotación Y de la cámara se envuelve de mínimo a máximo y de máximo a mínimo. Si false, la rotación Y de la cámara se limita al sector determinado por los valores mínimo y máximo. Por defecto es true.

Funciones de acceso:

Señal de notificación:

zoomAtTargetEnabled : bool

Esta propiedad mantiene si el zoom debe cambiar el objetivo de la cámara para que el punto ampliado del gráfico permanezca en la misma ubicación después del zoom.

Por defecto es true.

Funciones de acceso:

Señal del notificador:

zoomEnabled : bool

Esta propiedad indica si este manejador de entrada permite hacer zoom en el gráfico.

Por defecto es true.

Funciones de acceso:

Señal del notificador:

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);