Função Redefinir no PowerAppsReset function in PowerApps

Redefine um controle para o respectivo valor padrão, descartando quaisquer alterações de usuário.Resets a control to its default value, discarding any user changes.

DescriçãoDescription

A função Redefinir redefine o controle ao respectivo valor da propriedade Padrão.The Reset function resets a control to its Default property value. Quaisquer alterações do usuário são descartadas.Any user changes are discarded.

Não é possível redefinir os controles que estão dentro de um controle Galeria ou editar formulário de fora desses controles.You cannot reset controls that are within a Gallery or Edit form control from outside those controls. Você pode redefinir controles de fórmulas em controles dentro da mesma galeria ou formulário.You can reset controls from formulas on controls within the same gallery or form. Você também pode redefinir todos os controles dentro de um formulário com a função ResetForm.You can also reset all the controls within a form with the ResetForm function.

Usar a função Redefinir é uma alternativa para ativar/desativar a propriedade Redefinir dos controles de entrada e é geralmente preferível.Using the Reset function is an alternative to toggling the Reset property of input controls and is generally preferred. A propriedade Redefinir pode ser uma opção melhor se muitos controles precisam ser redefinidos juntamente com várias fórmulas.The Reset property may be a better choice if many controls need to be reset together from multiple formulas. É possível ativar/desativar a propriedade Redefinir de um controle de Botão 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 ).Toggling the Reset property can be done from a Button control with the formula Reset = Button.Pressed or from a variable with Reset = MyVar and toggling MyVar with the formula Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).

Controles de entrada também são redefinidos quando as respectivas propriedades Padrão são alteradas.Input controls are also reset when their Default property changes.

Redefinir não tem nenhum valor retornado e você pode usá-la somente em fórmulas de comportamento.Reset has no return value, and you can use it only in behavior formulas.

SintaxeSyntax

Reset( Controle )Reset( Control )

  • Controle – obrigatório.Control – Required. O controle a redefinir.The control to reset.

ExemploExample

  1. Insira um controle de Entrada de texto em uma tela.Insert a Text input control on a screen. Por padrão, o nome dele será TextInput1 e sua propriedade Padrão será definida como "Entrada de texto".By default, it's name will be TextInput1 and its Default property will be set to "Text input".
  2. Digite um novo valor na caixa de texto.Type a new value in the text box.
  3. Inserir um controle de Botão na tela.Insert a Button control on the screen.
  4. Defina a propriedade OnSelect do botão para Reset( TextInput1 ).Set the button's OnSelect property to Reset( TextInput1 ).
  5. Selecione o botão.Select the button. Isso pode ser feito mesmo durante a criação, selecionando em direção às extremidades do controle.This can be done even when authoring by selecting toward the ends of the control.
  6. O conteúdo da caixa de texto será retornado como o valor da propriedade Padrão.The contents of the text box will return to the value of the Default property.