[转载] 编写自定义函数详情 最终节-为自定义函数的每个参数定义下拉列表,说明以及示例,名称

本文章基于国外博客改写而来 链接
本文将介绍为自定义函数的每一个参数定义名称,下拉列表,示例,说明!最终节!
本文针对的是每一个参数的元数据来实现功能
file
我们先来定义一个自定义参数,实现可以自定义两个字符的运算方式:
file
file
我们想要修改自定义函数里面的参数名称,以及示例,再为每个参数增加一个说明,最终结果如下:
file
file
说明,提示,下拉框一应俱全,相比默认的函数这种看起来更规范,并且更容易让非编写此自定义函数的用户更加容易理解,
个人是推荐大家以后编写自定义函数尽量使用这种方法。
高级编辑器内容:
语法和第二节方法几乎一样,第一节的语法只能用在修改整个自定义函数的元数据,不能具体到修改每个参数。
修改每个参数的方法就是将默认的 x as text 修改为 x as (type text(这个类型可以根据需要修改) meta 元数据),创建一个text类型将元数据增加进去,差不多就是这个意思。
file
适用于参数的元数据字段有:
Documentation.FieldCaption(用来显示参数名称,当有此字段时会替换掉默认参数名称,值只能是文本)
Documentation.FieldDescription(用于在函数旁显示说明,支持特殊符号#(lf),需要注意的是当自定义函数拥有元数据时不会显示参数的说明,值只能是文本)
Documentation.AllowedValues(用来显示下拉框,可以是一个常量也可以是一个变量,值只能是List(值可以是文本或数值),注意并不能限制用户只输入下拉框里面的内容,当参数为可选会默认增加一个空值)
Documentation.SampleValues(用来显示示例,值为List但是只显示List第一个值(值可以是文本或数值),当存在Documentation.AllowedValues字段默认不显示)
关于自定义函数的文章到此结束
通过这4节文章你可以知道:元数据是什么?,修改自定义函数元数据,修改自定义函数的每一个参数的元数据
除了这个博主的博客文章之外,关于这个自定义函数与元数据的相关文章还有四个:文章1 文章2 文章3 文章4
在此特别感谢这几位博主以及对M函数的贡献,真是太厉害了
本人只是对其中一个博主的文章做转载翻译。
END
id=68309295
file

Ntt.Docomo