# 本地变量

本地变量是只能在画面、内容或其设置本地变量的脚本中访问的内部变量。由于本地变量仅在画面/内容内可用，因此便于临时数据。

隐藏显示

1. 本地变量的最大数量
2. 命名和数据类型
3. 数据绑定
4. 复制本地变量
5. 复制与本地变量关联的对象
6. 其他

## 本地变量的最大数量

在屏幕编辑软件中，每个画面/内容最多可以配置 300 个本地变量。当一个画面含有一个内容显示，且画面中的本地变量和与内容显示关联的内容中的本地变量的总数超过 3600 时，会发生错误。

本地变量的最大数量因人机型号而异。每个工程本地变量的最大数量不包括在每个工程全局变量的最大数量中。

有关每个人机型号的最大本地变量数量的信息，请参阅下文。

支持的型号/功能列表

在运行时绘制的画面中，可加载的本地变量的最大数量为 3600。如果超过了 3600 个本地变量的限制，绘图会停止，并显示系统错误。

注：

- 当使用滚动手势来改变滑动内容显示或滑动导航的画面/内容时，在当前未显示的上一个和下一个画面/内容中设置的本地变量也会被包括在对上限的计算中。

- 即使一个对象在运行时由于其当前的 [隐现] 设置而不可见，设置在该对象上的本地变量也会被包括在对上限的计算中。

- 如果您间接指定内容显示对象或幻灯片内容显示对象的 [内容 ID]，屏幕编辑软件就无法计算该内容的本地变量数量。因此，即使屏幕编辑软件中没有错误，在运行时也可能超过本地变量的限制，内容可能无法显示。如果发生这种情况，将显示一个系统错误。

## 命名和数据类型

本地变量名称在一个画面/内容中必须是唯一的。有关本地变量名称命名规范的信息，请参阅以下内容。

命名规范

除了 WSTRING，本地变量支持的数据类型与基本变量相同。也不支持用户数据类型变量的数据类型。 有关数据类型的信息，请参阅以下内容。

数据类型

不能使用全局变量作为本地数组变量的元素编号。

## 数据绑定

可以将一个对象属性关联一个本地变量。由于本地变量仅在画面/内容内可用，因此便于临时数据。当与一个本地变量进行关联时，会添加前缀 “$Local”。示例: $Local.Var1.Value

由于本地变量不能用于全局功能，如报警、数据记录、USB 条码读取器和 OPC UA，全局功能必须使用全局变量。有关数据绑定的信息，请参阅以下内容。

数据绑定

## 复制本地变量

您可以将全局变量复制到本地变量，反之亦然。

当把全局变量复制到本地变量时，相关属性会被复制。当将本地变量复制到全局变量时，本地变量中没有的属性将被设置默认值。

## 复制与本地变量关联的对象

可以将一个与本地变量关联的对象复制到另一个画面上。

当目标画面没有相同名称的本地变量时，将显示 [警报] 对话框。

选择 [粘贴] 按钮来粘贴对象。

选择 [绑定粘贴] 来粘贴对象以及与其关联的本地变量。

当目标画面有同名本地变量时，该对象被粘贴，目标画面中的本地变量与复制的对象相关联。如果本地变量数据类型不匹配，屏幕编辑软件中会出现错误。

## 其他

您不能使用 OPC UA 服务器或 Web API / WebSocket 读取或写入本地变量。