窗体变量

在V平台中，窗体变量是窗体级别定义的变量，在本窗体中的任何方法都可以调用，主要用于窗体与窗体之间的参数传值。

info

窗体变量，分为 「窗体输入」和 「窗体输出」，结合“打开窗体并返回数据”规则使用。

场景一（窗体输入）

案例介绍

案例下载

本案例，主要通过打开编辑窗体定义窗体输入接收主窗体传入的参数ID，加载对应的数据进行编辑。

配置演示

配置详细

1. 表定义

同时，在本案例中添加了几条初始化数据，如下：
info
表数据：在V平台中，指表的初始化数据（勾选初始化数据后，每次部署构件，对应id的数据记录都会初始化），部署后会同步至预览中。
预览：在窗体界面新增、编辑数据后（Eg：配置新增实体记录 → 保存实体到数据库），在预览中显示——对应传统概念的表数据。
注：界面中配置新增、删除都是针对预览中的数据，如果重新部署会重新将表数据初始化至预览中，然后在界面加载显示。

2. 窗体定义「学生信息编辑」

2.1 实体定义
根据「学生信息」表定义实体字段、编码。
2.2 界面定义
通过控件向导生成对应的实体控件，选择性别列进行控件替换，设置保存按钮等。
2.3 窗体输入
定义窗体输入，接收主窗体窗体的学生ID参数值。
2.4 规则配置
（1）窗体加载事件
在本案例中，编辑窗体主要通过主窗体打开使用。
主窗体点击「新增」打开时，编辑窗体作为新增数据使用，无需传参，窗体加载应配置「新增实体记录」规则；
主窗体点击「编辑」打开时，编辑窗体作为编辑数据使用，传入需要编辑的数据ID参数，窗体加载应配置「从数据库获取数据到实体」规则，加载对应的数据进行编辑；
（2）保存事件
退出窗体
该规则一般是窗体作为弹窗被打开时，确定、保持、取消按钮操作后，退出弹窗使用。
确定选择：主窗体配置的「打开窗体并返回数据」则返回True；
取消选择：主窗体配置的「打开窗体并返回数据」则返回False；
（3）取消事件

3. 窗体定义「学生信息列表」

3.1 实体定义
根据「学生信息」表定义实体字段、编码。
3.2 界面定义
需要将控件与实体字段进行绑定。
3.3 规则配置
（1）窗体加载事件
（2）新增事件
① 打开窗体并返回数据【学生信息编辑】——无需传参
② IF（BR_OUT.BR_OpenComponentReturnData1.isConfirmSelectionOnClose==True）
被打开的窗体【学生信息编辑】通过「保存」数据确定退出窗体，表示表数据更新，主窗体需要重新加载数据。
（3）编辑事件
与新增事件配置逻辑一样，只是「打开窗体并返回数据」规则中，配置传参，实现编辑功能。
（4）删除事件

预览效果

场景二（窗体输出）

案例介绍

本案例，主要通过「一览」打开编辑窗体定义窗体输出返回数据给主窗体。

讲解2种返回数据类型的处理场景：文本类型、实体类型。

配置演示

配置详细

1. 表定义

在场景一的构件中进行扩展，使用同一个业务表即可，如下：

2. 窗体定义「一览」

2.1 实体定义
根据「学生信息」表定义实体字段、编码。
2.2  界面定义
需要将控件与实体字段进行绑定。
2.3 窗体输出
2.4 规则配置
（1）窗体加载事件
配置「从数据库获取数据到实体」规则，加载学生信息数据即可。
（2）确定（返回ID）事件
（3）确定（返回实体）事件
（4）取消事件
配置「退出窗体」规则，选择取消退出。

3. 窗体定义「学生信息」

3.1 实体定义
根据「学生信息」表定义实体字段、编码。
3.2 界面定义
需要将控件与实体字段进行绑定。
3.3 规则配置
（1）一览（返回ID）事件
① 定义方法变量——接收返回的studentId参数 
提示：主窗体接收返回值，可以定义任意类型。
② 打开窗体并返回数据【一览】
② IF（BR_OUT.BR_OpenComponentReturnData1.isConfirmSelectionOnClose==True）
被打开的窗体【一览】通过「确定」退出窗体，表示已选中数据返回，主窗体需要根据返回参数加载对应的数据。
（2）一览（返回实体）事件

预览效果