Excel 2010 中为自定义函数参数添加描述.doc

Excel 2010 中为自定义函数参数添加描述 在Excel 2010 发布之前，用户已经可以为自定义函数(User-Defined Function)添加一系列的信息，比如描述等等。但是无法用常规的手段为自定义函数的参数添加描述信息。随着 Excel 2010 的发布，这个问题得到了解决。微软改进了VBA中Application对象的MacroOptions方法-在原来的基础上添加了一个 ArgumentDescriptions 参数，利用此参数就可以为用户自定义函数添加描述信息了。 以下给出一个具体例子来说明这个方法的具体应用（MacroOptions的具体说明参见备注）代码如下：用户自定义函数Function FunArgDes(int1As Integer, int2 As Integer) As Integer FunArgDes = int1 + int2End Function此过程用户注册自定义函数Sub RegUDF() Dim FuncName As String函数名称 Dim FuncDesc As String函数描述 Dim Category As String函数类别 Dim ArgDesc(1) As String函数参数描述数组 FuncName = FunArgDes FuncDesc = 返回两个整数的和(测试函数参数描述) Category = 函数参数描述测试 ArgDesc(0) = 函数参数第一个，整型 ArgDesc(1) = 函数参数第二个，整型 Call Application.MacroOptions(Macro:=FuncName, Description:=FuncDesc, Category:=Category, ArgumentDescriptions:=ArgDesc)End Sub将上面提供的代码复制到一个标准模块中，然后执行其中的 RegUDF 过程，你就可以在Excel中使用 FunArgDes 函数了备注：以下为微软帮助文档所提供的内容Application.MacroOptions 方法对应于“宏选项”对话框中的选项。还可使用此方法将用户定义函数 (UDF) 显示在“插入函数”对话框的内置类别或新类别中。 语法表达式.MacroOptions(Macro, Description, HasMenu, MenuText, HasShortcutKey, ShortcutKey, Category, StatusBar, HelpContextID, HelpFile, ArgumentDescriptions)表达式一个代表 Application 对象的变量。参数Macro可选Variant宏的名称或用户定义函数 (UDF) 的名称。Description可选Variant宏的描述。HasMenu可选Variant忽略该参数。MenuText可选Variant忽略该参数。HasShortcutKey可选Variant如果为 True，则为宏指定一个快捷键（还必须指定 ShortcutKey）。如果该参数为 False，则不为宏指定快捷键。如果宏已经有快捷键，则将该参数设置为 False 可删除快捷键。默认值为 False。ShortcutKey可选Variant如果 HasShortcutKey 为 True，则该参数为必选参数；否则忽略该参数。快捷键。Category可选Variant一个指定现有的宏函数类别的整数（例如，财务、日期与时间或用户定义）。请参阅备注部分，以确定映射为内置类别的整数。还可指定自定义类别的字符串。如果提供了一个字符串，它将作为类别名称显示在“插入函数”对话框中。如果此类别名称从未使用过，则将用该名称定义一个新的类别。如果使用的类别名称与某个内置名称相同（请参阅“说明”部分中的列表），Microsoft Excel 将把用户定义的函数映射到该内置类别。StatusBar可选Variant宏的状态栏文本。HelpContextID可选Variant一个指定分配给宏的帮助主题上下文 ID 的整数。HelpFile可选Variant包含 HelpContextId 定义的帮助主题的帮助文件名。ArgumentDescriptions可选Variant“函数参数”对话框中显示的 UDF 参数的描述。说明下表列出了哪些整数被映射到可在 Category 参数中使用的内置类别。Integer类别1财务2日期与时间3数学与三角函数4统计5查找与引用6数据库7文本8逻辑9信息10命令11自定义12宏控件13DDE/外部14用户定义15第一个自定义类别16第二个自定义类别17第三个自定义类别18第四个自定义类别19第五个自定义类别20第六个自定义类别21第七个自定义类别22第八个自定义类别23