主要内容

compiler.build.excelAddIn

创建微软Excel插件

自从R2021a

描述

例子

谨慎

这个函数只支持在Windows金宝app®操作系统。

compiler.build.excelAddIn (FunctionFiles)创建一个Excel®插件使用MATLAB®指定的功能FunctionFiles。在创建Excel插件之前,安装一个金宝app支持编译器

例子

compiler.build.excelAddIn (FunctionFiles,名称,值)创建一个Excel插件选项指定使用一个或多个名称参数。选项包括插件名称、输出目录,是否生成微软®Visual Basic®文件。

例子

compiler.build.excelAddIn (选择)创建一个Excel插件选项指定使用compiler.build.excelAddInOptions对象选择。你不能指定其他选项使用名称-值参数。

例子

结果= compiler.build.excelAddIn (___)构建信息作为回报compiler.build.Results对象使用任何输入参数组合在以前的语法。构建信息包括构建类型,编译后的文件路径,构建选项。

例子

全部折叠

创建一个Excel插件在Windows系统上使用一个函数文件,生成一个幻方。

确保您已经安装了以下:

在MATLAB中,找到你想要的MATLAB函数部署一个Excel插件。对于这个示例,使用该文件magicsquare.m位于matlabroot\走读生\ \编译器例子

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);

建立一个Excel插件使用compiler.build.excelAddIn命令。

compiler.build.excelAddIn (appFile);

函数生成下列文件在一个文件夹命名magicsquareexcelAddIn在当前工作目录中:

  • dlldata.c

  • GettingStarted.html

  • included金宝appSupportPackages.txt

  • magicsquare.def

  • magicsquare.bas(只有当你启用“GenerateVisualBasicFile”选项)

  • magicsquare.rc

  • magicsquare.xla(只有当你启用“GenerateVisualBasicFile”选项)

  • magicsquare_1_0.dll

  • magicsquare_dll.cpp

  • magicsquare_idl.h

  • magicsquare_idl.idl

  • magicsquare_idl.tlb

  • magicsquare_idl_i.c

  • magicsquare_idl_p.c

  • magicsquareClass_com.cpp

  • magicsquareClass_com.hpp

  • mccExcludedFiles.log

  • mwcomtypes.h

  • mwcomtypes_i.c

  • mwcomtypes_p.c

  • 固定

  • requiredMCR下载188bet金宝搏Products.txt

  • unresolvedSymbols.txt

创建一个Excel插件在Windows系统上使用名称-值参数和定制它。

对于这个示例,使用该文件magicsquare.m位于matlabroot\走读生\ \编译器例子

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);

建立一个Excel插件使用compiler.build.excelAddIn命令。使用名称-值参数指定插件名称和版本,生成一个微软Visual Basic文件,并启用详细输出。

compiler.build.excelAddIn (appFile“AddInName”,“MyMagicSquare”,“AddInVersion”,“2.0”,“GenerateVisualBasicFile”,“上”,“详细”,“上”);

函数生成下列文件在一个文件夹命名MyMagicSquareexcelAddIn在当前工作目录中:

  • dlldata.c

  • GettingStarted.html

  • included金宝appSupportPackages.txt

  • magicsquareClass_com.cpp

  • magicsquareClass_com.hpp

  • mccExcludedFiles.log

  • mwcomtypes.h

  • mwcomtypes_i.c

  • mwcomtypes_p.c

  • MyMagicSquare.bas

  • MyMagicSquare.def

  • MyMagicSquare.rc

  • MyMagicSquare.xla

  • MyMagicSquare_2_0.dll

  • MyMagicSquare_dll.cpp

  • MyMagicSquare_idl.h

  • MyMagicSquare_idl.idl

  • MyMagicSquare_idl.tlb

  • MyMagicSquare_idl_i.c

  • MyMagicSquare_idl_p.c

  • 固定

  • requiredMCR下载188bet金宝搏Products.txt

  • unresolvedSymbols.txt

创建多个Excel插件在Windows系统上使用compiler.build.ExcelAddInOptions对象。

对于这个示例,使用该文件magicsquare.m位于matlabroot\走读生\ \编译器例子

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);

创建一个ExcelAddInOptions对象使用appFile。使用名称-值参数来指定一个共同的输出目录,生成一个Visual Basic文件,并启用详细的输出。

