En esta página

Q3DGraphsWidgetItem Class

La clase Q3DGraphsWidgetItem proporciona una ventana y un bucle de renderizado para gráficos. Más información...

Encabezado: #include <Q3DGraphsWidgetItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS GraphsWidgets)
target_link_libraries(mytarget PRIVATE Qt6::GraphsWidgets)
qmake: QT += graphswidgets
Heredado de: QObject
Heredado por:

Q3DBarsWidgetItem, ` Q3DScatterWidgetItem` y Q3DSurfaceWidgetItem

Propiedades

Funciones públicas

virtual ~Q3DGraphsWidgetItem() override
QGraphsTheme *activeTheme() const
qsizetype addCustomItem(QCustom3DItem *item)
void addTheme(QGraphsTheme *theme)
float ambientLightStrength() const
qreal aspectRatio() const
QtGraphs3D::CameraPreset cameraPreset() const
QVector3D cameraTargetPosition() const
float cameraXRotation() const
float cameraYRotation() const
float cameraZoomLevel() const
void clearSelection()
int currentFps() const
QList<QCustom3DItem *> customItems() const
qreal cutoffMargin() const
void doPicking(QPoint point)
void doRayPicking(QVector3D origin, QVector3D direction)
QtGraphs3D::DragMode dragMode() const
QtGraphs3D::GridLineType gridLineType() const
bool hasSeries(QAbstract3DSeries *series) const
qreal horizontalAspectRatio() const
bool isOrthoProjection() const
bool isPanEnabled() const
bool isPolar() const
bool isRotationEnabled() const
bool isSelectionEnabled() const
bool isZoomAtTargetEnabled() const
bool isZoomEnabled() const
float labelMargin() const
QColor lightColor() const
float lightStrength() const
QLocale locale() const
qreal margin() const
float maxCameraXRotation() const
float maxCameraYRotation() const
float maxCameraZoomLevel() const
bool measureFps() const
float minCameraXRotation() const
float minCameraYRotation() const
float minCameraZoomLevel() const
int msaaSamples() const
QtGraphs3D::OptimizationHint optimizationHint() const
QVector3D queriedGraphPosition() const
float radialLabelOffset() const
void releaseCustomItem(QCustom3DItem *item)
void releaseTheme(QGraphsTheme *theme)
void removeCustomItem(QCustom3DItem *item)
void removeCustomItemAt(QVector3D position)
void removeCustomItems()
QSharedPointer<QQuickItemGrabResult> renderToImage(QSize imageSize = QSize()) const
Q3DScene *scene() const
QAbstract3DAxis *selectedAxis() const
QCustom3DItem *selectedCustomItem() const
qsizetype selectedCustomItemIndex() const
QtGraphs3D::ElementType selectedElement() const
int selectedLabelIndex() const
QtGraphs3D::SelectionFlags selectionMode() const
QtGraphs3D::ShadowQuality shadowQuality() const
float shadowStrength() const
QList<QGraphsTheme *> themes() const
QtGraphs3D::TransparencyTechnique transparencyTechnique() const
QQuickWidget *widget() const
bool wrapCameraXRotation() const
bool wrapCameraYRotation() const

Ranuras públicas

void setActiveTheme(QGraphsTheme *activeTheme)
void setAmbientLightStrength(float newAmbientLightStrength)
void setAspectRatio(qreal ratio)
void setCameraPosition(float horizontal, float vertical, float zoom = 100.0f)
void setCameraPreset(QtGraphs3D::CameraPreset preset)
void setCameraTargetPosition(QVector3D target)
void setCameraXRotation(float rotation)
void setCameraYRotation(float rotation)
void setCameraZoomLevel(float level)
void setCutoffMargin(qreal margin)
void setDragMode(QtGraphs3D::DragMode newDragMode)
void setGridLineType(const QtGraphs3D::GridLineType &gridLineType)
void setHorizontalAspectRatio(qreal ratio)
void setLabelMargin(float margin)
void setLightColor(QColor newLightColor)
void setLightStrength(float newLightStrength)
void setLocale(const QLocale &locale)
void setMargin(qreal margin)
void setMaxCameraXRotation(float rotation)
void setMaxCameraYRotation(float rotation)
void setMaxCameraZoomLevel(float level)
void setMeasureFps(bool enable)
void setMinCameraXRotation(float rotation)
void setMinCameraYRotation(float rotation)
void setMinCameraZoomLevel(float level)
void setMsaaSamples(int samples)
void setOptimizationHint(QtGraphs3D::OptimizationHint hint)
void setOrthoProjection(bool enable)
(since 6.12) void setPanButton(Qt::MouseButtons button)
void setPanEnabled(bool enable)
void setPolar(bool enable)
void setRadialLabelOffset(float offset)
void setRotationEnabled(bool enable)
void setSelectionEnabled(bool enable)
void setSelectionMode(const QtGraphs3D::SelectionFlags &selectionMode)
void setShadowQuality(const QtGraphs3D::ShadowQuality &shadowQuality)
void setShadowStrength(float newShadowStrength)
void setTransparencyTechnique(QtGraphs3D::TransparencyTechnique technique)
void setWidget(QQuickWidget *widget)
void setWrapCameraXRotation(bool wrap)
void setWrapCameraYRotation(bool wrap)
void setZoomAtTargetEnabled(bool enable)
void setZoomEnabled(bool enable)

