Formules de comportement pour les composants (expérimental)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Important

Il s’agit d’une fonctionnalité expérimentale. Pour plus d’informations, voir Fonctionnalités expérimentales et d’aperçu.

Spécifiez une ou plusieurs formules de comportement qui s’exécutent lorsqu’un événement déclenche une modification des instances de composant.

Par exemple, définissez une propriété OnReset du composant sur une ou plusieurs formules qui effectuent l’initialisation et effacent la saisie. Réinitialisez les valeurs lorsque la fonction Reset s’exécute sur les instances de composant.

Notes

La fonctionnalité permettant de créer des propriétés comportementales personnalisées est actuellement expérimentale. Cependant, vous pouvez utiliser la propriété OnReset par défaut disponible sur tous les composants de votre environnement de production.

OnReset

Avec un maître de composant sélectionné, sélectionnez OnReset dans la liste déroulante des propriétés (sur le côté gauche de la barre de formule), puis entrez une ou plusieurs formules.

Pour tester OnReset, configurez un contrôle pour réinitialiser le composant. Par exemple, définissez la propriété OnSelect d’un bouton sur cette formule : Réinitialiser(ComponentName).

Exemple : Réinitialiser le minuteur

Dans ce composant de sélecteur de temps, deux variables sont utilisées pour afficher le temps _selectedHour et _selectedMinute. Lorsque le sélecteur est réinitialisé, ces variables doivent être réinitialisées à une valeur par défaut, disons 12 :12.  La propriété OnReset du composant a la formule suivante : Set(_selectedHour,12); Set(_selectedMinute,12)

Pour déclencher la réinitialisation, accédez à un écran et insérez une instance du composant. Ajoutez un bouton et configurez OnSelect du bouton pour appeler Reset(TimerComponent_instance) pour déclencher OnReset.

Mettre à jour OnReset à l’aide d’une propriété personnalisée

Outre la réinitialisation d’une instance de composant depuis l’extérieur du composant, il existe une autre méthode pour déclencher OnReset de l’intérieur. « Augmenter OnReset lorsque la valeur change » est une option lors de la création d’une propriété d’entrée personnalisée. Elle permet le changement de valeur de cette propriété pour déclencher OnReset du composant. Cette méthode est conçue pour définir et réinitialiser facilement la valeur par défaut.

Exemple

L’exemple ci-dessus montre la révision des numéros de commande et la mise à jour des numéros. Le composant numérique de haut en bas est utilisé pour augmenter ou diminuer le nombre de commandes. Lors de la sélection de la galerie à gauche, le numéro par défaut du composant numérique haut et bas est réinitialisé pour afficher le numéro de commande de l’outil sélectionné. Augmenter OnReset lorsque la valeur change a permis de réinitialiser la valeur par défaut lorsque l’entrée change.

Pour ce faire, cochez Augmenter OnReset lorsque la valeur change de la propriété d’entrée par défaut. La valeur OnReset du composant est définie sur Set(_numericValue,’Numeric up down’.DefaultValue). _numericValue est la variable pour stocker la valeur de la valeur de la commande actuelle. Définissez la valeur Par défaut de la commande d’entrée de texte sur If(IsBlank(_numericValue), ’Numeric up down’.DefaultValue, _numericValue).

Voir aussi

• Composants de canevas
• Bibliothèque de composants
• Gestion du cycle de vie des applications (ALM) de la bibliothèque de composants
• Formules de comportement pour les composants
• Power Apps component framework
• Ajouter des composants canevas à une page personnalisée dans une application pilotée par modèle

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).