计算单元和内容控件单元详解

一.计算单元

计算单元主要模仿Excel中的单元格，也可以称为单元行。相比Excel的单元格多了符号项目，单位项目等，是为了工程计算而特别扩展的。下面分几方面对计算单元进行详细解释。



名称：计算单元的名称，一般为汉字。

符号：一般为希腊字母，和规范中的符号相同，通常是在word中写好并且设置好格式后再拷贝到单元中。

单位：长度单位mm，压强单位N/mm2等，可以有上下标格式等。

支持CAD拾取：当前版本无效，以后可以让用户在CAD中选取数据，实现一边画图一边计算。

中间变量单元：比较重要的一个属性，如果计算书中需要这么一个计算单元来进行替换占位符，但是在又不想出现在最终计算模块中，可以设置此属性为True。设置后计算单元会变成蓝色。

延后计算：当前版本无太多用处，先不用设置。

说明：给编写者自己看的一些说明。

出错信息：当计算单元的公式出错时会在这里出现一些提示信息，方便用户查找出错的原因。



数值类型：一般常用的有数字，正数，字符串和布尔值等，根据单元的需要而设置不同的类型。

数值控制器：当数值类型为数值时起作用，控制小数点的数量。输入校核条件可以限制一定范围内的数据输入，点击最右侧的小按钮弹出公式编辑器，输入自己代号的一些限制条件。比如当前的代号是A，校核条件输入A>0，用户输入小于0的数字的时候编辑器就会弹出警报。

数学代号：类似Excel的单元格的代号，在一个计算模块中，每个计算单元的数学代号都是唯一的不可重复。

替换代号：用来在word中站位用的，一般是数学代号外面加括号，括号可以选各种形式，只要保证在word中查找替换时保证唯一性即可。

值文本：可以在此输入本计算单元的值的文本。

值：计算单元最终的值，可能是数字也可能是文本等。



表达式层次：当表单式为单行时，表达式层次为”基础“，当表达式为表达式树时，层次为”高级“。

表达式树：点击此空格的最左边的小按钮，将会出现表达式树编辑器，可以在此编辑本单元的公式。

单元依赖项：只读，让用户知道本单元受哪几个其他单元的控制。

主动公式：主动公式用于输入本单元的数据时，主动去影响其他别的的单元的数据。其他单元的数据如果受函数影响，同时还能主动输入数据时，采用主动公式。否则在其他单元处采用标准的表达式来接受别的单元的控制。

主动公式依赖项：只读，让用户知道本单元的主动公式受哪几个其他单元的控制。

主动公式影响项：只读，让用户知道本单元的主动公式影响了哪几个其他单元。




只读性和可见性：控制单元在一定条件下是否可见，是否可以编辑。



计算结果单元：决定本单元是否代表最终的计算结果。结果单元有一些特殊的作用，当结果单元的数值不满足校验条件时，会在界面显示红色的警告。校验信息的内容可以直接从计算书拷贝过来，主要作用是让用户知道什么数值才是合格的数值，跟当前数值相比差了多少等等。
在界面上，结果单元如下图，前方有表示通过与否的绿色或者红色图标，数据最下方有校验信息。


验算合格：根据校验条件计算出来的是否合格。

警告级别：如果选择错误级别，当计算结果不通过的时候前方会显示红色叉号图标。选择警告级别时，只显示黄色感叹号图标。

校验条件：可以输入校验的公式。软件将根据此公式的计算结果来判定是否验算合格。

校验信息：上图中，最下方的验算结果和合格数据之间差距的信息。这段文字一般是从计算书中直接拷贝而来，计算书中的占位符也可以一起拷贝，软件刷新计算书时顺带刷新此信息。




控件类型：决定单元在计算模块中是否是文本框还是下拉框等等，如果是下拉框，还可以自定义内嵌数据，在”内部数据“中进行定义。

数据源类型：一般选择”内部数据“，例子中也有使用函数的，可以仿照使用。

使用缓存：目前可以先选择”否“，这样每次下拉数据时都能得到最新的数据。

内部数据：也叫内嵌数据，控件类型选择下拉框时出现，可以在这里输入想呈现在下拉框中的数据，一行代表一项数据。




当前规范：用户在模块菜单切换规范时这里也会同步改变。

支持的规范：表示本单元支持的规范，如果某规范不支持，那么切换到此规范时，这个单元将不可见。

规范有效性：只读性质，表明本单元在当前规范下是否可见。


二.内容控件单元

 内容控件单元也属于单元的一种，有效性受计算单元的函数的影响。当一个内容控件单元的有效性是False的时候，它所代表的在Word中的一段内容将在生成计算书时被删除。



内容控件标记：相当于ID，不可重复。

内容控件标题：内容控件的名字，和显示在word中的内容控件标题一致。

出错信息：当计算单元的公式出错时会在这里出现一些提示信息，方便用户查找出错的原因。

有效性：只读性质，由下面的有效性条件来决定。

有效性条件：可以输入一个公式，当此公式不满足时内容控件单元就处于失效状态，在生成计算书时其对应的word中的内容控件将被删除。

当前规范：用户在模块菜单切换规范时这里也会同步改变。

支持的规范：表示本单元支持的规范，如果某规范不支持，那么切换到此规范时，这个单元将会失效。