Señales

void activeThemeChanged(QGraphsTheme*activeTheme)
void ambientLightStrengthChanged()
void aspectRatioChanged(qreal ratio)
void cameraPresetChanged(QtGraphs3D::CameraPreset preset)
void cameraTargetPositionChanged(QVector3D destino)
void cameraXRotationChanged(float rotación)
void cameraYRotationChanged(float rotación)
void cameraZoomLevelChanged(float nivelDeZoom)
void currentFpsChanged(int fps)
void cutoffMarginChanged(qreal nuevoMargen)
void dragModeChanged(QtGraphs3D::DragMode dragMode)
void gridLineTypeChanged()
void horizontalAspectRatioChanged(qreal ratio)
void labelMarginChanged(float margen)
void lightColorChanged()
void lightStrengthChanged()
void localeChanged(const QLocale&locale)
void marginChanged(qreal margen)
void maxCameraXRotationChanged(float rotación)
void maxCameraYRotationChanged(float rotación)
void maxCameraZoomLevelChanged(float nivelDeZoom)
void measureFpsChanged(bool habilitado)
void minCameraXRotationChanged(float rotación)
void minCameraYRotationChanged(float rotación)
void minCameraZoomLevelChanged(float nivelDeZoom)
void msaaSamplesChanged(int muestras)
void optimizationHintChanged(QtGraphs3D::OptimizationHint hint)
void orthoProjectionChanged(bool habilitado)
void panEnabledChanged(bool enable)
void polarChanged(bool habilitado)
void queriedGraphPositionChanged(QVector3D datos)
void radialLabelOffsetChanged(float desplazamiento)
void rotationEnabledChanged(bool enable)
void selectedElementChanged(QtGraphs3D::ElementType tipo)
void selectionEnabledChanged(bool enable)
void selectionModeChanged(const QtGraphs3D::SelectionFlags selectionMode)
void shadowQualityChanged(QtGraphs3D::ShadowQuality quality)
void shadowStrengthChanged()
void transparencyTechniqueChanged(QtGraphs3D::TransparencyTechnique technique)
void wrapCameraXRotationChanged(bool wrap)
void wrapCameraYRotationChanged(bool wrap)
void zoomAtTargetEnabledChanged(bool enable)
void zoomEnabledChanged(bool enable)

Descripción detallada

Esta clase es una subclase de « QWindow » y proporciona un bucle de renderizado para los gráficos que la heredan.

No debería ser necesario utilizar esta clase directamente, sino una de sus subclases.

El multimuestreo está desactivado por defecto en ` QSurfaceFormat`. Para habilitar el multimuestreo, establece un formato de superficie personalizado como formato de superficie por defecto. Para obtener el formato de superficie personalizado, utiliza ` QQuick3D::idealSurfaceFormat()`.

Véanse también las clases de C++ para 3D:` Q3DBarsWidgetItem`, ` Q3DScatterWidgetItem`, ` Q3DSurfaceWidgetItem` y ` Qt Graphs `.

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 predeterminado temporal. Este tema temporal se elimina si posteriormente se establece explícitamente cualquier otro tema. Las propiedades del tema pueden modificarse incluso después de haberlo establecido, y los cambios surten efecto de inmediato.

Funciones de acceso:

QGraphsTheme *activeTheme() const
void setActiveTheme(QGraphsTheme *activeTheme)

Señal de notificador:

