创建Excel插件从MATLAB

支持平台:微软^®窗户^®只有。

这个例子展示了如何使用MATLAB^®编译器™生成一个Microsoft Excel^®包含在Excel中使用的自定义函数的加载宏。这个函数mymagic返回一个具有相等行和和和的n × n神奇方阵。目标系统不需要MATLAB的授权副本来运行加载宏。

在开始之前，请确认您已经满足Excel的所有目标要求MATLAB编译器．有关详细信息,请参见Excel目标要求和MATLAB编译器的限制．

请注意

生成Visual Basic^®文件,使对VBA项目对象模型的信任访问在Excel中。如果不这样做，则可以通过导入.bas文件到Excel。

创建函数MATLAB

在MATLAB中，找到要作为Excel外接程序部署的MATLAB代码。

对于本例，编译函数mymagic.m位于matlabroot\工具箱\ matlabxl \ \ xlmagic例子．

函数Y = mymagic(x) Y = magic(x)

在MATLAB命令提示符下，输入mymagic (5)．

输出是一个5乘5的正方形。

17 24 18 15 23 5 7 14 16 4 6 13 20 22 10 12 19 21 3 11 18 25 2 9

创建Excel添加使用库编译器应用程序

方法将该函数打包到Excel外接程序中库的编译器或者，如果您想从MATLAB命令窗口使用编程方法创建Excel外接程序，请参见使用compiler.build.excelAddIn创建Excel加载宏．

要打开库编译器应用程序，输入libraryCompiler在MATLAB提示符。
另外,在MATLAB应用程序标签，在最右边的应用程序部分，单击箭头。在应用程序部署,点击库的编译器．
在MATLAB编译器项目窗口中,选择Excel插件在类型部分。
在库的编译器app项目窗口，指定要部署的MATLAB应用程序的文件。
1. 在导出功能部分，单击．
2. 在添加文件窗口，浏览到示例文件夹，并选择要打包的函数。点击开放．
该函数被添加到导出的函数文件列表中。重复此步骤，将多个文件打包到同一个应用程序中。
在包装选项部分时，决定是否包含MATLAB运行时安装程序在生成的应用程序中选择其中一个选项:
- 从web下载运行时-生成一个安装程序，用于下载MATLAB运行时并将其与已部署的MATLAB应用程序一起安装。您可以指定安装程序的文件名。
- 包中包含的运行时—生成包含MATLAB运行时安装程序。您可以指定安装程序的文件名。
  
  请注意
  
  第一次选择此选项时，系统会提示您下载MATLAB运行时安装程序。
接下来，定义加载宏的名称并验证类映射．m要构建到应用程序中的文件。
1. 的库名称字段将自动填充mymagic作为程序集的名称。重命名它为xlmagic．在外接程序的实现中始终遵循相同的名称。
2. 中定义的函数mymagic.m映射到xlmagicclass．双击类以更改类名。
自定义打包的应用程序及其外观:
- 图书馆信息—可编辑已部署应用的信息。生成的安装程序使用此信息填充已安装的应用程序元数据。看到自定义安装程序．
- 额外的安装选项-编辑生成的安装程序的默认安装路径，并选择自定义logo。看到更换安装路径．
- 运行库所需的文件-生成的应用程序运行所需的附加文件。这些文件包含在生成的应用程序安装程序中。看到在编译器项目中管理所需文件．
- 为最终用户安装的文件-与应用程序一起安装的文件。
  看到指定要与应用程序一起安装的文件．
- 额外的运行时设置-控制生成的可执行文件的平台特定选项。看到额外的运行时设置．

打包应用程序

当您完成选择打包选项时，保存您的库的编译器投影并生成打包的应用程序。

点击包．
在“保存项目”对话框中，指定保存项目的位置。
在包对话框，验证一下当进程完成时打开输出文件夹被选中。
打包过程完成后，检查目标文件夹中生成的输出。
- 生成三个文件夹:for_redistribution，for_redistribution_files_only,for_testing．
  有关在这些文件夹中生成的文件的更多信息，请参见打包MATLAB函数后生成的文件．
- 日志文件PackagingLog.html包含包装的结果。

创建Excel插件使用`compiler.build.excelAddIn`

作为一种替代库的编译器在应用程序中，您可以使用编程方法创建Excel外接程序。方法已经创建了外接程序库的编译器,请参阅在Excel中安装外接程序．

在MATLAB中，找到要作为独立应用程序部署的MATLAB代码。对于本例，使用该文件进行编译mymagic.m位于matlabroot\工具箱\ matlabxl \ \ xlmagic例子．
```
appFile = fullfile (matlabroot,“工具箱”，“matlabxl”，“例子”，“xlmagic”，“mymagic.m”）;
```
方法构建Excel外接程序compiler.build.excelAddIn函数。使用名称-值参数设置库名和类名，并启用Visual Basic文件的生成。
```
buildResults = compiler.build.excelAddIn (appFile,.．.“AddInName”，“xlmagic”，.．.“名称”，“xlmagicclass”，.．.“GenerateVisualBasicFile”，“上”）;
```
控件中指定其他选项compiler.build使用名称-值参数命令。有关详细信息,请参见compiler.build.excelAddIn．
的compiler.build.Results对象buildResults包含有关生成类型、生成文件、包含的支持包和生成选项的信息。
该函数在名为mymagicexcelAddIn在您当前的工作目录中:
- dlldata.c
- GettingStarted.html
- includedSupportPackages.txt
- xlmagic.def
- xlmagic.bas
- xlmagic.rc
- xlmagic.xla
- xlmagic_1_0.dll
- xlmagic_dll.cpp
- xlmagic_idl.h
- xlmagic_idl.idl
- xlmagic_idl.tlb
- xlmagic_idl_i.c
- xlmagic_idl_p.c
- xlmagicClass_com.cpp
- xlmagicClass_com.hpp
- mccExcludedFiles.log
- mwcomtypes.h
- mwcomtypes_i.c
- mwcomtypes_p.c
- 固定
- requiredMCR2022世界杯八强谁会赢？Products.txt
- unresolvedSymbols.txt
请注意

生成的外接程序不包含MATLAB运行时或一个安装程序。方法创建安装程序buildResults对象,看到compiler.package.installer．

安装插件Excel

开放Microsoft Excel．
单击文件选项卡上,单击选项，然后单击插件类别。
在管理框中,单击Excel插件，然后按去．的插件对话框出现了。
点击浏览并定位外接程序xlmagic.xla．
系统提示您复制xlmagic.xla到外接程序与您的用户名关联的文件夹。您可以选择复制外接程序或直接运行它。对于本例，选择，是的．已复制外接程序并将其添加到工作簿中。
点击好吧关闭插件对话框

测试插件

在Excel工作簿中选择3乘3单元格的网格。
在公式栏中输入以下自定义函数:
```
= mymagic (3)
```
在您输入我的在公式栏里，mymagic在Excel中显示为自定义函数。
新闻Ctrl+转变+输入键盘上的。
选中的单元格显示以下输出:
```
8 1 6 3 5 7 4 9 2
```
有关其他示例，请打开该文件xlmagic.xls位于matlabroot\工具箱\ matlabxl \ \ xlmagic例子．此电子表格包含三个自定义VBA宏，演示了使用编译后的MATLAB函数的各种方法。

分发插件

要将加载宏分发给最终用户，请参见分发插件并集成到Microsoft Excel中．

另请参阅

libraryCompiler|compiler.build.excelAddIn