选择= compiler.build.excelAddInOptions (appFile,“OutputDir”,' D: \ \ MATLAB文件\ \工作ExcelAddInBatch”,“GenerateVisualBasicFile”,“上”,“详细”,“上”)
选择= ExcelAddInOptions属性:AddInName:“magicsquare”AddInVersion:“1.0.0.0”类名:“magicsquareClass”DebugBuild:从EmbedArchive: FunctionFiles: {“C: \ Program Files \ MATLAB \R2023a\走读生\ \编译器\ magicsquare例子。m} GenerateVisualBasicFile: AdditionalFiles: {} s + AutoDetectDataFiles: ons + ObfuscateArchive:杀死+ Supp金宝apportPackages:{“自动检测”}详细:OutputDir:“D: \ \ MATLAB文件\ \ ExcelAddInBatch工作”

构建插件使用ExcelAddInOptions对象。

compiler.build.excelAddIn(选择);

使用函数来创建一个新的插件文件myMagic2.m相同的选择,使用点符号来修改FunctionFiles现有的参数ExcelAddInOptions对象在运行构建函数了。

选择。FunctionFiles =“myMagic2.m”;compiler.build.excelAddIn(选择);

通过修改FunctionFiles参数,重新编译,您可以创建多个插件对象使用相同的选项。

创建一个Excel插件并保存信息构建类型,生成的文件,包括支持包,和构建选项金宝appcompiler.build.Results对象。

编译使用文件magicsquare.m

结果= compiler.build.excelAddIn (“magicsquare.m”)
结果=结果与属性:BuildType:“excelAddIn”文件:{2×1细胞}IncludedSupportPackages:{}选项:[1×1 compiler.b金宝appuild.ExcelAddInOptions]

文件属性包含以下编译文件的路径:

  • magicsquare_1_0.dll

  • GettingStarted.html

请注意

的文件magicsquare.basmagicsquare.xla都包含在文件只有当你启用“GenerateVisualBasicFile”选择在构建命令。

输入参数

全部折叠

文件实现MATLAB函数,指定为一个特征向量,一个字符串标量,字符串数组或单元阵列的特征向量。文件路径可以相对于当前工作目录或绝对的。文件必须有一个。m扩展。

例子:[" myfunc1.m”、“myfunc2.m”)

数据类型:字符|字符串|细胞

Excel插件构建选项,指定为一个compiler.build.ExcelAddInOptions对象。

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“详细”,“上”

Excel插件名称,指定为一个特征向量或字符串标量。生成的插件的默认名称的第一个元素FunctionFiles论点。名称必须以字母开头,只包含字母字符和下划线。

例子:“AddInName”、“myAddIn”

数据类型:字符|字符串

插件版本,指定为一个特征向量或字符串标量。

例子:“AddInVersion”、“4.0”

数据类型:字符|字符串

额外的文件和文件夹中包含Excel插件,指定为一个特征向量,一个字符串标量,字符串数组或单元阵列的特征向量。路径可以是相对于当前工作目录或绝对的。

例子:“AdditionalFiles”, (“myvars.mat”、“data.txt”)

数据类型:字符|字符串|细胞

国旗自动包括数据文件,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,然后数据文件提供某些功能(如作为输入负载打开外部文件)会自动包含在插件中。

  • 如果你设定这个属性“关闭”,那么你必须将数据文件添加到插件使用AdditionalFiles财产。

例子:“AutoDetectDataFiles”,“关闭”

数据类型:逻辑

类的名称,指定为一个特征向量或字符串标量。类名称必须匹配Excel插件类名的要求。

默认值是第一个文件中列出的名称FunctionFiles参数附加与

例子:“名称”、“magicsquareClass”

数据类型:字符|字符串

指定为旗帜,使调试符号“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,然后编译插件的调试符号。

  • 如果你设定这个属性“关闭”,然后插件不是编译调试符号。

例子:“DebugSymbols”,“上”

数据类型:逻辑

国旗中嵌入可部署归档文件,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,那么函数嵌入在Excel插件部署归档文件。

  • 如果你设定这个属性“关闭”,那么函数生成可部署归档文件作为一个单独的文件中。

例子:“EmbedArchive”,“关闭”

数据类型:逻辑

国旗来生成一个Visual Basic文件(.bas)和一个Excel插件文件(.xla),指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,那么函数生成一个Excel插件XLA文件和一个包含Visual Basic BAS文件Microsoft Excel公式函数接口插件。

  • 如果你设定这个属性“关闭”,那么函数不生成一个Visual Basic文件或Excel插件文件。

请注意

生成Excel插件文件(.xla),您必须启用“信任访问VBA项目对象模型”在Excel设置。

例子:“GenerateVisualBasicFile”,“上”

数据类型:逻辑

国旗使部署归档文件,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,然后文件夹结构和部署归档文件的文件名从最终用户混淆,和用户代码和数据包含在MATLAB文件放置到一个用户包内的档案。此外,所有。m包装之前文件转换为档案。相当于使用这个选项世纪挑战集团- j- s指定。

  • 如果你设定这个属性“关闭”,然后部署归档文件不是混淆。这是默认的行为。

例子:“ObfuscateArchive”,“上”

数据类型:逻辑

路径构建文件保存到输出目录,指定为一个特征向量或字符串标量。可以相对于当前工作目录的路径或绝对的。

建立文件夹的默认名称是附加的插件名称excelAddIn

例子:“OutputDir”、“D: \ \ MATLAB文件\ \ mymagicexcelAddIn工作'

数据类型:字符|字符串

金宝app支持包包含指定为以下选项之一:

  • “自动检测”(默认)——依赖分析过程自动检测,包括所需的支持包。金宝app

  • “没有”——不包括金宝app支持包。使用这个选项会导致运行时错误。

  • 一个字符串标量、特征向量或单元阵列特征向量的——仅包含了指定的支持包。金宝app列出支持包安装或使用的特定文件,看看金宝appcompiler.codetools.deployable金宝appSupportPackages

例子:S金宝appupportPackages,{“深度学习工具箱为TensorFlow模型转换器”,“深度学习工具箱Places365-GoogLeNet网络模型”}

数据类型:字符|字符串|细胞

国旗来控制构建冗长,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,然后用MATLAB命令窗口显示进度信息指示编译器输出在构建过程中。

  • 如果你设定这个属性“关闭”,那么命令窗口不显示进度信息。

例子:“详细”,“上”

数据类型:逻辑

输出参数

全部折叠

构建结果,作为一个返回compiler.build.Results对象。的结果对象包含:

  • 构建类型,它是“excelAddIn”

  • 路径如下文件:

    • GettingStarted.html

    • AddInName_AddInVersion. dll

    • AddInName.bas(如果您启用“GenerateVisualBasicFile”选项)

    • AddInName.xla(如果您启用“GenerateVisualBasicFile”选项)

  • 包括支持包的列表金宝app

  • 构建选项,指定为一个ExcelAddInOptions对象

限制

  • 这个函数只支持在Windows操作系统。金宝app

版本历史

介绍了R2021a