event 元素

定义可在 Power Apps Studio 中配置的 Power FX 表达式,然后在组件代码中触发。

适用于

画布和模型驱动应用

属性

Name Description 类型 必选 适用于
name 事件的名称 string 是的 画布和模型驱动应用
display-name-key 在自定义屏幕中用作描述事件名称的本地化字符串。 string 是的 画布应用
description-key 在自定义屏幕中用作描述事件说明的本地化字符串。 string 可选 画布应用
pfx-default-value 提供给组件的默认 Power Fx 表达式值。 请参阅 备注 可选 画布应用

注解

使用 pfx-default-value 属性值通过 Power Fx 表达式而不是静态默认值来计算事件和属性。 可以使用以下方法:

  • 响应式调整控件的大小
  • 访问连接器
  • 提供示例数据
  • 引用主题属性
  • 自定义事件

注释

  • 可以使用任何 Power Fx 表达式,但必须在导入控件时确保表达式有效。
  • 如果使用内部引号或其他特殊字符,请将值包装在单引号中,例如: pfx-default-value='"Test"'
  • 可以引用其他控件(包括屏幕)及其属性。 将这些引用写为: %ControlName.ID%.ControlProperty. 例如:pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • 编写枚举,例如 DisplayTypeScreenTransition as: %EnumName.RESERVED%.EnumValue。 例如:pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • 如果 pfx-default-value 包含,则优先于 default-value

父元素

元素 Description
控制 定义组件的命名空间、版本和显示信息。

Example

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

Power Apps 组件框架清单架构参考
Power Apps 组件框架 API 参考
Power Apps 组件框架概述