主要内容

安装和使用功能向导

功能向导外接程序,可用MATLAB®编译器™中使用的控制面板微软®Excel®使用一个或多个创建自定义Excel宏MATLAB编译器Excel插件。生成的宏由微软Visual Basic®用于可以修改以进行其他自定义的应用程序(VBA)代码。要使用该向导,您不需要VBA编程的知识。

函数向导使您能够创建Excel宏,这些宏指定从已编译的MATLAB函数到工作表的数据的位置和输出。将Excel工作表值传递给已编译的MATLAB模型,然后将模型输出返回给工作表中的单元格或单元格范围。使用函数向导处理具有结构数组参数或多个输出的MATLAB函数。

有关使用函数向导创建Excel宏的完整示例,请参见使用多个MATLAB函数创建宏

安装功能向导

在Excel中安装函数向导的方法与安装方法相同MATLAB编译器生成的插件。有关说明,请参见安装Excel插件

“功能向导”的外接程序文件位于matlabroot\工具箱\ matlabxl \ matlabxl \ win64 \ FunctionWizard.xlam.例如,如果使用MATLAB编译外接程序R2022b,安装文件C:\Program Files\MATLAB\R2022b\工具箱\ matlabxl \ matlabxl \ win64 \ FunctionWizard.xlam.属性的宏函数向导“主页”选项卡的加载项按钮。

开始功能向导

请注意

在使用“函数向导”外接程序之前,必须先注册MATLAB实用程序库。详细信息请参见注册MATLAB实用程序库

单击函数向导“主页”选项卡上的加载项按钮以启动“功能向导”。向导初始化后,控制面板打开。

功能向导控制面板

用于使用MATLAB函数的函数向导控制面板

请注意

关闭“函数向导”控制面板不会删除在Excel会话中添加的任何MATLAB函数或参数,但关闭Excel会重置“函数向导”。

定义要执行的函数

使用函数向导添加要执行的MATLAB函数。

  1. 在控制面板中,单击添加函数设置功能区域。打开“MATLAB组件”对话框。

  2. 在“可用组件”区域框中,从下拉列表中选择组件名称。

    请注意

    如果没有列出组件,请确保已注册其DLL。详细信息请参见注册外接程序和COM组件

  3. 类的函数类名称,选择要执行的函数。

  4. 点击添加函数.打开“函数属性”对话框。

    提示

    函数语法和帮助“函数属性”对话框中的区域显示MATLAB函数中的第一个帮助文本行。此描述对不熟悉MATLAB函数的最终用户很有帮助。

定义输入参数

请注意

函数向导目前不支持MATLAB金宝app稀疏的复杂的数据类型。

从函数属性对话框中,定义MATLAB函数的输入参数属性。

  1. 输入选项卡上,单击设置输入数据.的输入数据x对话框打开,其中x输入变量的名称。

    用于指定输入参数的x面板的Input Data

  2. 选择输入参数的类型。

    • 范围引用工作表中的单元格范围。单击右侧的文本框或单元格选择按钮,然后从工作表中选择包含输入数据的单元格。

      要在电子表格数据每次更改时自动重新计算,请选择自动重新计算变化选择。

      谨慎

      避免使用方向键选择范围。如果您必须使用方向键来选择范围,请从微软网站应用必要的修复:https://mskb.pki金宝搏官方网站solutions.com/kb/291110

    • 价值引用您在文本框中指定的值。输入一个值作为输入数据,并在下拉列表中选择数据类型。

    • 如果参数指向a结构数组结构体),选择这是一个MATLAB结构数组参数并点击好吧.结构数组参数的输入数据x对话框。

      结构数组参数的输入数据x面板,用于指定结构数组输入参数

      函数向导支持输入和输出的一维和二维结构数金宝app组。

      在部署带有结构数组参数的函数时,让最终用户知道哪些参数是结构数组,并列出它们的字段名。

      1. 在“结构数组组织”区域,选择其中之一逐元素组织平面组织.有关更多信息,请参见在结构数组中组织数据的方法

      2. 若要为每个结构数组参数添加字段,请单击添加字段.打开“结构数组参数字段”对话框。

        “结构数组参数字段”面板,用于指定结构数组字段

      3. 的名字字段,为结构数组字段定义名称。指定的名称必须与MATLAB函数中结构数组的字段名称完全匹配。

      4. 范围字段,为结构数组指定字段的范围。

        字段结构数组参数面板与名称和范围字段填写

      5. 点击好吧添加字段。

        对结构数组中的每个字段重复这些步骤。

  3. 若要指定如何格式化日期和处理此输入数据的空单元格,请单击选项的输入数据x对话框。打开“输入转换选项”对话框。

    “输入转换选项”对话框

    • 强制数值为类型下拉列表中,选择数据类型以控制数值数据的转换。

    • 将缺失数据视为下拉列表,任选一项NaN(非数字)

  4. 点击好吧添加输入参数。

