Partager via


Élément event

Définit une expression Power FX qui peut être configurée dans Power Apps Studio, puis déclenchée dans le code du composant.

Disponible pour

Applications canevas et applications pilotées par modèle

Propriétés

Nonm Description Type Requise Disponible pour
name Le nom de l’événement string Oui Applications canevas et applications pilotées par modèle
display-name-key Utilisé dans les écrans de personnalisation comme chaînes localisées qui décrivent le nom de l’événement. string Oui Applications de canevas
description-key Utilisé dans les écrans de personnalisation comme chaînes localisées qui décrivent la description de l’événement. string Facultatif Applications de canevas
pfx-default-value La valeur de l’expression Power Fx par défaut fournie au composant. Voir Remarques Facultatif Applications de canevas

Remarques

Utilisez la valeur de propriété pfx-default-value pour évaluer les événements et les propriétés à l’aide d’expressions Power Fx au lieu de valeurs statiques par défaut. Vous pouvez l’utiliser pour :

  • Dimensionner le contrôle de manière réactive
  • Accéder aux connecteurs
  • Fournir des exemples de données
  • Référencer les propriétés de thème
  • Événements personnalisés

Nonte

  • Vous pouvez utiliser n’importe quelle expression Power Fx, mais vous devez garantir que l’expression est valide lors de l’importation du contrôle.
  • Si vous utilisez des guillemets internes ou d’autres caractères spéciaux, placez la valeur entre guillemets simples, par exemple : pfx-default-value='"Test"'
  • Vous pouvez référencer d’autres contrôles (y compris des écrans) et leurs propriétés. Écrivez ces références sous la forme : %ControlName.ID%.ControlProperty. Par exemple : pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Écrivez des énumérations telles que DisplayType et ScreenTransition sous la forme : %EnumName.RESERVED%.EnumValue. Par exemple : pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Si pfx-default-value est inclus, alors il est prioritaire sur default-value.

Éléments parents

Élément Description
control Définit l’espace de noms du composant, la version et les informations d’affichage.

Exemple

<event name="OnSelectCustomButton"
   pfx-default-value='SubmitForm(%MyFormName.ID%); Back(%ScreenTransition.RESERVED%.Cover)'
   display-name-key="OnSelectCustomButton_Display_Key"
   description-key="OnSelectCustomButton_Desc_Key" />

Référence du schéma de manifeste Power Apps component framework
Référence des API Power Apps component framework
Vue d'ensemble de Power Apps component framework