Compartilhar via


Função Reset

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

Redefine um controle para o respectivo valor padrão, descartando quaisquer alterações de usuário.

Descrição

A função Reset redefine o controle ao respectivo valor da propriedade Default. Quaisquer alterações do usuário são descartadas.

Não é possível redefinir os controles que estão dentro de um controle Gallery ou Edit form de fora desses controles. Você pode redefinir controles de fórmulas em controles dentro da mesma galeria ou formulário. Você também pode redefinir todos os controles dentro de um formulário com a função ResetForm.

Usar a função Reset é uma alternativa para ativar/desativar a propriedade Reset dos controles de entrada e é geralmente preferível. A propriedade Reset pode ser uma opção melhor se muitos controles precisam ser redefinidos juntamente com várias fórmulas. É possível ativar/desativar a propriedade Reset de um controle Button com a fórmula Reset = Button.Pressed ou de uma variável com Reset = MyVar e ativando/desativando MyVar com a fórmula Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).

Controles de entrada também são redefinidos quando as respectivas propriedades Default são alteradas.

Reset não tem valor de retorno e você pode usá-lo somente em fórmulas de comportamento.

Sintaxe

Redefinir( Controle )

  • Controle – Obrigatório. O controle a redefinir.

Exemplo

  1. Insira um controle Text input em uma tela. Por padrão, o nome dele será TextInput1 e a propriedade Default será definida como "Entrada de texto".
  2. Digite um novo valor na caixa de texto.
  3. Inserir um controle Button na tela.
  4. Defina a propriedade OnSelect do botão para Reset( TextInput1 ).
  5. Selecione o botão. Isso pode ser feito mesmo durante a criação, selecionando em direção às extremidades do controle.
  6. O conteúdo da caixa de texto será retornado como o valor da propriedade Default.