ResetForm

Syntaxe

Paramètres

Description

Cette fonction permet de réinitialiser un formulaire à son état par défaut.

Remarques

• Réinitialise tous les champs d'un formulaire en une seule commande : La fonction ResetForm() est idéale pour réinitialiser l'ensemble des contrôles contenus dans un formulaire, en une seule instruction. Elle est plus pratique que d'appeler Reset() individuellement sur chaque champ, ce qui la rend indispensable pour maintenir un code propre et concis.
• Remet les champs à leurs valeurs initiales définies par la propriété Default : Quand ResetForm() est utilisée, chaque contrôle du formulaire revient à la valeur indiquée dans sa propriété Default. Cela signifie que pour maîtriser précisément l'effet de la réinitialisation, il faut bien configurer cette propriété pour chaque champ.
• Utile après une soumission ou une annulation de formulaire : Dans les scénarios d'enregistrement ou d'annulation de données, ResetForm() permet de repartir à zéro sans redémarrer l'application. Elle est souvent associée à un bouton "Annuler" ou à une logique conditionnelle après validation.
• Fonctionne uniquement sur des objets de type formulaire (EditForm ou DisplayForm) : ResetForm() s'applique exclusivement aux contrôles de type formulaire. Elle ne peut pas être utilisée directement sur des contrôles indépendants situés hors d'un formulaire, ce qui la distingue de Reset().
• Permet de corriger rapidement une saisie erronée : Si un utilisateur réalise une erreur de saisie, ResetForm() offre une manière rapide de tout effacer et de recommencer. Cela améliore la fluidité d'utilisation et évite les frustrations liées à la modification manuelle champ par champ.
• Indispensable dans les applications avec formulaire en boucle ou à répétition : Lorsque plusieurs enregistrements sont saisis en série (exemple : création de plusieurs contacts ou produits), ResetForm() est idéale pour préparer automatiquement le formulaire à une nouvelle saisie, dès qu'un enregistrement est validé.
• Se combine souvent avec NewForm() ou EditForm() pour contrôler l'état du formulaire : Il est courant d'utiliser ResetForm() avec NewForm() pour afficher un formulaire vide, ou avec EditForm() pour revenir à l'état initial d'un enregistrement en cours de modification. Cette combinaison permet de gérer dynamiquement les différents scénarios d'usage.
• Améliore la maintenabilité et la lisibilité du code Power Fx : Plutôt que de multiplier les lignes avec Reset(Control1), Reset(Control2),..., l'utilisation de ResetForm() simplifie grandement la logique. Elle centralise la réinitialisation dans un seul appel, ce qui rend le code plus clair et plus facile à faire évoluer.