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.
| Constante | Valor | Descripción |
|---|---|---|
QScrollerProperties::Fps60 | 1 | 60 fotogramas por segundo |
QScrollerProperties::Fps30 | 2 | 30 fotogramas por segundo |
QScrollerProperties::Fps20 | 3 | 20 fotogramas por segundo |
QScrollerProperties::Standard | 0 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | El sobrepaso es posible cuando el contenido es desplazable. Este es el valor predeterminado. |
QScrollerProperties::OvershootAlwaysOff | 1 | El sobrepaso nunca está habilitado, ni siquiera cuando el contenido es desplazable. |
QScrollerProperties::OvershootAlwaysOn | 2 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | Este 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::DragStartDistance | 1 | Esta 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::DragVelocitySmoothingFactor | 2 | Un 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::AxisLockThreshold | 3 | Restringe 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::ScrollingCurve | 4 | El 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::DecelerationFactor | 5 | Este 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::MinimumVelocity | 6 | La velocidad mínima necesaria tras finalizar el toque o soltar el ratón para iniciar el desplazamiento en m/s. |
QScrollerProperties::MaximumVelocity | 7 | Esta es la velocidad máxima que se puede alcanzar en m/s. |
QScrollerProperties::MaximumClickThroughVelocity | 8 | Esta 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::AcceleratingFlickMaximumTime | 9 | Es 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::AcceleratingFlickSpeedupFactor | 10 | La velocidad actual se multiplica por este número si se detecta un «flick acelerado». Debe ser >= 1. |
QScrollerProperties::SnapPositionRatio | 11 | Esta 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::SnapTime | 12 | Este 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::OvershootDragResistanceFactor | 13 | Este 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::OvershootDragDistanceFactor | 14 | Esta 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::OvershootScrollDistanceFactor | 15 | Esta 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::OvershootScrollTime | 16 | Es el tiempo, en seconds, que se utiliza para reproducir la animación completa de sobrepaso. |
QScrollerProperties::HorizontalOvershootPolicy | 17 | Esta es la política de sobrepaso horizontal (véase OvershootPolicy). |
QScrollerProperties::VerticalOvershootPolicy | 18 | Esta es la política de sobrepaso horizontal (véase OvershootPolicy). |
QScrollerProperties::FrameRate | 19 | Esta 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::ScrollMetricCount | 20 | Esta 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.