历史版本8 :下拉树控件 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1. 控件效果编辑
注：6.5.5版本会在输入框中显示选择值的完整路径。
2. 基本属性编辑
2.1 控件值
给下拉树赋默认值，根据下拉树返回值的不同，默认值的输入格式不相同，必须与返回值的格式保持一致，下拉树默认值设置请查看下拉树默认值设置
2.2 数据字典
- 自动构建
自动构建树能够根据数据自动构建出下拉树，无需一层一层定义数据，但是其必须使用树数据集来构建。
- 分层构建
不是所有的数据都能自动构建出下拉树，因此需要分层构建。
层次1通过数据字典来定义下拉框的实际值与显示值。
层次2的数据一般会根据层次1的数据进行过滤，因此需要定义成数据集，然后通过数据查询返回数据集定义的列。一般数据集定义成：SELECT 字段 FROM 表名 WHERE 层次1的字段 = '${layer1}'
注：layer1表示取层次1节点的值，若在层次3中调用，则是SELECT 字段 FROM 表名 WHERE 层次2的字段 = '${layer2}'依次类推。
3. 高级属性编辑
3.1 多选
即确定下拉树类型，勾选多选即为多选下拉树，去掉勾选即为单选下拉树。
3.2 异步加载
勾选即为使用异步加载，下拉树中首次只加载父节点的数据，当点击父节点前面的加号后才会重新与数据库交互取出对应的子节点数据，适用于数据量大的情况。
去掉勾选表示下拉树中的数据是一次性全部取出，适用于数据量小的情况。
3.3 允许直接编辑
：下拉树控件的编辑框里面允许直接输入值，并实现模糊查询，主要用于在下拉树中快速查找。3.4 允许自定义值
：允许在下拉树中手动输入值，不一定要在下拉列表中有对应数据相匹配。
：不允许在下拉树中手动输入，只能在列表中选择。3.5 只返回叶子节点
勾选只返回叶子节点，即下拉树文本框中只返回该节点的最后一层数据，不勾选即表示选中什么则返回什么，如下表：
| 选项 | 勾选叶子节点 | 不勾选叶子节点 |
| 选中a | 返回值：a1,a2,a3 | 返回值：a |
注：只返回叶子节点只对多选下拉树起作用，只返回叶子节点返回数组类型数据。
3.6 结果返回完整层次路径
- 结果不返回完整层次路径
下拉树是一种有层次结构的控件，不勾选选项，下拉树返回选中的值，根据是否只返回叶子节点确定最终选中的值，如下图，勾选，返回结果效果如下，查询出来的下拉树的值返回的是所有叶子节点数据，并且不是完整层次路径值，而是叶子节点的实际值：
回到下拉树属性设置面板，去掉前面的勾选，再次预览查看效果如下图，下拉树查询出来的值是选中节点的实际值，没有返回叶子节点，且不是完整层次路径值，选中什么返回什么：
- 结果返回完整层次路径
在下拉树属性面板勾选前面的勾选，并选中，预览查看模板，选中人力资源部选项的时候，可以看到下拉树返回的值为所有叶子节点的完整路径值，不再是叶子节点的实际值，如下图：
仍然勾选前面的勾选，去掉前面的勾选，预览查看模板，可以看到下拉树返回值返回的为选中项的完整路径值，并不是叶子节点的路径，如下图：
3.7 性能优先
下拉树在分层构建的时候，还是会去找子节点，导致性能很慢。
下拉树会去找其子节点以便来构建树，但是当选择“分层构建”这种方式的时候，是不需要有这步的。是可以直接根据设置的层级来构建树的，因此提供“性能优先”选项 。
单元格中下拉树控件
当构建方式选择“分层构建”时，多一个“性能优先”的选项，如下图：
注：默认不选中“性能优先”
参数面板和表单中下拉树控件
当构建方式选择“分层构建”时，多一个“性能优先”的选项，如下图：
注：使用该选项时，由于不找子节点，那如果有层目录下没有子节点，预先是不知道的，显示的时候仍会是“+”，点开当然是没有数据的，如下图：
下拉树的详细使用示例清查下拉树控件自动构建示例和下拉树控件分层构建示例