void activeThemeChanged(QGraphsTheme *activeTheme)

ambientLightStrength : float

Esta propiedad determina la intensidad de la luz ambiental en 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:

float ambientLightStrength() const
void setAmbientLightStrength(float newAmbientLightStrength)

Señal de notificación:

void ambientLightStrengthChanged()

aspectRatio : qreal

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

El valor por defecto es 2.0.

Nota: Notiene ningún efecto sobre Q3DBarsWidgetItem.

Funciones de acceso:

qreal aspectRatio() const
void setAspectRatio(qreal ratio)

Señal de notificación:

void aspectRatioChanged(qreal ratio)

Véase también horizontalAspectRatio.

cameraPreset : QtGraphs3D::CameraPreset

La posición preestablecida que la cámara está utilizando actualmente. El valor se puede establecer en uno de los valores de la enumeración `CameraPreset`. Esta propiedad se puede utilizar para establecer un ángulo de cámara predefinido desde el que se visualiza el gráfico.

Por defecto, la configuración preestablecida de la cámara está establecida en « CameraPreset::FrontLow ».

Nota: Si has establecido las propiedades cameraXRotation, cameraYRotation o cameraZoomLevel, o has llamado a setCustomCamera(), esta propiedad devolverá CameraPreset::NoPreset hasta que se vuelva a llamar a setCameraPreset() o se cambie la configuración preestablecida a otro valor.

Funciones de acceso:

QtGraphs3D::CameraPreset cameraPreset() const
void setCameraPreset(QtGraphs3D::CameraPreset preset)

Señal de notificador:

void cameraPresetChanged(QtGraphs3D::CameraPreset preset)

cameraTargetPosition : QVector3D

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

El valor por defecto es QVector3D(0.0, 0.0, 0.0).

Los valores de coordenadas válidos se encuentran entre -1.0...1.0, donde los valores extremos indican los límites del rango del eje correspondiente. Cualquier valor fuera de este rango se ajusta al límite.

Funciones de acceso:

QVector3D cameraTargetPosition() const
void setCameraTargetPosition(QVector3D target)

Señal de notificación:

void cameraTargetPositionChanged(QVector3D target)

cameraXRotation : float

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

Funciones de acceso:

float cameraXRotation() const
void setCameraXRotation(float rotation)

Señal de notificación:

void cameraXRotationChanged(float rotation)

cameraYRotation : float

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

Funciones de acceso:

float cameraYRotation() const
void setCameraYRotation(float rotation)

Señal de notificación:

void cameraYRotationChanged(float rotation)

cameraZoomLevel : float

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

El valor predeterminado de « 100.0f » significa que no hay ningún ajuste de zoom (ni de acercamiento ni de alejamiento) en la cámara. El valor está limitado por las propiedades « minCameraZoomLevel » y « maxCameraZoomLevel ».

Funciones de acceso:

float cameraZoomLevel() const
void setCameraZoomLevel(float level)

Señal de notificación:

void cameraZoomLevelChanged(float zoomLevel)

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 solo lectura cuando se habilita la medición de FPS. Este valor tarda al menos un segundo en actualizarse tras activar la medición.

Funciones de acceso:

int currentFps() const

Señal de notificación:

void currentFpsChanged(int fps)

Véase también measureFps.

[since 6.11] cutoffMargin : qreal

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

Nota: No afectaa los gráficos de barras.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

qreal cutoffMargin() const
void setCutoffMargin(qreal margin)

Señal de notificador:

void cutoffMarginChanged(qreal newMargin)

[since 6.12] dragMode : QtGraphs3D::DragMode

Determina cómo se interpretan los eventos de arrastre en el gráfico; puede tomar uno de los valores de la enumeración « QtGraphs3D::DragMode ».

El valor por defecto es ` QtGraphs3D::DragMode::Rotate`.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

QtGraphs3D::DragMode dragMode() const
void setDragMode(QtGraphs3D::DragMode newDragMode)

Señal Notifier:

void dragModeChanged(QtGraphs3D::DragMode dragMode)

Véase también panEnabled.

gridLineType : QtGraphs3D::GridLineType

Esta propiedad se aplica tanto si el tipo de líneas de cuadrícula es « QtGraphs3D::GridLineType::Shader » como « QtGraphs3D::GridLineType::Geometry ».

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

Funciones de acceso:

