Exponenta Banner
exponenta event banner

addLabel

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

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

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

Синтаксис

addLabel(file,categoryName,labelName)
addLabel(file,categoryName,labelName,labelData)

Описание

пример

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

В представлении Files Project в столбце Classification отображается метка 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'

В представлении Files Project для AnalogControl.slx файл, в Review столбце отображается To Review метка с данными о метке.

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

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

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

свернуть все

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

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

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

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

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

расширить все

Не рекомендуемый запуск в R2019a

См. также

Функции

Введенный в R2013a

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

Поддержка