关于公式的参数描述

你好,在我们的开发中，我们为Spread 控件做了一个公式面板，用户可以在公式面板中为函数的参数输入值，以计算函数结果，类似于下面的窗体： N1.jpg (26.53 KB, 下载次数: 472)

2014-11-24 15:47 上传

点击文件名下载附件

在这个面板中，需要对选定函数的每个参数进行描述。我们已经从设计器中的FormulaBar_FunctionInformation.zh_CN.xml 文件里获取了函数的整体描述，我们制作的面板可以从XML文件中提取出参数名并显示在面板中，但是没有函数中的每个参数的具体描述。请问葡萄城是否提供了这类的公式参数描述文件?

我们希望官方能够提供函数参数的描述，其一，工作量巨大，我们很难完成，而且项目开发成本也不允许；其二，将来如果官方提供了参数的具体描述，但是与我们的写法不一致，我们还要更改程序。

我们建议在FormulaBar_FunctionInformation.zh_CN.xml 文件中增加一个节点，以描述函数的参数。


该节点有4个属性:

Name:描述函数参数的名称;
Order:描述函数参数的位置;
Loop:如果参数是可以重复的,则为"True",否则为"False";
Description:函数参数的说明;

此外，在FormulaBar_FunctionInformation.zh_CN.xml 文件中我们希望增加一个属性，以描述函数的中文名称。对于用户来说，很难记住那么多的函数。当需要使用函数但是不知道函数名时，只有一个一个点选函数名以查看函数解释，效率低下。所以我们希望在FormulaBar_FunctionInformation.zh_CN.xml 文件中为Function 节点增加两个属性：
Name_CN="XXX"，描述函数的中文名称；
HelpURL="……"，记录函数的更详细的说明和帮助以及示例的URL地址，这个属性由开发者确定具体值，官方只提供属性即可。

综合上述建议，我们建议的 FormulaBar_FunctionInformation.zh_CN.xml 文件示例，形如(红色为建议修改的地方)：


<Function Name="ABS" Name_CN="绝对值"
Param="value" Description="返回数字的绝对值。" HelpURL="" />
    <Value Name="Number" Order="1" Loop="False" Description="要对其求绝对值的实数" />
<Function Name="ACCRINT" Name_CN="应计利息"
Param="issue,first,settle,rate,par,frequency,basis" Description="返回定期支付利息的债券的应计利息。" HelpURL="" />
    <Value Name="Issue" Order="1"
Loop="False" Description="表示债券的发行日期,以一串日期表示" />
    <Value Name="First_Interest" Order="2"
Loop="False" Description="表示债券的首次计息日,以一串日期表示" />
    <Value Name="Settlement" Order="3"
Loop="False" Description="表示债券的结算日,以一串日期表示" />
    <Value Name="Rate" Order="4"
Loop="False" Description="表示债券的年利息率" />
    <Value Name="ar" Order="5"
Loop="False" Description="表示债券的面值" />
……
<Function Name="AND" Name_CN="与逻辑"
Param="logical1,logical2" Description="如果其所有参数均为 TRUE，则返回 TRUE。" HelpURL="" />

    <Value Name="logical" Order="0"
Loop="True" Description="1-255个结果为 True 或 False 的检测条件，检测内容可以是逻辑值、数组或引用" />

回复 1楼swejet的帖子

swejet 你好，
感谢你的问题反馈，目前我们提供了中英文版的公式总体描述，请参考附件：

Resources.zip (17.52 KB, 下载次数: 542)

2014-11-24 18:45 上传

点击文件名下载附件

没有关于每个参数的描述。不过 Spread 控件公式基本和 Excel 公式统一，所以可以参考 Excel 公式参数。

谢谢