En esta página

QScrollerProperties Class

La clase QScrollerProperties almacena la configuración de un QScroller. Más...

Encabezado: #include <QScrollerProperties>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Tipos públicos

enum FrameRates { Fps60, Fps30, Fps20, Standard }
enum OvershootPolicy { OvershootWhenScrollable, OvershootAlwaysOff, OvershootAlwaysOn }
enum ScrollMetric { MousePressEventDelay, DragStartDistance, DragVelocitySmoothingFactor, AxisLockThreshold, ScrollingCurve, …, ScrollMetricCount }

Funciones públicas

QScrollerProperties()
QScrollerProperties(const QScrollerProperties &sp)
virtual ~QScrollerProperties()
QVariant scrollMetric(QScrollerProperties::ScrollMetric metric) const
void setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)
bool operator!=(const QScrollerProperties &sp) const
QScrollerProperties &operator=(const QScrollerProperties &sp)
bool operator==(const QScrollerProperties &sp) const

Miembros públicos estáticos

void setDefaultScrollerProperties(const QScrollerProperties &sp)
void unsetDefaultScrollerProperties()

Descripción detallada

La clase QScrollerProperties almacena los parámetros utilizados por ` QScroller`.

La configuración predeterminada depende de la plataforma, de modo que Qt emula el comportamiento de la plataforma en lo que respecta al desplazamiento cinético.

Por convención, los valores de `QScrollerProperties` se expresan en unidades físicas (metros, segundos) y ` QScroller ` los convierte utilizando el DPI actual.

Véase también QScroller.

Documentación sobre los tipos de miembros

enum QScrollerProperties::FrameRates

Esta enumeración describe las frecuencias de fotogramas disponibles que se utilizan al arrastrar o desplazarse.

ConstanteValorDescripción
QScrollerProperties::Fps60160 fotogramas por segundo
QScrollerProperties::Fps30230 fotogramas por segundo
QScrollerProperties::Fps20320 fotogramas por segundo
QScrollerProperties::Standard0El valor por defecto es de 60 fotogramas por segundo (lo que corresponde a QAbstractAnimation).

enum QScrollerProperties::OvershootPolicy

Esta enumeración describe los distintos modos de sobreimpulso.

ConstanteValorDescripción
QScrollerProperties::OvershootWhenScrollable0El sobrepaso es posible cuando el contenido es desplazable. Este es el valor predeterminado.
QScrollerProperties::OvershootAlwaysOff1El sobrepaso nunca está habilitado, ni siquiera cuando el contenido es desplazable.
QScrollerProperties::OvershootAlwaysOn2El sobrepaso siempre está habilitado, incluso cuando el contenido no es desplazable.

enum QScrollerProperties::ScrollMetric

Esta enumeración contiene los distintos tipos de métricas de desplazamiento. A menos que se indique lo contrario, la función ` setScrollMetric ` espera un ` QVariant ` de tipo `qreal`.

Consulta la documentación de QScroller para obtener más detalles sobre los conceptos que subyacen a los distintos valores.