QtGraphs3D::GridLineType gridLineType() const
void setGridLineType(const QtGraphs3D::GridLineType &gridLineType)

Señal de notificación:

void gridLineTypeChanged()

Véase también « QtGraphs3D::GridLineType ».

horizontalAspectRatio : qreal

Esta propiedad establece la relación de 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 predeterminado es « 0.0 ».

No tiene ningún efecto sobre ` Q3DBarsWidgetItem`, que gestiona el escalado en el plano horizontal mediante las propiedades ` barThickness ` y ` barSpacing `. Los gráficos polares también ignoran esta propiedad.

Funciones de acceso:

qreal horizontalAspectRatio() const
void setHorizontalAspectRatio(qreal ratio)

Señal de notificación:

void horizontalAspectRatioChanged(qreal ratio)

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 sitúan las etiquetas dentro del área de trazado, mientras que los valores positivos las sitúan fuera de ella. La rotación automática de las etiquetas se desactiva cuando el valor es negativo. El valor por defecto es 0.1

Funciones de acceso:

float labelMargin() const
void setLabelMargin(float margin)

Señal de notificación:

void labelMarginChanged(float margin)

Véase también QAbstract3DAxis::labelAutoAngle.

lightColor : QColor

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

Este valor afecta a la luz especificada en « Q3DScene ».

Funciones de acceso:

QColor lightColor() const
void setLightColor(QColor newLightColor)

Señal de notificador:

void lightColorChanged()

lightStrength : float

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

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

Este valor afecta a la luz especificada en Q3DScene.

Funciones de acceso:

float lightStrength() const
void setLightStrength(float newLightStrength)

Señal de notificación:

void lightStrengthChanged()

locale : QLocale

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

El valor por defecto es la configuración regional « "C" ».

Funciones de acceso:

QLocale locale() const
void setLocale(const QLocale &locale)

Señal de notificador:

void localeChanged(const QLocale &locale)

Véase también QValue3DAxis::labelFormat.

margin : qreal

Esta propiedad contiene el valor absoluto que se utiliza para el espacio que queda entre el borde del área trazable del gráfico 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 rango del eje Y si las proporciones del gráfico no se han modificado con respecto a los valores predeterminados. El valor predeterminado es -1.0.

Nota: Establecer un margen para un gráfico de dispersión menor que el margen determinado automáticamente puede provocar que los elementos de dispersión situados en los bordes del gráfico se superpongan con el fondo del gráfico.

Nota: En los gráficos de dispersión y de superficie, si el margen es pequeño en comparación con el tamaño de las etiquetas de los ejes, las posiciones de las etiquetas de los extremos de los ejes se ajustan para evitar que se superpongan con las etiquetas de los extremos de los ejes adyacentes.

Funciones de acceso:

qreal margin() const
void setMargin(qreal margin)

Señal de notificación:

void marginChanged(qreal margin)

maxCameraXRotation : float

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

Funciones de acceso:

float maxCameraXRotation() const
void setMaxCameraXRotation(float rotation)

Señal de notificación:

void maxCameraXRotationChanged(float rotation)

maxCameraYRotation : float

Esta propiedad indica el ángulo máximo de rotación en el eje Y de la cámara alrededor del punto de destino, expresado en grados. El valor por defecto es 90.0

Funciones de acceso:

float maxCameraYRotation() const
void setMaxCameraYRotation(float rotation)

Señal de notificación:

void maxCameraYRotationChanged(float rotation)

maxCameraZoomLevel : float

Esta propiedad establece 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 se ajusta también al nuevo máximo. Si el valor de « cameraZoomLevel » actual se encuentra fuera de los nuevos límites, también se ajusta. El valor por defecto es « 500.0f ».

Funciones de acceso:

float maxCameraZoomLevel() const
void setMaxCameraZoomLevel(float level)

Señal de notificación:

void maxCameraZoomLevelChanged(float zoomLevel)

Véase también cameraZoomLevel y minCameraZoomLevel.

measureFps : bool

Esta propiedad determina si la representación se realiza de forma continua en lugar de bajo demanda.

Si se establece en « true », el renderizado es continuo y se actualiza el valor de la propiedad « currentFps ». El valor por defecto es « false ».

Funciones de acceso:

bool measureFps() const
void setMeasureFps(bool enable)

Señal del notificador:

void measureFpsChanged(bool enabled)

Véase también ` currentFps`.

minCameraXRotation : float

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

