En esta página

GraphsItem3D QML Type

Tipo base para gráficos 3D. Más...

Import Statement: import QtGraphs
Inherited By:

Bars3D, Scatter3D, and Surface3D

Propiedades

Señales

Métodos

Descripción detallada

El tipo base no creable para todos los gráficos 3D en QtGraphs.

Véase también Bars3D, Scatter3D, Surface3D, y Qt Graphs Clases C++ para 3D.

Documentación de Propiedades

ambientLightStrength : real

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 entre 0.0 y 1.0.

aspectRatio : real

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.

Nota: No tiene efecto en Bars3D.

Véase también horizontalAspectRatio.

cameraPreset : Graphs3D.CameraPreset

El preajuste de cámara activo actualmente, que es uno de Graphs3D.CameraPreset. Si no hay ningún preajuste activo, el valor es Graphs3D.CameraPreset.NoPreset.

cameraTargetPosition : vector3d

El objetivo de la cámara como un vector3d. Por defecto es vector3d(0.0, 0.0, 0.0).

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

cameraXRotation : real

El ángulo de rotación X de la cámara alrededor del punto objetivo en grados partiendo de la posición base actual.

cameraYRotation : real

El ángulo de rotación Y de la cámara alrededor del punto objetivo en grados partiendo de la posición base actual.

cameraZoomLevel : real

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

Ver también minCameraZoomLevel y maxCameraZoomLevel.

currentFps : int

Cuando la medición de FPS está activada, los resultados del último segundo se almacenan en esta propiedad de sólo lectura. Tras la activación de la medición, este valor tarda al menos un segundo en actualizarse.

Véase también measureFps.

customItemList : list<Custom3DItem>

La lista de elementos Custom3DItem añadidos al gráfico. El gráfico se apropia de los elementos añadidos.

cutoffMargin : real [since 6.11]

Valor utilizado para la diferencia entre los límites de los ejes y la posición en la que se eliminan los elementos del gráfico.

Nota: No afecta a los gráficos de barras.

Esta propiedad se introdujo en Qt 6.11.

gridLineType : Graphs3D.GridLineType

Define si el tipo de líneas de la cuadrícula es Graphs3D.GridLineType.Shader o Graphs3D.GridLineType.Geometry.

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

Véase también Graphs3D.GridLineType.

horizontalAspectRatio : real

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. El valor por defecto es 0.0.

Nota: No tiene efecto en Bars3D, 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.

Ver también aspectRatio, polar, Bars3D::barThickness, y Bars3D::barSpacing.

labelMargin : real

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. El valor por defecto es 0.1

Véase también QAbstract3DAxis::labelAutoAngle.

lightColor : color

El color de la luz ambiental y especular definido en Scene3D.

lightStrength : real

La intensidad de la luz especular para todo el gráfico. El valor debe estar entre 0.0 y 10.0.

Este valor afecta a la luz especificada en Scene3D.

locale : locale

Establece la configuración regional utilizada para dar formato a varias etiquetas numéricas. Por defecto es "C".

Véase también Value3DAxis::labelFormat.

margin : real

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.

Nota: si se establece un margen más pequeño para un gráfico de dispersión que el margen determinado automáticamente, los elementos de dispersión de los bordes del gráfico pueden solaparse con el fondo del gráfico.

Nota: En los gráficos de dispersión y superficie, si el margen es pequeño en comparación con el tamaño de la etiqueta del eje, las posiciones de las etiquetas de borde de los ejes se ajustan para evitar la superposición con las etiquetas de borde de los ejes vecinos.

maxCameraXRotation : real [since 6.9]

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

Esta propiedad se introdujo en Qt 6.9.

maxCameraYRotation : real [since 6.9]

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

Esta propiedad se introdujo en Qt 6.9.

maxCameraZoomLevel : real

Establece el nivel máximo permitido de zoom de la cámara. Si el nuevo nivel máximo es inferior al nivel mínimo existente, el nivel mínimo se ajusta también al nuevo máximo. Si el cameraZoomLevel actual está fuera de los nuevos límites, también se ajusta. Por defecto 500.0f.

Véase también cameraZoomLevel y minCameraZoomLevel.

measureFps : bool

Si true, el renderizado se realiza de forma continua en lugar de bajo demanda, y se actualiza el valor de la propiedad currentFps. Por defecto es false.

Véase también currentFps.

minCameraXRotation : real [since 6.9]

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

Esta propiedad se introdujo en Qt 6.9.

minCameraYRotation : real [since 6.9]

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

Esta propiedad se introdujo en Qt 6.9.

minCameraZoomLevel : real

