Exponenta Banner

findLabel

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

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

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

Синтаксис

label = findLabel(file,categoryName,labelName)
label = findLabel(file,labelDefinition)
label = findLabel(category,labelName)

Описание

пример

label = findLabel(file,categoryName,labelName) возвращает метку и присоединенные к ней данные для метки labelName в categoryName категорий который присоединен к заданному file или файлы. Используйте этот синтаксис, когда вы знаете имя метки и категорию.

пример

label = findLabel(file,labelDefinition) возвращает метку файла и присоединенные к ней данные для имени метки и категории, заданные labelDefinition. Используйте этот синтаксис, если вы ранее получили labelDefinition путем доступа к Labels свойство, например, использование команды, подобной myfile.Labels(1).

пример

label = findLabel(category,labelName) возвращает определение метки в этой категории, заданное как labelName. Возвращает пустой массив, если метка не найдена.

Примеры

свернуть все

Найдите все файлы проекта с определенной меткой.

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

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 и добавить их в список, возвращенный в utility_files_to_review.

utility_files_to_review = {};
for jj=1:numel(files)
   this_file = files(jj);
   
   label = findLabel(this_file,'Classification','Utility');
      
   if ( ~isempty(label))
      % This is a file labeled 'Utility'. Add to the 
      % list of utility files.
      utility_files_to_review = [utility_files_to_review; this_file];
   end
end

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

sldemo_slproject_airframe;
proj = simulinkproject;

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

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

Получите метку по имени.

label = findLabel(myfile,'Classification','Design');

Кроме того, исследуйте Labels свойство файла, чтобы получить массив объектов Label, по одному для каждой метки, присоединенной к файлу.

labels = myfile.Labels

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

labeldefinition = myfile.Labels(1)

После того, как вы получите определение метки из свойства Labels, вы можете использовать его с findLabel.

label = findLabel(myfile,labeldefinition);

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

sldemo_slproject_airframe;
proj = simulinkproject;

Получите категорию.

category = proj.Categories(1)
category = 

  Category with properties:

                Name: 'Classification'
            DataType: 'none'
    LabelDefinitions: [1x8 slproject.LabelDefinition]

Получите определение метки.

ld = findLabel(category,'Design')
ld = 

  LabelDefinition with properties:

            Name: 'Design'
    CategoryName: 'Classification'

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

свернуть все

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

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

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

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

Категория меток, заданная как объект категории. Получите объект категории из proj.Categories свойство или при помощи findCategory.

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

свернуть все

Метка, возвращенная как объект метки.

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

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

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

См. также

Функции

Введенный в R2013a

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

Поддержка