Propriétés spéciales

  • 5 minutes

Les formulaires possèdent quelques propriétés et opérateurs nommés que nous aurions tendance à oublier. Cette section décrit quand et comment utiliser la propriété Error, la propriété Unsaved, l’opérateur nommé ThisItem et l’opérateur nommé Parent.

Propriété Error

La propriété Error contient la sortie des messages d’erreur générés par le contrôle Formulaire. Pour voir le contenu de la propriété, ajoutez un contrôle Libellé de texte à l’écran, puis, pour la propriété Text, entrez la formule Form1.Error. Elle sera vide s’il n’existe aucune erreur. Par contre, si vous essayez d’envoyer un formulaire sans renseigner toutes les colonnes obligatoires, un message du style « Une entrée est requise ou une valeur est non valide. Corrigez et réessayez. » Vous pouvez utiliser cette valeur dans les formules ou d’autres contrôles pour concevoir la gestion des erreurs de vos applications.

Propriété Unsaved

La propriété Unsaved est une propriété booléenne qui a la valeur true quand un formulaire a été modifié mais pas envoyé. Vous pouvez utiliser cette propriété pour vérifier si l’utilisateur a des modifications non enregistrées. Par exemple, supposons que vous configurez le bouton Précédent de votre application pour vérifier si le formulaire n’a pas été enregistré et, si effectivement des données ne sont pas enregistrées, ne pas continuer la navigation. Pour ce faire, vous pouvez utiliser la formule suivante dans la propriété OnSelect d’un contrôle Bouton.

If(YourFormName.Unsaved = false, Navigate(WelcomeScreen, ScreenTransition.Cover))

Cette fonction vérifie si le contrôle Formulaire nommé YourFormName a la valeur false pour la propriété Unsaved. Si la propriété a la valeur false, l’utilisateur est alors dirigé vers l’écran appelé WelcomeScreen. Si la propriété a la valeur true, rien ne se produit. Dans votre application, vous pouvez développer ce concept afin d’ajouter un message d’avertissement ou même une fenêtre contextuelle indiquant à l’utilisateur pourquoi il n’a pas pu continuer la navigation.

En plus de ces propriétés, le contrôle Formulaire inclut les opérateurs nommés ThisItem et Parent avec le contrôle Galerie.

Opérateur nommé ThisItem

Dans votre contrôle Formulaire ou Galerie, vous pouvez référencer les valeurs de l’enregistrement actuel en utilisant ThisItem. C’est utile lorsque vous créez manuellement des formules pour référencer des valeurs de l’enregistrement. Par exemple, si vous souhaitez ajouter une étiquette qui combine les colonnes FirstName et LastName en une seule chaîne avec un espace au milieu, vous pouvez utiliser la formule suivante.

ThisItem.FirstName & " " & ThisItem.LastName

Cette formule suppose que vous disposez d’une colonne appelée FirstName et d’une colonne appelée LastName pour l’enregistrement que vous affichez dans le contrôle Formulaire.

Opérateur nommé Parent

Dans les contrôles Formulaire et Galerie, il existe le concept d’objet parent. Dans le cas d’un contrôle Entrée ou autre dans un contrôle Formulaire, vous pouvez extraire une propriété à partir de la carte de données à l’aide de Parent et le nom de la propriété que vous souhaitez référencer. La valeur par défaut est un exemple. Les cartes de données stockent cette valeur dans leur propriété Default. À partir d’un contrôle Entrée, vous pouvez référencer cette valeur avec la formule Parent.Default dans la valeur Default du contrôle Entrée. Les galeries utilisent le même concept Parent pour interroger les propriétés du contrôle Galerie dans les contrôles de la galerie.