Fonction Reset

S’applique à : Applications canevas Applications pilotées par modèle

Réinitialise un contrôle à sa valeur par défaut, en ignorant les modifications de l’utilisateur.

Description

La fonction Reset réinitialise un contrôle à sa valeur de propriété Default. Toutes les modifications de l’utilisateur sont ignorées.

Vous ne pouvez pas réinitialiser les contrôles qui se trouvent dans un contrôle Gallery ou Edit form depuis l’extérieur de ces contrôles. Vous pouvez réinitialiser des contrôles à partir de formules sur les contrôles situés dans la même galerie ou le même formulaire. Vous pouvez également réinitialiser tous les contrôles d’un formulaire avec la fonction ResetForm.

L’utilisation de la fonction Reset est une alternative au basculement de la propriété Reset des contrôles d’entrée et c’est généralement la méthode préférée. La propriété Reset peut être un meilleur choix si de nombreux contrôles doivent être réinitialisés à partir de plusieurs formules. Le basculement de la propriété Reset peut être effectué à partir d’un contrôle Button avec la formule Reset = Button.Pressed ou à partir d’une variable avec la formule Reset = MyVar et en basculant MyVar avec la formule Button.OnSelect = Set(MyVar, true); Set (MyVar, false).

Les contrôles d’entrée sont également réinitialisés lorsque leur propriété Default change.

Reset ne retourne aucune valeur et vous pouvez l’utiliser uniquement dans une formule de comportement.

Syntaxe

Reset( Control )

  • Control : obligatoire. Contrôle à réinitialiser.

Exemple

  1. Insérez un contrôle Text input sur un écran. Par défaut, son nom est TextInput1 et sa propriété Default est définie sur Text input.
  2. Tapez une nouvelle valeur dans la zone de texte.
  3. Insérez un contrôle Button sur l’écran.
  4. Définissez la propriété OnSelect du bouton sur Reset( TextInput1 ).
  5. Sélectionnez le bouton. Cette opération est possible même lors de la création en sélectionnant vers les extrémités du contrôle.
  6. Le contenu de la zone de texte retourne la valeur de la propriété Default.