exponenta event banner

createCategory

Создание категории меток проекта

Описание

пример

createCategory(proj,categoryName) создает новую категорию меток в указанном проекте.

пример

createCategory(proj,categoryName,dataType) также указывает тип данных для хранения в метках новой категории. Дополнительные сведения о типах данных см. в разделе Основные классы MATLAB.

пример

createCategory(proj,categoryName,dataType,"single-valued") задает категорию с одним значением, в которой к файлу можно присоединить только одну метку из категории. Если не указать категорию с одним значением, можно присоединить к файлу несколько меток из этой категории.

пример

newcategory = createCategory(___) возвращает новую категорию в виде Category объект. Этот синтаксис используется с любой из предыдущих комбинаций входных аргументов.

Примеры

свернуть все

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

Откройте проект приложения Times Table. Использовать currentProject для создания объекта проекта из загруженного проекта.

matlab.project.example.timesTable
proj = currentProject;

Создание новой категории меток с именем Engineers, чтобы указать, какому инженеру принадлежит файл. Эти метки имеют char тип данных для присоединения данных символьного вектора.

createCategory(proj,"Engineers","char");

Используйте findCategory для получения новой категории.

engineersCategory = findCategory(proj,"Engineers");

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

createLabel(engineersCategory,"Tom");
createLabel(engineersCategory,"Harry");

Прикрепите одну из новых меток к файлу в проекте.

myfile = findFile(proj,"source/timesTableGame.m");
addLabel(myfile,"Engineers","Tom");

Получите метку и добавьте данные.

label = findLabel(myfile,"Engineers","Tom");
label.Data = "Maintenance responsibility";
disp(label)
Label with properties:

            File: [1x80 char]
            Data: "Maintenance responsibility"
        DataType: 'char'
            Name: "Tom"
    CategoryName: "Engineers"

Создание категории меток с помощью double тип данных, используемый для числовых данных.

Откройте проект приложения Times Table. Использовать currentProject для создания объекта проекта из загруженного проекта.

matlab.project.example.timesTable
proj = currentProject;

Создайте новую категорию меток. Укажите "double"в качестве типа данных. Это тип данных MATLAB ®, используемый для чисел по умолчанию.

coverageCategory = createCategory(proj,"Coverage","double")
category = 

  Category with properties:

                Name: "Coverage"
            DataType: 'double'
    LabelDefinitions: []

Создайте метку в новой категории и добавьте ее в файл проекта.

createLabel(coverageCategory,"Test");
myfile = findFile(proj,"source/timesTableGame.m");
label = addLabel(myfile,"Coverage","Test");

Добавьте числовые данные к метке.

label.Data = 80
newLabel = 

  Label with properties:

            File: "C:\myProjects\examples\TimesTableApp\source\timesTableGame.m"
        DataType: 'double'
            Data: 80
            Name: "Test"
    CategoryName: "Coverage"

Откройте проект приложения Times Table. Использовать currentProject для создания объекта проекта из загруженного проекта.

matlab.project.example.timesTable
proj = currentProject;

Создайте категорию меток для владельца файла и укажите одно значение, чтобы ограничить только одну метку в категории на файл.

engineersCategory = createCategory(proj,"Engineers","char", "single-valued");

Создайте метку в новой категории и добавьте ее в файл проекта.

createLabel(engineersCategory,"Tom");
myfile = findFile(proj,"source/timesTableGame.m");
addLabel(myfile,"Engineers","Tom")
ans = 

  Label with properties:

            File: "C:\myProjects\examples\TimesTableApp\source\timesTableGame.m"
        DataType: 'char'
            Data: []
            Name: "Tom"
    CategoryName: "Engineers"

Создайте вторую метку в новой категории и добавьте ее в тот же файл проекта. MATLAB заменяет первую метку новой.

createLabel(engineersCategory,"Harry");
addLabel(myfile,"Engineers","Harry")
ans = 

  Label with properties:

            File: "C:\myProjects\examples\TimesTableApp\source\timesTableGame.m"
        DataType: 'char'
            Data: []
            Name: "Harry"
    CategoryName: "Engineers"

Убедитесь, что первая метка по-прежнему прикреплена к файлу.

findLabel(myfile,"Engineers","Tom")
ans = 

  0×0 Label array with properties:

    File
    DataType
    Data
    Name
    CategoryName

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

свернуть все

Проект, указанный как matlab.project.Project объект. Использовать currentProject для создания объекта проекта из загруженного проекта.

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

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

Совет

После создания новой категории можно создать метки в новой категории с помощью createLabel функция.

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