Establece el nivel mínimo permitido de zoom de la cámara. Si el nuevo nivel mínimo es superior al nivel máximo existente, el nivel máximo también se ajusta al nuevo mínimo. Si el cameraZoomLevel actual está fuera de los nuevos límites, también se ajusta. El minCameraZoomLevel no puede establecerse por debajo de 1.0. Por defecto es 10.0.

Véase también cameraZoomLevel y maxCameraZoomLevel.

msaaSamples : int

El número de muestras utilizadas en el antialiasing multimuestra cuando renderingMode es Indirect. Cuando renderingMode es DirectToBackground, el valor de esta propiedad es de sólo lectura y devuelve el número de muestras especificado por el formato de superficie de la ventana. Por defecto es 4.

Véase también renderingMode.

optimizationHint : Graphs3D.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. El modo heredado representa todos los elementos del gráfico individualmente, sin instanciación. Sólo debe utilizarse si el modo por defecto no funciona, es decir, si el sistema de destino no soporta el instanciado. Por defecto es Default.

Nota: En algunos entornos, los gráficos grandes que utilizan la optimización estática pueden no renderizarse, porque todos los elementos se renderizan utilizando una única llamada de dibujo, y los diferentes controladores gráficos soportan diferentes números máximos de vértices por llamada. Esto ocurre principalmente en plataformas de 32 bits y OpenGL ES2. Para solucionar este problema, elige una malla de elementos con un número bajo de vértices o utiliza la malla de puntos.

Véase también Abstract3DSeries::mesh y Graphs3D.OptimizationHint.

orthoProjection : bool

Si true, se utilizará la proyección ortográfica para mostrar el gráfico. Por defecto es false.

Nota: Las sombras se desactivan cuando se selecciona true.

polar : bool

Si true, los ejes horizontales se transforman en ejes polares. 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 false.

Véase también orthoProjection y radialLabelOffset.

queriedGraphPosition : vector3d [read-only]

Esta propiedad de sólo lectura contiene los últimos valores de posición del gráfico a lo largo de cada eje consultado mediante Scene3D::graphPositionQuery. Los valores están normalizados en el 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 será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.

Nota: Los gráficos de barras sólo permiten consultar la posición del gráfico a nivel del suelo del gráfico, por lo que el valor y siempre es cero para los gráficos de barras y las consultas válidas sólo pueden realizarse en posiciones de pantalla que contengan el suelo del gráfico.

Véase también Scene3D::graphPositionQuery.

radialLabelOffset : real

Esta propiedad especifica 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. Esta propiedad se ignora si el valor de la propiedad polar es false. Por defecto es 1.0.

Véase también polar.

renderingMode : Graphs3D.RenderingMode

Cómo se mostrará el gráfico. Por defecto es Indirect.

Nota: Establecer la propiedad antialiasing del gráfico no hace nada. Sin embargo, es establecida por el propio gráfico si el modo de renderizado actual utiliza antialiasing.

Ver también msaaSamples y Graphs3D.RenderingMode.

rootNode : Node [read-only, since 6.9]

Devuelve un puntero al nodo raíz del gráfico 3D. Utilice esta propiedad para inyectar un gráfico 3D en un View3D separado utilizando importScene:

Bars3D {
  id: bars
}
View3D {
  importScene: bars.rootNode
}

Esta propiedad se introdujo en Qt 6.9.

Véase también View3D.

rotationEnabled : bool

Si este manejador de entrada permite la rotación del gráfico.

Por defecto true.

scene : Scene3D [read-only]

El puntero Scene3D que se puede utilizar para manipular la escena y acceder a los elementos de la escena.

Esta propiedad es de sólo lectura.

selectedElement : Graphs3D.ElementType [read-only]

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 se puede utilizar, por ejemplo, para implementar un manejo de entradas personalizado, como se demuestra en el ejemplo Manejo de ejes.

Véase también selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition, y Graphs3D.ElementType.

selectionEnabled : bool

Si este manejador de entrada permite la selección desde el gráfico.

Por defecto true.

selectionMode : Graphs3D.SelectionMode

El modo de selección activo en el gráfico. Uno de los valores del enum Graphs3D.SelectionFlag.

shadowQuality : Graphs3D.ShadowQuality

La calidad de las sombras. Uno de los valores del enum Graphs3D.ShadowQuality.

shadowStrength : real

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

theme : GraphsTheme

El tema activo del gráfico.

Véase también GraphsTheme.

transparencyTechnique : Graphs3D.TransparencyTechnique [since 6.9]

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.