对函数的每个输入参数重复这个过程。

定义输出参数

在“函数属性”对话框中,定义MATLAB函数的输出参数属性。

  1. 输出选项卡上,单击设置输出数据.的输出数据y对话框,其中y输出变量的名称。

    用于指定输出参数的y面板的Output Data

    提示

    你也可以指定MATLAB编译器自动调整输出数据的大小(自动调整大小),转置(转置),或以日期格式(输出日期).

  2. 范围字段,指定输出参数的类型为单元格范围或MATLAB结构数组。

    有关使用结构数组参数的详细信息,请参见定义输入参数

  3. 若要使Excel动态选择输出单元格数量,请选择自动调整大小如果尚未选中。

  4. 点击完成的输出数据y对话框添加输出参数。

对MATLAB函数的每个输出参数重复此过程。

请注意

当使用具有多个输出的函数时,为每个参数定义单独的输出范围。

测试并保存宏

完成向MATLAB函数添加参数后,单击完成在“函数属性”对话框中。函数出现在积极的功能“功能向导”中的控制面板列表。您可以随时编辑函数参数,方法是在列表中选择您的函数,然后单击编辑/设置数据

功能向导控制面板,myfunction在活动函数列表中

要测试宏,请单击执行在“执行函数”区域。定义为输出参数的单元格范围将自动填充当前Excel表上的函数输出。

保存宏:

  1. 创建宏控件中,为宏输入名称宏的名字字段。

  2. 存储宏下拉列表中,选择要存储宏的工作簿。

  3. 描述字段时,输入宏功能的简要说明。

  4. 点击创建宏

    宏被创建并保存在目标Excel工作簿中。

执行宏Excel

运行宏Microsoft Excel

提示

在运行宏之前,您可能需要启用适当的安全设置Microsoft Excel.有关宏权限和相关错误消息的信息,请参见错误及解决方法金宝搏官方网站

  1. Microsoft Excel,点击查看>宏>查看宏

  2. 中选择宏宏的名字下拉列表。

  3. 点击运行.定义为输出参数的单元格范围将自动用函数输出填充。

访问微软Visual Basic代码(可选)

要访问或修改宏中的Visual Basic代码:

  1. 从Excel中开发人员选项卡上,单击Visual Basic,或按ALT+打开Visual Basic编辑器.在较旧版本的Excel中,它可能位于工具>>Visual Basic编辑器

  2. 项目- VBAProject窗口,双击展开VBAProject (Book1)

  3. 扩大模块文件夹,然后双击Matlab宏模块。

    “Visual Basic代码”窗口将打开,其中包含此项目的代码。

将宏映射到按钮(可选)

要创建一个表单控件按钮,在单击按钮时运行宏:

  1. 从Excel中开发人员选项卡上,单击插入

  2. 表单控件菜单,选择按钮(窗体控件)图标。

    提示

    若要查看各种控件标签,请将鼠标放在“窗体控件”菜单上。

  3. 在“分配宏”对话框中,选择要将按钮分配给的宏,然后单击好吧

一个Excel电子表格,突出显示“插入表单控件”菜单,并打开“分配宏”对话框

相关的话题