Funciones de acceso:

float minCameraXRotation() const
void setMinCameraXRotation(float rotation)

Señal de notificación:

void minCameraXRotationChanged(float rotation)

minCameraYRotation : float

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

Funciones de acceso:

float minCameraYRotation() const
void setMinCameraYRotation(float rotation)

Señal de notificación:

void minCameraYRotationChanged(float rotation)

minCameraZoomLevel : float

Esta propiedad establece 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 nivel de zoom actual (zoomLevel) se encuentra fuera de los nuevos límites, también se ajusta. El nivel mínimo de zoom de la cámara (minCameraZoomLevel) no puede establecerse por debajo de 1.0f. El valor por defecto es 10.0f.

Funciones de acceso:

float minCameraZoomLevel() const
void setMinCameraZoomLevel(float level)

Señal de notificación:

void minCameraZoomLevelChanged(float zoomLevel)

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:

int msaaSamples() const
void setMsaaSamples(int samples)

Señal de notificación:

void msaaSamplesChanged(int samples)

optimizationHint : QtGraphs3D::OptimizationHint

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

El modo predeterminado utiliza el renderizado instanciado y ofrece todas las funciones con el mejor nivel de rendimiento en la mayoría de los sistemas. El modo estático optimiza el renderizado de gráficos y es ideal para conjuntos de datos grandes que no cambian. Es más lento con cambios dinámicos en los datos y rotaciones de elementos. La selección no está optimizada, por lo que no es recomendable utilizar el modo estático con conjuntos de datos masivos. La optimización estática solo funciona en gráficos de dispersión. El modo heredado renderiza todos los elementos del gráfico de forma individual, sin instanciación. Solo debe utilizarse si el modo predeterminado no funciona, es decir, si el sistema de destino no admite la instanciación. El valor predeterminado es QtGraphs3D::OptimizationHint::Default.

Nota: En algunos entornos, es posible que los gráficos de gran tamaño que utilicen la optimización estática no se representen, ya que todos los elementos se representan mediante una única llamada de dibujo, y los distintos controladores gráficos admiten diferentes recuentos máximos de vértices por llamada. Esto suele ser un problema sobre todo en plataformas de 32 bits y OpenGL ES2. Para solucionar este problema, elige una malla de elementos con un número reducido de vértices o utiliza la malla de puntos.

Funciones de acceso:

QtGraphs3D::OptimizationHint optimizationHint() const
void setOptimizationHint(QtGraphs3D::OptimizationHint hint)

Señal de notificador:

void optimizationHintChanged(QtGraphs3D::OptimizationHint hint)

Véase también QAbstract3DSeries::mesh.

orthoProjection : bool

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

El valor por defecto es « false ».

Nota: Las sombras se desactivarán cuando se establezca en true.

Funciones de acceso:

bool isOrthoProjection() const
void setOrthoProjection(bool enable)

Señal de notificación:

void orthoProjectionChanged(bool enabled)

Véase también QAbstract3DAxis::labelAutoAngle.

[since 6.12] panEnabled : bool

Esta propiedad indica si este controlador de entrada permite el desplazamiento por el gráfico.

El valor predeterminado es « true ».

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

bool isPanEnabled() const
void setPanEnabled(bool enable)

Señal de notificación:

void panEnabledChanged(bool enable)

Véase también dragMode y setPanButton().

polar : bool

Esta propiedad se mantiene tanto si los ejes horizontales se transforman en ejes polares como si no.

Si se establece 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.

El valor por defecto es false.

Funciones de acceso:

bool isPolar() const
void setPolar(bool enable)

Señal de notificación:

void polarChanged(bool enabled)

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 solo lectura contiene los resultados de Q3DScene::graphPositionQuery. Los valores se normalizan al intervalo [-1, 1]. Si la posición consultada se encontraba 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 intervalo [-1, 1]. El valor permanecerá indefinido hasta que se realice una consulta.

No existe una única coordenada 3D correcta que se corresponda con una posición concreta de la pantalla, por lo que, para mantener la coherencia, las consultas siempre se realizan respecto a los lados interiores de un rectángulo invisible que rodea el gráfico.

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

Funciones de acceso:

QVector3D queriedGraphPosition() const

Señal de notificación:

void queriedGraphPositionChanged(QVector3D data)

Véase también Q3DScene::graphPositionQuery.

radialLabelOffset : float

