ViewForm |
Voir le formulaire |
| Power Fx |
Syntaxe
Paramètres
| Nom |
Description |
| FormName |
Ce paramètre représente le nom du formulaire que l'on souhaite afficher en mode lecture seule. |
Description
Cette fonction permet de changer un formulaire en mode affichage.
Remarques
- Permet de passer un formulaire en lecture seule : La fonction ViewForm est utilisée pour modifier dynamiquement le mode d'affichage d'un formulaire, en
le plaçant en mode lecture seule. Cela empêche toute modification des champs tout en permettant à l'utilisateur de consulter les données.
- Utile pour des interfaces utilisateurs contrôlées : ViewForm est souvent employée dans des interfaces où l'on souhaite alterner entre
visualisation et édition, par exemple après une soumission de formulaire ou lorsqu'un utilisateur ne dispose que de droits de lecture.
- Le paramètre doit correspondre à un contrôle formulaire valide : Le paramètre FormName doit être le nom exact d'un contrôle Form dans
l'application. Si le nom est incorrect ou inexistant, la fonction n'aura aucun effet et pourrait générer des erreurs ou comportements inattendus.
- Peut être combinée avec des conditions ou des boutons : Il est courant d'utiliser ViewForm dans l'action OnSelect d'un bouton ou au sein de formules
conditionnelles (avec If ou Switch), pour adapter dynamiquement l'expérience utilisateur en fonction du
contexte ou des autorisations.
- Contribue à la sécurité et à l'intégrité des données : En forçant un formulaire en mode lecture via ViewForm, on empêche l'utilisateur de modifier
accidentellement ou intentionnellement les données. C'est un moyen simple mais efficace de protéger les informations sensibles ou critiques.
- Ne modifie pas les données affichées : La fonction ne change pas les données liées au formulaire, seulement son mode d'interaction. Elle n'affecte ni
la source de données ni les valeurs affichées, ce qui garantit une séparation claire entre présentation et logique de données.
- Fonction complémentaire de EditForm et NewForm : ViewForm fait partie d'un trio avec EditForm (pour l'édition) et NewForm (pour la création). Ensemble,
ces fonctions permettent de gérer les différents états d'un formulaire selon le scénario d'utilisation de l'application.
- Indispensable pour la navigation entre écrans : Dans des applications avec plusieurs écrans, ViewForm est souvent appelée juste avant une navigation
(Navigate(Screen)), afin que le formulaire cible s'affiche immédiatement dans l'état souhaité. Cela assure une expérience fluide et intuitive pour l'utilisateur.
Dernière mise à jour : Jeudi, le 1 Mai 2025