安装和使用功能向导
功能向导外接程序,可用MATLAB®编译器™中使用的控制面板微软®Excel®使用一个或多个创建自定义Excel宏MATLAB编译器Excel插件。生成的宏由微软Visual Basic®用于可以修改以进行其他自定义的应用程序(VBA)代码。要使用该向导,您不需要VBA编程的知识。
函数向导使您能够创建Excel宏,这些宏指定从已编译的MATLAB函数到工作表的数据的位置和输出。将Excel工作表值传递给已编译的MATLAB模型,然后将模型输出返回给工作表中的单元格或单元格范围。使用函数向导处理具有结构数组参数或多个输出的MATLAB函数。
有关使用函数向导创建Excel宏的完整示例,请参见使用多个MATLAB函数创建宏.
安装功能向导
在Excel中安装函数向导的方法与安装方法相同MATLAB编译器生成的插件。有关说明,请参见安装Excel插件.
“功能向导”的外接程序文件位于
.例如,如果使用MATLAB编译外接程序R2022b,安装文件matlabroot
\工具箱\ matlabxl \ matlabxl \ win64 \ FunctionWizard.xlamC:\Program Files\MATLAB\R2022b\工具箱\ matlabxl \ matlabxl \ win64 \ FunctionWizard.xlam
.属性的宏函数向导“主页”选项卡的加载项按钮。
开始功能向导
请注意
在使用“函数向导”外接程序之前,必须先注册MATLAB实用程序库。详细信息请参见注册MATLAB实用程序库.
单击函数向导“主页”选项卡上的加载项按钮以启动“功能向导”。向导初始化后,控制面板打开。
功能向导控制面板
请注意
关闭“函数向导”控制面板不会删除在Excel会话中添加的任何MATLAB函数或参数,但关闭Excel会重置“函数向导”。
定义要执行的函数
使用函数向导添加要执行的MATLAB函数。
在控制面板中,单击添加函数在设置功能区域。打开“MATLAB组件”对话框。
在“可用组件”区域框中,从下拉列表中选择组件名称。
请注意
如果没有列出组件,请确保已注册其DLL。详细信息请参见注册外接程序和COM组件.
从类的函数
类名称
,选择要执行的函数。点击添加函数.打开“函数属性”对话框。
提示
的函数语法和帮助“函数属性”对话框中的区域显示MATLAB函数中的第一个帮助文本行。此描述对不熟悉MATLAB函数的最终用户很有帮助。
定义输入参数
请注意
函数向导目前不支持MATLAB金宝app稀疏的
或复杂的
数据类型。
从函数属性对话框中,定义MATLAB函数的输入参数属性。
在输入选项卡上,单击设置输入数据.的输入数据
x
对话框打开,其中x
输入变量的名称。选择输入参数的类型。
范围引用工作表中的单元格范围。单击右侧的文本框或单元格选择按钮,然后从工作表中选择包含输入数据的单元格。
要在电子表格数据每次更改时自动重新计算,请选择自动重新计算变化选择。
谨慎
避免使用方向键选择范围。如果您必须使用方向键来选择范围,请从微软网站应用必要的修复:https://mskb.pki金宝搏官方网站solutions.com/kb/291110.
价值引用您在文本框中指定的值。输入一个值作为输入数据,并在下拉列表中选择数据类型。
如果参数指向a结构数组(结构体),选择这是一个MATLAB结构数组参数并点击好吧.结构数组参数的输入数据
x
对话框。函数向导支持输入和输出的一维和二维结构数金宝app组。
在部署带有结构数组参数的函数时,让最终用户知道哪些参数是结构数组,并列出它们的字段名。
在“结构数组组织”区域,选择其中之一逐元素组织或平面组织.有关更多信息,请参见在结构数组中组织数据的方法.
若要为每个结构数组参数添加字段,请单击添加字段.打开“结构数组参数字段”对话框。
在的名字字段,为结构数组字段定义名称。指定的名称必须与MATLAB函数中结构数组的字段名称完全匹配。
在范围字段,为结构数组指定字段的范围。
点击好吧添加字段。
对结构数组中的每个字段重复这些步骤。
若要指定如何格式化日期和处理此输入数据的空单元格,请单击选项的输入数据
x
对话框。打开“输入转换选项”对话框。从强制数值为类型下拉列表中,选择数据类型以控制数值数据的转换。
从将缺失数据视为下拉列表,任选一项零或NaN(非数字).
点击好吧添加输入参数。
对函数的每个输入参数重复这个过程。
定义输出参数
在“函数属性”对话框中,定义MATLAB函数的输出参数属性。
在输出选项卡上,单击设置输出数据.的输出数据
y
对话框,其中y
输出变量的名称。提示
你也可以指定MATLAB编译器自动调整输出数据的大小(自动调整大小),转置(转置),或以日期格式(输出日期).
在范围字段,指定输出参数的类型为单元格范围或MATLAB结构数组。
有关使用结构数组参数的详细信息,请参见定义输入参数.
若要使Excel动态选择输出单元格数量,请选择自动调整大小如果尚未选中。
点击完成的输出数据
y
对话框添加输出参数。
对MATLAB函数的每个输出参数重复此过程。
请注意
当使用具有多个输出的函数时,为每个参数定义单独的输出范围。
测试并保存宏
完成向MATLAB函数添加参数后,单击完成在“函数属性”对话框中。函数出现在积极的功能“功能向导”中的控制面板列表。您可以随时编辑函数参数,方法是在列表中选择您的函数,然后单击编辑/设置数据.
要测试宏,请单击执行在“执行函数”区域。定义为输出参数的单元格范围将自动填充当前Excel表上的函数输出。
保存宏:
在创建宏控件中,为宏输入名称宏的名字字段。
从存储宏下拉列表中,选择要存储宏的工作簿。
在描述字段时,输入宏功能的简要说明。
点击创建宏.
宏被创建并保存在目标Excel工作簿中。
执行宏Excel
运行宏Microsoft Excel.
提示
在运行宏之前,您可能需要启用适当的安全设置Microsoft Excel.有关宏权限和相关错误消息的信息,请参见错误及解决方法金宝搏官方网站.
在Microsoft Excel,点击查看>宏>查看宏.
中选择宏宏的名字下拉列表。
点击运行.定义为输出参数的单元格范围将自动用函数输出填充。
访问微软Visual Basic代码(可选)
要访问或修改宏中的Visual Basic代码:
从Excel中开发人员选项卡上,单击Visual Basic,或按ALT+季打开Visual Basic编辑器.在较旧版本的Excel中,它可能位于工具>宏>Visual Basic编辑器.
在项目- VBAProject窗口,双击展开
VBAProject (Book1)
.扩大
模块
文件夹,然后双击Matlab宏
模块。“Visual Basic代码”窗口将打开,其中包含此项目的代码。
将宏映射到按钮(可选)
要创建一个表单控件按钮,在单击按钮时运行宏:
从Excel中开发人员选项卡上,单击插入.
从表单控件菜单,选择按钮(窗体控件)图标。
提示
若要查看各种控件标签,请将鼠标放在“窗体控件”菜单上。
在“分配宏”对话框中,选择要将按钮分配给的宏,然后单击好吧.