Esta propiedad contiene el desplazamiento horizontal normalizado de las etiquetas del eje polar radial.

El valor 0.0 indica que las etiquetas deben dibujarse junto a la línea de la cuadrícula del eje angular en el ángulo 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:

float radialLabelOffset() const
void setRadialLabelOffset(float offset)

Señal de notificación:

void radialLabelOffsetChanged(float offset)

Véase también polar.

rotationEnabled : bool

Esta propiedad indica si este controlador de entrada permite la rotación de gráficos.

El valor por defecto es « true ».

Funciones de acceso:

bool isRotationEnabled() const
void setRotationEnabled(bool enable)

Señal de notificador:

void rotationEnabledChanged(bool enable)

[read-only] scene : Q3DScene* const

Esta propiedad contiene el puntero « Q3DScene », que se puede utilizar para manipular la escena y acceder a los elementos de la misma.

Esta propiedad es de solo lectura.

Funciones de acceso:

Q3DScene *scene() const

[read-only] selectedElement : QtGraphs3D::ElementType

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

Esta propiedad se puede utilizar para consultar el tipo del elemento seleccionado. El tipo es válido hasta que se realice una nueva selección en el gráfico y se emita la señal « selectedElementChanged ».

La señal se puede utilizar, por ejemplo, para implementar controladores de entrada personalizados, tal y como se muestra en el ejemplo de la Galería de gráficos, en la pestaña « Scatter Graph ».

Funciones de acceso:

QtGraphs3D::ElementType selectedElement() const

Señal de notificación:

void selectedElementChanged(QtGraphs3D::ElementType type)

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

selectionEnabled : bool

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

El valor por defecto es « true ».

Funciones de acceso:

bool isSelectionEnabled() const
void setSelectionEnabled(bool enable)

Señal del notificador:

void selectionEnabledChanged(bool enable)

selectionMode : QtGraphs3D::SelectionFlags

Modo de selección de elementos.

Una combinación de SelectionFlags. Por defecto, Item. Los distintos tipos de gráficos admiten diferentes modos de selección.

Funciones de acceso:

QtGraphs3D::SelectionFlags selectionMode() const
void setSelectionMode(const QtGraphs3D::SelectionFlags &selectionMode)

Señal de notificador:

void selectionModeChanged(const QtGraphs3D::SelectionFlags selectionMode)

Véase también QtGraphs3D::SelectionFlags.

shadowQuality : QtGraphs3D::ShadowQuality

Esta propiedad define la calidad de la sombra.

Uno de los valores de la enumeración ShadowQuality. Por defecto, Medium.

Nota: Si no se consigue establecer la calidad de la sombra en un nivel determinado, el nivel se reduce hasta que se establezca correctamente. La señal « shadowQualityChanged » se emite cada vez que se realiza un cambio.

Funciones de acceso:

QtGraphs3D::ShadowQuality shadowQuality() const
void setShadowQuality(const QtGraphs3D::ShadowQuality &shadowQuality)

Señal de notificación:

void shadowQualityChanged(QtGraphs3D::ShadowQuality quality)

Véase también « QtGraphs3D::ShadowQuality ».

shadowStrength : float

Esta propiedad determina la intensidad de las sombras en todo el gráfico.

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

Este valor afecta a la luz especificada en Q3DScene.

Funciones de acceso:

float shadowStrength() const
void setShadowStrength(float newShadowStrength)

Señal de notificación:

void shadowStrengthChanged()

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

Especifica qué técnica de transparencia se debe utilizar. El valor por defecto es « Default ». Al representar gráficos de superficies transparentes, utilice « Approximate » o « Accurate ». Para otros tipos de gráficos, se debe utilizar « Default ».

ConstanteDescripción
DefaultIndica que no se utilizan técnicas de transparencia independientes del orden. Ofrece el mejor rendimiento. Utilízalo cuando los gráficos no contengan transparencia o cuando un gráfico de barras o de dispersión también utilice instanciación, es decir, cuando optimizationHint sea {QtGraphs3D::OptimizationHint::Default}.
ApproximateIndica que el gráfico intenta una aproximación a la transparencia independiente del orden. Este método es más rápido que Accurate y funciona en hardware antiguo, pero puede dar lugar a resultados inexactos. Úsalo cuando se necesite transparencia independiente del orden, pero el coste de rendimiento deba ser menor que al utilizar transparencia independiente del orden precisa.
AccurateIndica que se utiliza una transparencia independiente del orden precisa. Úsala cuando se necesite una representación perfecta de la transparencia.

