Создание надстройки Microsoft Excel
Внимание
Эта функция поддерживается только в операционных системах Windows ®.
compiler.build.excelAddIn( создает надстройку Excel ® с использованием функций MATLAB ®, указанных вFunctionFiles)FunctionFiles. Перед созданием надстроек Excel установите поддерживаемый компилятор.
compiler.build.excelAddIn( создает надстройку Excel с параметрами, заданными с помощью одного или нескольких аргументов «имя-значение». Параметры включают имя надстройки, каталог вывода и необходимость создания файла Microsoft ® Visual Basic ®.FunctionFiles,Name,Value)
compiler.build.excelAddIn( создает надстройку Excel с параметрами, заданными с помощью opts)compiler.build.excelAddInOptions объект opts. Другие параметры нельзя задать с помощью аргументов «имя-значение».
results = compiler.build.excelAddIn(___)compiler.build.Results с использованием любой из комбинаций входных аргументов в предыдущих синтаксисах. Сведения о построении состоят из типа построения, путей к скомпилированным файлам и параметров построения.
Создайте надстройку Excel в системе Windows с помощью файла функций, который создает магический квадрат.
В MATLAB найдите функцию MATLAB, которую необходимо развернуть как надстройку Excel. Для этого примера используйте файл magicsquare.m расположен в matlabroot\extern\examples\compiler
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
Создание надстройки Excel с помощью compiler.build.excelAddIn команда.
compiler.build.excelAddIn(appFile);
Функция создает следующие файлы в папке с именем magicsquareexcelAddIn в текущей рабочей папке:
dlldata.c
GettingStarted.html
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
readme.txt
requiredMCRProducts.txt
unresolvedSymbols.txt
Создайте надстройку Excel в системе Windows и настройте ее с помощью аргументов «имя-значение».
Для этого примера используйте файл magicsquare.m расположен в matlabroot\extern\examples\compiler
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
Создание надстройки Excel с помощью compiler.build.excelAddIn команда. Используйте аргументы «имя-значение» для указания имени и версии надстройки, создания файла Microsoft Visual Basic и включения подробных выходных данных.
compiler.build.excelAddIn(appFile,'AddInName','MyMagicSquare',... 'AddInVersion','2.0',... 'GenerateVisualBasicFile','on',... 'Verbose','on');
Функция создает следующие файлы в папке с именем MyMagicSquareexcelAddIn в текущей рабочей папке:
dlldata.c
GettingStarted.html
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
readme.txt
requiredMCRProducts.txt
unresolvedSymbols.txt
Создание нескольких надстроек Excel в системе Windows с помощью compiler.build.ExcelAddInOptions объект.
Для этого примера используйте файл magicsquare.m расположен в matlabroot\extern\examples\compiler
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
Создание ExcelAddInOptions объект с использованием appFile. Используйте аргументы «имя-значение», чтобы указать общий выходной каталог, создать файл Visual Basic и включить подробный вывод.
opts = compiler.build.excelAddInOptions(appFile,... 'OutputDir','D:\Documents\MATLAB\work\ExcelAddInBatch',... 'GenerateVisualBasicFile','on',... 'Verbose','on')
opts =
ExcelAddInOptions with properties:
AddInName: 'magicsquare'
AddInVersion: '1.0.0.0'
ClassName: 'magicsquareClass'
DebugBuild: off
EmbedArchive: on
FunctionFiles: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}
GenerateVisualBasicFile: on
AdditionalFiles: {}
AutoDetectDataFiles: on
Verbose: on
OutputDir: 'D:\Documents\MATLAB\work\ExcelAddInBatch'Создайте надстройку с помощью ExcelAddInOptions объект.
compiler.build.excelAddIn(opts);
Создание новой надстройки с помощью файла функции myMagic2.m с теми же опциями, используйте точечную нотацию для изменения FunctionFiles аргумент существующего ExcelAddInOptions перед повторным запуском функции построения.
opts.FunctionFiles = 'myMagic2.m';
compiler.build.excelAddIn(opts);Путем изменения FunctionFiles аргумент и перекомпиляция, можно создать несколько надстроек, используя один и тот же объект options.
Создание надстройки Excel и сохранение информации о типе сборки, созданных файлах и параметрах сборки в compiler.build.Results объект.
Компиляция с помощью файла magicsquare.m расположен в matlabroot\extern\examples\compiler
results = compiler.build.excelAddIn('magicsquare.m')results =
Results with properties:
BuildType: 'excelAddIn'
Files: {2×1 cell}
Options: [1×1 compiler.build.ExcelAddInOptions] Files содержит пути к следующим скомпилированным файлам:
magicsquare_1_0.dll
GettingStarted.html
Примечание
Файлы magicsquare.bas и magicsquare.xla включены в Files только при включении 'GenerateVisualBasicFile' в команде build.
FunctionFiles - Файлы, реализующие функции MATLABФайлы, реализующие функции MATLAB, указанные как символьный вектор, строковый скаляр, строковый массив или массив ячеек символьных векторов. Пути к файлам могут быть относительно текущей рабочей папки или абсолютными. Файлы должны иметь .m расширение.
Пример: ["myfunc1.m","myfunc2.m"]
Типы данных: char | string | cell
opts - параметры сборки надстройки Excelcompiler.build.ExcelAddInOptions объектПараметры компоновки надстройки Excel, указанные как compiler.build.ExcelAddInOptions объект.
Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.
'Verbose','on''AddInName' - Имя надстройки ExcelИмя надстройки Excel, указанное как вектор символов или скаляр строки. Имя по умолчанию созданной надстройки является первой записью FunctionFiles аргумент. Имя должно начинаться с буквы и содержать только буквенные символы и знаки подчеркивания.
Пример: 'AddInName','myAddIn'
Типы данных: char | string
'AddInVersion' - Версия надстройки'1.0.0.0' (по умолчанию) | символьный вектор | строковый скалярВерсия надстройки, заданная как вектор символов или скаляр строки.
Пример: 'AddInVersion','4.0'
Типы данных: char | string
'AdditionalFiles' - Дополнительные файлыДополнительные файлы для включения в надстройку Excel, указанные как символьный вектор, строковый скаляр, строковый массив или массив ячеек символьных векторов. Пути к файлам могут быть относительно текущей рабочей папки или абсолютными.
Пример: 'AdditionalFiles',["myvars.mat","data.txt"]
Типы данных: char | string | cell
'AutoDetectDataFiles' - Флажок для автоматического включения файлов данных'on' (по умолчанию) | логическое значение on/offФлажок для автоматического включения файлов данных, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Если для этого свойства задано значение 'on', то файлы данных, которые вы предоставляете в качестве входных данных для определенных функций (таких как load и fopen) автоматически включаются в надстройку.
Если для этого свойства задано значение 'off', то необходимо добавить файлы данных в надстройку с помощью AdditionalFiles собственность.
Пример: 'AutoDetectDataFiles','Off'
Типы данных: logical
'ClassName' - Наименование классаИмя класса, указанное как символьный вектор или строковый скаляр. Имена классов должны соответствовать требованиям к именам классов надстроек Excel.
Значением по умолчанию является имя первого файла, указанного в FunctionFiles аргумент, добавленный с Class.
Пример: 'ClassName','magicsquareClass'
Типы данных: char | string
'DebugBuild' - Флаг для включения символов отладки'on' (по умолчанию) | логическое значение on/offФлаг для включения символов отладки, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Если для этого свойства задано значение 'on', то надстройка компилируется с использованием символов отладки.
Если для этого свойства задано значение 'off', то надстройка не компилируется с символами отладки.
Пример: 'DebugSymbols','On'
Типы данных: logical
'EmbedArchive' - Флаг для встраивания развертываемого архива'on' (по умолчанию) | логическое значение on/offФлаг для встраивания развертываемого архива, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Если для этого свойства задано значение 'on'затем функция встраивает развертываемый архив в надстройку Excel.
Если для этого свойства задано значение 'off', затем функция генерирует развертываемый архив в виде отдельного файла.
Пример: 'EmbedArchive','Off'
Типы данных: logical
'GenerateVisualBasicFile' - Флажок для создания файла Visual Basic'off' (по умолчанию) | логическое значение on/offФлажок для создания файла Visual Basic (.basи файл надстройки Excel (.xla), указано как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Если для этого свойства задано значение 'on'затем функция генерирует XLA-файл надстройки Excel и файл Visual Basic BAS, содержащий интерфейс Microsoft Excel Formula Function для надстройки.
Если для этого свойства задано значение 'off', то функция не создает файл Visual Basic или файл надстройки Excel.
Пример: 'GenerateVisualBasicFile','On'
Типы данных: logical
'OutputDir' - Путь к выходному каталогуПуть к выходному каталогу, в котором сохраняются файлы построения, определяемый как вектор символов или строковый скаляр. Путь может быть относительно текущего рабочего каталога или абсолютным.
Именем по умолчанию папки построения является имя надстройки, добавляемое с excelAddIn.
Пример: 'OutputDir','D:\Documents\MATLAB\work\mymagicexcelAddIn'
Типы данных: char | string
'Verbose' - Флаг для контроля полноты построения'off' (по умолчанию) | логическое значение on/offФлаг для управления подробностью построения, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Если для этого свойства задано значение 'on'затем в окне команд MATLAB отображается информация о ходе выполнения, указывающая на вывод компилятора в процессе построения.
Если для этого свойства задано значение 'off', то командное окно не отображает информацию о ходе выполнения.
Пример: 'Verbose','On'
Типы данных: logical
results - Результаты построенияcompiler.build.Results объектРезультаты построения, возвращенные как compiler.build.Results объект. Results объект содержит:
Тип построения, который является 'excelAddIn'
Пути к следующим файлам:
GettingStarted.html
AddInName_AddInVersion.dll
AddInName.bas'GenerateVisualBasicFile' опция)
AddInName.xla'GenerateVisualBasicFile' опция)
Параметры построения, указанные как ExcelAddInOptions объект
Эта функция поддерживается только в операционных системах Windows.
compiler.build.ExcelAddInOptions | Компилятор библиотеки | mcc
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.