主要内容

compiler.build.excelAddIn

创建微软Excel插件

折叠所有页面

语法

compiler.build.excelAddIn (FunctionFiles)
compiler.build.excelAddIn (FunctionFiles、名称、值)
compiler.build.excelAddIn(选择)
结果= compiler.build.excelAddIn(___）

描述

例子

谨慎

该功能仅支持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使用以前语法中的任何输入参数组合。构建信息由构建类型、已编译文件的路径和构建选项组成。

例子

全部折叠

使用生成魔方的函数文件在Windows系统上创建Excel外接程序。

确保您已安装以下:

在MATLAB中，找到要部署为Excel外接程序的MATLAB函数。对于本例，使用文件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

在Windows系统上创建Excel外接程序，并使用名称-值参数自定义它。

对于本例，使用文件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

控件在Windows系统上创建多个Excel加载项compiler.build.ExcelAddInOptions对象。

对于本例，使用文件magicsquare.m位于matlabroot\走读生\ \编译器例子．

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

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

opts = compiler.build.excelAddInOptions(appFile，.．.“OutputDir”，' D: \ \ MATLAB文件\ \工作ExcelAddInBatch”，.．.“GenerateVisualBasicFile”，“上”，.．.“详细”，“上”）
opts = ExcelAddInOptions与属性:AddInName: 'magicsquare' AddInVersion: '1.0.0.0' ClassName: 'magicsquareClass' DebugBuild:关闭嵌入式:打开函数文件:{'C:\程序文件\MATLAB\R2022b\走读生\ \编译器\ magicsquare例子。m'} GenerateVisualBasicFile: on AdditionalFiles: {} AutoDetectDataFiles: on 金宝appSupportPackages: {'autodetect'} Verbose: on OutputDir: 'D:\Documents\MATLAB\work\ExcelAddInBatch'

控件构建外接程序ExcelAddInOptions对象。

compiler.build.excelAddIn(选择);

要使用函数文件创建新的外接程序myMagic2.m使用相同的选项，使用点表示法修改FunctionFiles现有的论证ExcelAddInOptions对象，然后再次运行生成函数。

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

通过修改FunctionFiles参数和重新编译后，您可以使用相同的选项对象创建多个外接程序。

创建Excel外接程序并将有关构建类型、生成的文件、包含的支持包和构建选项的信息保存到金宝appcompiler.build.Results对象。

使用文件编译magicsquare.m位于matlabroot\走读生\ \编译器例子．

结果= compiler.build.excelAddIn(“magicsquare.m”）
results =带有属性的结果:BuildType: 'excelAddIn' Files: {2×1 cell} IncludedSupportPackages: {金宝app} Options: [1×1 compiler.build.ExcelAddInOptions]

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

  • magicsquare_1_0.dll

  • GettingStarted.html

请注意

的文件magicsquare.bas而且magicsquare.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（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

  • 如果将此属性设置为“上”，然后是作为某些函数的输入(例如负载而且打开外部文件)会自动包含在外接程序中。

  • 如果将此属性设置为“关闭”方法将数据文件添加到外接程序AdditionalFiles财产。

例子:“AutoDetectDataFiles”,“关闭”

数据类型:逻辑

类的名称，指定为字符向量或字符串标量。类名必须符合Excel外接程序类名要求。

列表中列出的第一个文件的名称FunctionFiles参数。类．

例子:“名称”、“magicsquareClass”

数据类型:字符|字符串

标志以启用调试符号，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

  • 如果将此属性设置为“上”，然后使用调试符号编译外接程序。

  • 如果将此属性设置为“关闭”，则外接程序不会使用调试符号编译。

例子:“DebugSymbols”,“上”

数据类型:逻辑

标志，以嵌入可部署归档文件，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

  • 如果将此属性设置为“上”，然后该函数将可部署归档嵌入到Excel外接程序中。

  • 如果将此属性设置为“关闭”，然后该函数将可部署归档文件生成为单独的文件。

例子:“EmbedArchive”,“关闭”

数据类型:逻辑

标志以生成Visual Basic文件(.bas)和Excel外接程序文件(.xla)，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

  • 如果将此属性设置为“上”，然后该函数生成一个Excel外接程序XLA文件和一个Visual Basic BAS文件，其中包含Microsoft Excel外接程序的函数接口。

  • 如果将此属性设置为“关闭”，则该函数不生成Visual Basic文件或Excel外接程序文件。

请注意

要生成Excel外接程序文件(.xla)，您必须在Excel设置中启用“信任访问VBA项目对象模型”。

例子:“GenerateVisualBasicFile”,“上”

数据类型:逻辑

保存生成文件的输出目录的路径，指定为字符向量或字符串标量。路径可以是相对于当前工作目录的路径，也可以是绝对路径。

生成文件夹的默认名称是附加的外接程序名称excelAddIn．

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

数据类型:字符|字符串

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

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

  • “没有”—不包含任金宝app何支持包。使用此选项可能会导致运行时错误。

  • 字符串标量、字符向量或字符向量的单元格数组—只包含指定的支持包。金宝app要列出已安装的支持包或特定文件使用的金宝app支持包，请参见compiler.codetools.deployable金宝appSupportPackages．

例子:“金宝app支持包”，{“TensorFlow模型的深度学习工具箱转换器”，“Places365-GoogLeNet网络的深度学习工具箱模型”}

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

标志来控制生成详细程度，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

  • 如果将此属性设置为“上”，然后MATLAB命令窗口显示进度信息，指示编译过程中的编译器输出。

  • 如果将此属性设置为“关闭”，则命令窗口不显示进度信息。

例子:“详细”,“上”

数据类型:逻辑

输出参数

全部折叠

构建结果，返回为compiler.build.Results对象。的结果对象包含:

  • 构建类型，即“excelAddIn”

  • 以下文件路径:

    • GettingStarted.html

    • AddInName＿AddInVersion. dll

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

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

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

  • 属性指定的生成选项ExcelAddInOptions对象

限制

  • 该功能仅支持Windows操作系统。金宝app

版本历史

R2021a中引入

另请参阅

||