---
title: event_ui_triggered
summary: 对于Lua UI事件的 MD条件,用荷载通过event.param3读取.
section: reference
kind: api
status: reference
updated: 2026-10-22
tags: ["X4","modding","event","ui","triggered"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## 返回值

| 类型 | 含义 |
| --- | --- |
| [事件数据](wiki:type-md-values) | MD 条件，不是 Lua 返回值。screen/control 是匹配表达式；在这里的通信桥中，event.param3 是由发送方定义的数据。 |

[类型与方法](wiki:types)

## 观察到的形式


层:Mission Director信号条件. 插入下面的信号 `cues`. 其他屏幕/控制对相匹配 [AddUITriggeredEvent](wiki:add-ui-triggered-event).




```xml
<cue name="Receive" instantiate="true" namespace="this">
  <conditions>
    <event_ui_triggered screen="'WikiBridge'" control="'ping'" />
  </conditions>
  <actions>
    <set_value name="$Payload" exact="event.param3" />
  </actions>
</cue>
```



**运行效果：** 在一个匹配的维基桥/平事件中,$Payload收到了它的有效载荷. 对于对合的Lua例子,这是"你好"字符串. 没有事件,这些提示行动不会运行.

## 参数


`screen` 和 `control` 是用来匹配事件的表达式. 在所示项目合同中, `event.param3` 能承载有效载荷.



## 在突变之前


验证值类型,列表长度,文本和对目标对象的权利. 用户界面事件不是授权. `instantiate` 和 `namespace` 影响重复处理和可变范围. 一次使用的Init使用不同的生命周期:见 [cue](wiki:md-cues).