ConstanteValorDescripción
QScrollerProperties::MousePressEventDelay0Este es el tiempo de retardo de un evento de pulsación del ratón al iniciar un gesto de deslizamiento en [s]. Si el gesto se activa dentro de ese tiempo, no se envía ninguna pulsación ni liberación del ratón al objeto desplazado. Si se activa tras ese retraso, se envía la pulsación de ratón retrasada junto con un evento de suelta simulado en la posición global QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX). Si se cancela el gesto, se envían tanto la pulsación de ratón retrasada como el evento de suelta real.
QScrollerProperties::DragStartDistance1Esta es la distancia mínima que debe desplazarse el punto táctil o del ratón antes de que se active el gesto de deslizamiento en m.
QScrollerProperties::DragVelocitySmoothingFactor2Un valor que describe en qué medida se incluyen las nuevas velocidades de arrastre en la velocidad de desplazamiento final. Este valor debe estar comprendido entre 0 y 1. Cuanto menor sea el valor, mayor será el suavizado aplicado a la velocidad de arrastre.
QScrollerProperties::AxisLockThreshold3Restringe el movimiento a un solo eje si este se produce dentro de un ángulo alrededor de dicho eje. El umbral debe estar comprendido entre 0 y 1.
QScrollerProperties::ScrollingCurve4El QEasingCurve utilizado al desacelerar la velocidad de desplazamiento tras un movimiento rápido iniciado por el usuario. Ten en cuenta que se trata de la curva de aceleración/deceleración para las posiciones, no para la velocidad: el valor por defecto es QEasingCurve::OutQuad, lo que da lugar a una disminución lineal de la velocidad (primera derivada) y a una desaceleración constante (segunda derivada).
QScrollerProperties::DecelerationFactor5Este factor influye en el tiempo que tarda el control de desplazamiento en desacelerar hasta una velocidad de 0. El valor real depende de la ScrollingCurve elegida. Para la mayoría de los tipos, el valor debería estar en el rango comprendido entre 0.1 y 2.0
QScrollerProperties::MinimumVelocity6La velocidad mínima necesaria tras finalizar el toque o soltar el ratón para iniciar el desplazamiento en m/s.
QScrollerProperties::MaximumVelocity7Esta es la velocidad máxima que se puede alcanzar en m/s.
QScrollerProperties::MaximumClickThroughVelocity8Esta es la velocidad máxima de desplazamiento permitida para un «click-through» en m/s. Esto significa que un clic sobre un objeto que se está desplazando (lentamente) en ese momento no solo detendrá el desplazamiento, sino que el evento de clic también se transmitirá al control de la interfaz de usuario. Esto resulta útil cuando se utilizan curvas de desplazamiento de tipo exponencial.
QScrollerProperties::AcceleratingFlickMaximumTime9Es el tiempo máximo en seconds que puede tardar un gesto de deslizamiento rápido en ser reconocido como un deslizamiento rápido acelerado. Si se establece en cero, no se detecta ningún gesto de este tipo. Un «deslizamiento acelerado» es un gesto de deslizamiento ejecutado sobre un objeto que ya se está desplazando. En tales casos, la velocidad de desplazamiento se multiplica por AcceleratingFlickSpeedupFactor para acelerarlo.
QScrollerProperties::AcceleratingFlickSpeedupFactor10La velocidad actual se multiplica por este número si se detecta un «flick acelerado». Debe ser >= 1.
QScrollerProperties::SnapPositionRatio11Esta es la distancia que el usuario debe arrastrar el área entre dos puntos de ajuste para que esta se ajuste a la siguiente posición. 0.33 significa que el desplazamiento solo debe alcanzar un tercio de la distancia entre dos puntos de ajuste para ajustarse al siguiente. La relación debe estar comprendida entre 0 y 1.
QScrollerProperties::SnapTime12Este es el factor de tiempo de la curva de desplazamiento. Un valor más bajo significa que el desplazamiento tardará más tiempo. La distancia de desplazamiento es independiente de este valor.
QScrollerProperties::OvershootDragResistanceFactor13Este valor es el factor que relaciona el arrastre del ratón con el movimiento real del área de desplazamiento (durante el sobrepaso). El factor debe estar comprendido entre 0 y 1.
QScrollerProperties::OvershootDragDistanceFactor14Esta es la distancia máxima para los movimientos de sobrepaso durante el arrastre. La distancia real de sobrepaso se calcula multiplicando este valor por el tamaño de la ventana gráfica del objeto desplazado. El factor debe estar comprendido entre 0 y 1.
QScrollerProperties::OvershootScrollDistanceFactor15Esta es la distancia máxima de los movimientos de sobrepaso durante el desplazamiento. La distancia real de sobrepaso se calcula multiplicando este valor por el tamaño del área visible del objeto desplazado. El factor debe estar comprendido entre 0 y 1.
QScrollerProperties::OvershootScrollTime16Es el tiempo, en seconds, que se utiliza para reproducir la animación completa de sobrepaso.
QScrollerProperties::HorizontalOvershootPolicy17Esta es la política de sobrepaso horizontal (véase OvershootPolicy).
QScrollerProperties::VerticalOvershootPolicy18Esta es la política de sobrepaso horizontal (véase OvershootPolicy).
QScrollerProperties::FrameRate19Esta es la velocidad de fotogramas que debe utilizarse al arrastrar o desplazarse. QScroller utiliza internamente un temporizador QAbstractAnimation para sincronizar todas las operaciones de desplazamiento con otras animaciones que puedan estar activas al mismo tiempo. Si el valor predeterminado de 60 fotogramas por segundo resulta demasiado rápido, se puede reducir con este ajuste, sin perder la sincronización con QAbstractAnimation. Ten en cuenta que aquí solo se permiten los valores de la enumeración FrameRates.
QScrollerProperties::ScrollMetricCount20Esta es siempre la última entrada.

Documentación de funciones de miembro

QScrollerProperties::QScrollerProperties()

Crea nuevas propiedades del control de desplazamiento.

QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)

Crea una copia de sp.

[virtual noexcept] QScrollerProperties::~QScrollerProperties()

Elimina las propiedades del control de desplazamiento.

QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const

Consulta el valor de « metric » de las propiedades del control de desplazamiento.

Véase también setScrollMetric() y ScrollMetric.

[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)

Establece las propiedades del control de desplazamiento para todos los nuevos objetos ` QScrollerProperties ` en ` sp`.

Utiliza esta función para anular las propiedades predeterminadas de la plataforma que devuelve el constructor por defecto. Si solo deseas modificar las propiedades de desplazamiento de un único control de desplazamiento, utiliza ` QScroller::setScrollerProperties()`.

Nota: Al llamar a esta función no se modificará el contenido de los objetos ` QScrollerProperties ` ya existentes.

Véase también unsetDefaultScrollerProperties().

void QScrollerProperties::setScrollMetric(QScrollerProperties::ScrollMetric metric, const QVariant &value)

Establece un valor específico de la métrica « metric » de ScrollerMetric en « value ».

Véase también scrollMetric() y ScrollMetric.

[static] void QScrollerProperties::unsetDefaultScrollerProperties()

Restablece las propiedades del control de desplazamiento devueltas por el constructor predeterminado a las propiedades predeterminadas de la plataforma.

Véase también setDefaultScrollerProperties().

bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const

Devuelve « true » si estas propiedades del control de desplazamiento son diferentes de « sp »; en caso contrario, devuelve « false ».

QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)

Asigna « sp » a estas propiedades del control de desplazamiento y devuelve una referencia a dichas propiedades.

bool QScrollerProperties::operator==(const QScrollerProperties &sp) const

Devuelve « true » si estas propiedades del control de desplazamiento son iguales a « sp »; en caso contrario, devuelve « false ».

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