Función Reset

Se aplica a: Aplicaciones de Canvas Aplicaciones basadas en modelos

Restablece un control a su valor predeterminado, descartando cualquier modificación del usuario.

Descripción

La función Reset restablece un control al valor de su propiedad Default. Se descartan los cambios que haya realizado el usuario.

No es posible restablecer los controles que estén en un control Gallery o Edit form desde fuera de dichos controles. Los controles se pueden restablecer desde las fórmulas de los controles que estén en la misma galería o formulario. También es posible restablecer todos los controles de un formulario con la función ResetForm.

La función Reset es una alternativa al uso la propiedad Reset de los controles de entrada y, por lo general, se prefiere usar la función, en lugar de la propiedad. La propiedad Reset puede ser una opción mejor si es preciso restablecer conjuntamente muchos controles de varias fórmulas. La activación o desactivación de la propiedad Reset se puede realizar desde un control Button con la fórmula Reset = Button.Pressed o desde una variable con Reset = MyVar, y la activación o desactivación de MyVar con la fórmula Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).

Los controles de entrada también se restablecen cuando su propiedad Default cambia.

Reset no tiene valor de retorno y solo se puede usar en fórmulas de comportamiento.

Sintaxis

Restablecer( Control )

• Control – Obligatorio. El control que se restablece.

Ejemplo

1. Inserte un control Text input en una pantalla. De forma predeterminada, su nombre será TextInput1 y el valor de su propiedad Default será "Text input".
2. Escriba un valor nuevo en el cuadro de texto.
3. Inserte un control Button en la pantalla.
4. Establezca la propiedad OnSelect del botón en Reset( TextInput1 ).
5. Seleccione el botón. Esto puede hacerse incluso durante la creación mediante la realización de la selección hacia los extremos del control.
6. El contenido del cuadro de texto volverá al valor de la propiedad Default.