createLabel

Create project label

Syntax

labelDefinitions = createLabel(category,LabelNames)

Description

labelDefinitions = createLabel(category,LabelNames) creates new labels, in the specified category. Use this syntax if you previously got a Category object by using the findCategory function.

Examples

Create a New Label

Open the Times Table App project. Use currentProject to create a project object from the currently loaded project.

openExample("matlab/TimesTableProjectExample")
proj = currentProject;

Get the first existing category.

cat = proj.Categories(1)

cat = 

  Category with properties:

                Name: "Classification"
        SingleValued: 1
            DataType: "none"
    LabelDefinitions: [1×7 matlab.project.LabelDefinition]

Define a new label in the category.

createLabel(cat,"Future");

Create a New Category of Labels for File Ownership

Open the Times Table App project. Use currentProject to create a project object from the currently loaded project.

openExample("matlab/TimesTableProjectExample")
proj = currentProject;

Create a new category of labels called "Engineers" which can be used to denote file ownership in a project. These labels have the char datatype for attaching character vector data.

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

Get the new category by name using the findCategory function

engineersCategory = findCategory(proj,"Engineers");

Create labels in the new category.

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

Attach one of the new labels to a file in the project.

label = addLabel(myfile,"Engineers","Tom");

Get the label and add data.

label.Data = "Maintenance responsibility"

  Label with properties:

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

Input Arguments

category — Category

Category object

Category for the new label, specified as a Category object. Get the Category object by accessing a Categories property, using a syntax like proj.Categories(1), or use the findCategory function. To create a new category, use the createCategory function.

LabelNames — The name of the new labels

string array | cell array of character vectors

The name of the new labels, specified as a string array or a cell array of character vectors.

Output Arguments

labelDefinitions — Labels definition

array of labelDefinition objects

Labels definition, returned as an array of labelDefinition objects.

Tips

• To create and attach a new label in an existing category using a single step, use addLabel instead.

• To create a new category of labels, use createCategory first.

Version History

Introduced in R2019a

R2025a: Create multiple labels in category

Starting in R2025a, the createLabel function supports creating multiple labels in the same category in one step.