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 |
- Lista de todos los miembros, incluidos los heredados
- Q3DGraphsWidgetItem forma parte de las clases C++ para widgets deQt Graphs .
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 ».
| Constante | Descripción |
|---|---|
Default | Indica 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}. |
Approximate | Indica 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. |
Accurate | Indica 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.