De functie Reset

Van toepassing op: Canvas-apps Modelgestuurde apps

Hiermee stelt u een besturingselement in op de standaardwaarde en worden gebruikerswijzigingen verworpen.

Beschrijving

Met de functie Reset stelt u een eigenschap van een besturingselement weer in op de waarde van de eigenschap Default. Alle door gebruikers doorgevoerde wijzigingen worden verworpen.

U kunt besturingselementen binnen een besturingselement van het type Gallery of Edit form niet opnieuw instellen buiten die besturingselementen. U kunt besturingselementen van formules op besturingselementen opnieuw instellen binnen dezelfde galerie of formulier. U kunt ook alle besturingselementen in een formulier opnieuw instellen met de functie ResetForm.

De functie Reset vormt een alternatief voor het in- of uitschakelen van de eigenschap Reset van de invoerbesturingselementen en geniet over het algemeen de voorkeur. De eigenschap Reset is mogelijk een betere keuze als veel besturingselementen uit meerdere formules samen opnieuw moeten worden ingesteld. De eigenschap Reset kan worden geschakeld via een besturingselement Button met de formule Reset = Button.Pressed of via een variabele met Reset = MyVar en dan MyVar schakelen met de formule Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).

Invoerbesturingselementen worden ook opnieuw ingesteld wanneer hun eigenschap Default wijzigt.

Reset heeft geen retourwaarde en u kunt deze functie alleen gebruiken in gedragsformules.

Syntaxis

Reset( Besturingselement )

  • Besturingselement: vereist. Het besturingselement dat u opnieuw wilt instellen.

Voorbeeld

  1. Voeg een besturingselement Text input toe aan een scherm. Standaard worden de naam TextInput1 en de bijbehorende eigenschap Default ingesteld op 'Text input'.
  2. Typ een nieuwe waarde in het tekstvak.
  3. Voeg een besturingselement Button toe aan het scherm.
  4. Stel de eigenschap OnSelect van de knop in op Reset( TextInput1 ).
  5. Selecteer de knop. Dit kan zelfs bij het ontwerpen worden gedaan door voor het einde van het besturingselement te selecteren.
  6. De inhoud van het tekstvak wordt ingesteld op de waarde van de eigenschap Default.