En esta página

Scatter3D QML Type

Gráfico de dispersión en 3D. Más...

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

Propiedades

Señales

Métodos

Descripción detallada

Este tipo permite a los desarrolladores representar gráficos de dispersión en 3D con Qt Quick.

Para utilizar este tipo, tendrás que importar el módulo Qt Graphs:

import QtGraphs

A continuación, podrás utilizar Scatter3D en tus archivos QML:

import QtQuick
import QtGraphs

Item {
    width: 640
    height: 480

    Scatter3D {
        width: parent.width
        height: parent.height
        Scatter3DSeries {
            ItemModelScatterDataProxy {
                itemModel: dataModel
                // Mapping model roles to scatter series item coordinates.
                xPosRole: "xPos"
                yPosRole: "yPos"
                zPosRole: "zPos"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ xPos: "2.754"; yPos: "1.455"; zPos: "3.362"; }
        ListElement{ xPos: "3.164"; yPos: "2.022"; zPos: "4.348"; }
        ListElement{ xPos: "4.564"; yPos: "1.865"; zPos: "1.346"; }
        ListElement{ xPos: "1.068"; yPos: "1.224"; zPos: "2.983"; }
        ListElement{ xPos: "2.323"; yPos: "2.502"; zPos: "3.133"; }
    }
}

Consulta «Gráfico de dispersión sencillo » para ver un ejemplo de uso más detallado.

Consulte también las clases de C++ para 3D:Scatter3DSeries, Spline3DSeries, ScatterDataProxy, Bars3D, Surface3D y Qt Graphs .

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 los 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.0 y 1.0.

aspectRatio : real

La relación de escala del gráfico entre el eje más largo en el plano horizontal y el eje y. El valor predeterminado es « 2.0 ».

Nota: Notiene ningún efecto sobre Bars3D.

Véase también horizontalAspectRatio.

axisX : Value3DAxis

El eje X activo.

Si no se especifica ningún eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

axisY : Value3DAxis

El eje Y activo.

Si no se especifica ningún eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

axisZ : Value3DAxis

El eje Z activo.

Si no se especifica ningún eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

cameraPreset : Graphs3D.CameraPreset

El preajuste de cámara actualmente activo, que es uno de los que se encuentran en 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. El valor por defecto es vector3d(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 correspondiente.

cameraXRotation : real

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

cameraYRotation : real

El ángulo de rotación en Y de la cámara alrededor del punto objetivo, expresado en grados y tomando como punto de partida la posición base actual.

cameraZoomLevel : real

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

Véase también minCameraZoomLevel y maxCameraZoomLevel.

currentFps : int

Cuando se activa la medición de FPS, los resultados del último segundo se almacenan en esta propiedad de solo lectura. Este valor tarda al menos un segundo en actualizarse tras activar la medición.

Véase también measureFps.

customItemList : list<Custom3DItem>

La lista de elementos « Custom3DItem » añadidos al gráfico. El gráfico asume la propiedad de los elementos añadidos.

cutoffMargin : real [since 6.11]

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

Nota: No afectaa los gráficos de barras.

Esta propiedad se introdujo en Qt 6.11.

dragMode : Graphs3D.DragMode [since 6.12]

Determina cómo se interpretan los eventos de arrastre en el gráfico; es uno de los valores de la enumeración Graphs3D.DragMode.

El valor predeterminado es « Graphs3D.DragMode.Rotate ».

Esta propiedad se introdujo en Qt 6.12.

Véase también panEnabled.

gridLineType : Graphs3D.GridLineType

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

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

Véase también « Graphs3D.GridLineType ».

horizontalAspectRatio : real

La relación de escala del gráfico entre el eje x y el eje z. El valor « 0.0 » indica que la escala se ajusta automáticamente en función de los rangos de los ejes. El valor por defecto es « 0.0 ».

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

Véase 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 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

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

Este valor afecta a la luz especificada en Scene3D.

locale : locale

Establece la configuración regional que se utiliza para dar formato a diversas etiquetas numéricas. El valor por defecto es la configuración regional "C".

Véase también Value3DAxis::labelFormat.

margin : real

El valor absoluto que se utiliza para el espacio que queda entre el borde del área del gráfico que se puede trazar 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: Si se establece un margen para un gráfico de dispersión menor que el margen determinado automáticamente, los elementos de dispersión situados en los bordes del gráfico pueden solaparse 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.

maxCameraXRotation : real [since 6.9]

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

Esta propiedad se introdujo en Qt 6.9.

maxCameraYRotation : real [since 6.9]

El ángulo máximo de rotación en el eje Y de la cámara alrededor del punto de referencia, expresado 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 actual, el nivel mínimo se ajusta también al nuevo máximo. Si el valor actual de « cameraZoomLevel » está fuera de los nuevos límites, también se ajusta. El valor por defecto es « 500.0f ».

Véase también cameraZoomLevel y minCameraZoomLevel.

measureFps : bool

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

Véase también currentFps.

minCameraXRotation : real [since 6.9]

El ángulo mínimo de rotación en el eje X de la cámara alrededor del punto objetivo, expresado 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 en Y de la cámara alrededor del punto de destino, expresado 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 actual, el nivel máximo se ajusta también al nuevo mínimo. Si el valor actual de « cameraZoomLevel » se encuentra fuera de los nuevos límites, también se ajusta. El valor de «minCameraZoomLevel» no puede establecerse por debajo de « 1.0 ». El valor por defecto es « 10.0 ».

Véase también cameraZoomLevel y maxCameraZoomLevel.

msaaSamples : int

El número de muestras utilizadas en el suavizado multimuestra cuando renderingMode es Indirect. Cuando renderingMode es DirectToBackground, este valor de propiedad es de solo lectura y devuelve el número de muestras especificado por el formato de superficie de la ventana. El valor por defecto es 4.

Véase también renderingMode.

optimizationHint : Graphs3D.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. 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 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 elemento con un número reducido de vértices o utiliza la malla de puntos.

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

orthoProjection : bool

Si se establece en « true », se utilizará la proyección ortográfica para mostrar el gráfico. El valor por defecto es « false ».

Nota: Las sombras se desactivarán si se establece en true.

panEnabled : bool [since 6.12]

Si este controlador de entrada permite el desplazamiento por el gráfico.

El valor por defecto es « true ».

Esta propiedad se introdujo en Qt 6.12.

polar : bool

Si se establece true, los ejes horizontales se convierten en ejes polares. El eje x pasa a ser el eje angular y el eje z, el eje radial. El modo polar no está disponible para los gráficos de barras.

El valor por defecto es false.

Véase también orthoProjection y radialLabelOffset.

queriedGraphPosition : vector3d [read-only]

Esta propiedad de solo lectura contiene los últimos valores de posición del gráfico a lo largo de cada eje consultados mediante ` Scene3D::graphPositionQuery`. Los valores se normalizan para que estén comprendidos en el intervalo ` [-1, 1]`. Si la posición consultada se encuentra fuera de los límites del gráfico, los valores no reflejarán la posición real, sino que corresponderán a 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.

Véase también Scene3D::graphPositionQuery.

radialLabelOffset : real

Esta propiedad especifica 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 correspondiente al ángulo 0. El valor 1.0 indica que las etiquetas se dibujan en su ubicación habitual, en el borde del fondo del gráfico. Esta propiedad se ignora si el valor de la propiedad «polar» es false. El valor por defecto es 1.0.

Véase también « polar ».

renderingMode : Graphs3D.RenderingMode

Cómo se representará el gráfico. El valor predeterminado es « Indirect ».

Nota: Establecer la propiedad « antialiasing » del gráfico no tiene ningún efecto. Sin embargo, el propio gráfico la establece si el modo de representación actual utiliza suavizado.

Véase también « msaaSamples » y « Graphs3D.RenderingMode ».

rootNode : Node [read-only, since 6.9]

Devuelve un puntero al nodo raíz del gráfico 3D. Utiliza esta propiedad para insertar un gráfico 3D en un « View3D » independiente mediante 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 controlador de entrada permite la rotación del gráfico.

El valor por defecto es « true ».

scene : Scene3D [read-only]

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

Esta propiedad es de solo lectura.

selectedElement : Graphs3D.ElementType [read-only]

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 un manejo de entradas personalizado, tal y como se muestra en el ejemplo «Axis Handling ».

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

selectedSeries : Scatter3DSeries [read-only]

La serie seleccionada o nulo.

selectionEnabled : bool

Si este controlador de entrada permite la selección en el gráfico.

El valor por defecto es « true ».

selectionMode : Graphs3D.SelectionMode

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

seriesList : list<Scatter3DSeries> [default]

Esta propiedad contiene las series del gráfico. Por defecto, esta propiedad contiene una lista vacía. Para establecer las series, utiliza el método addSeries() o defínelas como elementos secundarios del gráfico.

shadowQuality : Graphs3D.ShadowQuality

La calidad de las sombras. Uno de los valores de la enumeración Graphs3D.ShadowQuality.

shadowStrength : real

La intensidad de las sombras para 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 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 se debe utilizar. El valor predeterminado 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. Úsese 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 más 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. Utilízala cuando se necesite una representación perfecta de la transparencia.

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 pasa 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 repite 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 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 está limitada entre los valores mínimo y máximo sin que se produzca ningún rebote.

Si se establece « true », la rotación Y de la cámara se repite de mínimo a máximo y de máximo a mínimo. Si se establece « 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 al hacer zoom se debe cambiar el punto de referencia de la cámara para que el punto ampliado del gráfico permanezca en la misma posición tras el zoom.

El valor por defecto es ` true`.

zoomEnabled : bool

Si este controlador de entrada permite el zoom en el gráfico.

El valor por defecto es « true ».

Documentación de Signal

axisXChanged(ValueAxis3D axis)

Esta señal se emite cuando axisX cambia a axis.

Nota: El controlador correspondiente es onAxisXChanged.

axisYChanged(ValueAxis3D axis)

Esta señal se emite cuando axisY cambia a axis.

Nota: El controlador correspondiente es onAxisYChanged.

axisZChanged(ValueAxis3D axis)

Esta señal se emite cuando axisZ cambia a axis.

Nota: El controlador correspondiente es onAxisZChanged.

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

Esta señal se emite cuando se pulsa dos veces sobre el elemento del gráfico en un breve lapso de tiempo. El parámetro de señal « eventPoint » contiene información del evento de liberación sobre el punto en el que se ha pulsado, y « button » indica el « mouse button » en el que se ha hecho clic, o « NoButton » en una pantalla táctil.

Nota: El controlador correspondiente es « onDoubleTapped ».

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

dragged(QVector2D delta)

Esta señal se emite cuando se modifica la traslación del conjunto de puntos del gráfico mientras se realiza el gesto de pellizco. El vector delta indica la variación en la traslación.

Nota: El controlador correspondiente es onDragged.

Véase también ` PinchHandler::translationChanged`.

longPressed()

Esta señal se emite cuando se mantiene pulsado el elemento « parent » durante un tiempo superior a « TapHandler::longPressThreshold ».

Nota: El controlador 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». El valor « mousePos » indica la posición del ratón mientras este se está moviendo.

Nota: El controlador correspondiente es ` onMouseMove`.

Véase también QQuickItem::mouseMoveEvent.

pinch(qreal delta)

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

Nota: El controlador correspondiente es onPinch.

Véase también PinchHandler::scaleChanged.

selectedSeriesChanged(Scatter3DSeries series)

Esta señal se emite cuando selectedSeries cambia a series.

Nota: El controlador correspondiente es onSelectedSeriesChanged.

tapped(QEventPoint eventPoint, Qt::MouseButton button)

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

Nota: El controlador 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 controlador correspondiente es ` onWheel`.

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

Documentación del método

qsizetype addCustomItem(Custom3DItem item)

Añade un objeto ` Custom3DItem ` item al gráfico. El gráfico asume la propiedad 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 que ya está presente.

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

void addSeries(Scatter3DSeries series)

Añade la serie « series » al gráfico. Un gráfico puede contener varias series, pero solo tiene un conjunto de ejes. Si la serie recién añadida tiene un elemento seleccionado, este se resaltará y se desactivará cualquier selección existente. Solo una de las series añadidas puede tener una selección activa.

Véase también GraphsItem3D::hasSeries().

void clearSelection()

Borra la selección de todas las series asociadas.

void 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 doRayPicking(QVector3D origin, QVector3D direction)

Realiza la selección a partir de origin y en direction sobre los elementos del grafo, seleccionando el primer elemento encontrado.

Véase también selectedElement.

bool hasSeries(Abstract3DSeries series)

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

void releaseCustomItem(Custom3DItem item)

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

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

Véase también Custom3DItem::textureFile.

void removeCustomItem(Custom3DItem item)

Elimina el « item » personalizado. Borra los recursos que se le han asignado.

void removeCustomItemAt(vector3d position)

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

void removeCustomItems()

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

void removeSeries(Scatter3DSeries series)

Elimina el « series » del gráfico.

Véase también GraphsItem3D::hasSeries().

Abstract3DAxis selectedAxis()

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 eje seleccionado o nulo.

Véase también selectedElement.

Custom3DItem selectedCustomItem()

Se puede utilizar para obtener el elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » de tipo « 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 elemento personalizado seleccionado o null.

Véase también selectedElement.

qsizetype selectedCustomItemIndex()

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

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

void setDefaultInputHandler()

* * @brief Restablece el mecanismo predeterminado de gestión de entradas. * * Este método reactiva los gestores de entradas internos y predefinidos. * Úsalo para volver al comportamiento predeterminado tras haber llamado previamente a * unsetDefaultInputHandler. *

Véase también unsetDefaultInputHandler().

void setDragButton(Qt::MouseButtons button)

* * @brief Establece el botón del ratón que se utiliza para activar los eventos de arrastre. * * Este método permite cambiar el botón del ratón necesario para iniciar * una operación de arrastre a button. * El valor predeterminado es Qt::RightButton.

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

* * * @brief Establece el botón del ratón que se utiliza para activar eventos de desplazamiento. * * Este método permite cambiar el botón del ratón necesario para iniciar * una operación de arrastre a button. * El valor predeterminado es Qt::MiddleButton.

Este método se introdujo en Qt 6.12.

void unsetDefaultDragHandler()

* * @brief Desactiva el controlador de eventos de arrastre predeterminado. * * Esto desactiva específicamente la respuesta integrada a los gestos de arrastre. * Utiliza esta opción si necesitas implementar un controlador personalizado para el arrastre. *

Véase también unsetDefaultInputHandler().

void unsetDefaultInputHandler()

* * @brief Desactiva el mecanismo predeterminado de gestión de entradas. * * Este método desactiva todos los gestores de entradas predeterminados predefinidos. * Llama a este método cuando quieras anular los comportamientos predeterminados. *

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

void unsetDefaultPinchHandler()

* * @brief Desactiva el controlador predeterminado de gestos de pellizco. * * Esto desactiva específicamente la respuesta integrada a los gestos de pellizco. * Utilízalo para implementar un controlador personalizado de gestos de pellizco. *

Véase también unsetDefaultInputHandler().

void unsetDefaultTapHandler()

* * @brief Desactiva el controlador de eventos de toque predeterminado. * * Esto desactiva específicamente la respuesta integrada a los eventos de toque o clic, * lo que permite implementar una lógica personalizada para gestionar los toques. *

Véase también unsetDefaultInputHandler().

void unsetDefaultWheelHandler()

* * @brief Desactiva el controlador de eventos predeterminado de la rueda del ratón. * * En concreto, desactiva la respuesta integrada al desplazamiento con la rueda del ratón. * Utilízalo cuando implementes un comportamiento personalizado de la rueda. *

Véase 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.