---
title: onUpdate
summary: 通过 SetScript 注册的逐帧界面更新处理函数。扩展现有菜单时，请遵循其自身的 onUpdate 生命周期。
section: reference
kind: api
status: reference
updated: 2026-10-27
tags: ["API","X4"]
sources: ["https://chemodun.github.io/x4/modding-support/ui-modding/lua-globals/"]
---
## 说明

通过 SetScript 注册的逐帧界面更新处理函数。扩展现有菜单时，请遵循其自身的 onUpdate 生命周期。

## 处理函数参数

没有需要回调的证据. 具体而言,该例子不假设是 deltaTime参数.

## 事件订阅示例

在您自己的UI添加语境中,添加一个本地函数并保留其参考清理. 现有菜单通常通过自己的菜单更新生命周期整合.

```lua
local updates = 0
local function onWikiUpdate()
  updates = updates + 1
end

SetScript("onUpdate", onWikiUpdate)
```

### 清洁工作的分派

运行后,当所有者处置,不立即注册后:

```lua
RemoveScript("onUpdate", onWikiUpdate)
```

## 运行效果

更新每次交付更新增加1次. 任何东西都不会自动打印,

这些都是独立的学习例子,而不是执行的游戏测试.

## 返回值

那些例子没有任何价值. 它们不会建立改变引擎行为的回报合同. 处理者参数和回报值是单独的合同.

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