ConstanteDescripción
DefaultIndica que no se utilizan técnicas de transparencia independientes del orden. Ofrece el mejor rendimiento. Se utiliza cuando los gráficos no contienen transparencia o cuando un gráfico de barras o de dispersión también utiliza instanciación, es decir, optimizationHint es {QtGraphs3D::OptimizationHint::Default}.
ApproximateIndica que un gráfico intenta una aproximación de transparencia independiente del orden. Este método es más rápido que Accurate y funciona en hardware antiguo, pero puede dar resultados imprecisos. Se utiliza cuando se necesita la transparencia independiente del orden, pero el coste de rendimiento tiene que ser menor que cuando se utiliza la transparencia exacta independiente del orden.
AccurateIndica que se utiliza la transparencia precisa independiente del orden. Se utiliza cuando se necesita una transparencia perfecta.

Esta propiedad se introdujo en Qt 6.9.

wrapCameraXRotation : bool

El comportamiento de los límites mínimo y máximo en la rotación X. Por defecto, la rotación X va del valor mínimo al máximo y del máximo al mínimo.

Si se establece en true, la rotación X de la cámara se envuelve de mínimo a máximo y de máximo a 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.

wrapCameraYRotation : bool

El comportamiento de los límites mínimo y máximo en la rotación Y. Por defecto, la rotación Y se limita entre los valores mínimo y máximo sin ninguna envoltura.

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.

zoomAtTargetEnabled : bool

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.

zoomEnabled : bool

Si este manejador de entrada permite el zoom del gráfico.

Por defecto es true.

Documentación de señales

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

Esta señal se emite cuando el elemento del gráfico se toca dos veces en un breve espacio de tiempo. El parámetro de la señal eventPoint contiene información del evento de liberación sobre el punto que fue pulsado, y button es el mouse button que fue pulsado, o NoButton en una pantalla táctil.

Nota: El manejador correspondiente es onDoubleTapped.

Véase también QEventPoint, Qt::MouseButtons, y TapHandler::doubleTapped.

dragged(QVector2D delta)

Esta señal se emite cuando cambia la traslación del conjunto de puntos del gráfico mientras se realiza el gesto de pellizcar. El vector delta indica el cambio de traslación.

Nota: El manejador correspondiente es onDragged.

Véase también PinchHandler::translationChanged.

longPressed()

Esta señal se emite cuando se pulsa el elemento parent y se mantiene pulsado durante un periodo de tiempo superior a TapHandler::longPressThreshold.

Nota: El manejador correspondiente es onLongPressed.

Véase también TapHandler::longPressed.

mouseMove(QPoint mousePos)

Esta señal se emite cuando el gráfico recibe un evento mouseMove. mousePos valor da la posición del ratón mientras se mueve.

Nota: El manejador correspondiente es onMouseMove.

Véase también QQuickItem::mouseMoveEvent.

pinch(qreal delta)

Esta señal se emite cuando el factor de escala del gráfico cambia mientras se realiza el gesto de pellizcar. El valor delta da el cambio multiplicativo en la escala.

Nota: El manejador correspondiente es onPinch.

Véase también PinchHandler::scaleChanged.

tapped(QEventPoint eventPoint, Qt::MouseButton button)

Esta señal se emite cuando el elemento del gráfico se toca una vez. El parámetro de la señal eventPoint contiene información del evento de liberación sobre el punto que fue tocado, y button es el mouse button que fue pulsado, o NoButton en una pantalla táctil.

Nota: El manejador correspondiente es onTapped.

Véase también QEventPoint, Qt::MouseButtons, y TapHandler::singleTapped.

wheel(QQuickWheelEvent *event)

Esta señal se emite cada vez que el gráfico recibe un event de tipo QWheelEvent: es decir, cada vez que se mueve la rueda o se actualiza el gesto de desplazamiento.

Nota: El manejador correspondiente es onWheel.

Véase también WheelEvent y WheelHandler::wheel.

Documentación del método

qsizetype addCustomItem(Custom3DItem item)

Añade un Custom3DItem item al gráfico. Graph toma posesión del elemento añadido.

Devuelve el índice del elemento añadido si la adición se ha realizado correctamente, -1 si se intenta añadir un elemento nulo, y el índice del elemento si se intenta añadir un elemento ya añadido.

Véase también removeCustomItems(), removeCustomItem(), y removeCustomItemAt().

void clearSelection()

Borra la selección de todas las series adjuntas.

void doPicking(QPoint point)

Realiza el picking utilizando las coordenadas de la vista desde point sobre los elementos del gráfico, seleccionando el primer elemento golpeado. El manejo de entrada por defecto realiza esto al recibir el evento onTapped.

