# Fournit l’expérience d’affichage et de modification d’un champ unique d’un contrôle Display form (Afficher le formulaire) ou Edit form (Modifier le formulaire).

Description

## Les contrôles Display form (Afficher le formulaire) et Edit form (Modifier le formulaire) jouent le rôle de conteneurs pour l’affichage d’enregistrements complets. Chaque conteneur peut inclure un ensemble de contrôles Card (Carte) qui affichent des champs individuels ou offrent un moyen de mettre à jour ces champs. Chaque carte présente une propriété DataField qui spécifie le champ de l’enregistrement pour lequel il fonctionne.

Il existe des cartes prédéfinies pour différents types de données et expériences utilisateur. Par exemple, il peut y avoir une carte permettant de modifier un champ numérique à l’aide d’un contrôle Text input (Entrée de texte), ce qui est idéal pour une utilisation avec le clavier. Une autre carte peut prendre en charge la modification d’un nombre en utilisant un contrôle Slider (Curseur) à la place. Lorsque le contrôle de formulaire est sélectionné, vous pouvez facilement sélectionner une carte en fonction d’un champ dans le volet droit.

Les cartes peuvent elles-mêmes contenir des contrôles. Les contrôles d’une carte composent l’expérience d’affichage et de modification d’un champ unique. Par exemple, une carte numérique peut comprendre un contrôle Label pour fournir le nom d’affichage du champ et un contrôle Text input pour fournir un éditeur pour la valeur du champ. La carte peut également avoir un contrôle Label qui affiche les erreurs de validation qui se produisent et un contrôle Label pour l’astérisque habituel indiquant qu’un champ est obligatoire.

Vous pouvez personnaliser les contrôles d’une carte prédéfinie en la redimensionnant, en la déplaçant, en la masquant, en y ajoutant des contrôles et en apportant d’autres modifications. Vous pouvez également commencer avec une carte complètement vide, une « carte personnalisée », à laquelle vous ajoutez des contrôles à partir de zéro.

Les cartes prédéfinies sont verrouillées par défaut. Dans une carte verrouillée, vous pouvez modifier uniquement certaines propriétés du contrôle ou les contrôles qu’elle contient. Vous ne pouvez pas la supprimer. Vous pouvez afficher le verrou de la carte et le déverrouiller dans l’onglet View (Affichage) de la vue Advanced (Avancé). Si une propriété est verrouillée et ne peut pas être modifiée, elle s’affiche avec une icône de verrou en regard de son nom. Le déverrouillage d’une carte est une opération avancée qui doit être effectuée avec précaution, car la génération de formule automatique ne se fera plus pour la carte, et il n’est pas possible de verrouiller à nouveau une carte.

Dans le conteneur du formulaire, l’enregistrement ThisItem est disponible et contient tous les champs de l’enregistrement. Par exemple, la propriété Default de la carte est souvent définie sur ThisItem.FieldName.

Vous pouvez utiliser la référence Parent pour configurer un contrôle de manière à faire référence aux propriétés d’une carte. Par exemple, un contrôle doit utiliser Parent.Default pour lire l’état initial du champ dans la source de données. Lorsque vous utilisez Parent au lieu d’accéder directement aux informations souhaitées, la carte est mieux encapsulée et vous pouvez changer le champ sans rompre les formules internes.

Pour obtenir des exemples sur la personnalisation, le déverrouillage et la création de cartes, consultez Comprendre les cartes de données.

Principales propriétés

## DataField : nom du champ d’un enregistrement que cette carte affiche et modifie.

  • Le nom doit être une chaîne statique unique placée entre guillemets (par exemple, "Name"), et non une formule.
  • Supprimez la liaison d’une carte en définissant sa propriété DataField sur blank. Les propriétés Valid et Update sont ignorées pour les cartes non liées.

Default : valeur initiale d’un contrôle avant sa modification par l’utilisateur.

  • Pour chaque contrôle d’une carte, définissez cette propriété sur Parent.Default pour faire référence à la valeur par défaut du champ en fonction de la source de données. Par exemple, définissez la propriété Default d’un contrôle Slider (Curseur) sur Parent.Default pour vous assurer que l’utilisateur démarre avec une valeur générique pour le curseur correspondant.

DisplayName : nom convivial d’un champ dans une source de données.

  • La fonction DataSourceInfo fournit ces métadonnées à partir de la source de données.
  • Les contrôles que contient la carte doivent utiliser Parent.DisplayName pour faire référence au nom du champ.

Error : message d’erreur convivial à afficher pour ce champ lorsque la validation échoue.

  • Cette propriété est définie lorsque la fonction SubmitForm est appelée.
  • Le message décrit les problèmes de validation en fonction des métadonnées de la source de données et en vérifiant la propriété Required.

Required : indique si une carte, qui modifie le champ d’une source de données, doit contenir une valeur.

  • La fonction DataSourceInfo fournit les métadonnées requises à partir de la source de données.
  • Les contrôles que contient la carte doivent utiliser Parent.Required pour déterminer si ce champ de la carte est requis.

Update : valeur à écrire dans la source de données pour un champ.

  • Utilisez la formule de cette propriété pour extraire les valeurs des contrôles de modification de la carte afin de les écrire dans la source de données. Par exemple, définissez la propriété Update d’une carte sur Slider.Value pour mettre à jour la source de données avec une valeur issue du curseur de cette carte.

Width : distance entre les côtés droit et gauche d’un contrôle.

WidthFit : indique si un contrôle s’agrandit automatiquement dans le sens horizontal pour remplir l’espace vide d’un contrôle de conteneur tel qu’un contrôle Edit form. Si plusieurs cartes ont cette propriété définie sur true, l’espace est réparti entre elles. Pour plus d’informations, voir Comprendre la mise en page du formulaire de données.

Propriétés supplémentaires

##

BorderColor : couleur de bordure du contrôle.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness : épaisseur de bordure d’un contrôle.

Fill : couleur d’arrière-plan d’un contrôle.

Height : distance entre le haut et le bas d’un contrôle.

Valid : indique si un contrôle Card (Carte) ou Edit form (Modifier le formulaire) contient des entrées valides, prêtes à être envoyées à la source de données.

Visible : indique si un contrôle est visible ou est masqué.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou l’écran s’il n’y a pas de conteneur parent). Pour un contrôle Card dans un conteneur comprenant plusieurs colonnes, cette propriété détermine la colonne dans laquelle la carte s’affiche.

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou l’écran s’il n’y a pas de conteneur parent). Pour un contrôle Card dans un conteneur comprenant plusieurs lignes, cette propriété détermine la ligne dans laquelle la carte s’affiche.

Exemples

##

Pour obtenir des exemples, voir Comprendre les cartes de données et Comprendre la mise en page du formulaire de données.