Esta enumeración se introdujo en Qt 6.9.

Funciones de acceso:

QtGraphs3D::TransparencyTechnique transparencyTechnique() const
void setTransparencyTechnique(QtGraphs3D::TransparencyTechnique technique)

Señal de notificador:

void transparencyTechniqueChanged(QtGraphs3D::TransparencyTechnique technique)

Véase también QtGraphs3D::TransparencyTechnique.

wrapCameraXRotation : bool

Esta propiedad determina 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 repite 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. Por defecto, está establecido en « true ».

Funciones de acceso:

bool wrapCameraXRotation() const
void setWrapCameraXRotation(bool wrap)

Señal de notificación:

void wrapCameraXRotationChanged(bool wrap)

wrapCameraYRotation : bool

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

Si se establece en « true », la rotación Y de la cámara se repite cíclicamente desde el mínimo hasta el máximo y desde el máximo hasta el mínimo. Si se establece en « false », la rotación Y de la cámara queda limitada al sector determinado por los valores mínimo y máximo. Por defecto, está configurado en « true ».

Funciones de acceso:

bool wrapCameraYRotation() const
void setWrapCameraYRotation(bool wrap)

Señal de notificación:

void wrapCameraYRotationChanged(bool wrap)

zoomAtTargetEnabled : bool

Esta propiedad determina si al ampliar o reducir la imagen se debe cambiar el punto de enfoque de la cámara, de modo que el punto ampliado del gráfico permanezca en la misma posición tras el cambio de escala.

El valor predeterminado es « true ».

Funciones de acceso:

bool isZoomAtTargetEnabled() const
void setZoomAtTargetEnabled(bool enable)

Señal de notificación:

void zoomAtTargetEnabledChanged(bool enable)

zoomEnabled : bool

Esta propiedad indica si este controlador de entrada permite el zoom en los gráficos.

El valor predeterminado es « true ».

Funciones de acceso:

bool isZoomEnabled() const
void setZoomEnabled(bool enable)

Señal del notificador:

void zoomEnabledChanged(bool enable)

Documentación de las funciones de miembro

[override virtual noexcept] Q3DGraphsWidgetItem::~Q3DGraphsWidgetItem()

Destruye « Q3DGraphsWidgetItem ».

qsizetype Q3DGraphsWidgetItem::addCustomItem(QCustom3DItem *item)

Añade un objeto ` QCustom3DItem ` item al gráfico. El gráfico asume la propiedad del elemento añadido.

Devuelve el índice del elemento añadido si la operación de 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 que ya está presente.

Los elementos se representan en el orden en que se han insertado. Es necesario tener en cuenta el orden de representación cuando hay elementos opacos y transparentes.

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

void Q3DGraphsWidgetItem::addTheme(QGraphsTheme *theme)

Añade el theme indicado al gráfico. Los temas añadidos mediante addTheme no se utilizan directamente. Solo se asigna la propiedad del tema al gráfico. El theme no debe ser nulo ni estar ya añadido a otro gráfico.

Véase también releaseTheme() y setActiveTheme().

void Q3DGraphsWidgetItem::clearSelection()

Borra la selección de todas las series asociadas.

QList<QCustom3DItem *> Q3DGraphsWidgetItem::customItems() const

Devuelve la lista de todos los elementos personalizados añadidos.

Véase también addCustomItem().

void Q3DGraphsWidgetItem::doPicking(QPoint point)

Realiza la selección utilizando las coordenadas de la vista de point sobre los elementos del gráfico, seleccionando el primer elemento con el que se produce el contacto. El manejo predeterminado de entradas lleva a cabo esta acción al recibir el evento onTapped.

Véase también selectedElement.

void Q3DGraphsWidgetItem::doRayPicking(QVector3D origin, QVector3D direction)

Realiza la selección a partir de origin y en direction sobre los elementos del gráfico, eligiendo el primer elemento encontrado.

Véase también selectedElement.

bool Q3DGraphsWidgetItem::hasSeries(QAbstract3DSeries *series) const

Devuelve si el objeto « series » ya se ha añadido al gráfico.

void Q3DGraphsWidgetItem::releaseCustomItem(QCustom3DItem *item)

Recupera la propiedad del objeto « item » indicado y elimina el objeto « item » del gráfico.

