Exponenta Banner

compiler.build.ExcelAddInOptions

Опции для создания дополнений Excel

свернуть все на странице

    Синтаксис

    opts = compiler.build.ExcelAddInOptions(FunctionFiles)
    opts = compiler.build.ExcelAddInOptions(FunctionFiles,Name,Value)

    Описание

    пример

    opts = compiler.build.ExcelAddInOptions(FunctionFiles) создает ExcelAddInOptions объект с помощью MATLAB® функции заданы FunctionFiles. Используйте ExcelAddInOptions возразите как вход против compiler.build.excelAddIn функция.

    пример

    opts = compiler.build.ExcelAddInOptions(FunctionFiles,Name,Value) создает ExcelAddInOptions объект с опциями, заданными с помощью одних или нескольких аргументов name-value. Опции включают дополнительное имя, дополнительные файлы, чтобы включать, и выходная директория.

    Примеры

    свернуть все

    Создайте ExcelAddInOptions объект с помощью файла вводится.

    В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler.

    appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.ExcelAddInOptions(appFile)
    opts = 

  ExcelAddInOptions with properties:

                  AddInName: 'magicsquare'
               AddInVersion: '1.0.0.0'
                  ClassName: 'magicsquareClass'
                 DebugBuild: off
               EmbedArchive: on
              FunctionFiles: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
    GenerateVisualBasicFile: off
            AdditionalFiles: {}
        AutoDetectDataFiles: on
            SupportPackages: {'autodetect'}
                    Verbose: off
                  OutputDir: '.\magicsquareexcelAddIn'

    Можно изменить значения свойств существующего ExcelAddInOptions объект с помощью записи через точку. Например, включите многословный выход.

    opts.Verbose = 'on'
    opts = 

  ExcelAddInOptions with properties:

                  AddInName: 'magicsquare'
               AddInVersion: '1.0.0.0'
                  ClassName: 'magicsquareClass'
                 DebugBuild: off
               EmbedArchive: on
              FunctionFiles: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
    GenerateVisualBasicFile: off
            AdditionalFiles: {}
        AutoDetectDataFiles: on
            SupportPackages: {'autodetect'}
                    Verbose: on
                  OutputDir: '.\magicsquareexcelAddIn'

    Используйте ExcelAddInOptions возразите как вход против compiler.build.excelAddIn функционируйте, чтобы создать Excel® дополнение.

    buildResults = compiler.build.excelAddIn(opts);

    Создайте ExcelAddInOptions возразите и настройте его с помощью аргументов name-value.

    В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler. Используйте аргументы name-value, чтобы задать выходную директорию, сгенерировать Visual Basic® файл, и включает многословный выход.

    appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.ExcelAddInOptions(appFile,...
    'OutputDir','D:\Documents\MATLAB\work\MagicSquareAddIn',...
    'GenerateVisualBasicFile','On')
    opts =

  ExcelAddInOptions with properties:

                  AddInName: 'magicsquare'
               AddInVersion: '1.0.0.0'
                  ClassName: 'magicsquareClass'
                 DebugBuild: off
               EmbedArchive: on
              FunctionFiles: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
    GenerateVisualBasicFile: on
            AdditionalFiles: {}
        AutoDetectDataFiles: on
            SupportPackages: {'autodetect'}
                    Verbose: off
              OutputDir: 'D:\Documents\MATLAB\work\MagicSquareAddIn'

    Используйте ExcelAddInOptions возразите как вход против compiler.build.excelAddIn функционируйте, чтобы создать дополнение Excel.

    buildResults = compiler.build.excelAddIn(opts);

    Входные параметры

    свернуть все

    Список файлов, реализующих функции MATLAB в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Файлы должны иметь .m расширение.

    Пример: {'myFunction1.m','myFunction2.m'}

    Типы данных: char | string | cell

    Аргументы name-value

    Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

    Пример: 'Verbose','on'

    Имя дополнения Excel в виде вектора символов или строкового скаляра. Имя по умолчанию сгенерированного дополнения является первой записью FunctionFiles аргумент. Имя должно начаться с буквы и содержать только буквенные символы и символы нижнего подчеркивания.

    Пример: 'AddInName','myAddIn'

    Типы данных: char | string

    Дополнительная версия в виде вектора символов или строкового скаляра.

    Пример: 'AddInVersion','4.0'

    Типы данных: char | string

    Дополнительные файлы, чтобы включать в дополнение Excel в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта.

    Пример: 'AdditionalFiles',["myvars.mat","data.txt"]

    Типы данных: char | string | cell

    Отметьте, чтобы автоматически включать файлы данных в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем файлы данных, которые вы предоставляете как входные параметры определенным функциям (такой как load и fopen) автоматически включены в дополнение.

    • Если вы устанавливаете это свойство на 'off', затем необходимо добавить файлы данных в дополнение с помощью AdditionalFiles свойство.

    Пример: 'AutoDetectDataFiles','Off'

    Типы данных: логический

    Имя класса в виде вектора символов или строкового скаляра. Имена классов должны совпадать с дополнительными требованиями имени класса Excel.

    Значением по умолчанию является имя первого файла, перечисленного в FunctionFiles аргумент добавлен с Class.

    Пример: 'ClassName','magicsquareClass'

    Типы данных: char | string

    Отметьте, чтобы включить отладочные символы в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем дополнение скомпилировано с отладочными символами.

    • Если вы устанавливаете это свойство на 'off', затем дополнение не скомпилировано с отладочными символами.

    Пример: 'DebugSymbols','On'

    Типы данных: логический

    Отметьте, чтобы встроить развертываемый архив в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем функция встраивает развертываемый архив в дополнение Excel.

    • Если вы устанавливаете это свойство на 'off', затем функция генерирует развертываемый архив как отдельный файл.

    Пример: 'EmbedArchive','Off'

    Типы данных: логический

    Отметьте, чтобы сгенерировать файл Visual Basic (.bas) и дополнительный файл Excel (.xla) в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем функция генерирует дополнение Excel файл XLA и файл BAS Visual Basic, содержащий Microsoft® Интерфейс Excel Formula Function к дополнению.

    • Если вы устанавливаете это свойство на 'off', затем функция не генерирует файл Visual Basic или дополнительный файл Excel.

    Примечание

    Сгенерировать дополнительный файл Excel (.xla), необходимо включить, "Доверяют доступ к объектной модели проекта VBA" в настройках Excel.

    Пример: 'GenerateVisualBasicFile','On'

    Типы данных: логический

    Путь к выходной директории, где файлы типа "build" сохранены в виде вектора символов или строкового скаляра. Путь может быть относительно текущей рабочей директории или абсолюта.

    Имя по умолчанию папки сборки является дополнительным именем, добавленным с excelAddIn.

    Пример: 'OutputDir','D:\Documents\MATLAB\work\mymagicexcelAddIn'

    Типы данных: char | string

    Пакеты поддержки, чтобы включать в виде одной из следующих опций:

    • 'autodetect' (значение по умолчанию) — Процесс анализа зависимостей обнаруживает и включает необходимые пакеты поддержки автоматически.

    • 'none' — Никакие пакеты поддержки не включены. Используя эту опцию может вызвать ошибки периода выполнения.

    • Строковый скаляр, вектор символов или массив ячеек из символьных векторов — Только заданные пакеты поддержки включены. Чтобы перечислить установленные пакеты поддержки или используемых определенным файлом, смотрите compiler.codetools.deployableSupportPackages.

    .

    Пример: 'SupportPackages',{'Deep Learning Toolbox Converter for TensorFlow Models','Deep Learning Toolbox Model for Places365-GoogLeNet Network'}

    Типы данных: char | string | cell

    Отметьте, чтобы управлять многословием сборки в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем окно команды MATLAB отображает информацию о прогрессе, указывающую на выход компилятора во время процесса сборки.

    • Если вы устанавливаете это свойство на 'off', затем командное окно не отображает информацию о прогрессе.

    Пример: 'Verbose','On'

    Типы данных: логический

    Выходные аргументы

    свернуть все

    Дополнение Excel создает опции, возвращенные как ExcelAddInOptions объект.

    Смотрите также

    |

    Введенный в R2021a

    Документация MATLAB Compiler

    Поддержка