Função Reset
Aplica-se a:
Aplicações de tela Aplicações condicionadas por modelo
Repõe um controlo para o valor predefinido, rejeitando as alterações do utilizador.
Descrição
A função Reset repõe um controlo para o valor Default da propriedade. Todas as alterações do utilizador são eliminadas.
Não pode repor controlos que fazem parte de um controlo Gallery ou Edit form fora desses controlos. Pode repor controlos de fórmulas em controlos dentro da mesma galeria ou formulário. Também pode repor todos os controlos de um formulário com a função ResetForm.
A utilização da função Reset é uma alternativa à alternância da propriedade Reset dos controlos de entrada e é geralmente preferencial. A propriedade Reset poderá ser a melhor opção se for necessário repor vários controlos em conjunto a partir de várias fórmulas. A alternância da propriedade Reset pode ser feita a partir de um controlo Button com a fórmula Reset = Button.Pressed ou a partir de uma variável com Reset = MyVar e a alternância de MyVar com a fórmula Button.OnSelect = Set (MyVar, true ); Set(MyVar, false ).
Os controlos de entrada também são repostos quando for alterada a propriedade Default.
A função Reset não devolve nenhum valor e só pode ser utilizada em fórmulas de comportamento.
Sintaxe
Reset( Control )
- Control – Obrigatório. O controlo a repor.
Exemplo
- Insira um controlo de Text input num ecrã. Por predefinição, o nome será TextInput1 e a propriedade Default será definida como "Entrada de texto".
- Introduza um novo valor na caixa de texto.
- Insira um controlo Button no ecrã.
- Defina a propriedade OnSelect do botão como Reset( TextInput1 ).
- Selecione o botão. Esta ação pode ser realizada mesmo durante a criação ao selecionar em direção às extremidades do controlo.
- O conteúdo da caixa de texto devolverá o valor da propriedade Default.