Nota: Si se vuelve a añadir el mismo elemento al gráfico, es necesario volver a configurar la textura o el archivo de textura.

Véase también QCustom3DItem::setTextureImage() y QCustom3DItem::setTextureFile().

void Q3DGraphsWidgetItem::releaseTheme(QGraphsTheme *theme)

Devuelve la propiedad del tema « theme » al llamante, si se había añadido a este gráfico. Si el tema « theme » devuelto está en uso, se creará un nuevo tema predeterminado y se activará.

Si el tema predeterminado se libera y se vuelve a añadir más tarde, se comportará como cualquier otro tema.

Véase también addTheme() y setActiveTheme().

void Q3DGraphsWidgetItem::removeCustomItem(QCustom3DItem *item)

Elimina el « item » personalizado. Borra los recursos que se le habían asignado.

void Q3DGraphsWidgetItem::removeCustomItemAt(QVector3D position)

Elimina todos los elementos personalizados de position. Elimina los recursos que se les han asignado.

void Q3DGraphsWidgetItem::removeCustomItems()

Elimina todos los elementos personalizados. Borra los recursos que se les habían asignado.

QSharedPointer<QQuickItemGrabResult> Q3DGraphsWidgetItem::renderToImage(QSize imageSize = QSize()) const

Renderiza el fotograma actual en una imagen de tipo ` imageSize`. Devuelve un puntero compartido al resultado de la captura, que se puede utilizar para acceder a la imagen renderizada cuando esté lista. La imagen se renderiza con la configuración actual de suavizado.

Véase también QQuickItem::grabToImage().

QAbstract3DAxis *Q3DGraphsWidgetItem::selectedAxis() const

Se puede utilizar para obtener el eje seleccionado tras recibir una señal « selectedElementChanged » con cualquier tipo de etiqueta. La selección es válida hasta la siguiente señal « selectedElementChanged ».

Devuelve el puntero al eje seleccionado o «null».

Véase también selectedElement.

QCustom3DItem *Q3DGraphsWidgetItem::selectedCustomItem() const

Se puede utilizar para obtener el elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » con el tipo «Q3DGraphsWidgetItem::ElementType::CustomItem». La propiedad del elemento sigue correspondiendo al gráfico. La selección es válida hasta la siguiente señal « selectedElementChanged ».

Devuelve el puntero al elemento personalizado seleccionado o null.

Véase también selectedElement.

qsizetype Q3DGraphsWidgetItem::selectedCustomItemIndex() const

Se puede utilizar para consultar el índice del elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » con el tipo «Q3DGraphsWidgetItem::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 Q3DGraphsWidgetItem::selectedLabelIndex() const

Se puede utilizar para consultar el índice de la etiqueta seleccionada tras recibir una 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.

[slot] void Q3DGraphsWidgetItem::setCameraPosition(float horizontal, float vertical, float zoom = 100.0f)

Función de utilidad que establece las rotaciones y la distancia de la cámara. Las propiedades `horizontal ` y ` vertical ` definen las rotaciones de la cámara que se van a utilizar. Se puede especificar el parámetro opcional ` zoom ` para establecer el porcentaje de zoom de la cámara dentro de los límites definidos por las propiedades ` minCameraZoomLevel ` y ` maxCameraZoomLevel `.

[slot, since 6.12] void Q3DGraphsWidgetItem::setPanButton(Qt::MouseButtons button)

Establece el « button » del ratón que se utiliza para activar el desplazamiento en los gráficos 3D.

Esta función se introdujo en Qt 6.12.

Véase también « panEnabled ».

[slot] void Q3DGraphsWidgetItem::setWidget(QQuickWidget *widget)

Establece la instancia de ` widget ` indicada para que se utilice como ` QQuickWidget ` del elemento del widget. El gráfico se establece como contenido de ` QQuickWidget`.

Los gráficos solo se pueden representar en aplicaciones de widgets que utilicen QQuickWidgets.

Ejemplo de uso:

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

Véase también widget().

QList<QGraphsTheme *> Q3DGraphsWidgetItem::themes() const

Devuelve la lista de todos los temas añadidos.

Véase también addTheme().

QQuickWidget *Q3DGraphsWidgetItem::widget() const

Devuelve un puntero a la instancia de ` QQuickWidget ` que se ha establecido para el elemento del widget.

Véase también setWidget().

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