Exponenta Banner
exponenta event banner

addLabel

(Не рекомендуется) Прикрепить метку к файлу проекта

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

simulinkproject не рекомендуется. Использовать currentProject или openProject вместо этого. Дополнительные сведения см. в разделе Вопросы совместимости.

Синтаксис

addLabel (файл, имя категории, имя метки)
addLabel (файл, имя категории, имя метки, данные метки)

Описание

пример

addLabel(file,categoryName,labelName) добавляет указанную метку labelName в категории categoryName в файл.

пример

addLabel(file,categoryName,labelName,labelData) прикрепляет метку с данными labelData.

Примеры

свернуть все

Откройте проект планера и создайте объект проекта.

sldemo_slproject_airframe;
proj = simulinkproject;

Получить конкретный файл по имени.

myfile = findFile(proj,'models/AnalogControl.slx')
myfile = 

  ProjectFile with properties:

      Path: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
    Labels: [1x1 slproject.Label]
  Revision: '2'
SourceControlStatus: Unmodified

Получить Labels свойства файла.

myfile.Labels
ans = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: []
        DataType: 'none'
            Name: 'Design'
    CategoryName: 'Classification'

Прикрепить этикетку 'Artifact' в файл.

addLabel(myfile,'Classification','Artifact')

ans = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: []
        DataType: 'none'
            Name: 'Artifact'
    CategoryName: 'Classification'

Выполните индексирование в свойство Labels, чтобы получить метку, присоединенную к этому файлу.

reviewlabel = myfile.Labels(1)

reviewlabel = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: []
        DataType: 'none'
            Name: 'Artifact'
    CategoryName: 'Classification'

Отсоедините новую метку от файла.

removeLabel(myfile,reviewlabel)

Присоедините 'Classification' метка категории 'Utility' во все файлы проекта, имеющие .m расширение файла.

Откройте проект планера и создайте объект проекта.

sldemo_slproject_airframe;
proj = simulinkproject;

Получите список файлов.

files = proj.Files;

Закольцовывайте каждый файл. Если файл имеет расширение .m, прикрепить этикетку 'Utility'.

for fileIndex = 1:numel(files)
   file = files(fileIndex);
   [~, ~, fileExtension] = fileparts(file.Path);
   if strcmp(fileExtension,'.m')
       addLabel(file,'Classification','Utility');
   end
end

В представлении «Файлы проекта» в столбце «Классификация» отображается метка Utility для каждого .m в файле utilities папка.

Откройте проект планера и создайте объект проекта.

sldemo_slproject_airframe;
proj = simulinkproject;

Создание новой категории 'Review'.

createCategory(proj,'Review','char');

Для новой категории создайте метку 'To Review'.

reviewCategory = findCategory(proj,'Review');
createLabel(reviewCategory,'To Review');

Получить конкретный файл по имени.

myfile = findFile(proj,'models/AnalogControl.slx')
myfile = 

  ProjectFile with properties:

      Path: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
    Labels: [1x1 slproject.Label]
 Revision: '2'
SourceControlStatus: Unmodified

Прикрепить этикетку 'To Review' и символьный вектор данных метки для файла.

addLabel(myfile,'Review','To Review','Whole team design review')

Выполните индексирование в свойство Labels, чтобы получить вторую метку, присоединенную к данному файлу, и просмотреть данные метки.

myfile.Labels(2)

ans = 

  Label with properties:

            File: 'C:\Work\temp\slexamples\airframe\models\AnalogControl.slx'
            Data: 'Whole team design review'
        DataType: 'char'
            Name: 'To Review'
    CategoryName: 'Review'

В представлении «Файлы проекта» для AnalogControl.slx в столбце «Проверка» отображается To Review метка с данными метки.

Можно также задать или изменить данные метки с помощью свойства data.

mylabel = myfile.Labels(2);
mylabel.Data = 'Final review';

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

свернуть все

Файл для присоединения метки, указанный как объект файла. Объект файла можно получить, проверив свойство Files проекта (proj.Files) или использовать findFile для поиска файла по имени. Файл должен находиться в проекте.

Имя категории для метки, указанное как символьный вектор.

Имя присоединяемой метки, указанное как вектор символов или объект определения метки, возвращаемый file.Label собственность или findLabel. Можно указать новое имя метки, которое еще не существует в проекте.

Данные, присоединяемые к метке, задаются в виде символьного вектора или цифры. Тип данных зависит от определения метки. Получить этикетку для проверки ее DataType свойство с использованием file.Label или findLabel.

Вопросы совместимости

развернуть все

Не рекомендуется начинать с R2019a

См. также

Функции

Представлен в R2013a

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

Поддержка