QScrollerProperties Class
La clase QScrollerProperties almacena la configuración de un QScroller. Más...
| Cabecera: | #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.
Los parámetros por defecto dependen de la plataforma para que Qt emule el comportamiento de la plataforma para el desplazamiento cinético.
Como convención las QScrollerProperties están en unidades físicas (metros, segundos) y son convertidas por QScroller usando el DPI actual.
Ver también QScroller.
Documentación de tipos de miembros
enum QScrollerProperties::FrameRates
Este enum describe las velocidades 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 imágenes por segundo |
QScrollerProperties::Standard | 0 | el valor por defecto es 60 fotogramas por segundo (que corresponde a QAbstractAnimation). |
enum QScrollerProperties::OvershootPolicy
Este enum describe los distintos modos de rebasamiento.
| Constante | Valor | Descripción |
|---|---|---|
QScrollerProperties::OvershootWhenScrollable | 0 | La sobreimpresión es posible cuando el contenido es desplazable. Este es el valor por defecto. |
QScrollerProperties::OvershootAlwaysOff | 1 | La sobreimpresión nunca está activada, aunque el contenido sea desplazable. |
QScrollerProperties::OvershootAlwaysOn | 2 | La sobreimpresión siempre está activada, aunque el contenido no se pueda desplazar. |
enum QScrollerProperties::ScrollMetric
Este enum contiene los diferentes tipos de métrica de desplazamiento. Cuando no se indica lo contrario, la función setScrollMetric espera un QVariant de tipo qreal.
Consulte la documentación de QScroller para más detalles sobre los conceptos que subyacen a los diferentes valores.
| Constante | Valor | Descripción |
|---|---|---|
QScrollerProperties::MousePressEventDelay | 0 | Es el tiempo que se retrasa un evento de pulsación del ratón al iniciar un gesto de desplazamiento en [s]. Si el gesto se dispara dentro de ese tiempo, no se envía ninguna pulsación o liberación del ratón al objeto desplazado. Si se dispara después de ese tiempo, se envía la pulsación del ratón retrasada más un evento de liberación simulado en la posición global QPoint(-QWIDGETSIZE_MAX, -QWIDGETSIZE_MAX). Si el gesto se cancela, se envían tanto la pulsación retardada del ratón como el evento de liberación real. |
QScrollerProperties::DragStartDistance | 1 | Se trata de la distancia mínima que el punto táctil o del ratón debe desplazarse antes de que se desencadene el gesto de deslizamiento en m. |
QScrollerProperties::DragVelocitySmoothingFactor | 2 | Un valor que describe hasta qué punto las nuevas velocidades de arrastre se incluyen en la velocidad de desplazamiento final. Este valor debe estar comprendido entre 0 y 1. Cuanto menor sea el valor, más suavizado se aplicará a la velocidad de arrastre. |
QScrollerProperties::AxisLockThreshold | 3 | Restringe el desplazamiento a un eje si el desplazamiento está dentro de un ángulo alrededor del eje. El umbral debe estar comprendido entre 0 y 1. |
QScrollerProperties::ScrollingCurve | 4 | El QEasingCurve utilizado cuando se desacelera la velocidad de desplazamiento después de un flick iniciado por el usuario. Tenga en cuenta que se trata de la curva de deceleración de las posiciones, no de la velocidad: el valor por defecto es QEasingCurve::OutQuad, que da como resultado una disminución lineal de la velocidad (1ª derivada) y una deceleración constante (2ª derivada). |
QScrollerProperties::DecelerationFactor | 5 | Este factor influye en el tiempo que tarda el scroller en desacelerar hasta la velocidad 0. El valor real depende de la ScrollingCurve elegida. Para la mayoría de los tipos el valor debe estar en el rango de 0.1 a 2.0 |
QScrollerProperties::MinimumVelocity | 6 | La velocidad mínima que se necesita después de finalizar el toque o soltar el ratón para iniciar el desplazamiento en m/s. |
QScrollerProperties::MaximumVelocity | 7 | 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 clic en m/s. Esto significa que un clic en un objeto que se desplaza actualmente (lentamente) no sólo detendrá el desplazamiento, sino que el evento de clic también se enviará al control UI. Esto es útil cuando se utilizan curvas de desplazamiento de tipo exponencial. |
QScrollerProperties::AcceleratingFlickMaximumTime | 9 | Este es el tiempo máximo en seconds que un gesto de flick puede tardar en ser reconocido como un flick acelerado. Si se establece en cero, no se detecta ningún gesto de este tipo. Un "flick acelerado" es un gesto de flick ejecutado sobre un objeto que ya se está desplazando. En estos casos, la velocidad de desplazamiento se multiplica por AcceleratingFlickSpeedupFactor para acelerarla. |
QScrollerProperties::AcceleratingFlickSpeedupFactor | 10 | La velocidad actual se multiplica por este número si se detecta un gesto de aceleración. Debe ser >= 1. |
QScrollerProperties::SnapPositionRatio | 11 | Es la distancia que el usuario debe arrastrar el área entre dos puntos de encaje para encajarla en la siguiente posición. 0.33 significa que el desplazamiento sólo debe alcanzar un tercio de la distancia entre dos puntos de encaje para encajarse en el siguiente. La relación debe estar entre 0 y 1. |
QScrollerProperties::SnapTime | 12 | Es el factor de tiempo de la curva de desplazamiento. Un valor más bajo significa que el desplazamiento tardará más. La distancia de desplazamiento es independiente de este valor. |
QScrollerProperties::OvershootDragResistanceFactor | 13 | Este valor es el factor entre el arrastre del ratón y el movimiento real del área de desplazamiento (durante el rebasamiento). El factor debe estar comprendido entre 0 y 1. |
QScrollerProperties::OvershootDragDistanceFactor | 14 | Esta es la distancia máxima para los movimientos de rebasamiento durante el arrastre. La distancia de rebasamiento real se calcula multiplicando este valor por el tamaño de la ventana gráfica del objeto desplazado. El factor debe estar entre 0 y 1. |
QScrollerProperties::OvershootScrollDistanceFactor | 15 | Esta es la distancia máxima para los movimientos de rebasamiento durante el desplazamiento. La distancia de rebasamiento real 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::OvershootScrollTime | 16 | Este es el tiempo en seconds que se utiliza para reproducir la animación completa de rebasamiento. |
QScrollerProperties::HorizontalOvershootPolicy | 17 | Esta es la política de rebasamiento horizontal (véase OvershootPolicy). |
QScrollerProperties::VerticalOvershootPolicy | 18 | Esta es la política de rebasamiento horizontal (ver OvershootPolicy). |
QScrollerProperties::FrameRate | 19 | Esta es la velocidad de fotogramas que debe utilizarse mientras se arrastra o se desplaza. 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 estándar de 60 fotogramas por segundo es demasiado rápido, puede reducirse con este ajuste, sin dejar de estar sincronizado con QAbstractAnimation. Ten en cuenta que aquí sólo se permiten los valores del enum FrameRates. |
QScrollerProperties::ScrollMetricCount | 20 | Esta es siempre la última entrada. |
Documentación de las funciones miembro
QScrollerProperties::QScrollerProperties()
Construye nuevas propiedades de desplazamiento.
QScrollerProperties::QScrollerProperties(const QScrollerProperties &sp)
Construye una copia de sp.
[virtual noexcept] QScrollerProperties::~QScrollerProperties()
Destruye las propiedades del scroller.
QVariant QScrollerProperties::scrollMetric(QScrollerProperties::ScrollMetric metric) const
Consulta el valor metric de las propiedades del scroller.
Véase también setScrollMetric() y ScrollMetric.
[static] void QScrollerProperties::setDefaultScrollerProperties(const QScrollerProperties &sp)
Establece las propiedades de desplazamiento para todos los nuevos objetos QScrollerProperties a sp.
Utilice esta función para anular las propiedades predeterminadas de la plataforma devueltas por el constructor predeterminado. Si sólo desea cambiar las propiedades de desplazamiento de un único desplazamiento, utilice QScroller::setScrollerProperties()
Nota: La llamada a esta función no cambiará 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 metric ScrollerMetric en value.
Véase también scrollMetric() y ScrollMetric.
[static] void QScrollerProperties::unsetDefaultScrollerProperties()
Devuelve las propiedades del scroller devueltas por el constructor por defecto a las propiedades por defecto de la plataforma.
Véase también setDefaultScrollerProperties().
bool QScrollerProperties::operator!=(const QScrollerProperties &sp) const
Devuelve true si estas propiedades de desplazamiento son diferentes de sp; en caso contrario devuelve false.
QScrollerProperties &QScrollerProperties::operator=(const QScrollerProperties &sp)
Asigna sp a estas propiedades de desplazamiento y devuelve una referencia a estas propiedades de desplazamiento.
bool QScrollerProperties::operator==(const QScrollerProperties &sp) const
Devuelve true si estas propiedades 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.
