En esta página

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

Señales

Métodos

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.