BoundaryRule QML Type
Define una restricción sobre el rango de valores que se pueden establecer en una propiedad numérica. Más información...
| Import Statement: | import Qt.labs.animation |
Propiedades
- currentOvershoot : real
- easing : enumeration
- enabled : bool
- maximum : real
- maximumOvershoot : real
- minimum : real
- minimumOvershoot : real
- overshootFilter : enumeration
- overshootScale : real
- peakOvershoot : real
- returnDuration : int
Señales
Métodos
- bool returnToBounds()
Descripción detallada
Una BoundaryRule define el rango de valores que puede tener una propiedad concreta. Cuando se intentaría establecer un valor fuera de ese rango, aplica una «resistencia» mediante una curva de aceleración.
Por ejemplo, la siguiente «BoundaryRule» impide que un « DragHandler » arrastre el «Rectangle» demasiado lejos:
import QtQuick
import Qt.labs.animation
Rectangle {
id: root
width: 170; height: 120
color: "green"
DragHandler {
id: dragHandler
yAxis.minimum: -1000
xAxis.minimum: -1000
onActiveChanged: if (!active) xbr.returnToBounds();
}
BoundaryRule on x {
id: xbr
minimum: -50
maximum: 100
minimumOvershoot: 40
maximumOvershoot: 40
}
}Ten en cuenta que a una propiedad no se le puede asignar más de una regla de límite (BoundaryRule).
Véase también Animaciones y transiciones en Qt Quick, ejemplo de comportamiento, Qt Qmly «Ejemplos deQt Quick: controladores de puntero».
Documentación de propiedades
currentOvershoot : real
Esta propiedad contiene la diferencia entre el valor más reciente asignado a la propiedad interceptada y el valor maximum, o entre dicho valor y el valor minimum.
Es positivo si el valor de la propiedad supera maximum, negativo si el valor de la propiedad es inferior a minimum, o 0 si el valor de la propiedad se encuentra dentro de ambos límites.
easing : enumeration
Esta propiedad define la curva de aceleración que se aplicará en el modo de sobrepaso (siempre que se incumpla la restricción « minimum » o « maximum », mientras el valor se encuentre aún dentro del rango de sobrepaso correspondiente).
La curva de aceleración predeterminada es QEasingCurve::OutQuad.
enabled : bool
Esta propiedad determina si la regla se aplicará cuando la propiedad objeto de seguimiento cambie de valor.
De forma predeterminada, la opción « BoundaryRule » está activada.
maximum : real
Esta propiedad contiene el valor sin restricciones más alto que puede tener. Si se le asigna un valor superior, quedará restringida por easing y maximumOvershoot.
El valor por defecto es 1.
maximumOvershoot : real
Esta propiedad indica en qué medida se permite que el valor de la propiedad supere maximum. Siempre que el valor sea mayor que maximum y menor que maximum + maximumOvershoot, queda limitado por la curva easing. Cuando el valor intenta superar maximum + maximumOvershoot, se produce una parada brusca.
El valor por defecto es 0.
minimum : real
Esta propiedad contiene el valor sin restricciones más pequeño que puede tener. Si se le asigna un valor menor, quedará restringida por easing y minimumOvershoot.
El valor por defecto es 0.
minimumOvershoot : real
Esta propiedad determina en qué medida puede ser inferior a minimum. Siempre que el valor sea inferior a minimum y superior a minimum - minimumOvershoot, estará limitado por la curva easing. Cuando el valor intente situarse por debajo de minimum - minimumOvershoots, se producirá una parada brusca.
El valor por defecto es 0.
overshootFilter : enumeration
Esta propiedad especifica la función de agregación que se aplicará al valor de la propiedad interceptada.
Si se establece en « BoundaryRule.None » (valor predeterminado), la propiedad interceptada tendrá un valor cuyo rebasamiento se limita a « currentOvershoot ». Si se establece en « BoundaryRule.Peak », la propiedad interceptada tendrá un valor cuyo rebasamiento se limita a « peakOvershoot ».
overshootScale : real
Esta propiedad indica la cantidad en la que se escala el controlador de entrada ( easing ) durante la condición de sobrepaso. Por ejemplo, si se restringe que un elemento se desplace más de 100 píxeles más allá de un límite determinado, y el usuario (mediante algún controlador de entrada) intenta arrastrarlo 100 píxeles más allá de dicho límite, si overshootScale se establece en 1, el usuario lo conseguirá: el único efecto de la curva de aceleración es modificar la velocidad a la que el elemento se desplaza desde el sobrepaso 0 hasta el sobrepaso 100. Pero si se establece en 0,5, el controlador de entrada « BoundaryRule » ( ) ofrece resistencia, de modo que cuando el usuario intente moverlo 100 píxeles, el elemento solo se desplazará 50 píxeles; y la curva de aceleración modula la velocidad de movimiento de tal forma que, al principio, puede moverse en sincronía con el movimiento que intenta realizar el usuario y, a continuación, se ralentiza, dependiendo de la forma de la curva de aceleración.
El valor por defecto es 0,5.
peakOvershoot : real
Esta propiedad almacena el valor más positivo o más negativo de ` currentOvershoot ` que se haya registrado, hasta que se llame a ` returnToBounds()`.
Esto puede resultar útil cuando se sabe que el valor de la propiedad interceptada fluctúa y se desea detectar y reaccionar ante el valor máximo de sobrepaso, en lugar de ante las fluctuaciones.
Véase también overshootFilter.
returnDuration : int
Esta propiedad indica el tiempo, en milisegundos, que tardará ` returnToBounds()` en devolver la propiedad de destino al valor más cercano. Si se establece en 0, ` returnToBounds()` establecerá la propiedad de forma inmediata, en lugar de crear una tarea de animación.
El valor por defecto es 100 ms.
Documentación de Signal
returnedToBounds()
Esta señal se emite cuando currentOvershoot vuelve de nuevo a 0, tras haberse incumplido la restricción maximum o minimum. Si el retorno es animado, la señal se emite cuando finaliza la animación.
Nota: El controlador correspondiente es onReturnedToBounds.
Véase también returnDuration y returnToBounds().
Documentación del método
bool returnToBounds()
Devuelve la propiedad interceptada con un valor comprendido entre minimum y maximum, de modo que tanto currentOvershoot como peakOvershoot sean cero. Esto se animará si returnDuration es mayor que cero.
Devuelve «true» si era necesario ajustar el valor, o «false» si ya se encontraba dentro de los límites.
Véase también returnedToBounds.
© 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.