Véase también selectedElement.

void doRayPicking(QVector3D origin, QVector3D direction)

Realiza el picking a partir de origin y en direction sobre los elementos del gráfico, seleccionando el primer elemento alcanzado.

Véase también selectedElement.

bool hasSeries(Abstract3DSeries series)

Devuelve si el series ya ha sido añadido al gráfico.

void releaseCustomItem(Custom3DItem item)

Recupera la propiedad de item y elimina item del gráfico.

Nota: Si el mismo ítem es añadido de nuevo al gráfico, el archivo de textura necesita ser reajustado.

Véase también Custom3DItem::textureFile.

void removeCustomItem(Custom3DItem item)

Elimina la página personalizada item. Elimina los recursos asignados.

void removeCustomItemAt(vector3d position)

Elimina todos los elementos personalizados en position. Elimina los recursos asignados a ellos.

void removeCustomItems()

Elimina todos los elementos personalizados. Elimina los recursos asignados a ellos.

Abstract3DAxis selectedAxis()

Puede utilizarse para obtener el eje seleccionado tras recibir la señal selectedElementChanged con cualquier tipo de etiqueta. La selección es válida hasta la siguiente señal selectedElementChanged.

Devuelve el eje seleccionado, o null.

Véase también selectedElement.

Custom3DItem selectedCustomItem()

Puede utilizarse para obtener el elemento personalizado seleccionado tras recibir la señal selectedElementChanged con el tipo ElementType.CustomItem. La propiedad del elemento permanece en el gráfico. La selección es válida hasta la siguiente señal selectedElementChanged.

Devuelve el elemento personalizado seleccionado, o null.

Véase también selectedElement.

qsizetype selectedCustomItemIndex()

Puede utilizarse para consultar el índice del elemento personalizado seleccionado tras recibir la señal selectedElementChanged con el tipo ElementType.CustomItem. La selección es válida hasta la siguiente señal selectedElementChanged.

Devuelve el índice del elemento personalizado seleccionado, o -1.

Véase también selectedElement.

int selectedLabelIndex()

Puede utilizarse para consultar el índice de la etiqueta seleccionada tras recibir la señal selectedElementChanged con cualquier tipo de etiqueta. La selección es válida hasta la siguiente señal selectedElementChanged.

Devuelve el índice de la etiqueta seleccionada, o -1.

Véase también selectedElement.

void setDefaultInputHandler()

* @brief Restaura el mecanismo de manejo de entrada por defecto. * * Este método reactiva los manejadores de entrada internos predefinidos. * Utilícelo para volver al comportamiento por defecto después de haber llamado previamente a * unsetDefaultInputHandler. *

Véase también unsetDefaultInputHandler().

void setDragButton(Qt::MouseButtons button)

* @brief Establece el botón del ratón utilizado para desencadenar eventos de arrastre. * Este método permite cambiar el botón del ratón necesario para iniciar * una operación de arrastre a button. * Por defecto a Qt::RightButton.

void unsetDefaultDragHandler()

* @brief Desactiva el controlador de eventos de arrastre por defecto. * Esto deshabilita específicamente la respuesta incorporada a los gestos de arrastre. * Usa esto si necesitas implementar un manejador personalizado para arrastrar. *

Ver también unsetDefaultInputHandler().

void unsetDefaultInputHandler()

* @brief Desactiva el mecanismo de manejo de entrada por defecto. * * Este método desactiva los manejadores de entrada predefinidos por defecto. * Llama a este método cuando pretendas anular los comportamientos por defecto. *

Ver también unsetDefaultTapHandler(), unsetDefaultDragHandler(), unsetDefaultWheelHandler(), y unsetDefaultPinchHandler().

void unsetDefaultPinchHandler()

* @brief Desactiva el gestor de gestos de pellizco por defecto. * Esto deshabilita específicamente la respuesta incorporada a los gestos de pellizco. * Utilice esta opción para implementar un controlador de gestos de pellizco personalizado. *

Ver también unsetDefaultInputHandler().

void unsetDefaultTapHandler()

* @brief Desactiva el manejador de eventos por defecto. * Esto desactiva específicamente la respuesta incorporada a los eventos de pulsación o clic, permitiendo una lógica de gestión de pulsación personalizada. *

Ver también unsetDefaultInputHandler().

void unsetDefaultWheelHandler()

* @brief Desactiva el manejador de eventos por defecto de la rueda del ratón. * Esto deshabilita específicamente la respuesta incorporada al desplazamiento de la rueda del ratón. * Use esto cuando implemente un comportamiento de rueda personalizado. *

Ver también unsetDefaultInputHandler().

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